# junaidanwarr/100daysai-academy-tracker architecture

> Architecture diagram of the GitHub repository junaidanwarr/100daysai-academy-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/junaidanwarr/100daysai-academy-tracker
- Repository: https://github.com/junaidanwarr/100daysai-academy-tracker

## Overview

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: [`apps/youtube/services.py`](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/services.py) (Channel and analytics sync), [`apps/research/services.py`](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/research/services.py) (Research submissions), [`apps/assignments/services.py`](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/assignments/services.py) (Assignment workflow), [`apps/portal/views.py`](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/portal/views.py) (Student portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_portal["Student portal<br/>[views.py]"]
  node_accounts["Accounts and MFA<br/>[services.py]"]
end

subgraph group_lifecycle["Student lifecycle"]
  node_student_lifecycle["Enrollment and status<br/>[services.py]"]
  node_academy_data[("Students and batches<br/>[models.py]")]
  node_activity[("Activity log<br/>[activity.py]")]
end

subgraph group_learning["Learning workflows"]
  node_research["Research submissions<br/>[services.py]"]
  node_research_scoring["Research scoring<br/>[scoring.py]"]
  node_assignments["Assignment workflow<br/>[services.py]"]
  node_lms["LMS connections<br/>[lms.py]"]
end

subgraph group_youtube["YouTube tracking"]
  node_youtube["Channel and analytics sync<br/>[services.py]"]
  node_youtube_api["YouTube API client<br/>[api.py]"]
  node_youtube_oauth["YouTube consent<br/>[oauth.py]"]
  node_youtube_data[("Channel snapshots<br/>[models.py]")]
end

subgraph group_operations["Monitoring and operations"]
  node_monitoring["Alerts and notifications<br/>[services.py]"]
  node_evaluators["Alert evaluators<br/>[evaluators.py]"]
  node_jobs["Scheduled jobs<br/>[jobs.py]"]
  node_completion[("Completion records<br/>[models.py]")]
  node_settings["Operational settings"]
  node_access["Authorization and scoping<br/>[permissions.py]"]
  node_audit[("Audit trail<br/>[audit.py]")]
end

node_student(("Student"))
node_staff(("Staff"))
node_database[("PostgreSQL")]

node_student -->|"uses"| node_portal
node_staff -->|"manages students"| node_student_lifecycle
node_staff -->|"sets and reviews work"| node_assignments
node_portal -->|"submits research"| node_research
node_portal -->|"submits attempts"| node_assignments
node_portal -->|"connects channel"| node_youtube
node_portal -.->|"signs in"| node_accounts
node_student_lifecycle -->|"creates and updates"| node_academy_data
node_research -->|"scores submissions"| node_research_scoring
node_research -->|"records activity"| node_activity
node_assignments -->|"records activity"| node_activity
node_lms -->|"imports submissions"| node_assignments
node_youtube -->|"requests metrics"| node_youtube_api
node_youtube -->|"uses consent grants"| node_youtube_oauth
node_youtube -->|"writes snapshots"| node_youtube_data
node_youtube -->|"records discoveries"| node_activity
node_jobs -.->|"runs alert jobs"| node_monitoring
node_monitoring -->|"evaluates rules"| node_evaluators
node_evaluators -->|"reads student state"| node_academy_data
node_evaluators -->|"reads channel metrics"| node_youtube_data
node_jobs -->|"runs sync"| node_youtube
node_staff -->|"issues records"| node_completion
node_settings -->|"configures sync cadence"| node_youtube
node_settings -->|"configures thresholds"| node_research
node_access -->|"authorizes actions"| node_student_lifecycle
node_access -->|"authorizes actions"| node_research
node_access -->|"authorizes actions"| node_assignments
node_audit -->|"persists entries"| node_database
node_student_lifecycle -->|"writes audit"| node_audit
node_research -->|"writes audit"| node_audit
node_assignments -->|"writes audit"| node_audit
node_academy_data -.->|"stores records"| node_database
node_youtube_data -.->|"stores snapshots"| node_database

click node_portal "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/portal/views.py"
click node_accounts "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/accounts/services.py"
click node_student_lifecycle "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/academy/services.py"
click node_academy_data "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/academy/models.py"
click node_activity "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/academy/activity.py"
click node_research "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/research/services.py"
click node_research_scoring "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/research/scoring.py"
click node_assignments "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/assignments/services.py"
click node_lms "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/assignments/lms.py"
click node_youtube "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/services.py"
click node_youtube_api "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/api.py"
click node_youtube_oauth "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/oauth.py"
click node_youtube_data "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/models.py"
click node_monitoring "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/monitoring/services.py"
click node_evaluators "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/monitoring/evaluators.py"
click node_jobs "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/monitoring/jobs.py"
click node_completion "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/completion/models.py"
click node_settings "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/core/settings_service.py"
click node_access "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/core/permissions.py"
click node_audit "https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/core/audit.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_portal,node_accounts toneBlue
class node_student_lifecycle,node_academy_data,node_activity,node_database toneAmber
class node_research,node_research_scoring,node_assignments,node_lms toneMint
class node_youtube,node_youtube_api,node_youtube_oauth,node_youtube_data toneRose
class node_monitoring,node_evaluators,node_jobs,node_completion,node_settings,node_access,node_audit,node_student,node_staff toneIndigo
```

## Components

### Identity and access

- [Student portal](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/portal/views.py): `apps/portal/views.py`
- [Accounts and MFA](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/accounts/services.py): `apps/accounts/services.py`

### Student lifecycle

- [Enrollment and status](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/academy/services.py): `apps/academy/services.py`
- [Students and batches](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/academy/models.py): `apps/academy/models.py`
- [Activity log](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/academy/activity.py): `apps/academy/activity.py`

### Learning workflows

- [Research submissions](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/research/services.py): `apps/research/services.py`
- [Research scoring](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/research/scoring.py): `apps/research/scoring.py`
- [Assignment workflow](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/assignments/services.py): `apps/assignments/services.py`
- [LMS connections](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/assignments/lms.py): `apps/assignments/lms.py`

### YouTube tracking

- [Channel and analytics sync](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/services.py): `apps/youtube/services.py`
- [YouTube API client](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/api.py): `apps/youtube/api.py`
- [YouTube consent](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/oauth.py): `apps/youtube/oauth.py`
- [Channel snapshots](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/youtube/models.py): `apps/youtube/models.py`

### Monitoring and operations

- [Alerts and notifications](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/monitoring/services.py): `apps/monitoring/services.py`
- [Alert evaluators](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/monitoring/evaluators.py): `apps/monitoring/evaluators.py`
- [Scheduled jobs](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/monitoring/jobs.py): `apps/monitoring/jobs.py`
- [Completion records](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/completion/models.py): `apps/completion/models.py`
- [Operational settings](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/core/settings_service.py): `apps/core/settings_service.py`
- [Authorization and scoping](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/core/permissions.py): `apps/core/permissions.py`
- [Audit trail](https://github.com/junaidanwarr/100daysai-academy-tracker/blob/main/apps/core/audit.py): `apps/core/audit.py`

### Other components

- **Student**
- **Staff**
- **PostgreSQL**

## Connections

- Student → Student portal: uses (evidence: `README.md`)
- Staff → Enrollment and status: manages students (evidence: `README.md`)
- Staff → Assignment workflow: sets and reviews work (evidence: `README.md`)
- Student portal → Research submissions: submits research (evidence: `README.md`)
- Student portal → Assignment workflow: submits attempts (evidence: `README.md`)
- Student portal → Channel and analytics sync: connects channel (evidence: `README.md`)
- Student portal → Accounts and MFA: signs in
- Enrollment and status → Students and batches: creates and updates (evidence: `apps/academy/services.py`)
- Research submissions → Research scoring: scores submissions (evidence: `apps/research/services.py`)
- Research submissions → Activity log: records activity (evidence: `apps/research/services.py`)
- Assignment workflow → Activity log: records activity (evidence: `apps/assignments/services.py`)
- LMS connections → Assignment workflow: imports submissions (evidence: `README.md`)
- Channel and analytics sync → YouTube API client: requests metrics (evidence: `apps/youtube/services.py`)
- Channel and analytics sync → YouTube consent: uses consent grants (evidence: `apps/youtube/services.py`)
- Channel and analytics sync → Channel snapshots: writes snapshots (evidence: `apps/youtube/services.py`)
- Channel and analytics sync → Activity log: records discoveries (evidence: `README.md`)
- Scheduled jobs → Alerts and notifications: runs alert jobs
- Alerts and notifications → Alert evaluators: evaluates rules (evidence: `apps/monitoring/services.py`)
- Alert evaluators → Students and batches: reads student state (evidence: `apps/monitoring/evaluators.py`)
- Alert evaluators → Channel snapshots: reads channel metrics (evidence: `apps/monitoring/evaluators.py`)
- Scheduled jobs → Channel and analytics sync: runs sync (evidence: `README.md`)
- Staff → Completion records: issues records (evidence: `README.md`)
- Operational settings → Channel and analytics sync: configures sync cadence (evidence: `README.md`)
- Operational settings → Research submissions: configures thresholds (evidence: `apps/core/settings_service.py`)
- Authorization and scoping → Enrollment and status: authorizes actions (evidence: `apps/academy/services.py`)
- Authorization and scoping → Research submissions: authorizes actions (evidence: `apps/research/services.py`)
- Authorization and scoping → Assignment workflow: authorizes actions (evidence: `apps/assignments/services.py`)
- Audit trail → PostgreSQL: persists entries (evidence: `apps/core/audit.py`)
- Enrollment and status → Audit trail: writes audit (evidence: `apps/academy/services.py`)
- Research submissions → Audit trail: writes audit (evidence: `apps/research/services.py`)
- Assignment workflow → Audit trail: writes audit (evidence: `apps/assignments/services.py`)
- Students and batches → PostgreSQL: stores records
- Channel snapshots → PostgreSQL: stores snapshots
