Architecture (State 010 Kubernetes Runtime)

State 010 preserves state 009 browser/API routing behavior while running all services on a local Kubernetes cluster.

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

Entry Points

• edge-proxy: http://localhost:8080
• edge-health: http://localhost:8080/health
• grafana: http://localhost:8080/grafana
• prometheus: http://localhost:8080/prometheus

Architecture Diagram

Node Catalog

Node	Kind	Label	Notes
developer	actor	Developer	Runs local Kind-based Kubernetes runtime.
cluster	boundary	Kind Kubernetes Cluster	Local cluster namespace and workloads.
edge	gateway	NGINX Edge Proxy	Single browser entrypoint for UI/API/WebSocket routes.
web	frontend	Web Front End Angular	Angular frontend served behind edge proxy.
account	service	Account Service	Account and account-user APIs.
position	service	Position Service	Positions and trades query API.
tradeService	service	Trade Service	Trade order submission and validation.
referenceData	service	Reference Data	Ticker metadata lookup.
people	service	People Service	Person lookup and matching APIs.
nats	messaging	NATS Broker	Messaging backbone for trade, position, pricing, and order lifecycle streams.
tradeProcessor	service	Trade Processor	Consumes trade events and persists settled state.
database	database	Database	PostgreSQL persistence service.
grafana	observability	Grafana	Dashboard and observability visualization UI.
prometheus	observability	Prometheus	Metrics collection and query engine.

State Notes

• Functional behavior remains intentionally equivalent to state 009.
• Primary delta is runtime/operations model (Compose to Kubernetes).
• Edge proxy remains NGINX-based to keep route semantics stable.
• Observability stack from state 009 remains available in Kubernetes runtime.