How julescinc/mathutrice works
MATHutrice is a role-based web tutor for first-year mathematics practice. A student signs in, selects a notion, receives generated exercises, submits answers for correction, and builds competence scores used to recommend further practice. The application also offers free chat and teacher/admin pages, including PDF upload. The graph includes the documented product branches, but source excerpts are partial; edges rely on shown calls, SOURCE INDEX references, or README statements, and unsampled details are not inferred.
Main entry points: app.py Web routes · main.py Exercise orchestration · base_generator.py Generation core · session_generator.py Practice sessions
Components 22
Web application
- Web routes
mathutrice/app.py - Student pages
mathutrice/templates - Teacher pages
mathutrice/templates - Free chat
mathutrice/fonctions_python/chatbot.py - PDF upload
mathutrice/app.py
Practice and assessment
- Practice sessions
mathutrice/fonctions_python/session_generator.py - Exercise orchestration
mathutrice/fonctions_python/main.py - Generation core
mathutrice/fonctions_python/base_generator.py - Multiple choice
mathutrice/fonctions_python/type_questions/qcm_generator.py - Open answer
mathutrice/fonctions_python/type_questions/qro_generator.py - Step exercises
mathutrice/fonctions_python/type_questions/steps_generator.py - Fill blanks
mathutrice/fonctions_python/type_questions/trous_generator.py - Math verification
mathutrice/fonctions_python/verifier.py - Gap diagnosis
mathutrice/lacune_evaluation/LLM_as_Evaluator.py
Learning domain
- Notions and skills
mathutrice/referentiel.py
Persistence and LLM
- Learning records
mathutrice/models.py - Database session
mathutrice/database.py - Reference-data seed
mathutrice/seed.py - LLM client
mathutrice/llm_client.py
Other components
- Student
- Teacher / admin
- OpenAI-compatible LLM
Connections 31
- Student → Web routes: uses
README.md - Teacher / admin → Web routes: uses
README.md - Web routes → Student pages: renders
mathutrice/app.py - Web routes → Teacher pages: renders
mathutrice/app.py - Web routes → Practice sessions: requests sessions
mathutrice/app.py - Web routes → Free chat: uses chat
mathutrice/app.py - Web routes → Gap diagnosis: requests diagnosis
mathutrice/app.py - Web routes → PDF upload: handles uploads
README.md - Web routes → Database session: gets sessions
mathutrice/app.py - Web routes → Learning records: queries records
mathutrice/app.py - Practice sessions → Learning records: reads and updates
mathutrice/fonctions_python/session_generator.py - Practice sessions → Notions and skills: uses skills
mathutrice/fonctions_python/session_generator.py - Practice sessions → Exercise orchestration: generates exercises
mathutrice/fonctions_python/session_generator.py - Exercise orchestration → Multiple choice: dispatches
mathutrice/fonctions_python/main.py - Exercise orchestration → Open answer: dispatches
mathutrice/fonctions_python/main.py - Exercise orchestration → Step exercises: dispatches
mathutrice/fonctions_python/main.py - Exercise orchestration → Gap diagnosis: diagnoses answers
mathutrice/fonctions_python/main.py - Exercise orchestration → Notions and skills: uses skills
mathutrice/fonctions_python/main.py - Multiple choice → Generation core: uses generation
mathutrice/fonctions_python/type_questions/qcm_generator.py - Open answer → Generation core: uses generation
mathutrice/fonctions_python/type_questions/qro_generator.py - Step exercises → Generation core: uses generation
mathutrice/fonctions_python/type_questions/steps_generator.py - Fill blanks → Generation core: uses generation
mathutrice/fonctions_python/type_questions/trous_generator.py - Multiple choice → Math verification: checks answers
mathutrice/fonctions_python/type_questions/qcm_generator.py - Generation core → LLM client: calls
mathutrice/fonctions_python/base_generator.py - Gap diagnosis → Notions and skills: uses skills
mathutrice/lacune_evaluation/LLM_as_Evaluator.py - Gap diagnosis → LLM client: calls
mathutrice/lacune_evaluation/LLM_as_Evaluator.py - Free chat → LLM client: uses
mathutrice/fonctions_python/chatbot.py - LLM client → OpenAI-compatible LLM: sends prompts
README.md - Reference-data seed → Learning records: inserts reference data
mathutrice/seed.py - Reference-data seed → Notions and skills: loads reference data
mathutrice/seed.py - Web routes → Reference-data seed: initializes data
mathutrice/app.py