How medventures/haqaton-030 works
AqylRoute AI is a parent-facing support-route demo. The main journey gathers family and child information, generates a suggested route, and lets the parent upload, review, correct, and confirm a PMPK document. The README also describes later KPPK booking and weekly scheduling as synthetic browser-tab steps. The graph preserves the catalog and case-plan domain as internal planning capabilities. Some UI and persistence details were not sampled; those links are shown only where the README or indexed source references support them.
Main entry points: pmpk-api.ts PMPK API · parent-route-api.ts Route API · parent-route.ts Route assembly · parent-journey.tsx Parent dashboard
Components 21
Parent experience
- Sign-in actions
src/app/auth/actions.ts - Parent dashboard
src/app/parent/parent-journey.tsx - Interview UI
src/app/parent/interview/interview.tsx
Route planning
- Interview questions
src/lib/interview.ts - Route API
src/server/parent-route-api.ts - Route assembly
src/domain/parent-route.ts - Service catalog
src/domain/catalog/v1.ts - Eligibility conditions
src/domain/conditions.ts - Route generation
src/server/route-openai.ts - Route stages and scheduling
src/domain/route/route.ts
PMPK documents
- PMPK review UI
src/app/parent/pmpk-step.tsx - PMPK client
src/app/parent/pmpk-client.ts - PMPK API
src/server/pmpk-api.ts - PMPK validation
src/domain/pmpk.ts - Document extraction
src/server/pmpk-openai.ts
Services and data
- Supabase
- OpenAI
Case-plan domain
- Case-plan schema
src/domain/case-plan/schema.ts - Plan validation
src/domain/case-plan/validate.ts - Plan transitions
src/domain/case-plan/transitions.ts
Other components
- Parent
Connections 24
- Parent → Sign-in actions: signs in
- Sign-in actions → Supabase: authenticates
src/app/auth/actions.ts - Parent → Interview UI: provides answers
README.md - Interview UI → Interview questions: validates answers
- Parent → Parent dashboard: uses dashboard
README.md - Parent dashboard → Route API: requests route
README.md - Route API → Supabase: reads and saves route
src/server/parent-route-api.ts - Route API → Route assembly: checks completeness
src/server/parent-route-api.ts - Route API → Route generation: generates plan
src/server/parent-route-api.ts - Route assembly → Service catalog: selects actions
src/domain/parent-route.ts - Route assembly → Eligibility conditions: evaluates eligibility
src/domain/parent-route.ts - Route generation → OpenAI: requests generation
src/server/route-openai.ts - Route generation → Route assembly: assembles output
src/server/route-openai.ts - Parent → PMPK review UI: uploads and reviews
README.md - PMPK review UI → PMPK client: calls client
src/app/parent/pmpk-client.ts - PMPK client → PMPK API: calls API
src/app/parent/pmpk-client.ts - PMPK API → PMPK validation: validates fields
src/server/pmpk-api.ts - PMPK API → Supabase: stores document
src/server/pmpk-api.ts - PMPK API → Document extraction: requests parsing
src/server/pmpk-api.ts - Document extraction → OpenAI: extracts fields
README.md - PMPK API → Route API: supplies route inputs
src/server/pmpk-api.ts - Parent dashboard → Route stages and scheduling: shows later steps
README.md - Plan validation → Case-plan schema: validates against
src/domain/case-plan/validate.ts - Plan transitions → Case-plan schema: uses plan types
src/domain/case-plan/transitions.ts