How horrid-12/student-analytics works
Student Analytics Platform is a server-rendered FastAPI application for college cohorts. Its primary flow is account signup and role-gated access, student onboarding and staff approval, GitHub synchronization into account snapshots, then dashboard payloads and rendered pages. Additional branches cover verification, support tickets and notifications, and HackerRank insights. The graph follows the README and SOURCE INDEX; some feature implementations were not sampled, so documented but unverified links are dashed.
Main entry points: main.py HTTP routes · views.py Page payloads · db.py Application data store · sync.py Fleet synchronization
Components 21
Web and dashboards
- HTTP routes
app/main.py - Page payloads
app/views.py - Dashboard pages
app/templates - Charts
app/charts.py
Identity and onboarding
- Sessions and roles
app/auth.py - OAuth providers
app/google_oauth.py - Account onboarding
app/accounts.py
Sync and analytics
- Fleet synchronization
app/sync.py - GitHub analytics
app/services.py - GitHub transport
app/github_client.py
Persistence
- Account snapshots
app/accounts.py - Application data store
app/db.py - Postgres connection layer
app/database.py
Student services
- Workbook verification
app/crosscheck.py - Support tickets
app/support.py - Weekly announcements
app/weekly.py - HackerRank insights
app/hackerrank_client/client.py - HackerRank profile service
app/hackerrank_client/service.py
Other components
- Student / staff
- GitHub API
- HackerRank API
Connections 23
- Student / staff → HTTP routes: uses pages
README.md - HTTP routes → Sessions and roles: checks access
README.md - HTTP routes → OAuth providers: routes OAuth
app/main.py - HTTP routes → Account onboarding: handles onboarding
app/main.py - HTTP routes → Fleet synchronization: starts sync
README.md - HTTP routes → Page payloads: builds page data
README.md - Page payloads → Dashboard pages: renders pages
README.md - Page payloads → Charts: uses chart helpers
- Fleet synchronization → GitHub analytics: fetches analytics
app/sync.py - GitHub analytics → GitHub transport: requests API data
app/services.py - GitHub transport → GitHub API: calls API
README.md - Fleet synchronization → Account snapshots: stores snapshots
app/sync.py - Account snapshots → Application data store: reads and writes
app/accounts.py - Application data store → Postgres connection layer: uses connection pool
app/db.py - Page payloads → Application data store: loads page data
app/views.py - HTTP routes → Workbook verification: routes verification
app/main.py - Workbook verification → GitHub analytics: normalizes GitHub identity
app/crosscheck.py - Workbook verification → Application data store: persists references
app/crosscheck.py - HTTP routes → Support tickets: routes tickets
app/main.py - HTTP routes → Weekly announcements: routes announcements
app/main.py - HTTP routes → HackerRank insights: routes insights
app/main.py - HackerRank insights → HackerRank profile service: uses profile service
app/hackerrank_client/__init__.py - HackerRank profile service → HackerRank API: fetches profile data