Web Command Center

Taifex Quant Trading Platform

Paper-first control surface for the Phase 0-6 cloud-native roadmap. Strategy signals, risk checks, OMS state, and broker gateway boundaries stay decoupled.

TRADING_MODE=paperLive disabledBroker: paper

Backend Health

Fallback Mode

fetch failed

offline-safe

Safety Mode

Paper Only

Fallback paper-safe status. Backend is unavailable.

ENABLE_LIVE_TRADING=false

Risk Defaults

TX-equivalent limit

Max daily loss and stale quote limits are visible before any future OMS workflow.

MAX_TX_EQUIVALENT_EXPOSURE=0.25

Product Positioning

Taiwan index futures data analysis and Paper Trading research platform

This Web App turns the website promise into an interactive research workflow: users can inspect mock TX / MTX / TMF data, validate a strategy hypothesis, simulate a Paper Only order, review OMS events, and copy evidence without broker connectivity or real-money exposure.

Market Data Lab

Understand TX / MTX / TMF data before trading decisions

Feature
Deterministic quote snapshots, bid / ask / last, quote age, spread, and contract exposure context.
User benefit
Users can learn how market data flows through the platform and compare contract sizing before testing a strategy.

Strategy Research

Validate signal logic without creating orders

Feature
A mock strategy emits a standardized StrategySignal with signals_only=true.
User benefit
Users can separate research judgment from execution and quickly see what a strategy would request before any paper order simulation.

Paper Trading Simulator

Experience order workflow without broker risk

Feature
PaperOrderIntent, paper risk checks, simulated OMS lifecycle, and browser-local paper fill outcomes.
User benefit
Users can practice the end-to-end workflow and understand why a simulated order is accepted, rejected, partially filled, or filled.

Portfolio Review

See simulated position and PnL impact

Feature
Paper-only position, average price, unrealized PnL, paper equity, and resettable session state.
User benefit
Users can connect each simulated action to position changes while keeping the output clearly marked as demo metrics, not performance claims.

Evidence Center

Keep demo results reviewable

Feature
Copy demo summary, evidence JSON, session id, deterministic seed, and localStorage key.
User benefit
Users and reviewers can reproduce the browser-local scenario, share feedback, and audit what was shown in the demo.

Research Workflow

From analysis to paper decision review

  1. Market data preview
  2. StrategySignal generation
  3. Paper Only order simulation
  4. OMS timeline review
  5. Simulated position / PnL review
  6. Evidence JSON handoff

Safety Boundary

What this platform deliberately does not do

  • No real broker connection
  • No real order submission
  • No credential collection
  • No investment advice
  • No performance claim
  • Production Trading Platform remains NOT READY

Workflow Standardization

How the demo maps to the quant operating workflow

This learning layer connects the browser demo to the standardized method in docs/quant-workflow-standardization.md. It shows how data, strategy, backtest, rollover, Paper Trading, Risk Engine, OMS, and audit evidence fit together before any production trading path exists.

1

Data

Data standardization

TX / MTX / TMF quote snapshots use a common exposure language before strategy logic runs.

Demo action
Generate market tick
Standardized control
Market data should carry symbol, bid, ask, last, quote age, session context, and TX-equivalent exposure meaning.
2

Signal

StrategySignal standardization

The strategy emits a signal only; the platform owns all order-like workflow steps.

Demo action
Run mock strategy
Standardized control
StrategySignal stays signals_only=true and never calls broker, Risk Engine, OMS, or Broker Gateway directly.
3

Backtest

Backtest reproducibility

Research outputs should be tied to data versions, code versions, parameters, costs, and review notes.

Demo action
Inspect session id, seed, and evidence JSON
Standardized control
Backtest and demo artifacts must remain reproducible metadata and must not be treated as performance claims.
4

Rollover

Rollover data separation

Research can use adjusted continuous data, but paper and future execution mapping must reference real contracts.

Demo action
Review TX / MTX / TMF contract context
Standardized control
Rollover metadata separates research-only continuous futures from executable contract symbols and prices.
5

Paper intent

PaperOrderIntent flow

Only the platform converts a StrategySignal into a Paper Only order intent.

Demo action
Simulate Paper Only order
Standardized control
PaperOrderIntent is platform-owned and cannot approve live trading, collect credentials, or create real orders.
6

Risk

Risk Engine checks

Paper risk checks explain why a simulated workflow can proceed or must be rejected.

Demo action
Review risk approval result
Standardized control
Risk checks cover paper mode, live-disabled status, stale quotes, exposure, size, duplicate keys, and safety flags.
7

OMS

OMS lifecycle

The simulated OMS timeline makes lifecycle transitions visible instead of hiding them in strategy code.

Demo action
Review OMS timeline
Standardized control
OMS owns order state, idempotency, terminal status, and future reconciliation boundaries.
8

Audit

Audit evidence

Reviewer handoff requires a small evidence artifact that describes what happened and what stayed simulated.

Demo action
Copy demo summary or evidence JSON
Standardized control
Audit evidence must preserve safety flags and remain local/browser-only unless a future reviewed data layer exists.

Safety Boundary

Learning layer only, not an execution path

This panel is read-only product education. It does not fetch backend data, upload evidence, write databases, call brokers, create orders, collect credentials, or provide investment advice.

  • Paper Only
  • Browser-only / mock demo where applicable
  • No broker
  • No real order
  • No credentials
  • Not investment advice
  • Production Trading Platform: NOT READY

Demo Tour

Customer Demo Guided Flow

A read-only walkthrough for understanding release level, safety defaults, paper OMS records, research packets, and contract specs. The tour changes only local UI state.

Read-only tour
Step 1/7Open tab: Release

Confirm Release Level

Start with the release baseline and confirm the customer understands the current level before discussing any workflow.

What to verify
Marketing Website is an external presentation candidate, Web Command Center is an internal demo candidate, Paper Research Preview is an internal technical preview, and Production Trading Platform is NOT READY.
Safety boundary
This confirms the platform is available for evaluation only and is not positioned as production trading ready.

Prohibited actions

This release is not a production trading product

  • No live trading
  • No broker login
  • No real orders
  • No credential upload
  • No customer account onboarding
  • No trading recommendation

Interaction Layer

Read-only Command Center tools

The Paper OMS tab opens first so customers immediately enter the Browser-only Mock Demo stepper. Safe controls remain available for refreshing status, switching views, inspecting local samples, selecting paper audit records, and copying IDs. These controls do not submit real orders, write production databases, or connect brokers.

Read-only

Backend unavailable

Safe fallback is active

The production frontend can still show checked-in paper-safe data when the backend is unavailable. For a local demo, start the backend or create one local paper audit sample with the command below.

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

Local demo seed

make seed-paper-execution-demo

Browser-only Mock Runtime

Interactive Demo in this browser

Runs deterministic TX / MTX / TMF market data with market regime, spread, liquidity, quote age, and slippage estimates, plus signal-only strategy simulation, PaperOrderIntent risk checks, OMS timeline, paper broker fill simulation, and simulated portfolio metrics entirely in the browser. It requires no local backend, no broker, no database, no real money, and no live trading.

Paper OnlyBrowser-onlyNo backend requiredNo brokerNo real moneyNo live tradingNot investment advice

Guided Demo

Complete browser-only walkthrough

Follow these steps to operate the demo from market tick to signal, Paper Only order, simulated OMS, and paper-only metrics. Every step stays inside this browser.

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

Generate market tick

Create the next deterministic TX / MTX / TMF quote snapshot in this browser.

Expected result

Bid, ask, last, quote age, quote size, and liquidity score update without external market data.

Result explanation

The tick also shows a deterministic market regime such as normal, trending, volatile, illiquid, or stale_quote, so spread and liquidity can change without live data.

Safety boundary

No backend, broker, external market feed, database write, or live trading path is used.

Next step

Run the signal-only mock strategy against the selected symbol.

Visualization Layer

Market path, microstructure, order outcome, and paper PnL

Turns the browser-only demo into visual evidence: deterministic price path, bid / ask band, market regime strip, spread, liquidity, quote age, slippage estimate, paper order outcome, and simulated PnL.

Price Path

Deterministic TX / MTX / TMF market path

Current tick: 0
0

Latest visual snapshot: TMF 19998 · Market regime: normal

Microstructure

Spread / liquidity / quote age / slippage

Spread0.2
Liquidity score0.82
Quote age1
Slippage estimate0.01

These bars are deterministic mock data only. They are not external market data and do not represent live liquidity.

Order Outcome

Paper fill / partial / reject visual

Simulate a Paper Only order to visualize fill quantity, remaining quantity, and fill reason.

Paper Portfolio

Position and simulated PnL snapshot

Position
0
Unrealized PnL
0
Paper equity
1000000
Browser-onlyNo external market dataNo brokerNo real order

Market Realism Visualization

Regime, spread, liquidity, slippage, and fill reason

Shows how deterministic browser-only market conditions affect the Paper Only workflow. The panel explains quote quality, liquidity, stale quotes, simulated fill / partial / reject outcomes, and paper-only PnL context without external market data.

Regime Timeline

Deterministic market state sequence

normal
0normal
Normal

Narrower spread, healthier quote size, and lower quote age.

Trending

Directional deterministic price movement with moderate liquidity.

Volatile

Wider spread, larger price movement, and lower liquidity score.

Illiquid

Limited bid / ask size can cause partial fill or reject outcomes.

Stale quote

Older quote snapshots are rejected by paper risk guardrails.

Quote Quality

Spread, liquidity, quote age, and slippage meters

Spread0.2
Liquidity score0.82
Quote age1
Slippage estimate0.01
Bid size
7
Ask size
9
Volatility path
4

Fill Explanation

Why the simulated paper order filled, partially filled, or rejected

Simulate a Paper Only order to see the fill outcome and market-condition explanation.

Fill reason

No order has been simulated yet. Generate a tick, run the mock strategy, then simulate a Paper Only order.

Paper PnL Context

Position and mark-to-market context

Position
0
Average price
N/A
Mark price
19998
Unrealized PnL
0

PnL values are simulated browser-only workflow output. They are not investment advice or a performance claim.

Browser-onlyPaper OnlyNo external market dataNo brokerNo real orderNo credentialsNot investment advice

Browser-only mock demo is ready. No backend is required.

Session

Browser-local 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

Market Data

Deterministic browser price path

Market regimes: normal, trending, volatile, illiquid, stale_quote.

SymbolMarket regimeBidAskSpreadLastChangeQuote ageLiquidity score
TXnormal1999920000119999.5010.78
MTXnormal19998.2519998.750.519998.5010.82
TMFnormal19997.919998.10.219998010.82

Active snapshot: TMF 19998 · Market regime: normal · Spread: 0.2 · Liquidity score: 0.82 · Quote age: 1

Strategy

Signal-only strategy output

Generate a tick and run the mock strategy to see a StrategySignal.

Paper Order

Browser-only paper workflow result

Run a strategy, then simulate a paper order to see Risk / OMS / paper fill results.

Market Realism

Spread, liquidity, quote age, and slippage model

Market regime
normal
Spread
0.2
Liquidity score
0.82
Volatility path
4
Slippage estimate
0.01
Fill reason
Run a strategy, then simulate a paper order to see Risk / OMS / paper fill results.

Simulated Metrics

Paper-only portfolio and PnL

Position
0
Average price
N/A
Unrealized PnL
0
Paper equity
1000000
Performance claim
false

Demo Timeline

Browser session events

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

Safety

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

This runtime uses only browser local state and localStorage. It does not upload data, write a database, call a broker, or create a real order. Live trading stays disabled.

Feedback Capture

Interactive Demo feedback

After completing the browser-only walkthrough, copy a structured feedback pack for manual review. Nothing is submitted, uploaded, stored in a database, or sent to a broker.

Browser-onlyNo backend submitNo DB writeNo email or phoneNo broker accountNo credentialsNo trading recordNot investment adviceNo live trading
Complete Generate market tick, Run mock strategy, and Simulate Paper Only order to unlock the feedback pack.

Suggested feedback questions

  • Which step did you complete?
  • Which operation was unclear?
  • Which information was most useful?
  • Which screen was hardest to understand?
  • What feature should be added next?
  • Do you understand this is a Paper Only / Mock Demo?

Manual feedback pack

Use this copy-paste pack when reporting UX issues, unclear steps, product questions, or browser-only runtime problems.

This panel only prepares text for manual feedback. Do not include broker account details, passwords, API keys, credential files, real orders, real balances, real positions, or private trading records.

Warnings

Demo boundaries

  • 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.

Paper Execution

Paper simulation approval workflow

Read-only view of the controlled path from StrategySignal to PaperOrderIntent, Risk Engine, OMS, Paper Broker Gateway, and audit events. This UI does not submit simulations or expose live controls.

Backend paper execution status unavailable. Rendering safe fallback: fetch failed

Approval States

Allowed review outcomes

  • Research approved
  • Approved for paper simulation
  • Rejected
  • Needs data review

Paper Path

Required simulation route

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

Safety State

Paper Only, no live controls

A platform-created PaperOrderIntent may be simulated only after paper review. It remains separate from live trading and never calls a real broker.

TRADING_MODE=paperENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperBROKER_API_CALLED=falsePersistence: sqliteLOCAL_ONLY=true
Runs: 0OMS events: 0Audit events: 0Execution reports: 0Outbox metadata: 0Production OMS ready: falseLocal DB: data/paper_execution_audit.sqlite

Paper Risk Engine

Paper risk guardrail expansion

Read-only status for expanded paper-only Risk Engine checks: price reasonability, contract size, margin proxy, duplicate order prevention, daily loss, position limits, kill switch, and simulated broker heartbeat.

Backend paper risk status unavailable. Rendering safe fallback: fetch failed

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

Guardrails

Expanded pre-trade and in-trade checks

  • price_reasonability rejects paper prices outside the configured reference band.
  • max_order_size_by_contract caps TX / MTX / TMF paper quantity.
  • margin_proxy blocks paper exposure that exceeds the local margin proxy.
  • duplicate_order_prevention rejects previously seen idempotency keys.
  • daily_loss_state_tracking and position_limit_tracking use local paper state only.
  • kill_switch_status and broker_heartbeat_status are simulated paper placeholders.

Policy

Paper-only risk policy

Max TX-equivalent exposure
0.25
Stale quote seconds
3
Price reasonability band
2.00%
Max margin proxy
50000 TWD
Max position TX-equivalent
0.25
Max daily loss
5000 TWD

Local State

Paper risk state snapshot

Daily realized loss state
0 TWD
Current position TX-equivalent
0
Seen idempotency keys
0
Updated at
fallback

Contract Limits

Max order size by contract

TX
1
MTX
4
TMF
20

Check Names

RiskEvaluation check detail keys

LIVE_TRADING_DISABLEDPAPER_BROKER_ONLYIDEMPOTENCY_KEY_PRESENTPAPER_ONLY_INTENTMAX_EXPOSURESTALE_QUOTEPRICE_REASONABILITYMAX_ORDER_SIZE_BY_CONTRACTMARGIN_PROXYDUPLICATE_ORDER_PREVENTIONDAILY_LOSS_LIMITPOSITION_LIMITKILL_SWITCHBROKER_HEARTBEAT

Read-only guardrail surface. It does not submit orders, approve execution, write databases, call brokers, collect credentials, turn live trading on, or provide investment advice.

Paper Risk Boundary

Paper risk cross-account readiness

Read-only boundary showing that current Risk Engine guardrails use local paper state only. They are not a formal cross-account risk system, account hierarchy, margin feed, or centralized risk limit service.

Backend cross-account risk readiness unavailable. Rendering safe fallback: fetch failed

Readiness State

Local paper risk, not cross-account risk

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: falseLocal paper state: truePaper guardrails: true

Current Capabilities

Implemented local paper scope

local_paper_guardrails_enabledtruelocal_paper_state_enabledtruesingle_account_demo_state_enabledtruerisk_evaluation_detail_enabledtrueduplicate_idempotency_local_check_enabledtrue

Non-production Gaps

Missing cross-account controls

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

Current Scope

What exists today

  • 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.

Missing Controls

Required for cross-account risk

  • 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.

Before Production

Required implementation path

  • 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.

Warnings

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.

Safety Flags

Paper-only risk boundary

paper_onlytrueread_onlytruelive_trading_enabledfalsebroker_api_calledfalseexternal_account_data_loadedfalsereal_account_data_loadedfalseorder_createdfalsecredentials_collectedfalsedatabase_writtenfalsehosted_datastore_writtenfalseproduction_risk_approvalfalseproduction_cross_account_riskfalse

Read-only readiness surface. It does not create orders, write databases, load real account data, call brokers, collect credentials, grant production risk approval, or provide investment advice.

Mock Backend

Mock Backend Demo MVP

Runs deterministic mock market data, signal-only strategy simulation, PaperOrderIntent risk checks, OMS lifecycle, paper broker simulation, and a paper-only portfolio summary. It uses no broker, no real money, no external market data, and no live trading.

Paper OnlyMock BackendNo brokerNo real moneyNo live tradingNot investment advice

Mock Backend is ready for a Paper Only demo.

Market Data

Deterministic TX / MTX / TMF price path

SymbolBidAskLastChangeQuote age

Strategy

Signal-only strategy output

Run the mock strategy to generate a StrategySignal.

Paper Order

Paper workflow result

Simulate a paper order to inspect OMS and portfolio output.

Portfolio

Paper-only account summary

Position
0
Average price
N/A
Unrealized PnL
0
Paper equity
1000000

Safety

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

This panel calls only /api/mock-backend/* endpoints. It does not collect credentials, write production data, call a real broker, create a real order, or provide investment advice.

Warnings

Demo boundaries

    Paper Approval Queue

    Paper-only approval queue and history

    Read-only view of persisted paper approval requests, reviewer history, required review sequence, hash-chain references, and safety flags. This panel does not submit decisions, approve execution, collect credentials, or call brokers.

    Backend paper approval data unavailable. Rendering safe fallback: fetch failed; fetch failed; fetch failed

    Approval Status

    Local paper governance state

    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
    Approval mode
    paper_only_local_approval_foundation
    Reviewer roles
    research_reviewer, risk_reviewer, compliance_reviewer
    Supported decisions
    research_approved, approved_for_paper_simulation, rejected, needs_data_review
    Record policy
    Append-only local SQLite records with hash chaining. This is not a production WORM ledger or production identity system.

    Pending Queue

    Pending approval requests

    No pending paper approval requests are available.

    Reviewer History

    Approval history and hash-chain references

    No paper approval history is available.

    Read-only approval surface. It does not create approval requests, submit reviewer decisions, write databases, call brokers, collect credentials, create orders, or grant live-trading access.

    Compliance Approval Boundary

    Local paper scaffolding, not formal compliance approval

    Read-only readiness view showing that the current approval workflow is local Paper Only scaffolding. It is not a formal compliance approval system and does not grant paper execution or live approval by itself.

    Backend paper compliance approval readiness unavailable. Rendering safe fallback: fetch failed

    Read-only 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.

    Readiness state: local_paper_scaffolding_not_formal_compliance_system

    Approval scaffolding

    Local paper approval queue enabledtrueLocal SQLite persistence enabledtrueLocal dual-review rule enabledtrueFormal compliance approval enabledfalseProduction approval authorityfalseReviewer identity verifiedfalseRBAC/ABAC enforcedfalseSegregation of duties enforcedfalseCompliance policy engine enabledfalseApproval policy versioning enabledfalseTenant-scoped approval records enabledfalseLegal retention policy enforcedfalse

    Audit posture

    Local hash-chain enabledtrueWORM ledger enabledfalseImmutable audit log enabledfalseCentralized audit service enabledfalseSigned approval records enabledfalseExternal timestamping enabledfalseRetention policy enforcedfalseProduction compliance archive enabledfalse

    Safety defaults

    TRADING_MODEpaperENABLE_LIVE_TRADINGfalseBROKER_PROVIDERpaper

    Current local paper scope

    • Local Paper Only approval queue and history for demos and technical testing.
    • Local SQLite persistence with hash-chain references for paper approval decisions.
    • Controlled Paper Submit can reference a persisted approval_request_id.
    • Web Command Center can create local paper requests and decisions for paper simulation only.

    Missing for formal compliance

    • Real reviewer login and verified reviewer identity.
    • Formal RBAC/ABAC enforcement for approval authority.
    • Tenant-scoped customer accounts and hosted approval records.
    • Compliance policy engine with versioned approval rules.
    • Segregation of duties enforced by identity and authorization controls.
    • Immutable WORM ledger or centralized compliance audit service.
    • Signed approval records, external timestamping, and retention policy enforcement.
    • Legal, regulatory, security, and operations review for customer-facing approval workflows.

    Required before formal approval

    • Select and review an authentication provider.
    • Implement reviewer identity, session lifecycle, MFA, and logout behavior.
    • Implement tenant-scoped customer accounts and membership records.
    • Enforce RBAC/ABAC for reviewer, risk, compliance, and paper operator roles.
    • Define and version compliance approval policies.
    • Implement WORM or centralized immutable audit storage.
    • Implement signed approval records and tamper-evident export.
    • Complete legal/regulatory review before presenting any approval as formal compliance approval.

    Safety flags

    paper_onlytrueread_onlytruelive_trading_enabledfalsebroker_providerpaperbroker_api_calledfalseorder_createdfalsecredentials_collectedfalsebroker_credentials_collectedfalsedatabase_writtenfalseexternal_db_writtenfalseproduction_compliance_approvalfalselive_approval_grantedfalsepaper_execution_approval_grantedfalseproduction_trading_readyfalse

    Paper-only decisions

    • research_approved
    • approved_for_paper_simulation
    • rejected
    • needs_data_review

    Boundary warnings

    • This endpoint is read-only compliance approval readiness metadata only.
    • The local paper approval workflow is not formal compliance approval, not legal approval, and not live trading approval.
    • It does not enable live trading, write databases, collect credentials, call brokers, or create orders.
    • Production Trading Platform remains NOT READY.

    Paper Approval Request

    Create a paper-only approval request

    Creates one local approval request for a StrategySignal. This is the paper-only starting point for reviewer workflow and does not create orders, call Risk Engine, call OMS, collect credentials, or connect brokers.

    Paper Only requestENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperNo order created
    • Paper Only: calls only /api/paper-execution/approvals/requests.
    • Request creation starts at pending_review and does not create reviewer decisions.
    • StrategySignal remains signals-only and does not call Risk Engine, OMS, Broker Gateway, or brokers.
    • No live approval, credential upload, account login, broker connection, paper simulation, or real order is available in this step.

    Paper Approval Decision

    Record a paper-only reviewer decision

    Creates one reviewer decision for an existing local approval request. This form is paper-only, writes only the local approval decision record, and does not create orders, collect credentials, or call brokers.

    Paper Only decisionENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperNo credentials

    No actionable approval requests are available. Create a local paper approval request before recording reviewer decisions.

    • Paper Only: calls only the local approval decision endpoint for an existing approval_request_id.
    • This form records reviewer decisions only. It does not create paper simulations, orders, or paper execution approval by itself.
    • Dual review still requires distinct reviewer IDs and the backend validates the required sequence.
    • No live approval, credential upload, account login, broker connection, or real order path is available.

    Controlled Paper Submit

    Create a paper simulation record

    Creates one Paper Only simulation through the backend workflow record API only when the selected persisted approval_request_id has completed the required review sequence. It cannot approve live trading, collect credentials, or call a real broker.

    Paper Only submitENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperPersisted approval required

    Submit is disabled until a persisted approval_request_id reaches approved_for_paper_simulation.

    • Paper Only: calls /api/paper-execution/workflow/record only with a persisted approval_request_id.
    • The selected approval request must already be approved_for_paper_simulation through the local approval queue.
    • StrategySignal remains the approved signal payload and cannot call broker, Risk Engine, or OMS directly.
    • No live approval, no credential upload, no account login, and no real broker connection.

    Paper Broker Simulation

    Local quote-based simulation preview

    Preview how a Paper Broker Gateway outcome can be derived from caller-provided local quote and liquidity inputs. This does not submit orders, download market data, write databases, or call a broker.

    Paper OnlyENABLE_LIVE_TRADING=falseBROKER_PROVIDER=paperPreview only
    • Paper Only: calls /api/paper-execution/broker-simulation/preview only.
    • Inputs are caller-provided local quote snapshots; no external market data is downloaded.
    • The preview does not create orders, write databases, call Risk Engine, call OMS, or call a real broker.
    • This is not a production matching engine, broker execution report, live liquidity model, or trading recommendation.

    Adjust local quote inputs and preview a paper-only simulated broker outcome.

    Broker Simulation Readiness

    Paper broker simulation is not market matching

    Read-only boundary for deterministic and local quote-based paper simulation. Paper fills are simulated metadata only, not real market fills, broker execution reports, or production execution modeling.

    Backend paper broker simulation readiness data unavailable. Rendering safe fallback: fetch failed

    Readiness Status

    Current broker simulation boundary

    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: falseLocal quote preview: trueDeterministic simulation: true

    Current Paper Capabilities

    Local paper simulation

    DETERMINISTIC_SIMULATIONtrueLOCAL_QUOTE_PREVIEWtruePAPER_OUTCOMEStrueCALLER_PROVIDED_QUOTE_ONLYtrue

    Production Execution Gaps

    Controls not enabled

    REAL_MARKET_MATCHING_ENGINEfalseEXCHANGE_ORDER_BOOK_REPLAYfalseBROKER_EXECUTION_REPORT_MODELfalseLATENCY_QUEUE_POSITION_MODELfalseSLIPPAGE_LIQUIDITY_CALIBRATIONfalseREAL_ACCOUNT_RECONCILIATIONfalsePRODUCTION_EXECUTION_MODELfalse

    Current Scope

    What exists today

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

    Missing Controls

    Needed for production execution modeling

    • 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.

    Before Production Execution Model

    Required implementation and review

    • 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.

    Warnings

    Broker simulation readiness notes

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

    Safety Flags

    Read-only paper boundary

    PAPER_ONLYtrueREAD_ONLYtrueLIVE_TRADING_FLAGfalseBROKER_API_CALLEDfalseEXTERNAL_MARKET_DATA_DOWNLOADEDfalseREAL_ORDER_CREATEDfalseORDER_CREATEDfalseCREDENTIALS_COLLECTEDfalseDATABASE_WRITTENfalsePRODUCTION_EXECUTION_MODELfalse

    Read-only broker simulation readiness surface. It does not create orders, call Risk Engine, call OMS, call Broker Gateway execution paths, write databases, download market data, call brokers, collect credentials, or claim real fill accuracy.

    Broker Simulation Evidence

    Paper broker simulation evidence viewer

    Read-only local JSON viewer for evidence exported by make paper-broker-simulation-evidence-export. Files are parsed in this browser only and are not uploaded, persisted, or sent to backend APIs.

    Current source: No local broker simulation evidence loaded

    Select an explicit local paper broker simulation evidence JSON to inspect it in this browser.

    No local broker simulation evidence is loaded. Export one with make paper-broker-simulation-evidence-export and select the JSON file explicitly.

    Paper OMS / Audit

    Persisted paper workflow records

    Read-only local SQLite audit view for paper workflow runs, OMS events, and audit events. This view does not create records, submit simulations, connect brokers, or grant live-trading approval.

    Backend paper record query unavailable. Rendering safe empty state: fetch failed

    Paper Runs

    Latest persisted workflows

    No local paper workflow records are available yet.

    Selected Run

    Audit context

    No workflow run is selected.

    Timeline ready

    OMS Timeline

    Paper order lifecycle

    No OMS events are available for the selected paper workflow.

    Audit Timeline

    Paper workflow audit events

    No audit events are available for the selected paper workflow.

    Read-only audit surface. It does not write databases, alter persisted records, call brokers, create orders, escalate approvals, or provide trading advice.

    Paper OMS Reliability

    Paper OMS reliability metadata

    Read-only reliability view for local paper OMS metadata: outbox records, idempotency keys, execution reports, timeout candidates, and explicit non-production gaps. It does not process orders, write records, or contact brokers.

    Backend paper OMS reliability data unavailable. Rendering safe fallback: fetch failed; fetch failed; fetch failed

    Reliability Status

    Local paper OMS foundation

    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

    Safety Flags

    Paper-only reliability boundary

    PAPER_ONLYtrueLIVE_TRADING_FLAGfalseBROKER_API_CALLEDfalsePRODUCTION_OMS_READYfalseLOCAL_SQLITE_ONLYtrueASYNC_ORDER_PROCESSINGfalse

    Local Capabilities

    Implemented metadata checks

    LOCAL_OUTBOX_METADATAtrueDUPLICATE_ORDER_PREVENTIONtrueTIMEOUT_CANDIDATE_SCANtrueEXECUTION_REPORT_MODELtrueAMEND_REPLACEfalseRECONCILIATION_LOOPfalse

    Non-production Gaps

    Not a 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

    Latest local outbox records

    No local outbox metadata is available.

    Execution Reports

    Latest selected-order execution reports

    Latest selected order: None

    No execution reports are available for the selected order.

    Timeout Scan

    Paper timeout candidates

    Timeout handling is an explicit paper-only action. Preview validates the local EXPIRE metadata first; Mark writes only local SQLite OMS, audit, and execution-report metadata.

    No paper timeout candidates are available.

    Read-only reliability surface. It does not mutate OMS state, submit orders, process outbox workers, approve execution, write databases, call brokers, collect credentials, or provide investment advice.

    Paper OMS Readiness

    Paper OMS is not a production OMS

    Read-only production readiness boundary for the local Paper OMS. The current system has deterministic paper state transitions and local metadata, but not durable async processing, production timeout workers, amend/replace, broker execution report ingestion, or formal reconciliation.

    Backend Paper OMS production readiness data unavailable. Rendering safe fallback: fetch failed

    Readiness Status

    Current production OMS boundary

    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: falseLocal SQLite metadata: trueState machine: true

    Current Paper Capabilities

    Local paper scaffolding

    ORDER_STATE_MACHINEtrueLOCAL_OUTBOX_METADATAtrueDUPLICATE_IDEMPOTENCY_METADATAtrueEXECUTION_REPORT_METADATAtrueTIMEOUT_CANDIDATE_SCANtrueEXPLICIT_PAPER_TIMEOUT_MARKtrue

    Production OMS Gaps

    Controls not enabled

    ASYNC_ORDER_PROCESSINGfalseDISTRIBUTED_DURABLE_QUEUEfalseOUTBOX_WORKERfalseFULL_TIMEOUT_WORKERfalseAMEND_REPLACEfalseBROKER_EXECUTION_REPORT_INGESTIONfalseFORMAL_RECONCILIATION_LOOPfalse

    Current Scope

    What exists today

    • 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.

    Missing Controls

    Needed for 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.

    Before Production OMS

    Required implementation and review

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

    Warnings

    OMS readiness notes

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

    Safety Flags

    Read-only paper boundary

    PAPER_ONLYtrueREAD_ONLYtrueLIVE_TRADING_ENABLEDfalseBROKER_API_CALLEDfalseORDER_CREATEDfalseCREDENTIALS_COLLECTEDfalseDATABASE_WRITTENfalsePRODUCTION_OMS_READYfalseLIVE_APPROVAL_GRANTEDfalse

    Read-only production OMS readiness surface. It does not submit orders, process queues, mutate OMS state, approve execution, write databases, call brokers, collect credentials, or turn on live trading.

    Paper Audit Integrity

    Local audit hash-chain verification

    Read-only verification preview for local SQLite paper audit events. It checks stored previous_hash and event_hash metadata, but it is not WORM storage, centralized audit, signing, or production compliance.

    Backend paper audit integrity data unavailable. Rendering safe fallback: fetch failed; fetch failed

    Integrity Status

    Local audit verification preview

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

    Verified: trueAudit events: 0Broken chains: 0Missing hashes: 0

    Safety Flags

    Not a production audit ledger

    PAPER_ONLYtrueLOCAL_SQLITE_ONLYtrueLIVE_TRADING_FLAGfalseBROKER_API_CALLEDfalseWORM_LEDGERfalseCENTRALIZED_AUDIT_SERVICEfalse

    Event Checks

    Latest hash-chain checks

    No local paper audit events are available to verify.

    Known Gaps

    Non-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.

    Warnings

    Verification notes

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

    Read-only audit integrity surface. It does not write databases, repair chains, upload records, call brokers, collect credentials, create orders, grant live approval, or claim WORM / immutable audit compliance.

    Paper Audit WORM Readiness

    SQLite audit is not a production WORM ledger

    Read-only readiness boundary for the audit storage posture. Local SQLite with hash-chain metadata is useful for paper demos, but it is not WORM storage, an immutable ledger, centralized audit, signing, or production compliance.

    Backend WORM readiness data unavailable. Rendering safe fallback: fetch failed

    Readiness Status

    Current audit storage boundary

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

    Readiness state: local_sqlite_not_production_worm_ledgerLocal SQLite audit: trueLocal hash chain: trueWORM storage: false

    Production WORM Gaps

    Controls not enabled

    WORM_STORAGE_ENABLEDfalseIMMUTABLE_LEDGER_ENABLEDfalseAPPEND_ONLY_STORAGE_ENFORCEDfalseCENTRALIZED_AUDIT_SERVICE_ENABLEDfalseOBJECT_LOCK_ENABLEDfalseEXTERNAL_TIMESTAMPING_ENABLEDfalseCRYPTOGRAPHIC_SIGNING_ENABLEDfalseRETENTION_POLICY_ENFORCEDfalse

    Current Scope

    What exists today

    • 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.

    Missing Controls

    Needed for production WORM posture

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

    Before Any WORM Claim

    Required review and implementation

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

    Safety Flags

    Read-only paper boundary

    PAPER_ONLYtrueREAD_ONLYtrueLIVE_TRADING_ENABLEDfalseBROKER_API_CALLEDfalseORDER_CREATEDfalseCREDENTIALS_COLLECTEDfalseDATABASE_WRITTENfalseWORM_COMPLIANCE_CLAIMfalsePRODUCTION_AUDIT_COMPLIANCEfalse

    Warnings

    Audit posture notes

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

    Read-only WORM readiness surface. It does not write databases, upload audit records, repair chains, call brokers, collect credentials, create orders, grant live approval, or claim WORM / immutable audit compliance.

    Audit Integrity Evidence

    Paper audit integrity evidence viewer

    Read-only local JSON viewer for evidence exported by scripts/verify-paper-audit-integrity.py. Files are parsed in this browser only and are not uploaded, persisted, or sent to backend APIs.

    Current source: No local audit integrity evidence loaded

    Select an explicit local paper audit integrity verification JSON to inspect it in this browser.

    No local audit integrity evidence loaded. Run scripts/verify-paper-audit-integrity.py with --output, then explicitly select the JSON file.

    Demo Evidence

    Paper demo evidence viewer

    Read-only local JSON viewer for evidence exported by make paper-demo-evidence-export. Files are parsed in this browser only and are not uploaded, persisted, or sent to backend APIs.

    Current source: No local evidence loaded

    Select an explicit local paper demo evidence JSON to inspect it in this browser.

    No local demo evidence is loaded. Export one with make paper-demo-evidence-export and select the JSON file explicitly.