How junaidanwarr/100daysai-academy-tracker works
100DaysAI is a Django academy-tracking system for staff and students. Its principal workflow tracks a student from enrollment through research and assignment review, YouTube channel and performance tracking, alerts, and completion records. Staff use a separate console; students use a gated portal. The README describes service-layer authorization, row scoping, and audit attribution as shared operating rules. Several capabilities are documented but their implementation excerpts were not sampled, so those branches are linked only where the README supports the relationship.
Main entry points: youtube/services.py Channel and analytics sync · research/services.py Research submissions · assignments/services.py Assignment workflow · views.py Student portal
Components 23
Identity and access
- Student portal
apps/portal/views.py - Accounts and MFA
apps/accounts/services.py
Student lifecycle
- Enrollment and status
apps/academy/services.py - Students and batches
apps/academy/models.py - Activity log
apps/academy/activity.py
Learning workflows
- Research submissions
apps/research/services.py - Research scoring
apps/research/scoring.py - Assignment workflow
apps/assignments/services.py - LMS connections
apps/assignments/lms.py
YouTube tracking
- Channel and analytics sync
apps/youtube/services.py - YouTube API client
apps/youtube/api.py - YouTube consent
apps/youtube/oauth.py - Channel snapshots
apps/youtube/models.py
Monitoring and operations
- Alerts and notifications
apps/monitoring/services.py - Alert evaluators
apps/monitoring/evaluators.py - Scheduled jobs
apps/monitoring/jobs.py - Completion records
apps/completion/models.py - Operational settings
apps/core/settings_service.py - Authorization and scoping
apps/core/permissions.py - Audit trail
apps/core/audit.py
Other components
- Student
- Staff
- PostgreSQL
Connections 33
- Student → Student portal: uses
README.md - Staff → Enrollment and status: manages students
README.md - Staff → Assignment workflow: sets and reviews work
README.md - Student portal → Research submissions: submits research
README.md - Student portal → Assignment workflow: submits attempts
README.md - Student portal → Channel and analytics sync: connects channel
README.md - Student portal → Accounts and MFA: signs in
- Enrollment and status → Students and batches: creates and updates
apps/academy/services.py - Research submissions → Research scoring: scores submissions
apps/research/services.py - Research submissions → Activity log: records activity
apps/research/services.py - Assignment workflow → Activity log: records activity
apps/assignments/services.py - LMS connections → Assignment workflow: imports submissions
README.md - Channel and analytics sync → YouTube API client: requests metrics
apps/youtube/services.py - Channel and analytics sync → YouTube consent: uses consent grants
apps/youtube/services.py - Channel and analytics sync → Channel snapshots: writes snapshots
apps/youtube/services.py - Channel and analytics sync → Activity log: records discoveries
README.md - Scheduled jobs → Alerts and notifications: runs alert jobs
- Alerts and notifications → Alert evaluators: evaluates rules
apps/monitoring/services.py - Alert evaluators → Students and batches: reads student state
apps/monitoring/evaluators.py - Alert evaluators → Channel snapshots: reads channel metrics
apps/monitoring/evaluators.py - Scheduled jobs → Channel and analytics sync: runs sync
README.md - Staff → Completion records: issues records
README.md - Operational settings → Channel and analytics sync: configures sync cadence
README.md - Operational settings → Research submissions: configures thresholds
apps/core/settings_service.py - Authorization and scoping → Enrollment and status: authorizes actions
apps/academy/services.py - Authorization and scoping → Research submissions: authorizes actions
apps/research/services.py - Authorization and scoping → Assignment workflow: authorizes actions
apps/assignments/services.py - Audit trail → PostgreSQL: persists entries
apps/core/audit.py - Enrollment and status → Audit trail: writes audit
apps/academy/services.py - Research submissions → Audit trail: writes audit
apps/research/services.py - Assignment workflow → Audit trail: writes audit
apps/assignments/services.py - Students and batches → PostgreSQL: stores records
- Channel snapshots → PostgreSQL: stores snapshots