How kevalxd/sutra works
Sutra is a frontend prototype for demonstrating travel-disruption recovery. The user journey loads a demo itinerary, presents a disruption and its downstream impact, then retrieves alternatives and requests a recovery result, showing either a feasible repair or why none is feasible. The Next.js routes use local mock data; the recovery engine selects among feasible candidates. UI modules cover itinerary, impact, and recovery presentation. The README describes delay, cancellation, infeasible, and retryable-error scenarios. Some UI and API-client internals were not excerpted, so those connections are omitted or marked unverified.
Main entry points: sections.tsx Journey sections · app.tsx Sutra app · api.ts API client · scenario.ts Scenario parsing
Components 26
User experience
- Scenario page
app/page.tsx - Sutra app
components/sutra/app.tsx - Journey sections
components/sutra/sections.tsx - Recovery result views
components/sutra/result.tsx - Journey band
components/sutra/journey-band.tsx - Affected bookings
components/sutra/affected.tsx - Candidate comparison
components/sutra/comparison.tsx - Recovery path
components/sutra/recovery-path.tsx - Repair differences
components/sutra/repair-diff.tsx - Workflow interactions
components/sutra/kit.tsx - Travel globe
components/sutra/travel-globe.tsx - Background effects
components/sutra/grainient.tsx - Meteor effects
components/ui/meteors.tsx
Recovery workflow
- Recovery flow state
hooks/use-recovery-flow.ts - API client
lib/api.ts
Demo API
- Trip endpoint
app/api/trip/route.ts - Disruption endpoint
app/api/disruption/route.ts - Alternatives endpoint
app/api/alternatives/route.ts - Recovery endpoint
app/api/recovery/route.ts
Domain support
- Scenario parsing
lib/scenario.ts - Scenario mock data
lib/mock.ts - Recovery selection
lib/engine.ts - Date and value formatting
lib/format.ts - Place names
lib/places.ts - Workflow data types
lib/types.ts
Other components
- Traveller
Connections 37
- Traveller → Scenario page: chooses scenario
README.md - Scenario page → Scenario parsing: parses scenario
app/page.tsx - Scenario page → Sutra app: renders
app/page.tsx - Sutra app → Recovery flow state: runs workflow
components/sutra/app.tsx - Sutra app → Journey sections: renders
components/sutra/app.tsx - Sutra app → Recovery result views: renders
components/sutra/app.tsx - Sutra app → Workflow interactions: uses interactions
components/sutra/app.tsx - Sutra app → Background effects: renders
components/sutra/app.tsx - Sutra app → Meteor effects: renders
components/sutra/app.tsx - Journey sections → Journey band: renders
components/sutra/sections.tsx - Journey sections → Affected bookings: renders
components/sutra/sections.tsx - Journey sections → Travel globe: loads
components/sutra/sections.tsx - Journey sections → Workflow interactions: uses stages
components/sutra/sections.tsx - Journey sections → Date and value formatting: formats values
components/sutra/sections.tsx - Journey sections → Place names: names locations
components/sutra/sections.tsx - Recovery flow state → API client: requests data
hooks/use-recovery-flow.ts - API client → Trip endpoint: calls endpoint
- API client → Disruption endpoint: calls endpoint
- API client → Alternatives endpoint: calls endpoint
- API client → Recovery endpoint: calls endpoint
- Trip endpoint → Scenario parsing: parses scenario
app/api/trip/route.ts - Trip endpoint → Scenario mock data: loads trip
app/api/trip/route.ts - Disruption endpoint → Scenario parsing: parses scenario
- Disruption endpoint → Scenario mock data: uses mock data
- Alternatives endpoint → Scenario parsing: parses scenario
app/api/alternatives/route.ts - Alternatives endpoint → Scenario mock data: loads candidates
app/api/alternatives/route.ts - Recovery endpoint → Scenario parsing: parses scenario
app/api/recovery/route.ts - Recovery endpoint → Recovery selection: requests recovery
app/api/recovery/route.ts - Recovery selection → Scenario mock data: selects candidates
lib/engine.ts - Recovery selection → Workflow data types: uses domain types
lib/engine.ts - Journey band → Date and value formatting: formats journey
components/sutra/journey-band.tsx - Journey band → Place names: names locations
components/sutra/journey-band.tsx - Journey band → Workflow data types: uses booking data
components/sutra/journey-band.tsx - Journey sections → Workflow data types: uses workflow data
components/sutra/sections.tsx - Recovery result views → Candidate comparison: may present comparison
- Recovery result views → Recovery path: may show repair path
- Recovery result views → Repair differences: may show changes