Chapter 5: System Architecture

5.1 Use Cases Model

Actor	Goals
Learner	1. Register, log in, and manage their own profiles. 2. Choose preferred programming languages and interface languages. 3. Follow structured learning paths and unlock lessons progressively. 4. Learn via text, videos. 5. Practice coding using Monaco Editor with syntax highlighting, auto-completion, and real-time feedback. 6. Receive AI-powered hints, explanations, and recommendations. 7. Complete exercises, earn XP, badges, and certifications. 8. Track progress, mastery, and performance analytics. 9. Participate in leaderboards, streaks, and challenges.
Content Creator / Instructor	1. Create and manage courses, lessons, and coding exercises. 2. Categorize exercises by difficulty and validate before publishing. 3. Add multimedia (videos, images) and localized content. 4. Review and update educational materials. 5. Generate content in different formats (text, code).
Administrator	1. Manage user accounts and assign roles/permissions. 2. Monitor platform analytics and logs. 3. Moderate content and enforce warnings or removals. 4. Oversee data security, backups, and system performance. "-" 5. Configure integrations and APIs for external services. "-"
AI System (Gemini / OpenRouter)	1. Provide contextual hints and adaptive learning recommendations. 2. Analyze learner code to detect errors and suggest improvements. 3. Generate additional exercises and code examples. "-" 4. Adjust hint complexity based on user skill level. "-"
System (Platform / App)	1. Securely store and manage user data. 2. Execute and validate user code safely. 3. Deliver responsive and cross-platform experiences. 4. Integrate with external authentication and AI APIs. 5. Enforce data protection, input validation, and DDoS prevention.