# palak0991/circadia-productivity-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/palak0991/circadia-productivity-tracker
- Repository: https://github.com/palak0991/circadia-productivity-tracker

## Overview

Circadia is a full-stack 24-hour day planner with task and category management, timezone-aware daily views, JWT accounts, and productivity analytics. Users register or log in, then use the dashboard to view and manage scheduled tasks and categories; the SPA sends domain requests to the REST API, whose services manage persistent data. A scheduled backend process detects overdue tasks. The README documents the main capabilities and API; some implementation files, including analytics, category, and task service implementations, were not sampled, so their internal links are not asserted.

Main entry points: [`frontend/src/services/api.js`](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/api.js) (HTTP client), [`frontend/src/pages/DashboardPage.jsx`](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/pages/DashboardPage.jsx) (Planner dashboard), [`backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java`](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java) (Account service), [`frontend/src/App.jsx`](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/App.jsx) (App routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Planner interface"]
  node_app["App routing<br/>[App.jsx]"]
  node_authpages["Login and registration<br/>[LoginPage.jsx]"]
  node_authcontext["Auth state<br/>[AuthContext.jsx]"]
  node_dashboard["Planner dashboard<br/>[DashboardPage.jsx]"]
  node_timeline["24-hour timeline<br/>[Clock24.jsx]"]
  node_taskmodal["Task editor<br/>[TaskModal.jsx]"]
  node_categoryui["Category manager<br/>[CategoryModal.jsx]"]
  node_analyticsui["Analytics panel<br/>[AnalyticsPanel.jsx]"]
  node_authclient["Auth API client<br/>[authService.js]"]
  node_taskclient["Task API client<br/>[taskService.js]"]
  node_categoryclient["Category API client<br/>[categoryService.js]"]
  node_analyticsclient["Analytics API client"]
  node_http["HTTP client<br/>[api.js]"]
end

subgraph group_api["REST API"]
  node_authcontroller["Auth endpoints"]
  node_taskcontroller["Task endpoints"]
  node_categorycontroller["Category endpoints"]
  node_analyticscontroller["Analytics endpoints"]
end

subgraph group_domain["Domain and persistence"]
  node_taskservice["Task rules"]
  node_categoryservice["Category rules"]
  node_taskstore[("Task persistence")]
  node_categorystore[("Category persistence")]
end

subgraph group_identity["Identity and security"]
  node_authservice["Account service"]
  node_userstore[("User persistence")]
  node_jwt["JWT security"]
end

subgraph group_insights["Analytics and scheduling"]
  node_analyticsservice["Analytics rules"]
  node_scheduler["Missed-task scanner"]
end

node_user(("Planner user"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"protects route"| node_dashboard
node_authpages -->|"uses auth state"| node_authcontext
node_authcontext -->|"verifies session"| node_authclient
node_dashboard -->|"renders"| node_timeline
node_dashboard -->|"renders"| node_taskmodal
node_dashboard -->|"renders"| node_categoryui
node_dashboard -->|"renders"| node_analyticsui
node_dashboard -->|"loads tasks"| node_taskclient
node_dashboard -->|"loads categories"| node_categoryclient
node_authclient -->|"sends requests"| node_http
node_taskclient -->|"sends requests"| node_http
node_categoryclient -->|"sends requests"| node_http
node_analyticsclient -.->|"sends requests"| node_http
node_http -->|"calls auth API"| node_authcontroller
node_http -->|"calls task API"| node_taskcontroller
node_http -->|"calls category API"| node_categorycontroller
node_http -->|"calls analytics API"| node_analyticscontroller
node_authcontroller -->|"delegates"| node_authservice
node_taskcontroller -->|"delegates"| node_taskservice
node_categorycontroller -->|"delegates"| node_categoryservice
node_authservice -->|"reads and writes"| node_userstore
node_authservice -->|"seeds defaults"| node_categoryservice
node_authservice -->|"issues tokens"| node_jwt
node_taskservice -.->|"queries tasks"| node_taskstore
node_categoryservice -.->|"manages categories"| node_categorystore
node_analyticscontroller -.->|"delegates"| node_analyticsservice
node_scheduler -->|"triggers detection"| node_analyticsservice

click node_app "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/App.jsx"
click node_authpages "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/pages/LoginPage.jsx"
click node_authcontext "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_timeline "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/Clock24.jsx"
click node_taskmodal "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/TaskModal.jsx"
click node_categoryui "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/CategoryModal.jsx"
click node_analyticsui "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/AnalyticsPanel.jsx"
click node_authclient "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/authService.js"
click node_taskclient "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/taskService.js"
click node_categoryclient "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/categoryService.js"
click node_analyticsclient "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/analyticsService.js"
click node_http "https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/api.js"
click node_authcontroller "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/AuthController.java"
click node_taskcontroller "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/TaskController.java"
click node_categorycontroller "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/CategoryController.java"
click node_analyticscontroller "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/AnalyticsController.java"
click node_authservice "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java"
click node_taskservice "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/TaskServiceImpl.java"
click node_categoryservice "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/CategoryServiceImpl.java"
click node_analyticsservice "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/AnalyticsServiceImpl.java"
click node_taskstore "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/repository/TaskRepository.java"
click node_categorystore "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/repository/CategoryRepository.java"
click node_userstore "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/repository/UserRepository.java"
click node_scheduler "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/scheduler/MissedTaskScheduler.java"
click node_jwt "https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/security/JwtTokenProvider.java"

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_app,node_authpages,node_authcontext,node_dashboard,node_timeline,node_taskmodal,node_categoryui,node_analyticsui,node_authclient,node_taskclient,node_categoryclient,node_analyticsclient,node_http,node_user toneBlue
class node_authcontroller,node_taskcontroller,node_categorycontroller,node_analyticscontroller toneAmber
class node_taskservice,node_categoryservice,node_taskstore,node_categorystore toneMint
class node_authservice,node_userstore,node_jwt toneRose
class node_analyticsservice,node_scheduler toneIndigo
```

## Components

### Planner interface

- [App routing](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login and registration](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Auth state](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Planner dashboard](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [24-hour timeline](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/Clock24.jsx): `frontend/src/components/Clock24.jsx`
- [Task editor](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/TaskModal.jsx): `frontend/src/components/TaskModal.jsx`
- [Category manager](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/CategoryModal.jsx): `frontend/src/components/CategoryModal.jsx`
- [Analytics panel](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/components/AnalyticsPanel.jsx): `frontend/src/components/AnalyticsPanel.jsx`
- [Auth API client](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Task API client](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/taskService.js): `frontend/src/services/taskService.js`
- [Category API client](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/categoryService.js): `frontend/src/services/categoryService.js`
- [Analytics API client](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/analyticsService.js): `frontend/src/services/analyticsService.js`
- [HTTP client](https://github.com/palak0991/circadia-productivity-tracker/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### REST API

- [Auth endpoints](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/AuthController.java): `backend/src/main/java/com/visualizer/hour24/controller/AuthController.java`
- [Task endpoints](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/TaskController.java): `backend/src/main/java/com/visualizer/hour24/controller/TaskController.java`
- [Category endpoints](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/CategoryController.java): `backend/src/main/java/com/visualizer/hour24/controller/CategoryController.java`
- [Analytics endpoints](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/controller/AnalyticsController.java): `backend/src/main/java/com/visualizer/hour24/controller/AnalyticsController.java`

### Domain and persistence

- [Task rules](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/TaskServiceImpl.java): `backend/src/main/java/com/visualizer/hour24/service/impl/TaskServiceImpl.java`
- [Category rules](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/CategoryServiceImpl.java): `backend/src/main/java/com/visualizer/hour24/service/impl/CategoryServiceImpl.java`
- [Task persistence](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/repository/TaskRepository.java): `backend/src/main/java/com/visualizer/hour24/repository/TaskRepository.java`
- [Category persistence](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/repository/CategoryRepository.java): `backend/src/main/java/com/visualizer/hour24/repository/CategoryRepository.java`

### Identity and security

- [Account service](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java): `backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java`
- [User persistence](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/repository/UserRepository.java): `backend/src/main/java/com/visualizer/hour24/repository/UserRepository.java`
- [JWT security](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/security/JwtTokenProvider.java): `backend/src/main/java/com/visualizer/hour24/security/JwtTokenProvider.java`

### Analytics and scheduling

- [Analytics rules](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/service/impl/AnalyticsServiceImpl.java): `backend/src/main/java/com/visualizer/hour24/service/impl/AnalyticsServiceImpl.java`
- [Missed-task scanner](https://github.com/palak0991/circadia-productivity-tracker/blob/main/backend/src/main/java/com/visualizer/hour24/scheduler/MissedTaskScheduler.java): `backend/src/main/java/com/visualizer/hour24/scheduler/MissedTaskScheduler.java`

### Other components

- **Planner user**

## Connections

- Planner user → App routing: opens (evidence: `README.md`)
- App routing → Login and registration: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Planner dashboard: protects route (evidence: `frontend/src/App.jsx`)
- Login and registration → Auth state: uses auth state (evidence: `frontend/src/App.jsx`)
- Auth state → Auth API client: verifies session (evidence: `frontend/src/context/AuthContext.jsx`)
- Planner dashboard → 24-hour timeline: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Planner dashboard → Task editor: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Planner dashboard → Category manager: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Planner dashboard → Analytics panel: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Planner dashboard → Task API client: loads tasks (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Planner dashboard → Category API client: loads categories (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Auth API client → HTTP client: sends requests (evidence: `frontend/src/services/authService.js`)
- Task API client → HTTP client: sends requests (evidence: `frontend/src/services/taskService.js`)
- Category API client → HTTP client: sends requests (evidence: `frontend/src/services/categoryService.js`)
- Analytics API client → HTTP client: sends requests
- HTTP client → Auth endpoints: calls auth API (evidence: `README.md`)
- HTTP client → Task endpoints: calls task API (evidence: `README.md`)
- HTTP client → Category endpoints: calls category API (evidence: `README.md`)
- HTTP client → Analytics endpoints: calls analytics API (evidence: `README.md`)
- Auth endpoints → Account service: delegates (evidence: `backend/src/main/java/com/visualizer/hour24/controller/AuthController.java`)
- Task endpoints → Task rules: delegates (evidence: `backend/src/main/java/com/visualizer/hour24/controller/TaskController.java`)
- Category endpoints → Category rules: delegates (evidence: `backend/src/main/java/com/visualizer/hour24/controller/CategoryController.java`)
- Account service → User persistence: reads and writes (evidence: `backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java`)
- Account service → Category rules: seeds defaults (evidence: `backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java`)
- Account service → JWT security: issues tokens (evidence: `backend/src/main/java/com/visualizer/hour24/service/impl/AuthServiceImpl.java`)
- Task rules → Task persistence: queries tasks (evidence: `backend/src/main/java/com/visualizer/hour24/service/impl/TaskServiceImpl.java`)
- Category rules → Category persistence: manages categories
- Analytics endpoints → Analytics rules: delegates
- Missed-task scanner → Analytics rules: triggers detection (evidence: `backend/src/main/java/com/visualizer/hour24/scheduler/MissedTaskScheduler.java`)
