How miteshpanda/tacticsensei works
TacticSensei is a football-learning platform for beginners. Its main user journey is exploring structured Academy lessons and reference material, with quizzes and an AI tutor as interactive learning paths; the encyclopedias, comparison tool, and World Cup predictor extend that experience. The backend exposes these capabilities through FastAPI routes, with profile services, authentication, and persistent content and user data behind them. The README documents the product capabilities; source excerpts and the index support backend routing and selected service/storage links. Frontend-to-backend wiring is not shown, so those links are omitted.
Main entry points: router.py API router · academy.py Lesson content · quiz.py Lesson quizzes · glossary.py Glossary routes
Components 34
Football Academy
- Academy lessons
frontend/src/app/academy/page.tsx - Lesson content
backend/app/api/endpoints/academy.py - Lesson quizzes
backend/app/api/endpoints/quiz.py - Curriculum data
frontend/src/data/academy/curriculum.ts
Football Reference
- Player profiles
frontend/src/app/players/[slug]/page.tsx - Team profiles
frontend/src/app/teams/[slug]/page.tsx - Coach profiles
frontend/src/app/coaches/[slug]/page.tsx - Football glossary
frontend/src/app/glossary/page.tsx - Profile routes
backend/app/api/endpoints/players.py - Team routes
backend/app/api/endpoints/teams.py - Coach routes
backend/app/api/endpoints/coaches.py - Glossary routes
backend/app/api/endpoints/glossary.py - Profile service
backend/app/services/profiles.py
Interactive Tools
- AI football tutor
frontend/src/app/tutor/page.tsx - Tutor route
backend/app/api/endpoints/tutor.py - Tutor service
backend/app/services/tutor.py - World Cup predictor
frontend/src/app/predictor/page.tsx - Predictor route
backend/app/api/endpoints/predictor.py - Compare tool
frontend/src/app/compare/page.tsx
Identity And Admin
- Sign in
frontend/src/app/auth/page.tsx - Auth context
frontend/src/context/AuthContext.tsx - Admin dashboard
frontend/src/app/admin/[section]/page.tsx - Admin routes
backend/app/api/endpoints/admin.py - JWT authentication
backend/app/middleware/auth.py - User routes
backend/app/api/endpoints/users.py - User repository
backend/app/repositories/users_repo.py - Favorites routes
backend/app/api/endpoints/favorites.py - Favorites repository
backend/app/repositories/favorites_repo.py
API And Data
- FastAPI application
backend/app/main.py - API router
backend/app/api/router.py - SQL database
backend/app/core/database.py - Content models
backend/app/models/models.py - Supabase client
backend/app/core/supabase_client.py
Other components
- Football learner
Connections 36
- Football learner → Academy lessons: studies
- Football learner → Player profiles: explores
- Football learner → Team profiles: explores
- Football learner → Coach profiles: explores
- Football learner → Football glossary: looks up
- Football learner → AI football tutor: asks questions
- Football learner → World Cup predictor: simulates
- Football learner → Compare tool: compares
- FastAPI application → API router: mounts routes
backend/app/main.py - API router → Lesson content: registers
backend/app/api/router.py - API router → Lesson quizzes: registers
backend/app/api/router.py - API router → Profile routes: registers
backend/app/api/router.py - API router → Team routes: registers
backend/app/api/router.py - API router → Coach routes: registers
backend/app/api/router.py - API router → Glossary routes: registers
backend/app/api/router.py - API router → Tutor route: registers
backend/app/api/router.py - API router → Predictor route: registers
backend/app/api/router.py - API router → User routes: registers
backend/app/api/router.py - API router → Favorites routes: registers
backend/app/api/router.py - API router → Admin routes: registers
backend/app/api/router.py - Lesson content → SQL database: queries
backend/app/api/endpoints/academy.py - Lesson content → Content models: uses models
backend/app/api/endpoints/academy.py - Lesson quizzes → SQL database: queries
backend/app/api/endpoints/quiz.py - Lesson quizzes → Content models: uses models
backend/app/api/endpoints/quiz.py - Glossary routes → SQL database: queries
backend/app/api/endpoints/glossary.py - Glossary routes → Content models: uses models
backend/app/api/endpoints/glossary.py - Profile routes → Profile service: delegates
backend/app/api/endpoints/players.py - Team routes → Profile service: delegates
backend/app/api/endpoints/teams.py - Coach routes → Profile service: delegates
backend/app/api/endpoints/coaches.py - Tutor route → Tutor service: delegates
backend/app/api/endpoints/tutor.py - User routes → User repository: delegates
backend/app/api/endpoints/users.py - User repository → Supabase client: gets client
backend/app/repositories/users_repo.py - Favorites routes → JWT authentication: requires user
backend/app/api/endpoints/favorites.py - Favorites routes → Favorites repository: delegates
backend/app/api/endpoints/favorites.py - Admin routes → JWT authentication: checks access
backend/app/api/endpoints/admin.py - Admin routes → Supabase client: reads and writes
backend/app/api/endpoints/admin.py