Web 指揮中心

台指期量化交易平台

Phase 0-6 雲原生路線圖的紙上優先控制介面。策略訊號、風險檢查、OMS 狀態與券商閘道邊界維持解耦。

TRADING_MODE=paper實盤關閉券商模式: paper

後端健康狀態

安全備援模式

fetch failed

offline-safe

安全模式

僅限紙上交易

Fallback paper-safe status. Backend is unavailable.

ENABLE_LIVE_TRADING=false

風控預設

TX 等值曝險上限

在任何未來 OMS 工作流之前，先清楚呈現每日虧損上限與 stale quote 限制。

MAX_TX_EQUIVALENT_EXPOSURE=0.25

產品定位

台指期資料分析與 Paper Trading 研究平台

這個 Web App 把官網主張轉成可操作研究流程：使用者可以檢視 TX / MTX / TMF 模擬資料、驗證策略假設、模擬 Paper Only 訂單、查看 OMS 事件，並複製 evidence；全程不連券商、不使用真實資金。

Market Data Lab

先理解 TX / MTX / TMF 資料，再討論交易決策

功能
Deterministic quote snapshot、bid / ask / last、quote age、spread 與合約曝險脈絡。
使用者利益
使用者可以理解市場資料如何進入平台，並在測試策略前比較合約規格與曝險大小。

Strategy Research

驗證 signal 邏輯，但不建立訂單

功能
Mock strategy 只輸出標準化 StrategySignal，且 signals_only=true。
使用者利益
使用者可以把研究判斷與執行流程分開，先看策略想表達什麼，再進入紙上模擬。

Paper Trading Simulator

在無券商風險下體驗訂單流程

功能
PaperOrderIntent、paper risk checks、模擬 OMS lifecycle 與 browser-local paper fill outcomes。
使用者利益
使用者可以練習端到端流程，理解模擬訂單為何通過、拒絕、部分成交或成交。

Portfolio Review

查看模擬持倉與 PnL 影響

功能
Paper-only position、average price、unrealized PnL、paper equity 與可重置 session state。
使用者利益
使用者可以把每個模擬動作連到部位變化，同時清楚知道這只是 demo 指標，不是績效主張。

Evidence Center

讓 Demo 結果可回顧與回報

功能
複製 demo summary、evidence JSON、session id、deterministic seed 與 localStorage key。
使用者利益
使用者與 reviewer 可以重現 browser-local 情境、回傳問題，並稽核 demo 當下呈現的內容。

研究流程

從資料分析到紙上決策檢視

  1. 市場資料預覽
  2. StrategySignal 產生
  3. Paper Only 訂單模擬
  4. OMS 時間線檢視
  5. 模擬持倉 / PnL 檢視
  6. Evidence JSON 交付

安全邊界

本平台刻意不做的事

  • 不連真實券商
  • 不送真實委託
  • 不收集憑證
  • 不構成投資建議
  • 不做績效主張
  • Production Trading Platform 仍為 NOT READY

流程標準化

Demo 如何對應量化交易標準作業流程

這個導覽層把 browser demo 連到 docs/quant-workflow-standardization.md 的方法論，說明資料、策略、回測、換月、Paper Trading、Risk Engine、OMS 與 audit evidence 在正式交易路徑出現前如何串接。

1

資料

Data standardization

TX / MTX / TMF quote snapshot 先使用共同曝險語言，再進入策略邏輯。

Demo 操作
Generate market tick
標準化控制
市場資料應包含 symbol、bid、ask、last、quote age、session context 與 TX-equivalent exposure 意義。
2

訊號

StrategySignal standardization

策略只輸出 signal；所有類訂單流程都由平台負責。

Demo 操作
Run mock strategy
標準化控制
StrategySignal 維持 signals_only=true，不直接呼叫券商、Risk Engine、OMS 或 Broker Gateway。
3

回測

Backtest reproducibility

研究輸出應綁定資料版本、程式版本、參數、成本與 review notes。

Demo 操作
檢視 session id、seed 與 evidence JSON
標準化控制
Backtest 與 demo artifact 只能作為可重現 metadata，不得被呈現為績效主張。
4

換月

Rollover data separation

研究可使用 adjusted continuous data，但紙上與未來執行 mapping 必須參照真實合約。

Demo 操作
查看 TX / MTX / TMF 契約脈絡
標準化控制
Rollover metadata 必須分離 research-only continuous futures 與可執行合約代碼及價格。
5

紙上意圖

PaperOrderIntent flow

只有平台能把 StrategySignal 轉成 Paper Only order intent。

Demo 操作
Simulate Paper Only order
標準化控制
PaperOrderIntent 由平台擁有，不核准實盤、不收集憑證，也不建立真實委託。
6

風控

Risk Engine checks

紙上風控檢查會解釋模擬流程為何可以繼續或必須拒絕。

Demo 操作
查看 risk approval result
標準化控制
Risk checks 涵蓋 paper mode、實盤關閉、stale quote、exposure、size、duplicate key 與 safety flags。
7

OMS

OMS lifecycle

模擬 OMS timeline 讓 lifecycle transitions 可見，而不是藏在策略程式碼中。

Demo 操作
Review OMS timeline
標準化控制
OMS 負責 order state、idempotency、terminal status 與未來 reconciliation 邊界。
8

稽核

Audit evidence

Reviewer handoff 需要小型 evidence artifact，說明發生了什麼，以及哪些仍是模擬。

Demo 操作
複製 demo summary 或 evidence JSON
標準化控制
Audit evidence 必須保留 safety flags；除非未來有受審查資料層，否則維持本地 / browser-only。

安全邊界

僅作為學習導覽，不是執行路徑

此面板是只讀產品教育內容；不讀取後端、不上傳 evidence、不寫資料庫、不呼叫券商、不建立訂單、不收集憑證，也不構成投資建議。

  • Paper Only
  • Browser-only / mock demo where applicable
  • 不連券商
  • 不建立真實委託
  • 不收集憑證
  • 不構成投資建議
  • Production Trading Platform: NOT READY

Demo Tour

客戶測試導覽流程

只讀導覽用於理解版本層級、安全預設、紙上 OMS 紀錄、研究 Packet 與契約規格。此導覽只改變前端本地 UI 狀態。

只讀導覽
步驟 1/7建議分頁: 版本

確認版本層級

先查看 release baseline，確認客戶理解目前版本定位，再進入功能展示。

應確認內容
Marketing Website 是對外展示候選，Web Command Center 是內部 demo 候選，Paper Research Preview 是內部技術預覽，Production Trading Platform = NOT READY。
安全邊界
此步驟確認平台僅供評估，不會被定位為正式交易上線版本。

禁止操作

此版本不是正式交易產品

  • 不支援實盤交易
  • 不支援券商登入
  • 不支援真實委託
  • 不支援憑證上傳
  • 不支援客戶帳戶開通
  • 不提供交易建議

互動層

只讀 Command Center 工具

系統預設先開啟 Paper OMS 分頁，讓客戶立即進入 Browser-only Mock Demo stepper。仍可安全重新整理狀態、切換區段、檢視本地樣本、選取紙上稽核紀錄與複製 ID；這些控制項不送出真實委託、不寫 production database，也不連接券商。

只讀

後端無法連線

安全備援已啟用

即使後端無法連線，production 前端仍會顯示已檢查的紙上安全資料。本地 demo 可啟動後端，或使用下方指令建立一筆本地紙上稽核樣本。

  • health: fetch failed
  • roadmap: fetch failed
  • contracts: fetch failed
  • paper status: fetch failed

本地 demo seed

make seed-paper-execution-demo

Browser-only Mock Runtime

瀏覽器內互動 Demo

完全在瀏覽器內執行 deterministic TX / MTX / TMF 行情，並顯示市場狀態、價差、流動性、quote age 與滑價估計，再串接 signal-only 策略模擬、PaperOrderIntent 風控檢查、OMS 時間線、紙上券商成交模擬與模擬投組指標。它不需要本地後端、不連券商、不寫資料庫、不使用真實資金，也不啟用實盤交易。

Paper OnlyBrowser-only不需要後端無券商無真實資金實盤關閉不構成投資建議

互動導覽

完整 Browser-only 操作流程

依序從行情 tick、策略 signal、Paper Only 訂單、模擬 OMS 到 paper-only 指標完成體驗。每一步都只留在此瀏覽器內。

Session: browser-only-mock-demo-sessionSeed: taifex-browser-only-seed-v1
步驟 1/6Paper OnlyBrowser-only

產生行情 tick

在此瀏覽器內建立下一筆 deterministic TX / MTX / TMF quote snapshot。

預期結果

Bid、ask、last、quote age、quote size 與 liquidity score 會更新，且不下載外部行情。

結果說明

Tick 也會顯示 deterministic 市場狀態，例如 normal、trending、volatile、illiquid 或 stale_quote，讓價差與流動性可在不接真實行情下變化。

安全邊界

不使用後端、不連券商、不接外部行情、不寫資料庫，也不進入實盤路徑。

下一步

用選定契約執行僅輸出 signal 的模擬策略。

Visualization Layer

市場路徑、微結構、訂單結果與紙上 PnL

把 browser-only demo 轉成可視化證據：deterministic price path、bid / ask band、市場狀態條、價差、流動性、quote age、滑價估計、紙上訂單結果與模擬 PnL。

價格路徑

Deterministic TX / MTX / TMF market path

目前 tick: 0
0

最新可視化 snapshot: TMF 19998 · 市場狀態: normal

市場微結構

價差 / 流動性 / quote age / 滑價

價差0.2
流動性分數0.82
Quote age1
滑價估計0.01

這些長條都是 deterministic mock data，不是外部行情，也不代表真實流動性。

訂單結果

紙上成交 / 部分成交 / 拒單視覺化

模擬 Paper Only 訂單後，即可視覺化成交數量、剩餘數量與成交原因。

紙上投組

持倉與模擬 PnL snapshot

持倉
0
未實現 PnL
0
紙上權益
1000000
Browser-only不下載外部行情無券商無真實委託

市場真實度視覺化

市場狀態、價差、流動性、滑價與成交原因

說明 deterministic browser-only 市場條件如何影響 Paper Only workflow。此 panel 會呈現 quote quality、流動性、stale quote、模擬成交 / 部分成交 / 拒單結果，以及 paper-only PnL context，且不下載外部行情。

市場狀態時間線

Deterministic market state sequence

normal
0normal
Normal

價差較窄、quote size 較健康、quote age 較低。

Trending

Deterministic 價格方向較明確，流動性中等。

Volatile

價差較寬、價格變動較大、流動性分數較低。

Illiquid

Bid / ask size 有限，可能造成部分成交或拒單。

Stale quote

Quote snapshot 較舊，會被 paper risk guardrails 拒絕。

Quote Quality

價差、流動性、quote age 與滑價量表

價差0.2
流動性分數0.82
Quote age1
滑價估計0.01
Bid size
7
Ask size
9
波動路徑
4

成交說明

為何模擬紙上訂單成交、部分成交或被拒絕

模擬 Paper Only 訂單後，即可看到成交結果與市場條件說明。

成交原因

尚未模擬訂單。請先產生行情、執行模擬策略，再模擬 Paper Only 訂單。

Paper PnL Context

持倉與 mark-to-market context

持倉
0
平均價格
N/A
Mark price
19998
未實現 PnL
0

PnL 數值是 browser-only workflow 的模擬輸出，不構成投資建議，也不是績效主張。

Browser-onlyPaper Only不下載外部行情無券商無真實委託不收集憑證不構成投資建議

Browser-only mock demo 已準備好，不需要後端。

Session

瀏覽器本地 demo state

Session ID
browser-only-mock-demo-session
Deterministic mock seed
taifex-browser-only-seed-v1
localStorage key
taifex-browser-only-mock-demo-session-v1

行情資料

瀏覽器 deterministic 價格路徑

市場狀態：normal、trending、volatile、illiquid、stale_quote。

契約市場狀態BidAsk價差Last變動Quote age流動性分數
TXnormal1999920000119999.5010.78
MTXnormal19998.2519998.750.519998.5010.82
TMFnormal19997.919998.10.219998010.82

目前 snapshot: TMF 19998 · 市場狀態: normal · 價差: 0.2 · 流動性分數: 0.82 · Quote age: 1

策略

僅輸出 signal 的策略結果

先產生行情並執行模擬策略，即可看到 StrategySignal。

紙上訂單

Browser-only 紙上 workflow 結果

執行策略後，再模擬紙上訂單，即可看到 Risk / OMS / paper fill 結果。

市場真實度

價差、流動性、quote age 與滑價模型

市場狀態
normal
價差
0.2
流動性分數
0.82
波動路徑
4
滑價估計
0.01
成交原因
執行策略後，再模擬紙上訂單，即可看到 Risk / OMS / paper fill 結果。

模擬指標

Paper-only 投組與 PnL

持倉
0
平均價格
N/A
未實現 PnL
0
紙上權益
1000000
績效主張
false

Demo 時間線

瀏覽器 session events

  1. SESSION_STARTBrowser-only mock demo initialized. No backend, broker, DB, or live trading path was used.

安全旗標

Browser-only safety flags

paper_only=truebrowser_only=truemock_backend=truedeterministic_data=truelive_trading_enabled=falsebroker_api_called=falseexternal_market_data_downloaded=falsereal_order_created=falsecredentials_collected=falseproduction_trading_ready=falseinvestment_advice=falsedatabase_written=falseperformance_claim=false

此 runtime 只使用瀏覽器本地狀態與 localStorage。它不上傳資料、不寫資料庫、不呼叫券商、不建立真實委託，實盤維持關閉。

回饋收集

互動 Demo 回饋

完成 browser-only 操作流程後，可複製結構化回饋包供人工審查。此 panel 不提交、不上傳、不寫資料庫，也不送往券商。

Browser-only不提交後端不寫 DB不收 email 或電話不收券商帳戶不收集憑證不收真實交易紀錄不構成投資建議實盤關閉
請先完成產生行情、執行模擬策略、模擬 Paper Only 訂單，即可啟用回饋包。

建議回饋問題

  • 完成到哪一步？
  • 哪個操作不清楚？
  • 哪個資訊最有幫助？
  • 哪個畫面最難理解？
  • 想新增什麼功能？
  • 是否理解這是 Paper Only / Mock Demo？

人工回饋包

回報 UX 問題、操作不清楚、產品問題或 browser-only runtime 狀況時，請使用這份可複製格式。

此 panel 只準備人工回饋文字。請勿放入券商帳戶資料、密碼、API keys、憑證檔、真實委託、真實餘額、真實持倉或私人交易紀錄。

警示

Demo 邊界

  • Browser-only mock demo uses deterministic local state in this browser.
  • No backend, broker SDK, external market data, database write, credentials, real order, or live trading path is used.
  • Simulated PnL is for product workflow demonstration only and is not investment advice or a performance claim.

紙上執行

紙上模擬審批流程

只讀檢視從 StrategySignal 到 PaperOrderIntent、Risk Engine、OMS、Paper Broker Gateway 與 audit events 的受控路徑。此 UI 不送出模擬，不提供任何實盤控制。

後端紙上執行狀態無法取得，正在顯示安全備援資料： fetch failed

審核狀態

允許的審核結果

  • 研究已通過
  • 已核准紙上模擬
  • 已拒絕
  • 需要資料審查

紙上路徑

必要模擬路由

  1. StrategySignal
  2. 平台 PaperOrderIntent
  3. Risk Engine
  4. OMS
  5. Paper Broker Gateway
  6. Audit Event

安全狀態

僅限 Paper Only，無實盤控制

平台建立的 PaperOrderIntent 只有在紙上審核後才能模擬，且與實盤交易分離，永遠不呼叫真實券商。

TRADING_MODE=paperENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperBROKER_API_CALLED=false持久化: sqliteLOCAL_ONLY=true
執行紀錄: 0OMS 事件: 0稽核事件: 0Execution reports: 0Outbox metadata: 0Production OMS ready: false本地 DB: data/paper_execution_audit.sqlite

紙上 Risk Engine

紙上風控 Guardrail 擴充

只讀顯示擴充後的 paper-only Risk Engine checks：price reasonability、契約單筆數量、margin proxy、duplicate order prevention、daily loss、position limit、kill switch 與模擬 broker heartbeat。

後端紙上風控狀態無法取得，正在顯示安全備援資料： fetch failed

TRADING_MODE=paperENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperPAPER_ONLY=trueBROKER_API_CALLED=falseKILL_SWITCH=falseBROKER_HEARTBEAT=true

Guardrails

擴充的 pre-trade / in-trade checks

  • price_reasonability 會拒絕超出 reference band 的紙上價格。
  • max_order_size_by_contract 限制 TX / MTX / TMF 紙上單筆數量。
  • margin_proxy 會阻擋超過本地 margin proxy 的紙上曝險。
  • duplicate_order_prevention 會拒絕已出現過的 idempotency key。
  • daily_loss_state_tracking 與 position_limit_tracking 僅使用本地紙上狀態。
  • kill_switch_status 與 broker_heartbeat_status 是模擬紙上 placeholder。

Policy

Paper-only 風控政策

最大 TX 等值曝險
0.25
Stale quote seconds
3
Price reasonability band
2.00%
最大 margin proxy
50000 TWD
最大持倉 TX 等值
0.25
最大單日損失
5000 TWD

本地狀態

紙上風控 state snapshot

單日已實現損失狀態
0 TWD
目前持倉 TX 等值
0
已記錄 idempotency keys
0
更新時間
fallback

契約限制

各契約單筆最大數量

TX
1
MTX
4
TMF
20

Check Names

RiskEvaluation checks 明細 key

LIVE_TRADING_DISABLEDPAPER_BROKER_ONLYIDEMPOTENCY_KEY_PRESENTPAPER_ONLY_INTENTMAX_EXPOSURESTALE_QUOTEPRICE_REASONABILITYMAX_ORDER_SIZE_BY_CONTRACTMARGIN_PROXYDUPLICATE_ORDER_PREVENTIONDAILY_LOSS_LIMITPOSITION_LIMITKILL_SWITCHBROKER_HEARTBEAT

只讀 guardrail 介面。它不送出訂單、不核准執行、不寫資料庫、不呼叫券商、不收集憑證、不啟用實盤，也不提供投資建議。

紙上風控邊界

紙上跨帳戶風控 Readiness

只讀顯示目前 Risk Engine guardrails 仍使用本地紙上狀態。它不是正式跨帳戶風控系統、帳戶層級、保證金 feed 或集中式風控限制服務。

後端跨帳戶風控 readiness 無法取得，正在顯示安全備援資料： fetch failed

Readiness 狀態

本地紙上風控，尚非跨帳戶風控

Fallback cross-account risk readiness metadata. Paper Risk Engine guardrails use local paper state and are not a formal cross-account risk system.

Readiness state: local_paper_risk_state_not_cross_account_risk_systemProduction cross-account risk: false本地紙上狀態: true紙上 guardrails: true

目前能力

已實作本地紙上範圍

local_paper_guardrails_enabledtruelocal_paper_state_enabledtruesingle_account_demo_state_enabledtruerisk_evaluation_detail_enabledtrueduplicate_idempotency_local_check_enabledtrue

非 production 缺口

尚缺跨帳戶控制

cross_account_aggregation_enabledfalseaccount_hierarchy_enabledfalsetenant_isolated_risk_state_enabledfalsereal_account_margin_feed_enabledfalsebroker_position_feed_enabledfalsecentralized_risk_limits_enabledfalsedistributed_kill_switch_enabledfalsedurable_risk_state_store_enabledfalsereal_time_equity_pnl_tracking_enabledfalseproduction_cross_account_risk_systemfalse

目前範圍

目前已存在內容

  • Paper-only guardrail evaluation for local simulation workflows.
  • Local in-memory paper risk state for demo and engineering checks.
  • Single-account style paper state snapshot in the current Web Command Center.

缺少控制項

跨帳戶風控所需能力

  • Cross-account exposure aggregation by customer, strategy, symbol, and contract.
  • Real account margin, equity, cash, PnL, order, fill, and position feeds.
  • Broker-side position and order reconciliation per account.
  • Centralized durable risk state store with replay and recovery.

Production 前置條件

必要實作路徑

  • Define tenant, account, portfolio, strategy, and reviewer identity model.
  • Design account-scoped and group-scoped risk limit schemas.
  • Select reviewed durable storage for cross-account risk state.

警示

Readiness caveats

  • Fallback cross-account risk readiness metadata. Backend is unavailable.
  • Local paper risk state is not a hosted or cross-account risk store.
  • Production Trading Platform remains NOT READY.

安全旗標

Paper-only 風控邊界

paper_onlytrueread_onlytruelive_trading_enabledfalsebroker_api_calledfalseexternal_account_data_loadedfalsereal_account_data_loadedfalseorder_createdfalsecredentials_collectedfalsedatabase_writtenfalsehosted_datastore_writtenfalseproduction_risk_approvalfalseproduction_cross_account_riskfalse

只讀 readiness 介面。它不建立訂單、不寫資料庫、不載入真實帳戶資料、不呼叫券商、不收集憑證、不授予 production risk approval，也不提供投資建議。

模擬後端

Mock Backend Demo MVP

執行 deterministic mock market data、signal-only 策略模擬、PaperOrderIntent 風控檢查、OMS lifecycle、紙上券商模擬與 paper-only portfolio summary。它不連券商、不使用真實資金、不下載外部行情，也不啟用實盤交易。

Paper OnlyMock Backend無券商無真實資金實盤關閉不構成投資建議

Mock Backend 已準備好進行 Paper Only demo。

行情資料

Deterministic TX / MTX / TMF 價格路徑

契約BidAskLast變動Quote age

策略

僅輸出 signal 的策略結果

執行模擬策略即可產生 StrategySignal。

紙上訂單

紙上 workflow 結果

模擬紙上訂單即可檢視 OMS 與投組輸出。

投組

Paper-only 帳戶摘要

持倉
0
平均價格
N/A
未實現損益
0
紙上權益
1000000

安全旗標

Mock backend safety flags

paper_only=truemock_backend=truedeterministic_data=truelive_trading_enabled=falsebroker_api_called=falseexternal_market_data_downloaded=falsereal_order_created=falsecredentials_collected=falseproduction_trading_ready=falseinvestment_advice=false

此 panel 只呼叫 /api/mock-backend/* endpoints。不收集憑證、不寫 production data、不呼叫真實券商、不建立真實委託，也不提供投資建議。

警示

Demo 邊界

    紙上審批佇列

    紙上審批佇列與歷史

    只讀檢視已持久化的紙上審批請求、覆核人歷史、必要審批順序、雜湊鏈參考與安全旗標。此面板不送出決策、不核准執行、不收集憑證，也不呼叫券商。

    後端紙上審批資料無法取得，正在顯示安全備援資料： fetch failed; fetch failed; fetch failed

    審批狀態

    本地紙上治理狀態

    Fallback paper approval status. Approval UI remains read-only and paper-only while backend is unavailable.

    TRADING_MODE=paperENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperDUAL_REVIEW_REQUIRED=trueBROKER_API_CALLED=false
    審批模式
    paper_only_local_approval_foundation
    覆核人角色
    research_reviewer, risk_reviewer, compliance_reviewer
    支援決策
    research_approved, approved_for_paper_simulation, rejected, needs_data_review
    紀錄政策
    Append-only local SQLite records with hash chaining. This is not a production WORM ledger or production identity system.

    待審佇列

    待審 approval requests

    目前沒有待審的紙上 approval request。

    覆核人歷史

    審批歷史與雜湊鏈參考

    目前沒有紙上審批歷史。

    只讀審批介面。它不建立 approval request、不送出覆核決策、不寫資料庫、不呼叫券商、不收集憑證、不建立訂單，也不授予實盤交易權限。

    合規審批邊界

    本地紙上骨架，不是正式合規審批

    只讀檢視目前 approval workflow 仍是本地 Paper Only scaffolding。它不是正式合規審批系統，本身不授予紙上執行或實盤核准。

    後端紙上合規審批 readiness 無法取得，正在顯示安全備援資料： fetch failed

    只讀 endpoint

    GET /api/paper-execution/approvals/compliance-readiness

    The current approval workflow is local Paper Only scaffolding for technical demos. It is not a formal compliance approval system, does not verify reviewer identity, and does not grant live or production trading approval.

    就緒狀態: local_paper_scaffolding_not_formal_compliance_system

    審批骨架

    本地紙上審批佇列已啟用true本地 SQLite 持久化已啟用true本地雙人覆核規則已啟用true正式合規審批已啟用falseProduction approval authorityfalseReviewer identity 已驗證falseRBAC/ABAC 已強制執行false職責分離已強制執行falseCompliance policy engine 已啟用falseApproval policy versioning 已啟用falseTenant-scoped approval records 已啟用falseLegal retention policy 已強制執行false

    稽核姿態

    本地 hash-chain 已啟用trueWORM ledger 已啟用falseImmutable audit log 已啟用falseCentralized audit service 已啟用falseSigned approval records 已啟用falseExternal timestamping 已啟用falseRetention policy 已強制執行falseProduction compliance archive 已啟用false

    安全預設

    TRADING_MODEpaperENABLE_LIVE_TRADINGfalseBROKER_PROVIDERpaper

    目前本地紙上範圍

    • 用於 demo 與技術測試的本地 Paper Only approval queue 與 history。
    • 針對紙上 approval decisions 的本地 SQLite persistence 與 hash-chain references。
    • Controlled Paper Submit 可引用已持久化的 approval_request_id。
    • Web Command Center 僅可為紙上模擬建立本地 paper requests 與 decisions。

    正式合規審批缺口

    • 真實 reviewer login 與已驗證 reviewer identity。
    • 針對 approval authority 的正式 RBAC/ABAC enforcement。
    • Tenant-scoped customer accounts 與 hosted approval records。
    • 具備 versioned approval rules 的 compliance policy engine。
    • 由 identity 與 authorization controls 強制執行的職責分離。
    • Immutable WORM ledger 或 centralized compliance audit service。
    • Signed approval records、external timestamping 與 retention policy enforcement。
    • 針對 customer-facing approval workflows 的 legal、regulatory、security 與 operations review。

    正式審批前必要條件

    • 選擇並審查 authentication provider。
    • 實作 reviewer identity、session lifecycle、MFA 與 logout behavior。
    • 實作 tenant-scoped customer accounts 與 membership records。
    • 針對 reviewer、risk、compliance 與 paper operator roles 強制 RBAC/ABAC。
    • 定義並版本化 compliance approval policies。
    • 實作 WORM 或 centralized immutable audit storage。
    • 實作 signed approval records 與 tamper-evident export。
    • 任何 approval 被呈現為正式合規審批前，必須完成 legal/regulatory review。

    安全旗標

    paper_onlytrueread_onlytruelive_trading_enabledfalsebroker_providerpaperbroker_api_calledfalseorder_createdfalsecredentials_collectedfalsebroker_credentials_collectedfalsedatabase_writtenfalseexternal_db_writtenfalseproduction_compliance_approvalfalselive_approval_grantedfalsepaper_execution_approval_grantedfalseproduction_trading_readyfalse

    紙上決策

    • research_approved
    • approved_for_paper_simulation
    • rejected
    • needs_data_review

    邊界警示

    • 此 endpoint 僅為只讀 compliance approval readiness metadata。
    • 本地 paper approval workflow 不是正式合規審批、不是法律核准，也不是實盤核准。
    • 它不啟用實盤、不寫資料庫、不收集憑證、不呼叫券商，也不建立訂單。
    • Production Trading Platform 仍為 NOT READY。

    紙上審批請求

    建立紙上 approval request

    針對 StrategySignal 建立一筆本地 approval request。這是覆核 workflow 的 Paper Only 起點，不建立訂單、不呼叫 Risk Engine、不呼叫 OMS、不收集憑證，也不連接券商。

    僅限紙上請求ENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paper不建立訂單
    • Paper Only：只呼叫 /api/paper-execution/approvals/requests。
    • 建立 request 後初始狀態為 pending_review，不會建立覆核人決策。
    • StrategySignal 仍只輸出訊號，不直接呼叫 Risk Engine、OMS、Broker Gateway 或券商。
    • 此步驟不提供實盤核准、不上傳憑證、不登入帳戶、不連接券商、不建立紙上模擬，也不建立真實委託。

    紙上審批決策

    記錄紙上覆核決策

    針對既有本地 approval request 建立一筆覆核人決策。此表單僅限紙上，僅寫入本地審批決策紀錄，不建立訂單、不收集憑證，也不呼叫券商。

    僅限紙上決策ENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paper不收集憑證

    目前沒有可操作的 approval request。請先建立本地紙上 approval request，再記錄覆核人決策。

    • Paper Only：只針對既有 approval_request_id 呼叫本地審批決策 endpoint。
    • 此表單只記錄覆核人決策；它本身不建立紙上模擬、訂單或紙上執行核准。
    • 雙人覆核仍需要不同 reviewer ID，且後端會驗證必要順序。
    • 不提供實盤核准、不上傳憑證、不登入帳戶、不連接券商，也不建立真實委託路徑。

    受控紙上送出

    建立紙上模擬紀錄

    只有在選取的 persisted approval_request_id 已完成必要審批順序後，才會透過後端 workflow record API 建立一筆 Paper Only 模擬。它不提供實盤核准、不能收集憑證，也不會呼叫真實券商。

    Paper Only submitENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paper必須引用已持久化審批

    必須先有 persisted approval_request_id 達到 approved_for_paper_simulation，才能送出紙上模擬。

    • Paper Only：只以 persisted approval_request_id 呼叫 /api/paper-execution/workflow/record。
    • 選取的 approval request 必須已經在本地審批佇列中達到 approved_for_paper_simulation。
    • StrategySignal 仍是已核准的訊號 payload，不能直接呼叫券商、Risk Engine 或 OMS。
    • 不提供實盤核准、不上傳憑證、不登入帳戶，也不連接真實券商。

    紙上券商模擬

    本地 quote-based 模擬預覽

    使用使用者提供的本地 quote 與 liquidity 輸入，預覽 Paper Broker Gateway 可能推導出的紙上結果。此功能不送出訂單、不下載行情、不寫資料庫，也不呼叫券商。

    僅限紙上ENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paper僅限預覽
    • Paper Only：只呼叫 /api/paper-execution/broker-simulation/preview。
    • 輸入僅為使用者提供的本地 quote snapshot；不下載外部行情資料。
    • 此預覽不建立訂單、不寫資料庫、不呼叫 Risk Engine、不呼叫 OMS，也不呼叫真實券商。
    • 這不是 production 撮合引擎、券商 execution report、實盤 liquidity model，也不是交易建議。

    調整本地 quote 輸入，預覽 paper-only 模擬券商結果。

    券商模擬 Readiness

    紙上券商模擬不是真實市場撮合

    針對 deterministic 與本地 quote-based 紙上模擬的只讀邊界。Paper fill 只是模擬 metadata，不是真實市場成交、券商 execution report，也不是 production execution model。

    後端紙上券商模擬 readiness 資料不可用。顯示安全 fallback： fetch failed

    Readiness 狀態

    目前券商模擬邊界

    Fallback Paper Broker simulation readiness metadata. Local paper fills are not real market fills or broker execution reports.

    Readiness state: local_paper_simulation_not_market_matching_or_broker_executionProduction execution model: false本地 quote preview: trueDeterministic simulation: true

    目前 Paper 能力

    本地紙上模擬

    DETERMINISTIC_SIMULATIONtrueLOCAL_QUOTE_PREVIEWtruePAPER_OUTCOMEStrueCALLER_PROVIDED_QUOTE_ONLYtrue

    Production Execution 缺口

    尚未啟用的控制

    REAL_MARKET_MATCHING_ENGINEfalseEXCHANGE_ORDER_BOOK_REPLAYfalseBROKER_EXECUTION_REPORT_MODELfalseLATENCY_QUEUE_POSITION_MODELfalseSLIPPAGE_LIQUIDITY_CALIBRATIONfalseREAL_ACCOUNT_RECONCILIATIONfalsePRODUCTION_EXECUTION_MODELfalse

    目前範圍

    現在已存在項目

    • Deterministic broker_simulation outcomes for paper workflow tests.
    • Caller-provided local quote snapshot preview.
    • Paper-only simulated ack/reject/partial_fill/fill/cancel outcomes.

    缺少控制

    Production execution model 所需項目

    • Real market matching engine.
    • Exchange order book replay.
    • Broker execution report ingestion and normalization.
    • Latency and queue position model.
    • Real account, order, fill, and position reconciliation.

    Production Execution Model 前

    必要實作與審查

    • Define broker execution report schema behind broker-gateway.
    • Define market data and order book replay sources with data licensing review.
    • Design latency, queue position, slippage, and liquidity model assumptions.

    警示

    券商模擬 readiness 備註

    • Fallback broker simulation readiness metadata. Backend is unavailable.
    • Paper fills are simulated metadata, not real market fills.
    • Production Trading Platform remains NOT READY.

    安全旗標

    只讀紙上邊界

    PAPER_ONLYtrueREAD_ONLYtrueLIVE_TRADING_FLAGfalseBROKER_API_CALLEDfalseEXTERNAL_MARKET_DATA_DOWNLOADEDfalseREAL_ORDER_CREATEDfalseORDER_CREATEDfalseCREDENTIALS_COLLECTEDfalseDATABASE_WRITTENfalsePRODUCTION_EXECUTION_MODELfalse

    只讀券商模擬 readiness 介面。它不建立訂單、不呼叫 Risk Engine、不呼叫 OMS、不呼叫 Broker Gateway 執行路徑、不寫資料庫、不下載行情、不呼叫券商、不收集憑證，也不宣稱真實成交精準度。

    券商模擬 Evidence

    紙上券商模擬 evidence viewer

    只讀本地 JSON viewer，用於檢視 make paper-broker-simulation-evidence-export 匯出的 evidence。檔案只在此瀏覽器內解析，不會上傳、不會持久化，也不會送往後端 API。

    目前來源: 尚未載入本地券商模擬 evidence

    請明確選取本地紙上券商模擬 evidence JSON，僅在此瀏覽器內檢視。

    尚未載入本地券商模擬 evidence。請先用 make paper-broker-simulation-evidence-export 匯出，再明確選取 JSON 檔。

    紙上 OMS / 稽核

    已持久化紙上流程紀錄

    只讀檢視本地 SQLite 中的紙上 workflow runs、OMS events 與 audit events。此畫面不建立紀錄、不送出模擬、不連接券商，也不提供實盤控制。

    後端紙上紀錄查詢無法取得，正在顯示安全空狀態： fetch failed

    紙上紀錄

    最新持久化 workflow

    目前沒有可用的本地紙上 workflow 紀錄。

    選取流程

    稽核上下文

    目前沒有選取 workflow run。

    時間線已就緒

    OMS 時間線

    紙上委託生命週期

    選取的紙上 workflow 目前沒有 OMS events。

    稽核時間線

    紙上 workflow 稽核事件

    選取的紙上 workflow 目前沒有 audit events。

    只讀稽核介面。它不寫入資料庫、不修改持久化紀錄、不呼叫券商、不建立訂單、不升級審批，也不提供交易建議。

    紙上 OMS Reliability

    紙上 OMS reliability metadata

    只讀檢視本地紙上 OMS metadata：outbox 紀錄、idempotency keys、execution reports、timeout candidates 與明確非 production 缺口。此畫面不處理訂單、不寫紀錄，也不連接券商。

    後端紙上 OMS reliability 資料無法取得，正在顯示安全備援資料： fetch failed; fetch failed; fetch failed

    Reliability 狀態

    本地紙上 OMS 基礎

    Fallback Paper OMS reliability metadata. The production OMS path is not ready and remains paper-only.

    Outbox items: 0Idempotency keys: 0Execution reports: 0Timeout candidates: 0

    安全旗標

    紙上 reliability 邊界

    PAPER_ONLYtrueLIVE_TRADING_FLAGfalseBROKER_API_CALLEDfalsePRODUCTION_OMS_READYfalseLOCAL_SQLITE_ONLYtrueASYNC_ORDER_PROCESSINGfalse

    本地能力

    已實作 metadata checks

    LOCAL_OUTBOX_METADATAtrueDUPLICATE_ORDER_PREVENTIONtrueTIMEOUT_CANDIDATE_SCANtrueEXECUTION_REPORT_MODELtrueAMEND_REPLACEfalseRECONCILIATION_LOOPfalse

    非 production 缺口

    尚非 production OMS

    • No asynchronous order worker exists.
    • No distributed durable queue or outbox worker exists.
    • No amend or replace workflow exists.
    • No production reconciliation loop exists.
    • Local SQLite reliability metadata is not a production WORM ledger.

    Outbox Metadata

    最新本地 outbox 紀錄

    目前沒有本地 outbox metadata。

    Execution Reports

    最新選取訂單 execution reports

    最新選取訂單: 無

    目前選取訂單沒有 execution reports。

    Timeout Scan

    紙上 timeout candidates

    Timeout handling 是明確的 paper-only 操作。Preview 先驗證本地 EXPIRE metadata；Mark 只寫入本地 SQLite 的 OMS、稽核與 execution-report metadata。

    目前沒有紙上 timeout candidates。

    只讀 reliability 介面。它不修改 OMS 狀態、不送出訂單、不處理 outbox workers、不核准執行、不寫資料庫、不呼叫券商、不收集憑證，也不提供投資建議。

    Paper OMS Readiness

    Paper OMS 不是 production OMS

    只讀 production readiness boundary。現有系統具備 deterministic paper state transitions 與本地 metadata，但尚未具備 durable async processing、production timeout workers、amend/replace、broker execution report ingestion 或 formal reconciliation。

    後端 Paper OMS production readiness 資料無法取得，正在顯示安全備援資料： fetch failed

    Readiness 狀態

    目前 production OMS 邊界

    Fallback Paper OMS production readiness metadata. Local paper OMS scaffolding is not a production OMS.

    Readiness state: local_paper_oms_scaffolding_not_production_omsProduction OMS ready: false本地 SQLite metadata: trueState machine: true

    目前紙上能力

    本地紙上骨架

    ORDER_STATE_MACHINEtrueLOCAL_OUTBOX_METADATAtrueDUPLICATE_IDEMPOTENCY_METADATAtrueEXECUTION_REPORT_METADATAtrueTIMEOUT_CANDIDATE_SCANtrueEXPLICIT_PAPER_TIMEOUT_MARKtrue

    Production OMS 缺口

    尚未啟用的控制

    ASYNC_ORDER_PROCESSINGfalseDISTRIBUTED_DURABLE_QUEUEfalseOUTBOX_WORKERfalseFULL_TIMEOUT_WORKERfalseAMEND_REPLACEfalseBROKER_EXECUTION_REPORT_INGESTIONfalseFORMAL_RECONCILIATION_LOOPfalse

    目前範圍

    目前已存在項目

    • Deterministic paper OMS state machine and lifecycle transitions.
    • Local SQLite paper workflow, OMS event, audit event, and execution-report metadata.
    • Local outbox metadata for completed paper workflow submissions.

    缺少控制

    Production OMS 所需項目

    • Asynchronous order processing worker.
    • Distributed durable queue or production outbox worker.
    • Amend and replace order lifecycle.
    • Formal reconciliation loop against broker/account state.

    Production OMS 前

    必要實作與審查

    • Select and review durable queue/outbox architecture.
    • Implement idempotent asynchronous OMS worker processing.
    • Implement formal reconciliation loop and locked-state handling.

    警示

    OMS readiness 備註

    • Fallback production OMS readiness metadata. Backend is unavailable.
    • Production Trading Platform remains NOT READY.

    安全旗標

    只讀紙上邊界

    PAPER_ONLYtrueREAD_ONLYtrueLIVE_TRADING_ENABLEDfalseBROKER_API_CALLEDfalseORDER_CREATEDfalseCREDENTIALS_COLLECTEDfalseDATABASE_WRITTENfalsePRODUCTION_OMS_READYfalseLIVE_APPROVAL_GRANTEDfalse

    只讀 production OMS readiness 介面。它不送出訂單、不處理 queues、不修改 OMS 狀態、不核准執行、不寫資料庫、不呼叫券商、不收集憑證，並維持實盤關閉。

    紙上稽核完整性

    本地 audit hash-chain 驗證

    只讀驗證本地 SQLite 紙上 audit events。此預覽檢查 stored previous_hash 與 event_hash metadata，但不是 WORM 儲存、集中式稽核、簽章或 production compliance。

    後端紙上稽核完整性資料無法取得，正在顯示安全備援資料： fetch failed; fetch failed

    完整性狀態

    本地稽核驗證預覽

    Fallback paper audit integrity verification. No local audit events are loaded.

    已驗證: trueAudit events: 0Broken chains: 0Missing hashes: 0

    安全旗標

    不是 production audit ledger

    PAPER_ONLYtrueLOCAL_SQLITE_ONLYtrueLIVE_TRADING_FLAGfalseBROKER_API_CALLEDfalseWORM_LEDGERfalseCENTRALIZED_AUDIT_SERVICEfalse

    事件檢查

    最新 hash-chain checks

    目前沒有可驗證的本地紙上 audit events。

    已知缺口

    非 production audit posture

    • Local SQLite is not WORM storage.
    • No centralized audit service is enabled.
    • No external timestamping, signing, or notarization is enabled.
    • No retention policy enforcement is enabled.

    警示

    驗證備註

    • Fallback paper audit integrity verification. Backend is unavailable.
    • Local SQLite audit records are not WORM storage or production compliance.

    只讀 audit integrity 介面。它不寫資料庫、不修補 chain、不上傳紀錄、不呼叫券商、不收集憑證、不建立訂單、不核准實盤，也不宣稱 WORM / immutable audit compliance。

    Paper Audit WORM Readiness

    SQLite audit 不是 production WORM ledger

    只讀稽核儲存 readiness boundary。本地 SQLite 搭配 hash-chain metadata 可用於紙上 demo，但不是 WORM 儲存、immutable ledger、集中式稽核、簽章或 production compliance。

    後端 WORM readiness 資料無法取得，正在顯示安全備援資料： fetch failed

    Readiness 狀態

    目前稽核儲存邊界

    Fallback WORM readiness metadata. Local SQLite audit records are not a production WORM or immutable audit ledger.

    Readiness state: local_sqlite_not_production_worm_ledger本地 SQLite audit: true本地 hash chain: trueWORM storage: false

    Production WORM 缺口

    尚未啟用的控制

    WORM_STORAGE_ENABLEDfalseIMMUTABLE_LEDGER_ENABLEDfalseAPPEND_ONLY_STORAGE_ENFORCEDfalseCENTRALIZED_AUDIT_SERVICE_ENABLEDfalseOBJECT_LOCK_ENABLEDfalseEXTERNAL_TIMESTAMPING_ENABLEDfalseCRYPTOGRAPHIC_SIGNING_ENABLEDfalseRETENTION_POLICY_ENFORCEDfalse

    目前範圍

    目前已存在項目

    • Local SQLite paper audit records for demos and engineering review.
    • Local hash-chain metadata for paper audit integrity preview.
    • Read-only UI display of the current non-production audit posture.

    缺少控制

    Production WORM posture 所需項目

    • Storage-level WORM controls.
    • Centralized audit service.
    • Cryptographic signing and external timestamping.
    • Retention policy and legal hold enforcement.

    宣稱 WORM 前

    必要審查與實作

    • Select a reviewed WORM-capable storage architecture.
    • Implement immutable audit schemas and retention policies.
    • Complete security, legal, compliance, and DR review.

    安全旗標

    只讀紙上邊界

    PAPER_ONLYtrueREAD_ONLYtrueLIVE_TRADING_ENABLEDfalseBROKER_API_CALLEDfalseORDER_CREATEDfalseCREDENTIALS_COLLECTEDfalseDATABASE_WRITTENfalseWORM_COMPLIANCE_CLAIMfalsePRODUCTION_AUDIT_COMPLIANCEfalse

    警示

    稽核姿態備註

    • Fallback WORM readiness metadata. Backend is unavailable.
    • Local SQLite audit persistence is not production WORM storage.
    • Production Trading Platform remains NOT READY.

    只讀 WORM readiness 介面。它不寫資料庫、不上傳 audit records、不修補 chain、不呼叫券商、不收集憑證、不建立訂單、不核准實盤，也不宣稱 WORM / immutable audit compliance。

    Audit Integrity Evidence

    紙上稽核完整性 evidence viewer

    只讀本地 JSON viewer，用於檢視 scripts/verify-paper-audit-integrity.py 匯出的 evidence。檔案只在此瀏覽器內解析，不會上傳、不會持久化，也不會送往後端 API。

    目前來源: 尚未載入本地 audit integrity evidence

    請明確選取本地紙上稽核完整性驗證 JSON，僅在此瀏覽器內檢視。

    尚未載入本地 audit integrity evidence。請先用 scripts/verify-paper-audit-integrity.py 搭配 --output 匯出，再明確選取 JSON 檔。

    Demo Evidence

    紙上 demo evidence viewer

    只讀本地 JSON viewer，用於檢視 make paper-demo-evidence-export 匯出的 evidence。檔案只在此瀏覽器內解析，不會上傳、不會持久化，也不會送往後端 API。

    目前來源: 尚未載入本地 evidence

    請明確選取本地紙上 demo evidence JSON，僅在此瀏覽器內檢視。

    尚未載入本地 demo evidence。請先用 make paper-demo-evidence-export 匯出，再明確選取 JSON 檔。