How pierredelaguiche/moodle-app works
moodle-app is a local, read-only Moodle companion. Its main workflow is to configure a study folder and Moodle access, check courses and files, let the user choose downloads, organize and track those files locally, and optionally generate notes or ask questions with a chosen model. The browser UI also exposes deadlines, announcements, calendar, study, and activity features. The excerpts establish the HTTP/backend boundary and several service dependencies; relationships for unsampled features are included only where the README documents them.
Main entry points: app.py App backend · providers.py Model providers · files.py File tracking · moodle Moodle service
Components 27
User interface
- Browser UI
src/moodle_app/web/static - Local server
src/moodle_app/web/server.py - App backend
src/moodle_app/web/app.py - Background jobs
src/moodle_app/web/jobs.py - Dashboard and lists
src/moodle_app/services/digest.py - Calendar and deadlines
src/moodle_app/services/calendar.py - Calendar feed
src/moodle_app/services/ics.py
Moodle synchronization
- Moodle service
src/moodle_app/moodle - Course sync
src/moodle_app/services/sync.py - File tracking
src/moodle_app/services/files.py - File layout
src/moodle_app/services/layout.py - Week rules
src/moodle_app/domain/weeks.py
Study workspace
- Progress tracker
src/moodle_app/services/tracker.py - Study and editor
src/moodle_app/services/editor.py - Notes generation
src/moodle_app/services/notes.py - Notes planner
src/moodle_app/notes/planner.py - Text extraction
src/moodle_app/notes/extract.py - AI assistant
src/moodle_app/services/ai.py - Folder chat
src/moodle_app/services/chat.py
Local data and integrations
- Study folder
- SQLite records
src/moodle_app/db/repos.py - User settings
src/moodle_app/config.py - Model providers
src/moodle_app/llm/providers.py - Model usage
src/moodle_app/services/usage.py
Other components
- Student
- Moodle site
- Chosen model
Connections 29
- Student → Browser UI: uses
- Browser UI → Local server: requests API
src/moodle_app/web/server.py - Local server → App backend: routes requests
src/moodle_app/web/server.py - App backend → Background jobs: starts jobs
src/moodle_app/web/app.py - App backend → Course sync: checks Moodle
src/moodle_app/web/app.py - Course sync → Moodle service: fetches course data
src/moodle_app/services/sync.py - Moodle service → Moodle site: reads courses
- Course sync → File tracking: reconciles files
src/moodle_app/services/sync.py - File tracking → Moodle service: downloads selected files
src/moodle_app/services/files.py - Moodle service → Study folder: saves files
- File tracking → SQLite records: records file state
src/moodle_app/services/files.py - File tracking → File layout: plans destinations
src/moodle_app/services/files.py - File layout → Week rules: uses week folders
src/moodle_app/services/layout.py - App backend → Dashboard and lists: serves dashboard data
src/moodle_app/web/app.py - App backend → Calendar and deadlines: serves calendar data
src/moodle_app/web/server.py - Calendar and deadlines → Calendar feed: offers calendar feed
- App backend → Progress tracker: serves progress
src/moodle_app/web/app.py - App backend → Study and editor: serves file editing
src/moodle_app/web/server.py - App backend → Notes generation: starts note creation
- Notes generation → Notes planner: plans note jobs
src/moodle_app/services/notes.py - Notes planner → Text extraction: extracts source text
src/moodle_app/notes/planner.py - Notes planner → Model providers: generates notes
src/moodle_app/notes/planner.py - Model providers → Chosen model: sends prompts
src/moodle_app/llm/providers.py - App backend → AI assistant: answers context questions
src/moodle_app/web/app.py - App backend → Folder chat: offers folder chat
src/moodle_app/web/app.py - AI assistant → Model providers: requests completion
src/moodle_app/services/ai.py - Folder chat → Model providers: requests completion
src/moodle_app/services/chat.py - Model providers → Model usage: tracks usage
src/moodle_app/services/usage.py - App backend → User settings: uses settings
src/moodle_app/web/server.py