goex

Event-driven trading platform with gRPC services, Kafka event flow, and PostgreSQL persistence.

Architecture

sequenceDiagram
    participant Client
    participant Gateway
    participant OrderIngest
    participant Risk
    participant Ledger
    participant Kafka
    participant Matching
    participant MarketData

    Client->>Gateway: POST /orders
    Gateway->>OrderIngest: Submit order
    OrderIngest->>Risk: PreTradeCheck (gRPC)
    Risk-->>OrderIngest: Allowed/Denied
    OrderIngest->>Ledger: ReserveBalance (gRPC)
    Ledger-->>OrderIngest: Reserved
    OrderIngest->>Kafka: orders.accepted
    Kafka->>Matching: orders.accepted
    Matching->>Kafka: trades.executed
    Kafka->>Ledger: trades.executed
    Kafka->>MarketData: trades.executed
    Ledger->>Kafka: ledger.entries, balances.updated

Loading

Local Development

1. make dev-start
2. make dev-verify
3. make dev-test

Trader UI (React/Vite):

cd web && npm install && npm run dev

Open http://localhost:5173 — demo@example.com / demo123.

Compose UI: http://localhost:3000 (service web).

Tests

Run all tests:

./scripts/test-full.sh

Documentation

Start with docs/README.md. It identifies the authoritative source for runtime topology, HTTP/gRPC contracts, events, migrations, and local operations. ROADMAP.md is the only active project plan.