migzjr025/gamified_math

How migzjr025/gamified_math works

This is a Next.js teacher-facing student assessment and learning-game application. Teachers manage students, units, questions, assessments, grades, and achievement records; students take game assessments whose results contribute to grading and reporting. The graph separates user-facing surfaces, domain APIs, authentication, and persistence. Several UI-to-API links are shown as unverified because the sampled UI source does not expose its HTTP calls; unsampled features are retained where the tree and source index establish them.

Main entry points: index.ts PostgreSQL connection · auth.ts Session and access control · StudentsInteractive.tsx Student management · UnitsInteractive.tsx Unit management

Components 27

Teacher and learner surfaces

Dashboard src/components/DashboardInteractive.tsx
Student management src/components/StudentsInteractive.tsx
Unit management src/components/UnitsInteractive.tsx
Question management src/components/QuestionsInteractive.tsx
Assessment management src/components/AssessmentsInteractive.tsx
Learning game src/components/GameInteractive.tsx
Grades and reports src/components/GradesInteractive.tsx
Achievements src/components/AchievementsInteractive.tsx
Settings src/components/SettingsInteractive.tsx
User administration src/components/AdminUsersInteractive.tsx
Navigation src/components/SidebarNav.tsx

Learning and assessment

Student records API src/app/api/students/route.ts
Units API src/app/api/units/route.ts
Questions API src/app/api/questions/route.ts
Assessments API src/app/api/assessments/route.ts
Game results API src/app/api/game-results/route.ts
Grades API src/app/api/grades/route.ts
Achievements API src/app/api/achievements/route.ts

Identity and administration

Login API src/app/api/auth/login/route.ts
OTP verification src/lib/otp.ts
OTP email delivery src/lib/email.ts
Session and access control src/lib/auth.ts
Admin users API src/app/api/admin/users/route.ts

Data and services

PostgreSQL connection src/db/index.ts
Relational data model src/db/schema.ts
PostgreSQL

Other components

Teacher or learner

Connections 41

Teacher or learner → Dashboard: uses
Teacher or learner → Student management: manages
Teacher or learner → Unit management: configures
Teacher or learner → Question management: authors
Teacher or learner → Assessment management: creates
Teacher or learner → Learning game: plays
Teacher or learner → Grades and reports: reviews
Teacher or learner → Achievements: reviews
Teacher or learner → Settings: configures
Teacher or learner → User administration: administers
Question management → Navigation: uses src/components/QuestionsInteractive.tsx
Student management → Navigation: uses src/components/StudentsInteractive.tsx
Unit management → Navigation: uses src/components/UnitsInteractive.tsx
Student management → Student records API: requests records
Unit management → Units API: requests units
Question management → Questions API: requests questions
Assessment management → Assessments API: requests assessments
Learning game → Questions API: loads questions
Learning game → Game results API: submits results
Grades and reports → Grades API: requests grades
Achievements → Achievements API: requests achievements
User administration → Admin users API: requests users
Login API → Session and access control: creates session src/app/api/auth/login/route.ts
Login API → OTP verification: starts verification src/app/api/auth/login/route.ts
OTP verification → OTP email delivery: sends code src/lib/otp.ts
Student records API → Session and access control: checks session src/app/api/students/route.ts
Assessments API → Session and access control: checks session src/app/api/assessments/route.ts
Grades API → Session and access control: checks session src/app/api/grades/route.ts
Game results API → Session and access control: checks session src/app/api/game-results/route.ts
Admin users API → Session and access control: checks admin src/app/api/admin/users/route.ts
Student records API → PostgreSQL connection: queries data src/app/api/students/route.ts
Units API → PostgreSQL connection: queries data src/app/api/units/route.ts
Questions API → PostgreSQL connection: queries data src/app/api/questions/route.ts
Assessments API → PostgreSQL connection: queries data src/app/api/assessments/route.ts
Game results API → PostgreSQL connection: reads and writes src/app/api/game-results/route.ts
Grades API → PostgreSQL connection: reads and writes src/app/api/grades/route.ts
Achievements API → PostgreSQL connection: queries data src/app/api/achievements/route.ts
Admin users API → PostgreSQL connection: queries data src/app/api/admin/users/route.ts
Session and access control → PostgreSQL connection: loads user src/lib/auth.ts
OTP verification → PostgreSQL connection: stores codes src/lib/otp.ts
PostgreSQL connection → PostgreSQL: connects src/db/index.ts

Drawn by GitDiagram on November 11, 2026 from the repository's file tree, README and source files. Read as Markdown ·