How driv-lingo/coordinate_submission works
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: actions.ts Response Actions · pipeline.ts Incident Pipeline · ops.ts Operational Views · ingest.ts Live Ingest
Components 33
Intake & Navigation
- Intake API
src/app/api/incidents/route.ts - AI Interpretation
src/ai/index.ts - Incident Pipeline
src/engine/pipeline.ts - Needs & Paths
src/engine/navigator.ts - Guidance & Handoffs
src/engine/handoff.ts
Response Operations
- Operations API
src/app/api/ops/route.ts - Response Actions
src/server/actions.ts - Eligibility & Matching
src/engine/matching.ts - Dispatch & Lifecycle
src/engine/dispatch.ts - Mission Reassessment
src/engine/reassess.ts - Volunteer API
src/app/api/responders/[id]/route.ts
Conditions & Maps
- Live Ingest
src/live/ingest.ts - Source Adapters
src/providers/registry.ts - Public Hazards API
src/app/api/public/hazards/route.ts - Route Planning
src/maps/route.ts
User Workspaces
- Request Workspace
src/app/request/ResidentRequest.tsx - Coordinator Workspace
src/app/ops/OpsDashboard.tsx - Volunteer Workspace
src/app/volunteer/VolunteerDashboard.tsx - Public Map
src/app/map/PublicHazardMap.tsx - Preparedness
src/app/preparedness/Preparedness.tsx - Resource Board
src/app/resources/ResourcesBoard.tsx
Data & Services
- Condition Store
src/data/repository.ts - Realtime Updates
src/realtime/pubsub.ts - Operational Views
src/server/ops.ts - Snapshot API
src/app/api/snapshot/route.ts - SITREP API
src/app/api/sitrep/route.ts
Other components
- Resident
- Coordinator
- Volunteer
- Public
- Operational Feeds
- Azure Maps
- Azure AI Foundry
Connections 31
- 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