How dsuth10/legends-of-learning-4 works
Legends of Learning is a classroom learning platform that combines teacher-managed classes and quests with student quest completion, character progression, rewards, equipment, and clans. The principal workflow is a teacher assigning learning activity, a student completing it and receiving progression rewards, and teachers monitoring class and engagement outcomes. The README documents these major capabilities; the sampled code confirms authentication, role-based dashboard routing, student import, and backup behavior. Other subsystem links are kept broad because their route and service implementations were not sampled.
Main entry points: student_main.py Student Dashboard · blueprint.py Teacher Dashboard · student.py Student Adventures · main.py Home Router
Components 22
Access and Dashboards
- Home Router
app/routes/main.py - Authentication
app/routes/auth.py - Auth Forms
app/forms/auth.py - Student Dashboard
app/routes/student_main.py - Teacher Dashboard
app/routes/teacher/blueprint.py
Learning Activities
- Student Adventures
app/routes/adventures/student.py - Teacher Adventures
app/routes/adventures/teacher.py - Adventure Lifecycle
app/services/adventure_lifecycle.py - Adventure Assignment
app/services/adventure_assignment.py - Adventure Quizzes
app/services/adventure_quiz.py - Adventure Rewards
app/services/adventure_rewards.py
Student Progression
- Abilities and Battle
app/routes/student/abilities.py - Battle Routes
app/routes/student/battle.py - Clan Features
app/routes/clan.py
Classroom Operations
- Class Management
app/routes/teacher/classes.py - Student Management
app/routes/teacher/students_api.py - Student Service
app/services/student_service.py - Student Import
app/services/student_import_service.py - Analytics
app/services/analytics_service.py
Other components
- Student
- Teacher
- Application Database
app/models/__init__.py
Connections 24
- Student → Home Router: opens
- Teacher → Home Router: opens
- Home Router → Student Dashboard: routes students
- Home Router → Teacher Dashboard: routes teachers
- Student → Authentication: signs in
- Teacher → Authentication: signs in
- Authentication → Auth Forms: validates with
- Authentication → Application Database: queries users
- Teacher Dashboard → Class Management: manages classes
- Teacher Dashboard → Student Management: manages students
- Student Management → Student Import: imports roster
- Student Import → Student Service: creates students
- Student Service → Application Database: writes users
- Teacher Dashboard → Teacher Adventures: manages adventures
- Teacher Adventures → Adventure Assignment: assigns activity
- Student Dashboard → Student Adventures: opens activities
- Student Adventures → Adventure Quizzes: handles quizzes
- Student Adventures → Adventure Lifecycle: handles progress
- Student Adventures → Adventure Rewards: grants rewards
- Student Dashboard → Abilities and Battle: uses abilities
- Student Dashboard → Battle Routes: enters battles
- Student Dashboard → Clan Features: uses clans
- Teacher Dashboard → Analytics: views analytics
- Analytics → Application Database: reads metrics