# Order Management and Matcher

> For the complete documentation index, see [llms.txt](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/llms.txt).

Pricing + observability runtime extended with order management, matcher flow, and order-specific telemetry.

*   Generated from: `system/architecture.model.json`
*   Canonical flows: `system/end-to-end-flows.md`

## Architecture Diagram

Diagram source

```mermaid
flowchart LR
  developer["Developer"]
  app_runtime["TraderX App Runtime"]
  obs_runtime["Observability Runtime"]
  ingress["NGINX Ingress"]
  trade_ui["Angular Trade UI"]
  order_api["Order Management API"]
  order_matcher["Order Matcher"]
  nats["NATS Broker"]
  trade_processor["Trade Processor"]
  prometheus["Prometheus"]
  blackbox["Blackbox Exporter"]
  loki["Loki"]
  grafana["Grafana"]
  developer -->|"Uses app and admin UI"| ingress
  ingress -->|"Serves UI"| trade_ui
  trade_ui -->|"Calls order APIs"| order_api
  order_api -->|"Submits and updates orders"| order_matcher
  order_api -->|"Publishes lifecycle events"| nats
  order_matcher -->|"Publishes fills and status"| nats
  nats -->|"Delivers matcher-generated fills"| trade_processor
  prometheus -->|"Scrapes /metrics"| order_matcher
  prometheus -->|"Scrapes probe metrics"| blackbox
  blackbox -->|"HTTP probes"| order_api
  blackbox -->|"HTTP probes"| order_matcher
  order_matcher -->|"Structured logs via promtail"| loki
  developer -->|"Views order observability"| grafana
  grafana -->|"Queries metrics"| prometheus
  grafana -->|"Queries logs"| loki
```

## Node Catalog

| Node | Kind | Label | Notes |
| --- | --- | --- | --- |
| `developer` | actor | Developer | Local developer using this state. |
| `app_runtime` | boundary | TraderX App Runtime | State 009 pricing/runtime baseline with order-management extensions. |
| `obs_runtime` | boundary | Observability Runtime | LGTM + OTel stack from state 007 carried forward with order telemetry coverage. |
| `ingress` | service | NGINX Ingress | Routes UI, API, and order admin traffic. |
| `trade_ui` | service | Angular Trade UI | Trade ticket, blotters, and admin tab. |
| `order_api` | service | Order Management API | Order create/query/edit/cancel/force-fill endpoints. |
| `order_matcher` | service | Order Matcher | Matches open orders and emits order lifecycle + fill events. |
| `nats` | service | NATS Broker | Realtime transport for pricing, trade, position, and order subjects. |
| `trade_processor` | service | Trade Processor | Consumes fills and persists trades/positions. |
| `prometheus` | service | Prometheus | Scrapes order metrics and blackbox probes. |
| `blackbox` | service | Blackbox Exporter | Probes order endpoints and inherited runtime endpoints. |
| `loki` | service | Loki | Aggregates order and runtime logs. |
| `grafana` | service | Grafana | Dashboards for queue depth, open orders, events, and matcher latency. |