How luc7o/yachay-play works
YachayPlay supports teacher-led classroom activities: teachers create coded games, students join and play, and results feed into history and statistics. The map includes Ludo and Crossword live play, browser-based Word Lightning, teacher tools, accounts, question banks, profiles, and live collaborative slides. Edges are limited to relationships shown in excerpts, SOURCE INDEX references, or README statements; unsampled integrations and tools are represented without speculative call chains.
Main entry points: api.js HTTP API Client · App.jsx App Navigation · CrosswordGame.jsx Crossword Screens · db.js PostgreSQL
Components 32
App and Accounts
- App Navigation
frontend/src/App.jsx - Sign-in Screen
frontend/src/AuthScreen.jsx - HTTP API Client
frontend/src/api.js - Socket Client
frontend/src/socket.js - Game Catalog
frontend/src/GameCatalog.jsx
Classroom Games
- Ludo Screens
frontend/src/ludo/EngineerGame.jsx - Ludo Board Data
backend/board.js - Crossword Screens
frontend/src/cw/CrosswordGame.jsx - Word Bank
backend/crossword/words.js - Word Lightning
frontend/src/PalabraRelampago.jsx
Teacher Tools
- Live Slides
frontend/src/estudio/Estudio.jsx - Classroom Tools
frontend/src/Pizarra.jsx - Activity Timer
frontend/src/cronometroStore.js - Question Bank UI
frontend/src/QuestionBank.jsx
Backend Services
- Authentication Routes
backend/auth.js - User and Tokens
backend/authCore.js - Ludo Game Server
backend/server.js - Crossword Routes
backend/crossword/routes.js - Crossword Engine
backend/crossword/engine.js - Slides Engine
backend/slides/engine.js - Slide Operations
backend/slides/model.js - Slides Routes
backend/slides/routes.js - Slides Sockets
backend/slides/sockets.js - Question Bank Service
backend/questionBank.js - Profile and Ranking
backend/profile.js - Class Statistics
backend/stats.js - AI Assistant
backend/assistant.js
Persistence
- Crossword Persistence
backend/crossword/persist.js - Slides Persistence
backend/slides/persist.js - PostgreSQL
backend/db.js
Other components
- Teacher
- Student
Connections 48
- Teacher → App Navigation: uses
- Student → App Navigation: uses
- App Navigation → Sign-in Screen: shows
frontend/src/App.jsx - App Navigation → Game Catalog: navigates
frontend/src/App.jsx - App Navigation → HTTP API Client: calls
frontend/src/App.jsx - App Navigation → Socket Client: uses
frontend/src/App.jsx - Sign-in Screen → HTTP API Client: calls
frontend/src/AuthScreen.jsx - HTTP API Client → Authentication Routes: HTTP requests
frontend/src/api.js - Authentication Routes → User and Tokens: authenticates
backend/auth.js - User and Tokens → PostgreSQL: reads and writes
backend/authCore.js - Teacher → Ludo Screens: hosts
- Student → Ludo Screens: plays
- App Navigation → Ludo Screens: shows
frontend/src/App.jsx - HTTP API Client → Ludo Game Server: game requests
frontend/src/api.js - Socket Client → Ludo Game Server: live events
- Ludo Game Server → Ludo Board Data: uses board map
backend/server.js - Teacher → Crossword Screens: creates game
- Student → Crossword Screens: joins and plays
- App Navigation → Crossword Screens: shows
frontend/src/App.jsx - Crossword Screens → HTTP API Client: requests rooms
frontend/src/cw/CrosswordGame.jsx - Crossword Screens → Socket Client: joins live play
frontend/src/cw/CrosswordGame.jsx - HTTP API Client → Crossword Routes: HTTP requests
frontend/src/api.js - Crossword Routes → Crossword Engine: creates and looks up
backend/crossword/routes.js - Crossword Engine → Word Bank: selects words
backend/crossword/engine.js - Crossword Engine → Crossword Persistence: room persistence
backend/server.js - Crossword Persistence → PostgreSQL: stores results
backend/crossword/persist.js - Student → Word Lightning: plays in browser
- Teacher → Live Slides: leads activity
- Student → Live Slides: collaborates
- Live Slides → HTTP API Client: uses HTTP
frontend/src/estudio/Estudio.jsx - Live Slides → Socket Client: uses live events
frontend/src/estudio/Estudio.jsx - Slides Routes → Slides Engine: calls
backend/slides/routes.js - Slides Sockets → Slides Engine: updates rooms
backend/slides/sockets.js - Slides Engine → Slide Operations: applies operations
backend/slides/engine.js - Slides Persistence → Slides Engine: persists rooms
backend/slides/persist.js - Slides Persistence → PostgreSQL: stores rooms
backend/slides/persist.js - Teacher → Classroom Tools: uses tools
- Teacher → Activity Timer: uses timer
- Teacher → Question Bank UI: manages questions
- Question Bank UI → HTTP API Client: calls
- HTTP API Client → Question Bank Service: HTTP requests
frontend/src/api.js - Question Bank Service → PostgreSQL: stores questions
backend/questionBank.js - Question Bank Service → Teacher: official and teacher questions
- Teacher → Class Statistics: views results
- Student → Class Statistics: views history
- HTTP API Client → Class Statistics: HTTP requests
- Class Statistics → PostgreSQL: reads results
- Teacher → Profile and Ranking: manages profile