Target Production Architecture

Logical architecture

Experience plane
  Flutter live call · officer portal · administration
        ↓ WebRTC / HTTPS
Media plane
  LiveKit SFU · TURN/TLS · room auth · network telemetry
        ↓ audio events / selected video evidence
Realtime agent plane
  streaming STT/TTS · interruption · frame sampler · camera guidance
        ↓ durable case commands
Application and reasoning plane
  case service · reasoning agent · tool loop · notifications
        ├── model gateway
        ├── hierarchical retrieval / research
        ├── weather / soil / terrain / field history
        ├── exact policy verification
        └── human review / live join coordinator
Data and governance plane
  PostgreSQL/PostGIS · object storage · audit · analytics

Live media plane

• LiveKit handles rooms, participants, audio/video tracks, adaptive subscription, TURN and connection telemetry.
• Agent workers subscribe to audio continuously and video according to sampling policy.
• Full-resolution diagnostic stills use a separate authenticated capture/upload path.
• Officer join uses the same room and role-scoped tokens.
• Recording/egress is disabled unless a purpose-specific policy enables it.

Scaling domains

Scale independently: SFU/TURN nodes, realtime agent workers, STT connections, TTS streams, video samplers, reasoning calls, research jobs, retrieval, PostgreSQL, object storage and officer operations.

Provider gateway

All STT, TTS, reasoning, vision, embedding and search calls pass through internal adapters that manage model version, redaction, selected-frame limits, schema validation, timeouts, quotas, cost and fallback.

Target options