Zone Desk · Architecture
Process spine
Architecture · click node to explain
Agent & node interactions
How planes talk — live edge status from desk probes
Live probes
System guides
L0 · Boundary
v0.4.1Advisory supply/demand scalping desk — multi-feed chart, conf≥70 setup log, Agent lab, Grok 4.5 learn.
Chart: full history · 1m default · adaptive live poll · multi-TF S/R.
Nav: Chart · Trades · Agent · Learn · Systems · Zones · Exness · Settings
L1 · People
Who uses the desk and who runs the infra.
Sean is the primary gated desk user (allowlist email).
Email badge in top bar · login page when not bypassed
L1 · Edge
Every request passes a gate before desk pages load.
Next.js middleware runs first on almost every path.
/login · redirects · allowlist errors
L1 · Presentation
1m · 5sCockpit: market, candles, layers, and the entry/exit plan.
Command bar: symbol price · TF chips · Tick / Reload · Full screen (F).
Sticky command bar · slim tool row · chart · plan panel
L1 · Edge / BFF
Server step that glues market data to the model engine.
Route: GET /api/chart?symbol=&interval= (force-dynamic, no-store).
Network tab JSON · Refresh · live/delayed/stale badge
L1 · Data in
Live multi-source prices so zones sit on real candles.
Priority: Exness MT5/MetaApi (if configured) → Binance USDT → Yahoo.
Feed pills · Chart ← provider · data status badge
L1 · Data in
Optional real Exness prices via MT5 bridge or MetaApi.
No free public Exness REST — needs EXNESS_BRIDGE_URL or MetaApi token.
/exness · Exness pill off/live · feed.ok in debug
L1 · Domain brain
Rule-based detection of zones, bias, score, and trade plan.
Computes ATR, swing highs/lows, and window bias.
Zone bands · Fib lines · plan numbers · thesis bullets
L2 · Model concept
Price bands where buyers or sellers previously showed force.
Demand: long lower wick + push up → green band.
Green/red chart bands · Zones page cards · Active zone panel
L2 · Decision output
E/S/TPE / S / TP prices — same numbers on chart and Trades log.
Entry at active zone edge (no chase if price already blasted through).
Plan banner · gold ENTRY · red SL · green TP · side panel table
L1 · Presentation
zoom-safeLightweight Charts: candles, zones, plan lines — zoom preserved live.
Full OHLCV history · default viewport recent bars (scroll for history).
Center canvas under tool row
L1 · Presentation
Manual trendlines, rays, horizontals, fibs, boxes, notes.
Toolbar tools + favourite tools stored in localStorage.
Drawing toolbar under chart · favourites · undo/clear
L1 · Presentation
Words + scores explaining the same plan as the chart lines.
Shows bias, ATR, range position, confidence bar.
Right column on /chart
L1 · Domain brain
v1.5.4Walk-forward S/R strategy — optimizes expectancy_r_net after costs.
Agent v1.5.4: lab fill + volume profile for 1000-trade WR; high_wr selective.
/agent · run · WR% · exp_net · equity · Learn
L1 · Presentation
scan · ≥70Setup book ≥70 · 30m windows · Scan refresh · taken WR.
Scan & refresh pulls liquid markets on 5m (no chart required).
/setups · Scan & refresh · window countdown · WA status
L1 · Edge / BFF
List / scan / save setups · windows · policy.
GET /api/trades?scan=1 — multi-symbol refresh
Network · /setups
L1 · Edge / BFF
Grok 4.5 / rules model updates + budget gate.
GET /api/agent/learn — model, budget, continuous
/learn · Agent Learn
L1 · Ops process
Grok 4.5Grok 4.5 proposes model params within 10% SuperGrok Heavy.
Fresh backtest + desk outcomes → Grok JSON → model_overrides.
/learn · history · budget strip · data/grok_learn_usage.json
L1 · Ops process
WA · 30mHQ setups (conf≥70) pushed when the 30m window closes.
In-desk: processClosedWindows on trades refresh.
WA status on /setups · Systems WA probe
L1 · Platform
Auth + Postgres for users, settings, saved zones/setups.
Supabase Auth issues sessions for allowlisted emails.
Login form · settings defaults · schema.sql
L1 · Ops process
Adaptive live heartbeat — 5s on 1m, slower on higher TFs.
Sense: pull candles from best available provider (Exness→Binance→Yahoo).
Updated badge · live 5s · 1m chip · Refresh button
Boundary · Separation
This desk is chart S/D — not Zimbabwe logistics supply/demand.
AfriLoop mining model = cities, corridors, stockouts, desk RFQ.
docs/BUILD_SCOPE_INVENTORY.md · store SUPPLY_DEMAND_ZONE_MODEL.md