Architecture (State 002 Edge Proxy Uncontainerized)

State 002 keeps uncontainerized services and introduces an edge proxy as the single browser-facing entrypoint.

• Inherits architectural baseline from: 001-baseline-uncontainerized-parity
• Generated from: system/architecture.model.json
• Canonical flows: ../001-baseline-uncontainerized-parity/system/end-to-end-flows.md

Entry Points

• edge-proxy: http://localhost:18080
• angular-upstream: http://localhost:18093

Architecture Diagram

Diagram source

flowchart LR
  trader["Trader Browser"]
  edge["Edge Proxy"]
  web["Web Front End Angular"]
  account["Account Service"]
  position["Position Service"]
  tradeService["Trade Service"]
  referenceData["Reference Data"]
  people["People Service"]
  tradeFeed["Trade Feed"]
  tradeProcessor["Trade Processor"]
  database["Database"]
  trader -->|"Single browser entrypoint"| edge
  edge -->|"/"| web
  edge -->|"/account-service"| account
  edge -->|"/position-service"| position
  edge -->|"/trade-service"| tradeService
  edge -->|"/reference-data"| referenceData
  edge -->|"/people-service"| people
  edge -->|"/socket.io"| tradeFeed
  tradeService -->|"Validate account"| account
  tradeService -->|"Validate ticker"| referenceData
  tradeService -->|"Publish trades/new"| tradeFeed
  tradeProcessor -->|"Consume and publish updates"| tradeFeed
  tradeProcessor -->|"Persist trade/position state"| database
  account -->|"Validate person for account-user mapping"| people
  account -->|"Account persistence"| database
  position -->|"Query trades/positions"| database

Node Catalog

Node	Kind	Label	Notes
trader	actor	Trader Browser	User enters only through edge proxy.
edge	gateway	Edge Proxy	Single browser-facing origin.
web	frontend	Web Front End Angular	Served behind edge proxy.
account	service	Account Service	Account and account-user CRUD.
position	service	Position Service	Trades and positions query endpoints.
tradeService	service	Trade Service	Trade submission and validation.
referenceData	service	Reference Data	Ticker lookup/list.
people	service	People Service	Directory lookup and validation.
tradeFeed	messaging	Trade Feed	Socket.IO publish/subscribe bus.
tradeProcessor	service	Trade Processor	Processes new trades and updates positions.
database	database	Database	Persistent account, trade, and position state.

State Notes

• State 002 preserves baseline functional flows F1-F6.
• Primary delta is topology and origin model, not business behavior.