How baitc-hacks/hack-e54d9694-that-day-in works
That Day is an AI-assisted city-governance simulator: participants build a five-measure, budget-constrained plan for Astana districts, inspect projected effects, then calculate and explore a report. The graph preserves separate practice-event, recommendation, participant-ranking, presentation, and experimental review-analysis capabilities documented in the README. Several API handlers and UI state modules were not excerpted; their links are included only where the README or SOURCE INDEX supports them.
Main entry points: city-workspace.tsx City workspace · scenario.ts Scenario API · index.ts Scenario simulation · route.ts Event APIs
Components 23
Planning experience
- City workspace
src/components/city-workspace.tsx - Interactive map
src/components/city-map.tsx - Map studio
src/components/map-studio.tsx - Scenario tools
src/components/scenario-tools.tsx - Map event state
src/features/map/use-playground.ts - Report state
src/features/simulator/use-report.ts - API request client
src/features/scenario-tools/client.ts
Simulation model
- Scenario simulation
src/lib/simulation/index.ts - Map event simulation
src/lib/simulation/map-events.ts - Practice events
src/data/events.ts - Feedback projection
src/lib/feedback/projection.ts
Server API
- Catalog API
src/app/api/catalog/route.ts - Scenario API
src/app/api/_lib/scenario.ts - Event APIs
src/app/api/events/simulate/route.ts
Analysis features
- AI analysis
src/lib/ai/analyze.ts - Recommendations
src/lib/simulation/recommendations.ts - Participant leaderboard
src/lib/competition/store.ts - Presentation generation
src/lib/simulation/presentation.ts - Review signal extraction
src/lib/ai/reviews.ts
Data and state
- City dataset
src/data/index.ts - Shared contracts
src/shared/contracts.ts - Feature contracts
src/shared/features.ts
Other components
- City planner
Connections 29
- City planner → City workspace: builds plan
- City workspace → Map studio: renders
src/components/city-workspace.tsx - Map studio → Interactive map: renders
src/components/map-studio.tsx - City workspace → Scenario tools: offers
src/components/city-workspace.tsx - City workspace → Report state: uses
src/components/city-workspace.tsx - City workspace → Map event state: uses
src/components/city-workspace.tsx - City workspace → API request client: requests
src/components/city-workspace.tsx - API request client → Catalog API: fetches catalog
src/features/scenario-tools/client.ts - API request client → Scenario API: posts scenario
src/features/scenario-tools/client.ts - Catalog API → Scenario API: reads catalog
src/app/api/catalog/route.ts - Scenario API → City dataset: loads data
src/app/api/_lib/scenario.ts - Scenario API → Shared contracts: validates request
src/app/api/_lib/scenario.ts - Scenario API → Scenario simulation: simulates plan
src/app/api/_lib/scenario.ts - Scenario tools → Scenario simulation: previews plan
src/components/scenario-tools.tsx - Scenario simulation → City dataset: calculates from
- Map event state → Map event simulation: simulates events
src/features/map/use-playground.ts - Map event simulation → Practice events: uses event data
src/lib/simulation/map-events.ts - Event APIs → Practice events: selects event
src/app/api/events/simulate/route.ts - Event APIs → Scenario simulation: simulates event
src/app/api/events/simulate/route.ts - Event APIs → Feature contracts: validates event
src/app/api/events/simulate/route.ts - City planner → AI analysis: requests explanation
- AI analysis → Scenario API: receives calculated facts
- City planner → Recommendations: explores alternatives
- City planner → Participant leaderboard: publishes result
- City planner → Presentation generation: creates slides
- City planner → Review signal extraction: submits feedback
- Review signal extraction → Feedback projection: validates signals
src/lib/ai/reviews.ts - Feedback projection → Scenario simulation: projects changes
src/lib/feedback/projection.ts - Recommendations → Scenario simulation: evaluates candidates