How relay28/wordmaster works
WordMaster is a role-based language-learning platform. Teachers manage classrooms and learning content; students join configurable, role-based game sessions, practice through chat, and receive progress and assessment feedback. The graph highlights those user-facing stages, authentication, AI-assisted features, and persistent state. Some backend components are represented at subsystem level because their source was not sampled; links between them are shown only where the excerpts, SOURCE INDEX, or README support them.
Main entry points: AppRoutes.jsx Application routes · GameSessionManagerService.java Turn and game manager · AuthController.java Authentication API · UploadContent.jsx Content authoring
Components 21
Access and identity
- Application routes
frontend/wordmaster/src/AppRoutes.jsx - User auth state
frontend/wordmaster/src/components/context/UserAuthContext.jsx - Authentication API
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/controller/AuthController.java - Authentication service
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/AuthService.java
Classroom and content
- Classroom management
frontend/wordmaster/src/components/Classroom/Classroom Details Page.jsx - Content authoring
frontend/wordmaster/src/components/content/UploadContent.jsx - Classroom and content APIs
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/controller/ClassroomController.java - AI services
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/AIService.java
Gameplay and assessment
- Waiting room
frontend/wordmaster/src/components/WaitingRoom/WaitingRoomPage.jsx - Live gameplay
frontend/wordmaster/src/components/gameplay/GameCore.jsx - Session orchestration
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/GameSessionService.java - Turn and game manager
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/GameSessionManagerService.java - Gameplay chat
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/ChatService.java - Progress and assessment
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/ProgressTrackingService.java - Student reports
frontend/wordmaster/src/components/Reports/StudentReportPage.jsx
Backend and persistence
- Real-time channel
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/config/WebSocketConfig.java - Grammar checking service
backend/wrdmstr/python-services/gector_service.py - MySQL database
- Player-session repository
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/repository/PlayerSessionEntityRepository.java
Other components
- Teacher or student
- Microsoft identity
Connections 27
- Teacher or student → Application routes: uses
frontend/wordmaster/src/AppRoutes.jsx - Application routes → User auth state: checks identity
frontend/wordmaster/src/AppRoutes.jsx - Application routes → Classroom management: routes to
frontend/wordmaster/src/AppRoutes.jsx - Application routes → Waiting room: routes to
frontend/wordmaster/src/AppRoutes.jsx - Application routes → Live gameplay: routes to
frontend/wordmaster/src/AppRoutes.jsx - Teacher or student → Authentication API: authenticates
README.md - Authentication API → Authentication service: delegates to
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/controller/AuthController.java - Authentication service → MySQL database: persists users
- Authentication API → Microsoft identity: supports OAuth2
README.md - Teacher or student → Classroom management: manages classes
README.md - Teacher or student → Content authoring: creates content
README.md - Classroom management → Classroom and content APIs: uses API
- Content authoring → Classroom and content APIs: uses API
- Content authoring → AI services: AI-assisted generation
README.md - Teacher or student → Waiting room: joins session
README.md - Waiting room → Session orchestration: starts session
- Live gameplay → Real-time channel: real-time play
README.md - Session orchestration → Turn and game manager: delegates turns
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/GameSessionService.java - Turn and game manager → Player-session repository: reads and writes
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/GameSessionManagerService.java - Turn and game manager → AI services: requests prompts
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/GameSessionManagerService.java - Turn and game manager → Progress and assessment: updates progress
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/service/gameplay/GameSessionManagerService.java - Live gameplay → Gameplay chat: submits messages
- Gameplay chat → Real-time channel: broadcasts messages
- Gameplay chat → Grammar checking service: grammar analysis
- Teacher or student → Student reports: reviews results
README.md - Student reports → Progress and assessment: views progress
- Player-session repository → MySQL database: queries
backend/wrdmstr/src/main/java/cit/edu/wrdmstr/repository/PlayerSessionEntityRepository.java