How mohandgl53/chess_mastery works
Chess Mastery is a full-stack chess training platform. Players enter through the React app to play and analyze games, study lessons and puzzles, track progress, and request AI coaching; the frontend also runs Stockfish locally for chess evaluation. Backend APIs support accounts, learning, games, player memory, and coaching, with PostgreSQL persistence and a RAG knowledge base. The graph combines explicit README capabilities with shown imports and calls; unsampled subsystem links are omitted where their wiring could not be verified.
Main entry points: App.tsx App Router · app.ts Express API · chessEngine.ts Chess Engine · PlayPage.tsx Play Games
Components 29
Chess Client
- App Router
frontend/src/App.tsx - API Client
frontend/src/services/api/client.ts
Chess Training
- Play Games
frontend/src/pages/PlayPage.tsx - Game Analysis
frontend/src/pages/AnalyzePage.tsx - Game Review
frontend/src/components/game/GameReviewModal.tsx - Chess Engine
frontend/src/services/chessEngine.ts - Stockfish Worker
frontend/src/services/StockfishEngineService.ts - Lessons
frontend/src/pages/LearnPage.tsx - Lesson Study
frontend/src/pages/LessonPage.tsx - Practice Drills
frontend/src/pages/PracticePage.tsx - Tactical Puzzles
frontend/src/pages/PuzzlesPage.tsx - Progress Tracking
frontend/src/pages/ProgressPage.tsx - Player Profile
frontend/src/pages/ProfilePage.tsx
Backend API
- Express API
backend/src/app.ts - Authentication
backend/src/services/auth.service.ts - Auth Endpoints
backend/src/controllers/auth.controller.ts - Curriculum Services
backend/src/services/curriculum.service.ts - Practice Services
backend/src/services/practice.service.ts - Game Services
backend/src/services/game.service.ts - Player Memory
backend/src/services/player-memory.service.ts - PostgreSQL
backend/src/config/database.ts - Coach API
frontend/src/services/api/coachApi.ts
Coaching Intelligence
- Coach Service
frontend/src/services/LLMCoachService.ts - Coach Backend
backend/src/services/coach.service.ts - RAG Retrieval
backend/src/services/rag.retrieval.service.ts - Knowledge Ingestion
backend/src/services/knowledge.ingestion.service.ts - Embedding Provider
backend/src/providers/embedding/embedding.factory.ts - Chess Knowledge
backend/src/config/database.ts
Other components
- Player
Connections 31
- Player → App Router: uses
README.md - App Router → Play Games: routes to
frontend/src/App.tsx - App Router → Game Analysis: routes to
frontend/src/App.tsx - App Router → Lessons: routes to
frontend/src/App.tsx - App Router → Lesson Study: routes to
frontend/src/App.tsx - App Router → Practice Drills: routes to
frontend/src/App.tsx - App Router → Tactical Puzzles: routes to
frontend/src/App.tsx - App Router → Progress Tracking: routes to
frontend/src/App.tsx - App Router → Player Profile: routes to
frontend/src/App.tsx - Play Games → Chess Engine: uses
- Game Analysis → Chess Engine: uses
- Play Games → Game Review: reviews game
- Chess Engine → Stockfish Worker: loads
frontend/src/services/chessEngine.ts - Coach Service → Chess Engine: gets candidates
frontend/src/services/LLMCoachService.ts - Coach Service → Coach API: requests coaching
frontend/src/services/LLMCoachService.ts - Coach API → Express API: calls API
README.md - Express API → PostgreSQL: configures
backend/src/app.ts - Express API → Auth Endpoints: mounts routes
backend/src/app.ts - Auth Endpoints → Authentication: calls
backend/src/controllers/auth.controller.ts - Authentication → PostgreSQL: uses
backend/src/services/auth.service.ts - Express API → Curriculum Services: serves curriculum
- Express API → Practice Services: serves practice
- Express API → Game Services: serves games
- Express API → Player Memory: serves player data
- Express API → Coach Backend: serves coaching
- Coach Backend → RAG Retrieval: retrieves knowledge
- RAG Retrieval → Embedding Provider: creates embeddings
backend/src/services/rag.retrieval.service.ts - RAG Retrieval → Chess Knowledge: searches chunks
backend/src/services/rag.retrieval.service.ts - Knowledge Ingestion → Embedding Provider: creates embeddings
backend/src/services/knowledge.ingestion.service.ts - Knowledge Ingestion → Chess Knowledge: stores chunks
backend/src/services/knowledge.ingestion.service.ts - Chess Knowledge → PostgreSQL: shares PostgreSQL
backend/src/config/database.ts