How maverickbms/codeguard-pro works
CodeGuard Pro is a local-first learning platform: the learner opens the Electron desktop app, which starts a loopback Django server and presents its UI; learners use it to study the ASCENSO roadmap and record progress. Django also provides assessment, tutoring, challenges, and gamification, backed by local SQLite data. A separate knowledge workflow edits and publishes versioned content, then can pull signed updates. The README documents these capabilities; sampled excerpts confirm selected service calls, but not the full view-to-service wiring.
Main entry points: main.js Electron shell · services.py Roadmap services · views.py Roadmap views · services_evaluacion.py Assessment engine
Components 23
Desktop runtime
- Electron shell
electron/main.js - Local Django server
server_entry.py
Learning experience
- Learning interface
static/js/codeguard.js - Roadmap views
apps/roadmaps/views.py - Roadmap services
apps/roadmaps/services.py - Roadmap and progress
apps/roadmaps/models.py - Assessment engine
apps/roadmaps/services_evaluacion.py - Evaluation records
apps/roadmaps/models_evaluacion.py - Local tutor
apps/tutoring/services.py - Tutoring sessions
apps/tutoring/models.py
Knowledge lifecycle
- Editorial workflow
apps/roadmaps/publisher.py - Content import
apps/roadmaps/content_import.py - Signed packages
apps/roadmaps/distribution.py - Package installer
apps/roadmaps/installer.py - Knowledge sync
apps/roadmaps/sync_client.py
Practice and rewards
- Challenges
apps/challenges/services.py - Gamification
apps/gamification/services.py
Identity and local data
- Identity services
apps/accounts/services.py - Audit logging
apps/audit/services.py - Local application data
config/settings/base.py - Backup tools
apps/core/backup.py
Other components
- Learner
- Ollama local
Connections 28
- Learner → Electron shell: opens app
README.md - Electron shell → Local Django server: starts server
electron/main.js - Electron shell → Local Django server: checks health
electron/main.js - Electron shell → Knowledge sync: starts sync
electron/main.js - Learner → Learning interface: studies locally
README.md - Learning interface → Roadmap views: uses roadmap
- Roadmap views → Roadmap services: delegates to
- Roadmap services → Roadmap and progress: records progress
apps/roadmaps/services.py - Roadmap views → Assessment engine: submits answers
- Assessment engine → Evaluation records: stores results
apps/roadmaps/services_evaluacion.py - Assessment engine → Roadmap services: checks criteria
apps/roadmaps/services_evaluacion.py - Learner → Local tutor: requests hints
README.md - Local tutor → Ollama local: requests explanation
apps/tutoring/services.py - Local tutor → Tutoring sessions: stores sessions
apps/tutoring/services.py - Content import → Editorial workflow: imports drafts
- Editorial workflow → Signed packages: publishes package
README.md - Knowledge sync → Signed packages: verifies package
apps/roadmaps/sync_client.py - Knowledge sync → Package installer: installs updates
apps/roadmaps/sync_client.py - Package installer → Roadmap and progress: updates catalog
apps/roadmaps/installer.py - Learner → Challenges: records result
README.md - Challenges → Local application data: persists attempt
apps/challenges/services.py - Roadmap services → Gamification: awards progress
- Gamification → Roadmap and progress: reads completion
apps/gamification/services.py - Learner → Identity services: authenticates optionally
README.md - Identity services → Audit logging: records access events
apps/accounts/services.py - Audit logging → Local application data: stores events
apps/audit/services.py - Learner → Backup tools: runs backup command
README.md - Backup tools → Local application data: backs up database
README.md