# driv-lingo/coordinate_submission architecture

> Architecture diagram of the GitHub repository driv-lingo/coordinate_submission, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/driv-lingo/coordinate_submission
- Repository: https://github.com/driv-lingo/coordinate_submission

## Overview

CoORDINATE turns resident reports into guidance and, when requested and safe, capability-matched community missions that coordinators dispatch and continually reassess. The graph preserves the separate navigation, operational-response, and live-condition workflows, plus volunteer readiness and public hazard information. README documents the live ingest and reassessment flows; sampled source confirms incident construction, route safety checks, and selected API ownership. Some internal action and provider wiring is documented but not included in the sampled source.

Main entry points: [`src/server/actions.ts`](https://github.com/driv-lingo/coordinate_submission/blob/main/src/server/actions.ts) (Response Actions), [`src/engine/pipeline.ts`](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/pipeline.ts) (Incident Pipeline), [`src/server/ops.ts`](https://github.com/driv-lingo/coordinate_submission/blob/main/src/server/ops.ts) (Operational Views), [`src/live/ingest.ts`](https://github.com/driv-lingo/coordinate_submission/blob/main/src/live/ingest.ts) (Live Ingest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Intake & Navigation"]
  node_intake_api["Intake API<br/>[route.ts]"]
  node_ai_interpretation["AI Interpretation<br/>[index.ts]"]
  node_incident_pipeline["Incident Pipeline<br/>[pipeline.ts]"]
  node_need_paths["Needs &amp; Paths<br/>[navigator.ts]"]
  node_handoffs["Guidance &amp; Handoffs<br/>[handoff.ts]"]
end

subgraph group_response["Response Operations"]
  node_ops_api["Operations API<br/>[route.ts]"]
  node_ops_actions["Response Actions<br/>[actions.ts]"]
  node_matching["Eligibility &amp; Matching<br/>[matching.ts]"]
  node_dispatch["Dispatch &amp; Lifecycle<br/>[dispatch.ts]"]
  node_reassessment["Mission Reassessment<br/>[reassess.ts]"]
  node_volunteer_api["Volunteer API<br/>[route.ts]"]
end

subgraph group_conditions["Conditions &amp; Maps"]
  node_live_ingest["Live Ingest<br/>[ingest.ts]"]
  node_source_adapters["Source Adapters<br/>[registry.ts]"]
  node_map_api["Public Hazards API<br/>[route.ts]"]
  node_route_planning["Route Planning<br/>[route.ts]"]
end

subgraph group_experience["User Workspaces"]
  node_resident_ui["Request Workspace"]
  node_ops_ui["Coordinator Workspace<br/>[OpsDashboard.tsx]"]
  node_volunteer_ui["Volunteer Workspace"]
  node_map_ui["Public Map"]
  node_preparedness_ui["Preparedness<br/>[Preparedness.tsx]"]
  node_resource_ui["Resource Board<br/>[ResourcesBoard.tsx]"]
end

subgraph group_platform["Data &amp; Services"]
  node_conditions_store[("Condition Store<br/>[repository.ts]")]
  node_realtime["Realtime Updates<br/>[pubsub.ts]"]
  node_ops_views["Operational Views<br/>[ops.ts]"]
  node_snapshot_api["Snapshot API<br/>[route.ts]"]
  node_sitrep_api["SITREP API<br/>[route.ts]"]
end

node_resident(("Resident"))
node_coordinator(("Coordinator"))
node_volunteer(("Volunteer"))
node_public(("Public"))
node_external_feeds["Operational Feeds"]
node_azure_maps["Azure Maps"]
node_foundry["Azure AI Foundry"]

node_resident -->|"submits request"| node_resident_ui
node_resident_ui -->|"sends intake"| node_intake_api
node_intake_api -->|"builds incident"| node_incident_pipeline
node_incident_pipeline -->|"requests interpretation"| node_ai_interpretation
node_ai_interpretation -.->|"interprets language"| node_foundry
node_incident_pipeline -->|"decomposes needs"| node_need_paths
node_incident_pipeline -->|"creates handoffs"| node_handoffs
node_need_paths -->|"requested needs"| node_ops_actions
node_coordinator -->|"reviews &amp; dispatches"| node_ops_ui
node_ops_ui -->|"loads operation"| node_ops_api
node_ops_api -->|"builds view"| node_ops_views
node_ops_views -->|"reassesses missions"| node_reassessment
node_ops_actions -->|"checks eligibility"| node_matching
node_ops_actions -->|"records dispatch"| node_dispatch
node_ops_actions -->|"plans route"| node_route_planning
node_route_planning -.->|"requests directions"| node_azure_maps
node_volunteer -->|"offers help"| node_volunteer_ui
node_volunteer_ui -->|"loads status"| node_volunteer_api
node_volunteer_api -->|"submits responder action"| node_ops_actions
node_external_feeds -->|"provides reports"| node_source_adapters
node_source_adapters -->|"adapts feeds"| node_live_ingest
node_live_ingest -->|"stores conditions"| node_conditions_store
node_live_ingest -->|"publishes updates"| node_realtime
node_public -->|"views hazards"| node_map_ui
node_map_ui -->|"loads hazards"| node_map_api
node_coordinator -->|"requests overview"| node_snapshot_api
node_snapshot_api -->|"builds snapshot"| node_ops_views
node_coordinator -->|"requests SITREP"| node_sitrep_api
node_sitrep_api -->|"reads operation"| node_ops_views
node_coordinator -->|"manages readiness"| node_preparedness_ui
node_coordinator -->|"reviews capacity"| node_resource_ui

click node_intake_api "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/incidents/route.ts"
click node_ai_interpretation "https://github.com/driv-lingo/coordinate_submission/blob/main/src/ai/index.ts"
click node_incident_pipeline "https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/pipeline.ts"
click node_need_paths "https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/navigator.ts"
click node_handoffs "https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/handoff.ts"
click node_ops_api "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/ops/route.ts"
click node_ops_actions "https://github.com/driv-lingo/coordinate_submission/blob/main/src/server/actions.ts"
click node_matching "https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/matching.ts"
click node_dispatch "https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/dispatch.ts"
click node_reassessment "https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/reassess.ts"
click node_volunteer_api "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/responders/%5Bid%5D/route.ts"
click node_live_ingest "https://github.com/driv-lingo/coordinate_submission/blob/main/src/live/ingest.ts"
click node_source_adapters "https://github.com/driv-lingo/coordinate_submission/blob/main/src/providers/registry.ts"
click node_conditions_store "https://github.com/driv-lingo/coordinate_submission/blob/main/src/data/repository.ts"
click node_realtime "https://github.com/driv-lingo/coordinate_submission/blob/main/src/realtime/pubsub.ts"
click node_map_api "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/public/hazards/route.ts"
click node_route_planning "https://github.com/driv-lingo/coordinate_submission/blob/main/src/maps/route.ts"
click node_ops_views "https://github.com/driv-lingo/coordinate_submission/blob/main/src/server/ops.ts"
click node_snapshot_api "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/snapshot/route.ts"
click node_sitrep_api "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/sitrep/route.ts"
click node_resident_ui "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/request/ResidentRequest.tsx"
click node_ops_ui "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/ops/OpsDashboard.tsx"
click node_volunteer_ui "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/volunteer/VolunteerDashboard.tsx"
click node_map_ui "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/map/PublicHazardMap.tsx"
click node_preparedness_ui "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/preparedness/Preparedness.tsx"
click node_resource_ui "https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/resources/ResourcesBoard.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_intake_api,node_ai_interpretation,node_incident_pipeline,node_need_paths,node_handoffs toneBlue
class node_ops_api,node_ops_actions,node_matching,node_dispatch,node_reassessment,node_volunteer_api toneAmber
class node_live_ingest,node_source_adapters,node_map_api,node_route_planning toneMint
class node_resident_ui,node_ops_ui,node_volunteer_ui,node_map_ui,node_preparedness_ui,node_resource_ui toneRose
class node_conditions_store,node_realtime,node_ops_views,node_snapshot_api,node_sitrep_api,node_resident,node_coordinator,node_volunteer,node_public,node_external_feeds,node_azure_maps,node_foundry toneIndigo
```

## Components

### Intake & Navigation

- [Intake API](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/incidents/route.ts): `src/app/api/incidents/route.ts`
- [AI Interpretation](https://github.com/driv-lingo/coordinate_submission/blob/main/src/ai/index.ts): `src/ai/index.ts`
- [Incident Pipeline](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/pipeline.ts): `src/engine/pipeline.ts`
- [Needs & Paths](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/navigator.ts): `src/engine/navigator.ts`
- [Guidance & Handoffs](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/handoff.ts): `src/engine/handoff.ts`

### Response Operations

- [Operations API](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/ops/route.ts): `src/app/api/ops/route.ts`
- [Response Actions](https://github.com/driv-lingo/coordinate_submission/blob/main/src/server/actions.ts): `src/server/actions.ts`
- [Eligibility & Matching](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/matching.ts): `src/engine/matching.ts`
- [Dispatch & Lifecycle](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/dispatch.ts): `src/engine/dispatch.ts`
- [Mission Reassessment](https://github.com/driv-lingo/coordinate_submission/blob/main/src/engine/reassess.ts): `src/engine/reassess.ts`
- [Volunteer API](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/responders/%5Bid%5D/route.ts): `src/app/api/responders/[id]/route.ts`

### Conditions & Maps

- [Live Ingest](https://github.com/driv-lingo/coordinate_submission/blob/main/src/live/ingest.ts): `src/live/ingest.ts`
- [Source Adapters](https://github.com/driv-lingo/coordinate_submission/blob/main/src/providers/registry.ts): `src/providers/registry.ts`
- [Public Hazards API](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/public/hazards/route.ts): `src/app/api/public/hazards/route.ts`
- [Route Planning](https://github.com/driv-lingo/coordinate_submission/blob/main/src/maps/route.ts): `src/maps/route.ts`

### User Workspaces

- [Request Workspace](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/request/ResidentRequest.tsx): `src/app/request/ResidentRequest.tsx`
- [Coordinator Workspace](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/ops/OpsDashboard.tsx): `src/app/ops/OpsDashboard.tsx`
- [Volunteer Workspace](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/volunteer/VolunteerDashboard.tsx): `src/app/volunteer/VolunteerDashboard.tsx`
- [Public Map](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/map/PublicHazardMap.tsx): `src/app/map/PublicHazardMap.tsx`
- [Preparedness](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/preparedness/Preparedness.tsx): `src/app/preparedness/Preparedness.tsx`
- [Resource Board](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/resources/ResourcesBoard.tsx): `src/app/resources/ResourcesBoard.tsx`

### Data & Services

- [Condition Store](https://github.com/driv-lingo/coordinate_submission/blob/main/src/data/repository.ts): `src/data/repository.ts`
- [Realtime Updates](https://github.com/driv-lingo/coordinate_submission/blob/main/src/realtime/pubsub.ts): `src/realtime/pubsub.ts`
- [Operational Views](https://github.com/driv-lingo/coordinate_submission/blob/main/src/server/ops.ts): `src/server/ops.ts`
- [Snapshot API](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/snapshot/route.ts): `src/app/api/snapshot/route.ts`
- [SITREP API](https://github.com/driv-lingo/coordinate_submission/blob/main/src/app/api/sitrep/route.ts): `src/app/api/sitrep/route.ts`

### Other components

- **Resident**
- **Coordinator**
- **Volunteer**
- **Public**
- **Operational Feeds**
- **Azure Maps**
- **Azure AI Foundry**

## Connections

- Resident → Request Workspace: submits request
- Request Workspace → Intake API: sends intake
- Intake API → Incident Pipeline: builds incident
- Incident Pipeline → AI Interpretation: requests interpretation
- AI Interpretation → Azure AI Foundry: interprets language
- Incident Pipeline → Needs & Paths: decomposes needs
- Incident Pipeline → Guidance & Handoffs: creates handoffs
- Needs & Paths → Response Actions: requested needs
- Coordinator → Coordinator Workspace: reviews & dispatches
- Coordinator Workspace → Operations API: loads operation
- Operations API → Operational Views: builds view
- Operational Views → Mission Reassessment: reassesses missions
- Response Actions → Eligibility & Matching: checks eligibility
- Response Actions → Dispatch & Lifecycle: records dispatch
- Response Actions → Route Planning: plans route
- Route Planning → Azure Maps: requests directions
- Volunteer → Volunteer Workspace: offers help
- Volunteer Workspace → Volunteer API: loads status
- Volunteer API → Response Actions: submits responder action
- Operational Feeds → Source Adapters: provides reports
- Source Adapters → Live Ingest: adapts feeds
- Live Ingest → Condition Store: stores conditions
- Live Ingest → Realtime Updates: publishes updates
- Public → Public Map: views hazards
- Public Map → Public Hazards API: loads hazards
- Coordinator → Snapshot API: requests overview
- Snapshot API → Operational Views: builds snapshot
- Coordinator → SITREP API: requests SITREP
- SITREP API → Operational Views: reads operation
- Coordinator → Preparedness: manages readiness
- Coordinator → Resource Board: reviews capacity