How allylearning/frontier-economics-ai-quiz works
Frontier Economics Quiz is an embedded AI-policy training quiz. A player starts a quiz, answers policy questions, can request a hint, and receives scoring, feedback, and a generated performance summary; scores are also saved for leaderboard display. The graph follows the sampled client and server-action calls. The README documents only the product purpose, so unsampled page composition and detailed flow wiring are not expanded beyond supported paths.
Main entry points: QuizClient.tsx Quiz controller · genkit.ts Genkit runtime · page.tsx Quiz page · generate-hint.ts Hint generation
Components 16
Quiz experience
- Quiz page
src/app/page.tsx - Quiz controller
src/components/quiz/QuizClient.tsx - Quiz setup
src/components/quiz/StartScreen.tsx - Question interface
src/components/quiz/QuestionCard.tsx - Quiz progress
src/components/quiz/QuizProgress.tsx - Results summary
src/components/quiz/QuizSummary.tsx
Quiz content
- Question pool
src/lib/questions.ts - Quiz data types
src/types/index.ts
AI assistance
- Hint generation
src/ai/flows/generate-hint.ts - Answer evaluation
src/ai/flows/evaluate-open-text-answer.ts - Summary generation
src/ai/flows/generate-quiz-summary.ts - Genkit runtime
src/ai/genkit.ts
Scoring and leaderboard
- Leaderboard actions
src/actions/leaderboardActions.ts - Leaderboard database
src/lib/prisma.ts
Other components
- Player
- Google AI model
Connections 16
- Player → Quiz page: opens quiz
- Quiz page → Quiz controller: renders
- Quiz controller → Quiz setup: presents setup
- Quiz controller → Question pool: loads questions
- Quiz controller → Question interface: presents question
- Quiz controller → Quiz progress: updates progress
- Quiz controller → Hint generation: requests hint
- Quiz controller → Answer evaluation: requests evaluation
- Quiz controller → Leaderboard actions: saves and fetches scores
- Quiz controller → Summary generation: requests summary
- Quiz controller → Results summary: displays results
- Leaderboard actions → Leaderboard database: reads and writes
- Summary generation → Genkit runtime: runs flow
- Hint generation → Genkit runtime: runs flow
- Answer evaluation → Genkit runtime: runs flow
- Genkit runtime → Google AI model: calls model