Upload 3 files

README.md

@@ -1,19 +1,35 @@
 ---
-title: Time Release Study Simulator
-emoji: 🚀
-colorFrom: red
-colorTo: red
-sdk: docker
-app_port: 8501
-tags:
-- streamlit
+title: Meridia Frontier TRS Simulator
+emoji: 🚢
+colorFrom: blue
+colorTo: blue
+sdk: streamlit
+sdk_version: 1.32.0
+app_file: app.py
 pinned: false
-short_description: 'Customs Time Release Study (TRS) simulator '
+license: mit
 ---
 
-# Welcome to Streamlit!
+# The Meridia Frontier — TRS Simulator
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+A gamified Time Release Study (TRS) simulator for customs policy analysis.
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+## Features
+- 🗺 **Isometric Port View** — Live Phaser.js game canvas showing Azure Port, Vortex Air Terminal & Stone Pass
+- 📊 **Japan-style TRS Charts** — Stacked bar breakdown of release time segments
+- 📋 **Audit Ledger** — Full CSV export of every simulated Bill of Entry
+- ⚙ **Policy Levers** — Advance Filing, RMS Facilitation, AEO Enrollment, PGA Single Window, Deferred Duty, Auto-OOC
+
+## How to use
+1. Adjust policy sliders in the sidebar
+2. Click **RUN SIMULATION**
+3. Watch cargo dots appear on the isometric port map
+4. Switch to **TRS REPORT** tab for the stacked bar chart
+5. Download the **Audit Ledger CSV** for full data
+
+## Tech Stack
+- `SimPy` — Discrete event simulation engine
+- `Streamlit` — Web framework
+- `Phaser.js 3` — Isometric game rendering (via st.components)
+- `Plotly` — TRS analytics charts
+- `Pandas` — CSV export

app.py

@@ -0,0 +1,990 @@
+import streamlit as st
+import simpy
+import numpy as np
+import pandas as pd
+import plotly.graph_objects as go
+import json
+import random
+from dataclasses import dataclass, field
+from typing import List, Optional
+import time
+
+st.set_page_config(
+    page_title="Meridia Frontier — TRS Simulator",
+    page_icon="🚢",
+    layout="wide",
+    initial_sidebar_state="expanded"
+)
+
+# ── Inject custom CSS ──────────────────────────────────────────────────────────
+st.markdown("""
+<style>
+@import url('https://fonts.googleapis.com/css2?family=Rajdhani:wght@400;500;600;700&family=Share+Tech+Mono&display=swap');
+
+:root {
+    --meridia-dark: #0a0e1a;
+    --meridia-navy: #0d1b2a;
+    --meridia-blue: #1a3a5c;
+    --meridia-cyan: #00d4ff;
+    --meridia-gold: #f5a623;
+    --meridia-green: #00ff88;
+    --meridia-red: #ff4757;
+    --meridia-text: #c8d8e8;
+    --meridia-muted: #5a7a9a;
+}
+
+html, body, [class*="css"] {
+    font-family: 'Rajdhani', sans-serif;
+    background-color: var(--meridia-dark) !important;
+    color: var(--meridia-text) !important;
+}
+
+.stApp { background: var(--meridia-dark) !important; }
+
+/* Sidebar */
+[data-testid="stSidebar"] {
+    background: linear-gradient(180deg, #0d1b2a 0%, #0a0e1a 100%) !important;
+    border-right: 1px solid #1a3a5c !important;
+}
+
+/* Metrics */
+[data-testid="stMetric"] {
+    background: rgba(0,212,255,0.05) !important;
+    border: 1px solid rgba(0,212,255,0.2) !important;
+    border-radius: 8px !important;
+    padding: 12px !important;
+}
+[data-testid="stMetricValue"] { color: var(--meridia-cyan) !important; font-family: 'Share Tech Mono' !important; font-size: 1.8rem !important; }
+[data-testid="stMetricLabel"] { color: var(--meridia-muted) !important; font-size: 0.75rem !important; letter-spacing: 0.1em !important; }
+[data-testid="stMetricDelta"] { font-family: 'Share Tech Mono' !important; }
+
+/* Sliders */
+[data-testid="stSlider"] > div > div > div > div {
+    background: var(--meridia-cyan) !important;
+}
+
+/* Buttons */
+.stButton > button {
+    background: linear-gradient(135deg, #1a3a5c, #0d1b2a) !important;
+    border: 1px solid var(--meridia-cyan) !important;
+    color: var(--meridia-cyan) !important;
+    font-family: 'Rajdhani', sans-serif !important;
+    font-weight: 600 !important;
+    letter-spacing: 0.1em !important;
+    border-radius: 4px !important;
+    transition: all 0.2s !important;
+}
+.stButton > button:hover {
+    background: rgba(0,212,255,0.15) !important;
+    box-shadow: 0 0 12px rgba(0,212,255,0.3) !important;
+}
+
+/* Section headers */
+h1, h2, h3 { font-family: 'Rajdhani', sans-serif !important; letter-spacing: 0.05em !important; }
+h1 { color: var(--meridia-cyan) !important; }
+h2 { color: var(--meridia-gold) !important; }
+h3 { color: var(--meridia-text) !important; }
+
+/* Tabs */
+[data-testid="stTabs"] button {
+    font-family: 'Rajdhani', sans-serif !important;
+    font-weight: 600 !important;
+    letter-spacing: 0.08em !important;
+    color: var(--meridia-muted) !important;
+}
+[data-testid="stTabs"] button[aria-selected="true"] {
+    color: var(--meridia-cyan) !important;
+    border-bottom-color: var(--meridia-cyan) !important;
+}
+
+/* Dataframe */
+[data-testid="stDataFrame"] { border: 1px solid #1a3a5c !important; }
+
+/* Scrollbar */
+::-webkit-scrollbar { width: 4px; }
+::-webkit-scrollbar-track { background: var(--meridia-dark); }
+::-webkit-scrollbar-thumb { background: var(--meridia-blue); border-radius: 2px; }
+
+.port-badge {
+    display: inline-block;
+    padding: 2px 10px;
+    border-radius: 20px;
+    font-size: 0.7rem;
+    font-weight: 700;
+    letter-spacing: 0.1em;
+    text-transform: uppercase;
+}
+
+.glow-text { text-shadow: 0 0 10px rgba(0,212,255,0.5); }
+</style>
+""", unsafe_allow_html=True)
+
+
+# ══════════════════════════════════════════════════════════════════════════════
+# DATA MODEL
+# ══════════════════════════════════════════════════════════════════════════════
+
+@dataclass
+class BoE:
+    shipment_id: str
+    port_type: str          # Sea / Air / Land
+    filing_type: str        # Advance / Normal
+    pga_involved: bool
+    aeo_status: str         # T1 / T2 / T3 / None
+    machine_release: bool   = False
+    t_arrival: float        = 0.0
+    t_filed: float          = 0.0
+    t_assessed: float       = 0.0
+    t_payment: float        = 0.0
+    t_ooc: float            = 0.0
+
+    @property
+    def total_hours(self): return max(self.t_ooc - self.t_arrival, 0)
+    @property
+    def seg_filing(self): return max(self.t_filed - self.t_arrival, 0)
+    @property
+    def seg_assessment(self): return max(self.t_assessed - self.t_filed, 0)
+    @property
+    def seg_payment(self): return max(self.t_payment - self.t_assessed, 0)
+    @property
+    def seg_logistics(self): return max(self.t_ooc - self.t_payment, 0)
+
+
+# ══════════════════════════════════════════════════════════════════════════════
+# SIMPY SIMULATION ENGINE
+# ══════════════════════════════════════════════════════════════════════════════
+
+def run_simulation(params: dict) -> List[BoE]:
+    """Core SimPy discrete-event simulation of Meridia's three ports."""
+    results: List[BoE] = []
+    rng = np.random.default_rng(42)
+
+    env = simpy.Environment()
+
+    # Resources
+    officers_sea  = simpy.Resource(env, capacity=params["officers_sea"])
+    officers_air  = simpy.Resource(env, capacity=params["officers_air"])
+    officers_land = simpy.Resource(env, capacity=params["officers_land"])
+
+    PORT_CONFIG = {
+        "Sea":  {"volume": 50, "resource": officers_sea,  "speed_mult": 1.0},
+        "Air":  {"volume": 10, "resource": officers_air,  "speed_mult": 0.5},
+        "Land": {"volume": 25, "resource": officers_land, "speed_mult": 0.75},
+    }
+
+    counter = [0]
+
+    def process_boe(env, port_type, cfg):
+        counter[0] += 1
+        sid = f"BoE-{port_type[0]}{counter[0]:04d}"
+
+        # Determine attributes
+        is_advance = rng.random() < (params["advance_filing_pct"] / 100)
+        is_aeo     = rng.random() < (params["aeo_enrollment_pct"] / 100)
+        is_pga     = rng.random() < 0.35   # 35% PGA involvement
+        aeo_status = rng.choice(["T1","T2","T3"]) if is_aeo else "None"
+        green      = rng.random() < (params["rms_facilitation_pct"] / 100)
+
+        boe = BoE(
+            shipment_id=sid,
+            port_type=port_type,
+            filing_type="Advance" if is_advance else "Normal",
+            pga_involved=is_pga,
+            aeo_status=aeo_status,
+        )
+
+        boe.t_arrival = env.now
+
+        # ── Stage 1: Arrival → Filing ──────────────────────────────────────
+        if is_advance:
+            filing_delay = 0
+        else:
+            filing_delay = rng.gamma(shape=2, scale=12) * cfg["speed_mult"]
+        yield env.timeout(filing_delay)
+        boe.t_filed = env.now
+
+        # ── Stage 2: Assessment ────────────────────────────────────────────
+        if green:
+            assess_delay = 0  # Green channel: skip
+        else:
+            with cfg["resource"].request() as req:
+                yield req
+                if is_aeo:
+                    assess_delay = rng.gamma(shape=2, scale=2) * cfg["speed_mult"]
+                else:
+                    assess_delay = rng.gamma(shape=2, scale=4) * cfg["speed_mult"]
+                # Physical exam
+                if rng.random() < 0.15 and not green:
+                    assess_delay += rng.gamma(shape=3, scale=8) * cfg["speed_mult"]
+                yield env.timeout(assess_delay)
+        boe.t_assessed = env.now
+
+        # ── Stage 3: Payment / PGA ────────────────────────────────────────
+        if is_aeo and params["deferred_duty"]:
+            payment_delay = 0
+        else:
+            base_pay = rng.gamma(shape=2, scale=3)
+            if is_pga and not params["pga_single_window"]:
+                base_pay *= 4.0   # Big amber expansion
+            elif is_pga and params["pga_single_window"]:
+                base_pay *= 1.4
+            payment_delay = base_pay * cfg["speed_mult"]
+        yield env.timeout(payment_delay)
+        boe.t_payment = env.now
+
+        # ── Stage 4: Out-of-Charge ────────────────────────────────────────
+        if green and params["auto_ooc"]:
+            logistics_delay = 0
+            boe.machine_release = True
+        else:
+            logistics_delay = rng.gamma(shape=2, scale=1.5) * cfg["speed_mult"]
+        yield env.timeout(logistics_delay)
+        boe.t_ooc = env.now
+
+        results.append(boe)
+
+    def port_generator(env, port_type, cfg):
+        """Generate shipments for a port with Poisson inter-arrivals."""
+        for _ in range(cfg["volume"]):
+            env.process(process_boe(env, port_type, cfg))
+            interarrival = rng.exponential(scale=1.5)
+            yield env.timeout(interarrival)
+
+    for ptype, cfg in PORT_CONFIG.items():
+        env.process(port_generator(env, ptype, cfg))
+
+    env.run(until=500)
+    return results
+
+
+# ══════════════════════════════════════════════════════════════════════════════
+# PHASER.JS ISOMETRIC GAME VIEW
+# ══════════════════════════════════════════════════════════════════════════════
+
+def build_phaser_scene(results: List[BoE], params: dict) -> str:
+    """Generate the Phaser.js isometric port visualization."""
+
+    art_h    = round(params["avg_art"], 1) if results else 0
+    fac_pct  = round(params["green_pct"], 1) if results else 0
+    aeo_pct  = round(params["aeo_pct"], 1) if results else 0
+    mach_pct = round(params["machine_pct"], 1) if results else 0
+    target48 = round(params["target48_pct"], 1) if results else 0
+    ship_count = len([r for r in results if r.port_type=="Sea"]) if results else 0
+    air_count  = len([r for r in results if r.port_type=="Air"]) if results else 0
+    land_count = len([r for r in results if r.port_type=="Land"]) if results else 0
+
+    # Shipment status data for visualization
+    if results:
+        statuses = []
+        for r in results[:60]:
+            if r.total_hours < 3:   s = "fast"
+            elif r.total_hours < 24: s = "ok"
+            elif r.total_hours < 48: s = "slow"
+            else:                    s = "delayed"
+            statuses.append({"id": r.shipment_id, "port": r.port_type,
+                              "hours": round(r.total_hours, 1), "status": s,
+                              "machine": r.machine_release})
+    else:
+        statuses = []
+
+    statuses_json = json.dumps(statuses)
+
+    return f"""<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  * {{ margin:0; padding:0; box-sizing:border-box; }}
+  body {{
+    background: #0a0e1a;
+    font-family: 'Rajdhani', 'Share Tech Mono', monospace;
+    overflow: hidden;
+    width: 100%;
+    height: 520px;
+  }}
+  @import url('https://fonts.googleapis.com/css2?family=Rajdhani:wght@600;700&family=Share+Tech+Mono&display=swap');
+
+  #game-container {{
+    position: relative;
+    width: 100%;
+    height: 100%;
+  }}
+
+  #hud {{
+    position: absolute;
+    top: 0; left: 0; right: 0;
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    padding: 12px 16px;
+    pointer-events: none;
+    z-index: 10;
+  }}
+
+  .hud-panel {{
+    background: rgba(10,14,26,0.85);
+    border: 1px solid rgba(0,212,255,0.3);
+    border-radius: 6px;
+    padding: 8px 14px;
+    backdrop-filter: blur(4px);
+  }}
+
+  .hud-title {{
+    font-family: 'Rajdhani', sans-serif;
+    font-size: 9px;
+    font-weight: 700;
+    letter-spacing: 0.15em;
+    color: #5a7a9a;
+    text-transform: uppercase;
+    margin-bottom: 2px;
+  }}
+
+  .hud-value {{
+    font-family: 'Share Tech Mono', monospace;
+    font-size: 22px;
+    font-weight: 400;
+    color: #00d4ff;
+    line-height: 1;
+  }}
+
+  .hud-value.good  {{ color: #00ff88; }}
+  .hud-value.warn  {{ color: #f5a623; }}
+  .hud-value.bad   {{ color: #ff4757; }}
+
+  .hud-sub {{
+    font-size: 9px;
+    color: #5a7a9a;
+    margin-top: 2px;
+    font-family: 'Rajdhani', sans-serif;
+    letter-spacing: 0.05em;
+  }}
+
+  .hud-row {{ display: flex; gap: 10px; }}
+
+  #bottom-hud {{
+    position: absolute;
+    bottom: 0; left: 0; right: 0;
+    display: flex;
+    gap: 8px;
+    padding: 10px 16px;
+    z-index: 10;
+    pointer-events: none;
+  }}
+
+  .port-stat {{
+    background: rgba(10,14,26,0.85);
+    border: 1px solid rgba(0,212,255,0.2);
+    border-radius: 6px;
+    padding: 6px 12px;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+  }}
+
+  .port-dot {{ width: 8px; height: 8px; border-radius: 50%; }}
+  .port-dot.sea  {{ background: #00d4ff; box-shadow: 0 0 6px #00d4ff; }}
+  .port-dot.air  {{ background: #f5a623; box-shadow: 0 0 6px #f5a623; }}
+  .port-dot.land {{ background: #00ff88; box-shadow: 0 0 6px #00ff88; }}
+
+  .port-name {{
+    font-size: 10px;
+    font-weight: 700;
+    letter-spacing: 0.1em;
+    color: #c8d8e8;
+    font-family: 'Rajdhani', sans-serif;
+  }}
+
+  .port-count {{
+    font-size: 14px;
+    font-family: 'Share Tech Mono', monospace;
+    color: #00d4ff;
+  }}
+
+  #ticker {{
+    position: absolute;
+    top: 50%; left: 50%;
+    transform: translate(-50%, -50%);
+    pointer-events: none;
+    z-index: 5;
+    text-align: center;
+  }}
+
+  #clock {{
+    font-family: 'Share Tech Mono', monospace;
+    font-size: 13px;
+    color: rgba(0,212,255,0.4);
+    letter-spacing: 0.2em;
+  }}
+
+  canvas {{ display: block; }}
+  #phaser-canvas {{ width: 100% !important; height: 100% !important; }}
+</style>
+</head>
+<body>
+<div id="game-container">
+  <div id="hud">
+    <div class="hud-panel">
+      <div class="hud-title">Average Release Time</div>
+      <div class="hud-value {'good' if art_h < 24 else 'warn' if art_h < 48 else 'bad'}">{art_h}h</div>
+      <div class="hud-sub">NTFAP Target: 48h</div>
+    </div>
+
+    <div class="hud-row">
+      <div class="hud-panel">
+        <div class="hud-title">Green Channel</div>
+        <div class="hud-value {'good' if fac_pct > 60 else 'warn'}">{fac_pct}%</div>
+        <div class="hud-sub">Facilitated</div>
+      </div>
+      <div class="hud-panel">
+        <div class="hud-title">Machine Release</div>
+        <div class="hud-value {'good' if mach_pct > 40 else 'warn'}">{mach_pct}%</div>
+        <div class="hud-sub">Auto-OOC</div>
+      </div>
+      <div class="hud-panel">
+        <div class="hud-title">Target ≤48h</div>
+        <div class="hud-value {'good' if target48 > 80 else 'warn' if target48 > 60 else 'bad'}">{target48}%</div>
+        <div class="hud-sub">Achievement</div>
+      </div>
+    </div>
+
+    <div class="hud-panel">
+      <div class="hud-title">AEO Enrolled</div>
+      <div class="hud-value {'good' if aeo_pct > 50 else 'warn'}">{aeo_pct}%</div>
+      <div class="hud-sub">Trusted Traders</div>
+    </div>
+  </div>
+
+  <div id="bottom-hud">
+    <div class="port-stat">
+      <div class="port-dot sea"></div>
+      <span class="port-name">AZURE PORT</span>
+      <span class="port-count">{ship_count}</span>
+    </div>
+    <div class="port-stat">
+      <div class="port-dot air"></div>
+      <span class="port-name">VORTEX AIR</span>
+      <span class="port-count">{air_count}</span>
+    </div>
+    <div class="port-stat">
+      <div class="port-dot land"></div>
+      <span class="port-name">STONE PASS</span>
+      <span class="port-count">{land_count}</span>
+    </div>
+    <div id="clock" class="port-stat" style="margin-left:auto; border-color: rgba(0,212,255,0.15);">
+      <span id="sim-clock" style="font-family:'Share Tech Mono',monospace; font-size:12px; color:#5a7a9a; letter-spacing:0.15em;">MERIDIA — SIM ACTIVE</span>
+    </div>
+  </div>
+
+  <script src="https://cdn.jsdelivr.net/npm/phaser@3.60.0/dist/phaser.min.js"></script>
+  <script>
+  const STATUSES = {statuses_json};
+  const RUNNING  = {'true' if results else 'false'};
+
+  // ── Colour palette ──────────────────────────────────────────────────────
+  const C = {{
+    fast:    0x00ff88,
+    ok:      0x00d4ff,
+    slow:    0xf5a623,
+    delayed: 0xff4757,
+    sea:     0x00d4ff,
+    air:     0xf5a623,
+    land:    0x00ff88,
+    grid:    0x1a3a5c,
+    dark:    0x0a0e1a,
+    water:   0x0d2340,
+    sand:    0x1a2e40,
+    building:0x152840,
+  }};
+
+  class MeridiaScene extends Phaser.Scene {{
+    constructor() {{ super({{ key: 'MeridiaScene' }}); }}
+
+    preload() {{}}
+
+    create() {{
+      const W = this.scale.width;
+      const H = this.scale.height;
+
+      // ── Sky gradient background ────────────────────────────────────────
+      const bg = this.add.graphics();
+      bg.fillGradientStyle(0x0a0e1a, 0x0a0e1a, 0x0d2340, 0x0d2340, 1);
+      bg.fillRect(0, 0, W, H);
+
+      // ── Stars ─────────────────────────────────────────────────────────
+      const stars = this.add.graphics();
+      stars.fillStyle(0xffffff, 0.6);
+      for (let i = 0; i < 80; i++) {{
+        const x = Phaser.Math.Between(0, W);
+        const y = Phaser.Math.Between(0, H * 0.5);
+        const r = Math.random() < 0.1 ? 1.5 : 0.8;
+        stars.fillCircle(x, y, r);
+      }}
+
+      // ── Isometric grid helper ─────────────────────────────────────────
+      const ISO_W = 48, ISO_H = 24;
+
+      const toIso = (col, row) => {{
+        return {{
+          x: W/2 + (col - row) * ISO_W / 2,
+          y: 140  + (col + row) * ISO_H / 2
+        }};
+      }};
+
+      const drawTile = (gfx, col, row, color, alpha=1, h=0) => {{
+        const p = toIso(col, row);
+        const pts = [
+          p.x,        p.y - h,
+          p.x+ISO_W/2, p.y+ISO_H/2 - h,
+          p.x,        p.y+ISO_H - h,
+          p.x-ISO_W/2, p.y+ISO_H/2 - h,
+        ];
+        gfx.fillStyle(color, alpha);
+        gfx.fillPoints(pts.reduce((a,v,i)=> i%2===0?[...a,{{x:pts[i],y:pts[i+1]}}]:a,[]), true);
+        // Left face (darker)
+        if (h > 0) {{
+          const lpts = [
+            p.x-ISO_W/2, p.y+ISO_H/2 - h,
+            p.x,         p.y+ISO_H   - h,
+            p.x,         p.y+ISO_H,
+            p.x-ISO_W/2, p.y+ISO_H/2,
+          ];
+          gfx.fillStyle(Phaser.Display.Color.ValueToColor(color).darken(30).color, alpha);
+          gfx.fillPoints(lpts.reduce((a,v,i)=> i%2===0?[...a,{{x:lpts[i],y:lpts[i+1]}}]:a,[]), true);
+          // Right face
+          const rpts = [
+            p.x,         p.y+ISO_H   - h,
+            p.x+ISO_W/2, p.y+ISO_H/2 - h,
+            p.x+ISO_W/2, p.y+ISO_H/2,
+            p.x,         p.y+ISO_H,
+          ];
+          gfx.fillStyle(Phaser.Display.Color.ValueToColor(color).darken(15).color, alpha);
+          gfx.fillPoints(rpts.reduce((a,v,i)=> i%2===0?[...a,{{x:rpts[i],y:rpts[i+1]}}]:a,[]), true);
+        }}
+      }};
+
+      const terrain = this.add.graphics();
+
+      // ── Water tiles (left zone — Azure Port) ──────────────────────────
+      for (let r = 0; r < 8; r++) {{
+        for (let c = 0; c < 5; c++) {{
+          drawTile(terrain, c-3, r, C.water, 0.9);
+        }}
+      }}
+
+      // ── Land tiles ────────────────────────────────────────────────────
+      for (let r = 0; r < 8; r++) {{
+        for (let c = 2; c < 12; c++) {{
+          const shade = (c+r) % 2 === 0 ? 0x1a2e40 : 0x162838;
+          drawTile(terrain, c, r, shade, 1);
+        }}
+      }}
+
+      // ── Buildings (customs offices) ───────────────────────────────────
+      const buildings = this.add.graphics();
+
+      const drawBuilding = (col, row, w, d, h, color) => {{
+        for (let dc=0; dc<w; dc++) {{
+          for (let dr=0; dr<d; dr++) {{
+            drawTile(buildings, col+dc, row+dr, color, 1, h);
+          }}
+        }}
+      }};
+
+      // Azure Port customs hall
+      drawBuilding(3, 1, 2, 2, 18, 0x1a4a6c);
+      // Vortex Air terminal
+      drawBuilding(7, 1, 3, 2, 14, 0x2a3a5c);
+      // Stone Pass checkpoint
+      drawBuilding(3, 5, 2, 2, 12, 0x1a4a3c);
+
+      // ── Port labels ────────────────────────────────────────────────────
+      const labelStyle = {{
+        fontFamily: 'Rajdhani, sans-serif',
+        fontSize:   '10px',
+        fontStyle:  'bold',
+        color:      '#5a9abf',
+        letterSpacing: 2,
+      }};
+
+      const p1 = toIso(3.5, 0);
+      this.add.text(p1.x, p1.y - 30, 'AZURE PORT', {{ ...labelStyle, color: '#00d4ff' }}).setOrigin(0.5);
+
+      const p2 = toIso(8.5, 0);
+      this.add.text(p2.x, p2.y - 24, 'VORTEX AIR', {{ ...labelStyle, color: '#f5a623' }}).setOrigin(0.5);
+
+      const p3 = toIso(4, 5.5);
+      this.add.text(p3.x, p3.y - 22, 'STONE PASS', {{ ...labelStyle, color: '#00ff88' }}).setOrigin(0.5);
+
+      // ── Cargo dots (animated, colour by status) ────────────────────────
+      if (RUNNING && STATUSES.length > 0) {{
+        const portOrigins = {{
+          Sea:  {{ col: 1.5, row: 3 }},
+          Air:  {{ col: 8.5, row: 3 }},
+          Land: {{ col: 4,   row: 6 }},
+        }};
+
+        STATUSES.forEach((s, i) => {{
+          const orig = portOrigins[s.port];
+          const col = orig.col + (Math.random()-0.5)*2.5;
+          const row = orig.row + (Math.random()-0.5)*2.0;
+          const pos  = toIso(col, row);
+
+          const color = C[s.status];
+          const gfx   = this.add.graphics();
+
+          gfx.fillStyle(color, 0.9);
+          gfx.fillCircle(pos.x, pos.y, 5);
+          gfx.lineStyle(1, color, 0.4);
+          gfx.strokeCircle(pos.x, pos.y, 9);
+
+          if (s.machine) {{
+            gfx.lineStyle(1, 0xffffff, 0.6);
+            gfx.strokeCircle(pos.x, pos.y, 13);
+          }}
+
+          // Pulse animation
+          this.tweens.add({{
+            targets: gfx,
+            alpha:   {{ from: 0.5, to: 1 }},
+            duration: 800 + i * 40,
+            yoyo: true,
+            repeat: -1,
+            ease: 'Sine.easeInOut',
+          }});
+
+          // Float vertically
+          this.tweens.add({{
+            targets: gfx,
+            y: gfx.y - 4,
+            duration: 1200 + i * 60,
+            yoyo: true,
+            repeat: -1,
+            ease: 'Sine.easeInOut',
+          }});
+
+          // Tooltip on hover
+          const hitZone = this.add.circle(pos.x, pos.y, 14, 0xffffff, 0)
+                              .setInteractive({{ useHandCursor: true }});
+
+          const tooltip = this.add.text(pos.x + 16, pos.y - 16,
+            `${{s.id}}\\n${{s.port}} | ${{s.hours}}h | ${{s.status.toUpperCase()}}`,
+            {{
+              fontFamily: 'Share Tech Mono, monospace',
+              fontSize:   '9px',
+              color:      '#c8d8e8',
+              backgroundColor: '#0a0e1aee',
+              padding:    {{ x:6, y:4 }},
+              lineSpacing: 3,
+            }}
+          ).setVisible(false).setDepth(100);
+
+          hitZone.on('pointerover', () => tooltip.setVisible(true));
+          hitZone.on('pointerout',  () => tooltip.setVisible(false));
+        }});
+      }} else {{
+        // Idle state — gentle floating dots
+        for (let i=0; i<12; i++) {{
+          const col = Math.random()*10 - 1;
+          const row = Math.random()*7;
+          const pos = toIso(col, row);
+          const gfx = this.add.graphics();
+          gfx.fillStyle(0x1a3a5c, 0.7);
+          gfx.fillCircle(pos.x, pos.y, 4);
+          this.tweens.add({{
+            targets: gfx, alpha: {{from:0.2, to:0.7}},
+            duration: 1500+i*200, yoyo:true, repeat:-1,
+          }});
+        }}
+      }}
+
+      // ── Ship in water ──────────────────────────────────────────────────
+      const shipGfx = this.add.graphics();
+      const sp = toIso(-1, 3);
+      shipGfx.fillStyle(0x2a5a8c, 1);
+      shipGfx.fillRect(sp.x-20, sp.y-6, 40, 12);
+      shipGfx.fillStyle(0x3a7abf, 1);
+      shipGfx.fillRect(sp.x-8, sp.y-14, 16, 8);
+
+      this.tweens.add({{
+        targets: shipGfx, y: '-=3',
+        duration: 2000, yoyo: true, repeat: -1, ease: 'Sine.easeInOut',
+      }});
+
+      // ── Legend ─────────────────────────────────────────────────────────
+      const lg = this.add.graphics();
+      const lx = W - 130, ly = H - 110;
+      [[C.fast,'<3h FAST'],[C.ok,'<24h OK'],[C.slow,'<48h SLOW'],[C.delayed,'>48h LATE']].forEach(([col,lbl],i) => {{
+        lg.fillStyle(col, 1);
+        lg.fillCircle(lx, ly + i*20, 5);
+        this.add.text(lx+12, ly+i*20-7, lbl, {{
+          fontFamily:'Rajdhani,sans-serif', fontSize:'10px',
+          fontStyle:'bold', color:'#5a7a9a', letterSpacing:1,
+        }});
+      }});
+    }}
+
+    update() {{
+      // Update simulated clock
+      const el = document.getElementById('sim-clock');
+      if (el) {{
+        const now = new Date();
+        el.textContent = now.toLocaleTimeString('en-GB') + ' | MERIDIA FRONTIER';
+      }}
+    }}
+  }}
+
+  new Phaser.Game({{
+    type:       Phaser.AUTO,
+    parent:     'game-container',
+    width:      '100%',
+    height:     520,
+    transparent: true,
+    backgroundColor: '#0a0e1a',
+    scale: {{
+      mode:       Phaser.Scale.FIT,
+      autoCenter: Phaser.Scale.CENTER_BOTH,
+    }},
+    scene: [MeridiaScene],
+    canvas: document.createElement('canvas'),
+  }});
+  </script>
+</div>
+</body>
+</html>"""
+
+
+# ══════════════════════════════════════════════════════════════════════════════
+# TRS STACKED BAR CHART
+# ══════════════════════════════════════════════════════════════════════════════
+
+def build_trs_chart(results: List[BoE]) -> go.Figure:
+    ports = ["Sea (Azure Port)", "Air (Vortex)", "Land (Stone Pass)", "ALL PORTS"]
+    port_map = {"Sea": "Sea (Azure Port)", "Air": "Air (Vortex)", "Land": "Land (Stone Pass)"}
+
+    data = {p: {"filing": [], "assessment": [], "payment": [], "logistics": []} for p in ports}
+
+    for r in results:
+        pk = port_map[r.port_type]
+        data[pk]["filing"].append(r.seg_filing)
+        data[pk]["assessment"].append(r.seg_assessment)
+        data[pk]["payment"].append(r.seg_payment)
+        data[pk]["logistics"].append(r.seg_logistics)
+        data["ALL PORTS"]["filing"].append(r.seg_filing)
+        data["ALL PORTS"]["assessment"].append(r.seg_assessment)
+        data["ALL PORTS"]["payment"].append(r.seg_payment)
+        data["ALL PORTS"]["logistics"].append(r.seg_logistics)
+
+    avgs = {p: {seg: np.mean(v) if v else 0 for seg, v in segs.items()} for p, segs in data.items()}
+
+    segs = [
+        ("filing",     "Pre-arrival / Filing",    "#1a4a8c"),
+        ("assessment", "Customs Assessment",       "#2a7abf"),
+        ("payment",    "Trade Action / PGA / Duty","#f5a623"),
+        ("logistics",  "Post-clearance Logistics", "#3a5a7a"),
+    ]
+
+    fig = go.Figure()
+    for seg_key, seg_name, color in segs:
+        fig.add_trace(go.Bar(
+            name=seg_name,
+            x=ports,
+            y=[avgs[p][seg_key] for p in ports],
+            marker_color=color,
+            text=[f"{avgs[p][seg_key]:.1f}h" for p in ports],
+            textposition="inside",
+            textfont=dict(family="Share Tech Mono, monospace", size=10, color="white"),
+        ))
+
+    # 48h target line
+    fig.add_hline(y=48, line_dash="dash", line_color="#ff4757", line_width=1.5,
+                  annotation_text="48h NTFAP Target", annotation_font_color="#ff4757",
+                  annotation_font_size=10)
+    fig.add_hline(y=24, line_dash="dot", line_color="#f5a623", line_width=1,
+                  annotation_text="24h Air Target", annotation_font_color="#f5a623",
+                  annotation_font_size=10)
+
+    fig.update_layout(
+        barmode="stack",
+        plot_bgcolor="#0d1b2a",
+        paper_bgcolor="#0a0e1a",
+        font=dict(family="Rajdhani, sans-serif", color="#c8d8e8"),
+        title=dict(text="MERIDIA TRS — RELEASE TIME BREAKDOWN BY PORT",
+                   font=dict(size=14, color="#00d4ff", family="Rajdhani"),
+                   x=0.5),
+        xaxis=dict(gridcolor="#1a3a5c", linecolor="#1a3a5c"),
+        yaxis=dict(gridcolor="#1a3a5c", linecolor="#1a3a5c",
+                   title="Hours", titlefont=dict(color="#5a7a9a")),
+        legend=dict(orientation="h", y=-0.2, font=dict(size=10)),
+        margin=dict(t=50, b=80, l=50, r=20),
+        height=380,
+    )
+    return fig
+
+
+# ══════════════════════════════════════════════════════════════════════════════
+# STREAMLIT UI
+# ══════════════════════════════════════════════════════════════════════════════
+
+def main():
+    # ── Header ─────────────────────────────────────────────────────────────
+    st.markdown("""
+    <div style='text-align:center; padding: 1rem 0 0.5rem;'>
+      <h1 style='font-family:Rajdhani,sans-serif; font-size:2.2rem; letter-spacing:0.15em;
+                 color:#00d4ff; text-shadow: 0 0 20px rgba(0,212,255,0.4); margin:0;'>
+        ◈ THE MERIDIA FRONTIER
+      </h1>
+      <p style='color:#5a7a9a; font-size:0.8rem; letter-spacing:0.2em; margin:4px 0 0;
+               font-family:Rajdhani,sans-serif;'>
+        TIME RELEASE STUDY — GAMIFIED CUSTOMS SIMULATOR
+      </p>
+    </div>
+    <hr style='border:none; border-top: 1px solid #1a3a5c; margin: 0.75rem 0;'>
+    """, unsafe_allow_html=True)
+
+    # ── Sidebar Controls ────────────────────────────────────────────────────
+    with st.sidebar:
+        st.markdown("### ⚙ POLICY LEVERS")
+        st.markdown("<p style='color:#5a7a9a;font-size:0.72rem;letter-spacing:0.1em;'>ADJUST PARAMETERS & RUN SIM</p>", unsafe_allow_html=True)
+
+        st.markdown("**Filing & Risk**")
+        advance_pct  = st.slider("Advance Filing %",     0, 100, 40, key="adv")
+        rms_pct      = st.slider("RMS Facilitation %",   0, 100, 50, key="rms")
+        aeo_pct      = st.slider("AEO Enrollment %",     0, 100, 30, key="aeo")
+
+        st.markdown("**System Enablers**")
+        pga_sw       = st.toggle("PGA Single Window",    value=False, key="pga")
+        deferred     = st.toggle("Deferred Duty (AEO)",  value=False, key="def")
+        auto_ooc     = st.toggle("Auto Out-of-Charge",   value=False, key="ooc")
+
+        st.markdown("**Officer Capacity**")
+        officers_sea  = st.slider("Sea Officers",   1, 20, 8, key="osea")
+        officers_air  = st.slider("Air Officers",   1, 10, 4, key="oair")
+        officers_land = st.slider("Land Officers",  1, 15, 6, key="oland")
+
+        st.markdown("---")
+        run_btn = st.button("▶  RUN SIMULATION", use_container_width=True)
+        reset_btn = st.button("↺  RESET",         use_container_width=True)
+
+    # ── Session state ────────────────────────────────────────────────────────
+    if "results" not in st.session_state:
+        st.session_state.results = []
+    if "sim_params" not in st.session_state:
+        st.session_state.sim_params = {}
+    if reset_btn:
+        st.session_state.results = []
+        st.session_state.sim_params = {}
+
+    if run_btn:
+        params = dict(
+            advance_filing_pct=advance_pct,
+            rms_facilitation_pct=rms_pct,
+            aeo_enrollment_pct=aeo_pct,
+            pga_single_window=pga_sw,
+            deferred_duty=deferred,
+            auto_ooc=auto_ooc,
+            officers_sea=officers_sea,
+            officers_air=officers_air,
+            officers_land=officers_land,
+        )
+        with st.spinner("Simulating Meridia port activity..."):
+            results = run_simulation(params)
+
+        # Compute summary stats
+        arts = [r.total_hours for r in results]
+        green_results = [r for r in results if r.seg_assessment == 0 and r.seg_filing == 0]
+        aeo_results   = [r for r in results if r.aeo_status != "None"]
+        machine_results = [r for r in results if r.machine_release]
+
+        params["avg_art"]      = np.mean(arts) if arts else 0
+        params["green_pct"]    = len(green_results) / len(results) * 100 if results else 0
+        params["aeo_pct"]      = len(aeo_results)   / len(results) * 100 if results else 0
+        params["machine_pct"]  = len(machine_results)/ len(results) * 100 if results else 0
+        params["target48_pct"] = len([a for a in arts if a <= 48]) / len(arts) * 100 if arts else 0
+
+        st.session_state.results    = results
+        st.session_state.sim_params = params
+
+    results    = st.session_state.results
+    sim_params = st.session_state.sim_params
+
+    # ��─ Main content tabs ───────────────────────────────────────────────────
+    tab1, tab2, tab3 = st.tabs(["🗺  PORT VIEW", "📊  TRS REPORT", "📋  AUDIT LEDGER"])
+
+    with tab1:
+        # Phaser.js game
+        html_src = build_phaser_scene(results, sim_params)
+        st.components.v1.html(html_src, height=530, scrolling=False)
+
+        if not results:
+            st.info("Configure policy levers in the sidebar and click **RUN SIMULATION** to activate the port.")
+        else:
+            st.markdown("---")
+            col1, col2, col3, col4 = st.columns(4)
+            col1.metric("Avg Release Time",  f"{sim_params['avg_art']:.1f}h",
+                        f"{48 - sim_params['avg_art']:.1f}h vs 48h target")
+            col2.metric("Green Channel",     f"{sim_params['green_pct']:.0f}%",  "Facilitated")
+            col3.metric("Machine Release",   f"{sim_params['machine_pct']:.0f}%","Auto-OOC")
+            col4.metric("Target ≤48h",       f"{sim_params['target48_pct']:.0f}%","Achieved")
+
+    with tab2:
+        if not results:
+            st.info("Run the simulation first to generate the TRS report.")
+        else:
+            fig = build_trs_chart(results)
+            st.plotly_chart(fig, use_container_width=True)
+
+            # Insights
+            art = sim_params["avg_art"]
+            st.markdown("### 🔍 POLICY INSIGHTS")
+            col_a, col_b = st.columns(2)
+            with col_a:
+                if art < 3:
+                    st.success("🏆 **Jaigaon LCS Efficiency Achieved!** ART < 3h — world-class performance.")
+                elif art < 24:
+                    st.success(f"✅ ART {art:.1f}h — Air terminal target achieved.")
+                elif art < 48:
+                    st.warning(f"⚠ ART {art:.1f}h — Below 48h target but can improve.")
+                else:
+                    st.error(f"🚨 ART {art:.1f}h — Exceeds NTFAP 48h target. Enable Advance Filing + Facilitation.")
+
+            with col_b:
+                if sim_params.get("aeo_pct", 0) == 0:
+                    st.warning("PGA without Single Window detected" if not pga_sw else "")
+                pga_on  = advance_pct > 60 and rms_pct > 60
+                if pga_on:
+                    st.success("✅ Advance Filing + Facilitation combo active — optimal path.")
+                else:
+                    st.info("💡 Tip: Set Advance Filing + RMS Facilitation both above 60% to reach Jaigaon-level ART.")
+
+    with tab3:
+        if not results:
+            st.info("Run the simulation first to populate the audit ledger.")
+        else:
+            df = pd.DataFrame([{
+                "Shipment_ID":    r.shipment_id,
+                "Port_Type":      r.port_type,
+                "Filing_Type":    r.filing_type,
+                "PGA_Involved":   r.pga_involved,
+                "AEO_Status":     r.aeo_status,
+                "Machine_Release":r.machine_release,
+                "Filing_h":       round(r.seg_filing, 2),
+                "Assessment_h":   round(r.seg_assessment, 2),
+                "Payment_h":      round(r.seg_payment, 2),
+                "Logistics_h":    round(r.seg_logistics, 2),
+                "Total_Hours":    round(r.total_hours, 2),
+            } for r in results])
+
+            st.dataframe(df, use_container_width=True, height=400)
+
+            csv = df.to_csv(index=False).encode("utf-8")
+            st.download_button(
+                "⬇  Download Meridia_TRS_Ledger.csv",
+                data=csv,
+                file_name="Meridia_TRS_Ledger.csv",
+                mime="text/csv",
+                use_container_width=True,
+            )
+
+
+if __name__ == "__main__":
+    main()

requirements.txt

@@ -1,3 +1,5 @@
-altair
-pandas
-streamlit
+streamlit>=1.32.0
+simpy>=4.1.1
+numpy>=1.26.0
+pandas>=2.2.0
+plotly>=5.20.0