Architecture (State 005 PostgreSQL Database Replacement)

State 005 replaces H2 database runtime with PostgreSQL while preserving state 004 containerized ingress topology and baseline flows.

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

Entry Points

• ingress: http://localhost:8080
• postgres: postgres://localhost:18083/traderx

Architecture Diagram

Diagram source

flowchart LR
  trader["Trader Browser"]
  ingress["NGINX Ingress"]
  web["Web Front End Angular"]
  referenceData["Reference Data"]
  tradeFeed["Trade Feed"]
  people["People Service"]
  account["Account Service"]
  position["Position Service"]
  tradeProcessor["Trade Processor"]
  tradeService["Trade Service"]
  database["PostgreSQL Database"]
  trader -->|"Single browser entrypoint"| ingress
  ingress -->|"/"| web
  ingress -->|"/account-service"| account
  ingress -->|"/position-service"| position
  ingress -->|"/trade-service"| tradeService
  ingress -->|"/reference-data"| referenceData
  ingress -->|"/people-service"| people
  ingress -->|"/trade-feed (WS)"| tradeFeed
  tradeService -->|"Validate account"| account
  tradeService -->|"Validate ticker"| referenceData
  tradeService -->|"Publish trade event"| tradeFeed
  tradeProcessor -->|"Consume/publish account updates"| tradeFeed
  account -->|"Validate person"| people
  account -->|"Read/write account data"| database
  position -->|"Read positions/trades"| database
  tradeProcessor -->|"Persist processed trades/positions"| database

Node Catalog

Node	Kind	Label	Notes
trader	actor	Trader Browser	Uses Angular UI via ingress.
ingress	gateway	NGINX Ingress	Single browser entrypoint for UI + API + websocket.
web	frontend	Web Front End Angular	TraderX UI.
referenceData	service	Reference Data	Ticker lookup/list.
tradeFeed	messaging	Trade Feed	Socket.IO pub/sub layer (unchanged from state 004).
people	service	People Service	Identity lookup and validation.
account	service	Account Service	Account and account-user operations using PostgreSQL.
position	service	Position Service	Trades/positions query operations using PostgreSQL.
tradeProcessor	service	Trade Processor	Trade processing and persistence using PostgreSQL.
tradeService	service	Trade Service	Trade submission and validation.
database	database	PostgreSQL Database	Persistent account/trade/position state.

State Notes

• State 005 is an architecture-track branch from state 004.
• Only database engine/runtime is replaced; functional API and messaging contracts remain stable.
• H2 web console is removed from runtime expectations in this state.