How abby6702/msuedu_ai works
MSUEdu AI is a Flask tutoring and peer-learning platform. Students discover approved tutors, request sessions, and use an AI assistant, quizzes, progress tools, and a coordinator that prepares—but does not commit—booking changes until confirmation. Tutors manage teaching details and respond to requests; administrators review tutors and manage platform data. Routes delegate to services, which use MySQL-backed helpers; AI features call the local Ollama service. Relationships are limited to README statements and the shown source/index references; unsampled subsystems are represented where the tree supports them.
Main entry points: request_service.py Request lifecycle · tutor_service.py Tutor matching · db.py Database helpers · bookings.py Booking requests
Components 24
Access and administration
- Authentication
app/routes/auth.py - Accounts
app/routes/account.py - Admin console
app/routes/admin.py - User profiles
app/services/user_service.py
Tutoring marketplace
- Tutor workspace
app/routes/tutor.py - Student discovery
app/routes/student.py - Booking requests
app/routes/bookings.py - Tutor matching
app/services/tutor_service.py - Request lifecycle
app/services/request_service.py
AI learning tools
- AI assistant
app/routes/assistant.py - Quizzes
app/routes/quizzes.py - Progress insights
app/routes/progress.py - AI coordinator
app/routes/agent.py - Coordinator planning
app/services/agent_service.py - Quiz attempts
app/services/quiz_service.py - AI workflows
app/services/ai_service.py
Shared platform services
- Database helpers
app/db.py - Notifications
app/services/notification_service.py - Input and time rules
app/validators.py
Other components
- Students
- Tutors
- Administrators
- Local Ollama
- MySQL
Connections 40
- Students → Authentication: sign up
README.md - Tutors → Authentication: sign up
README.md - Administrators → Admin console: manage platform
README.md - Students → Student discovery: find tutors
README.md - Students → Booking requests: request sessions
README.md - Tutors → Tutor workspace: manage availability
README.md - Tutors → Booking requests: respond to requests
README.md - Students → AI assistant: ask questions
README.md - Students → Quizzes: take quizzes
README.md - Students → Progress insights: view progress
README.md - Students → AI coordinator: request coordination
README.md - Authentication → User profiles: manage accounts
app/routes/auth.py - Accounts → User profiles: update profile
app/routes/account.py - Admin console → User profiles: manage users
app/routes/admin.py - Admin console → Tutor matching: review tutors
app/routes/admin.py - Admin console → Request lifecycle: monitor requests
- Student discovery → Tutor matching: search tutors
app/routes/student.py - Student discovery → Request lifecycle: view requests
app/routes/student.py - Tutor workspace → Tutor matching: manage teaching
app/routes/tutor.py - Tutor workspace → Request lifecycle: respond to requests
app/routes/tutor.py - Booking requests → Request lifecycle: change bookings
app/routes/bookings.py - Booking requests → Tutor matching: check tutor details
app/routes/bookings.py - AI assistant → AI workflows: generate responses
app/routes/assistant.py - Quizzes → Quiz attempts: manage attempts
app/routes/quizzes.py - Quizzes → AI workflows: generate quiz
- Progress insights → AI workflows: summarize progress
app/routes/progress.py - Progress insights → Quiz attempts: read quiz results
app/routes/progress.py - AI coordinator → Coordinator planning: plan request
app/routes/agent.py - Coordinator planning → Local Ollama: interpret message
app/services/agent_service.py - Coordinator planning → Tutor matching: find tutors
app/services/agent_service.py - Coordinator planning → Request lifecycle: prepare changes
app/services/agent_service.py - AI workflows → Local Ollama: request completion
app/services/ai_service.py - User profiles → Database helpers: read and write
app/services/user_service.py - Tutor matching → Database helpers: read and write
app/services/tutor_service.py - Request lifecycle → Database helpers: read and write
app/services/request_service.py - Quiz attempts → Database helpers: read and write
app/services/quiz_service.py - Notifications → Database helpers: read and write
app/services/notification_service.py - Database helpers → MySQL: query database
app/db.py - Request lifecycle → Notifications: record events
app/services/request_service.py - Booking requests → Input and time rules: validate input
app/routes/bookings.py