# deathkernel/tracker architecture

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

- Interactive diagram: https://gitdiagram.com/deathkernel/tracker
- Repository: https://github.com/deathkernel/tracker

## Overview

This is a local UPSC study-tracking dashboard: users plan and record preparation in a browser, with progress saved locally through a FastAPI/SQLite backend and browser-storage fallback. The README documents the study cycle, roadmap, progress tracking, customization, backup, and optional phone access. The export script’s database and HTML reads are visible in its excerpt; server wiring and browser implementation details were not sampled, so those links are documented at a high level or omitted.

Main entry points: [`index.html`](https://github.com/deathkernel/tracker/blob/main/index.html) (Dashboard UI), [`powerbi_export.py`](https://github.com/deathkernel/tracker/blob/main/powerbi_export.py) (Power BI export), [`server.py`](https://github.com/deathkernel/tracker/blob/main/server.py) (FastAPI server), [`revision_engine.py`](https://github.com/deathkernel/tracker/blob/main/revision_engine.py) (Revision scheduling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Study dashboard"]
  node_dashboard["Dashboard UI<br/>[index.html]"]
  node_topic_browse["Topic browser<br/>[index.html]"]
  node_preferences["Display preferences<br/>[index.html]"]
end

subgraph group_planning["Study planning"]
  node_study_cycle["Study cycle<br/>[index.html]"]
  node_roadmap["Weekly roadmap<br/>[index.html]"]
  node_daily_tasks["Daily checklist<br/>[index.html]"]
end

subgraph group_tracking["Progress tracking"]
  node_study_log["Study log<br/>[index.html]"]
  node_revision["Revision scheduling<br/>[revision_engine.py]"]
  node_custom_data["Custom subjects<br/>[index.html]"]
  node_backup["JSON backup<br/>[index.html]"]
end

subgraph group_platform["Local platform"]
  node_server["FastAPI server<br/>[server.py]"]
  node_sqlite[("Tracker database<br/>[server.py]")]
  node_browser_storage[("Browser storage<br/>[index.html]")]
  node_powerbi_export["Power BI export<br/>[powerbi_export.py]"]
end

node_student(("Student"))

node_student -->|"uses"| node_dashboard
node_dashboard -->|"browses topics"| node_topic_browse
node_dashboard -->|"configures"| node_preferences
node_dashboard -->|"plans study"| node_study_cycle
node_dashboard -->|"views roadmap"| node_roadmap
node_dashboard -->|"checks tasks"| node_daily_tasks
node_dashboard -->|"records activity"| node_study_log
node_dashboard -->|"adds content"| node_custom_data
node_dashboard -->|"backs up"| node_backup
node_dashboard -->|"uses backend"| node_server
node_server -->|"persists locally"| node_sqlite
node_dashboard -->|"falls back"| node_browser_storage
node_powerbi_export -->|"reads state"| node_sqlite
node_powerbi_export -->|"reads HTML data"| node_dashboard
node_dashboard -.->|"revision feature"| node_revision

click node_dashboard "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_topic_browse "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_preferences "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_study_cycle "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_roadmap "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_daily_tasks "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_study_log "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_revision "https://github.com/deathkernel/tracker/blob/main/revision_engine.py"
click node_custom_data "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_backup "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_server "https://github.com/deathkernel/tracker/blob/main/server.py"
click node_sqlite "https://github.com/deathkernel/tracker/blob/main/server.py"
click node_browser_storage "https://github.com/deathkernel/tracker/blob/main/index.html"
click node_powerbi_export "https://github.com/deathkernel/tracker/blob/main/powerbi_export.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_dashboard,node_topic_browse,node_preferences toneBlue
class node_study_cycle,node_roadmap,node_daily_tasks toneAmber
class node_study_log,node_revision,node_custom_data,node_backup toneMint
class node_server,node_sqlite,node_browser_storage,node_powerbi_export toneRose
class node_student toneIndigo
```

## Components

### Study dashboard

- [Dashboard UI](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [Topic browser](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [Display preferences](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`

### Study planning

- [Study cycle](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [Weekly roadmap](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [Daily checklist](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`

### Progress tracking

- [Study log](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [Revision scheduling](https://github.com/deathkernel/tracker/blob/main/revision_engine.py): `revision_engine.py`
- [Custom subjects](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [JSON backup](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`

### Local platform

- [FastAPI server](https://github.com/deathkernel/tracker/blob/main/server.py): `server.py`
- [Tracker database](https://github.com/deathkernel/tracker/blob/main/server.py): `server.py`
- [Browser storage](https://github.com/deathkernel/tracker/blob/main/index.html): `index.html`
- [Power BI export](https://github.com/deathkernel/tracker/blob/main/powerbi_export.py): `powerbi_export.py`

### Other components

- **Student**

## Connections

- Student → Dashboard UI: uses (evidence: `README.md`)
- Dashboard UI → Topic browser: browses topics (evidence: `README.md`)
- Dashboard UI → Display preferences: configures (evidence: `README.md`)
- Dashboard UI → Study cycle: plans study (evidence: `README.md`)
- Dashboard UI → Weekly roadmap: views roadmap (evidence: `README.md`)
- Dashboard UI → Daily checklist: checks tasks (evidence: `README.md`)
- Dashboard UI → Study log: records activity (evidence: `README.md`)
- Dashboard UI → Custom subjects: adds content (evidence: `README.md`)
- Dashboard UI → JSON backup: backs up (evidence: `README.md`)
- Dashboard UI → FastAPI server: uses backend (evidence: `README.md`)
- FastAPI server → Tracker database: persists locally (evidence: `README.md`)
- Dashboard UI → Browser storage: falls back (evidence: `README.md`)
- Power BI export → Tracker database: reads state (evidence: `powerbi_export.py`)
- Power BI export → Dashboard UI: reads HTML data (evidence: `powerbi_export.py`)
- Dashboard UI → Revision scheduling: revision feature
