# himasaigandham/progressgrid architecture

> Architecture diagram of the GitHub repository himasaigandham/progressgrid, 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/himasaigandham/progressgrid
- Repository: https://github.com/himasaigandham/progressgrid

## Overview

ProgressGrid is a personal habit-tracking dashboard: users sign in, create habits, record completions, and review consistency over time. The Java API handles authentication and habit rules; the browser provides the interactive dashboard, while repositories persist user, habit, category, and completion data. The README documents daily, weekly, and monthly visualizations and reminders. Source excerpts show service and persistence calls; frontend-to-API wiring and some dashboard capabilities are represented only at the README level, so those links are documented rather than source-verified.

Main entry points: [`Back-End/src/main/java/com/progressgrid/api/service/AuthService.java`](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/AuthService.java) (Account and reset flow), [`Back-End/src/main/java/com/progressgrid/api/service/HabitService.java`](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/HabitService.java) (Habit rules and stats), [`Back-End/src/main/java/com/progressgrid/api/service/EmailService.java`](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/EmailService.java) (Reset email delivery), [`Front-End/app.js`](https://github.com/himasaigandham/progressgrid/blob/main/Front-End/app.js) (Habit dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_dashboard["Habit dashboard<br/>[app.js]"]
  node_login_ui["Sign-in interface<br/>[login.js]"]
  node_auth_ui["Account interface<br/>[login.js]"]
end

subgraph group_api["API and domain"]
  node_api_app["Java API"]
  node_habit_api["Habit endpoints"]
  node_habit_logic["Habit rules and stats<br/>[HabitService.java]"]
  node_habit_dto["Habit data transfer"]
  node_habit_models["Habit domain records"]
end

subgraph group_identity["Identity and recovery"]
  node_auth_api["Account endpoints"]
  node_auth_logic["Account and reset flow<br/>[AuthService.java]"]
  node_otp["OTP verification<br/>[OtpService.java]"]
  node_email["Reset email delivery<br/>[EmailService.java]"]
  node_token["Session tokens<br/>[TokenService.java]"]
  node_security["API access rules<br/>[AuthConfig.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA repositories"]
  node_database[("Application database<br/>[schema.sql]")]
end

node_student(("Student"))
node_resend["Resend email service"]
node_smtp["SMTP mail service"]

node_student -->|"tracks habits"| node_dashboard
node_student -->|"signs in"| node_auth_ui
node_dashboard -.->|"uses habit API"| node_habit_api
node_auth_ui -.->|"uses account API"| node_auth_api
node_habit_api -->|"delegates to"| node_habit_logic
node_habit_logic -->|"maps data"| node_habit_dto
node_habit_logic -->|"reads and writes"| node_repositories
node_habit_models -->|"relates records"| node_habit_models
node_auth_api -->|"delegates to"| node_auth_logic
node_auth_logic -->|"reads and writes users"| node_repositories
node_auth_logic -->|"issues tokens"| node_token
node_auth_logic -->|"verifies codes"| node_otp
node_auth_logic -->|"sends reset code"| node_email
node_email -->|"sends via API"| node_resend
node_email -->|"sends by mail"| node_smtp
node_security -->|"validates tokens"| node_token
node_repositories -.->|"persists records"| node_database
node_habit_logic -.->|"returns progress data"| node_dashboard

click node_dashboard "https://github.com/himasaigandham/progressgrid/blob/main/Front-End/app.js"
click node_login_ui "https://github.com/himasaigandham/progressgrid/blob/main/Front-End/login.js"
click node_api_app "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/ProgressGridApplication.java"
click node_habit_api "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/controller/HabitController.java"
click node_habit_logic "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/HabitService.java"
click node_habit_dto "https://github.com/himasaigandham/progressgrid/tree/main/Back-End/src/main/java/com/progressgrid/api/dto"
click node_habit_models "https://github.com/himasaigandham/progressgrid/tree/main/Back-End/src/main/java/com/progressgrid/api/model"
click node_auth_ui "https://github.com/himasaigandham/progressgrid/blob/main/Front-End/login.js"
click node_auth_api "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/controller/AuthController.java"
click node_auth_logic "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/AuthService.java"
click node_otp "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/OtpService.java"
click node_email "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/EmailService.java"
click node_token "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/security/TokenService.java"
click node_security "https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/security/AuthConfig.java"
click node_repositories "https://github.com/himasaigandham/progressgrid/tree/main/Back-End/src/main/java/com/progressgrid/api/repository"
click node_database "https://github.com/himasaigandham/progressgrid/blob/main/Data-Base/schema.sql"

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_login_ui,node_auth_ui toneBlue
class node_api_app,node_habit_api,node_habit_logic,node_habit_dto,node_habit_models toneAmber
class node_auth_api,node_auth_logic,node_otp,node_email,node_token,node_security toneMint
class node_repositories,node_database toneRose
class node_student,node_resend,node_smtp toneIndigo
```

## Components

### Browser experience

- [Habit dashboard](https://github.com/himasaigandham/progressgrid/blob/main/Front-End/app.js): `Front-End/app.js`
- [Sign-in interface](https://github.com/himasaigandham/progressgrid/blob/main/Front-End/login.js): `Front-End/login.js`
- [Account interface](https://github.com/himasaigandham/progressgrid/blob/main/Front-End/login.js): `Front-End/login.js`

### API and domain

- [Java API](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/ProgressGridApplication.java): `Back-End/src/main/java/com/progressgrid/api/ProgressGridApplication.java`
- [Habit endpoints](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/controller/HabitController.java): `Back-End/src/main/java/com/progressgrid/api/controller/HabitController.java`
- [Habit rules and stats](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/HabitService.java): `Back-End/src/main/java/com/progressgrid/api/service/HabitService.java`
- [Habit data transfer](https://github.com/himasaigandham/progressgrid/tree/main/Back-End/src/main/java/com/progressgrid/api/dto): `Back-End/src/main/java/com/progressgrid/api/dto`
- [Habit domain records](https://github.com/himasaigandham/progressgrid/tree/main/Back-End/src/main/java/com/progressgrid/api/model): `Back-End/src/main/java/com/progressgrid/api/model`

### Identity and recovery

- [Account endpoints](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/controller/AuthController.java): `Back-End/src/main/java/com/progressgrid/api/controller/AuthController.java`
- [Account and reset flow](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/AuthService.java): `Back-End/src/main/java/com/progressgrid/api/service/AuthService.java`
- [OTP verification](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/OtpService.java): `Back-End/src/main/java/com/progressgrid/api/service/OtpService.java`
- [Reset email delivery](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/service/EmailService.java): `Back-End/src/main/java/com/progressgrid/api/service/EmailService.java`
- [Session tokens](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/security/TokenService.java): `Back-End/src/main/java/com/progressgrid/api/security/TokenService.java`
- [API access rules](https://github.com/himasaigandham/progressgrid/blob/main/Back-End/src/main/java/com/progressgrid/api/security/AuthConfig.java): `Back-End/src/main/java/com/progressgrid/api/security/AuthConfig.java`

### Persistence

- [JPA repositories](https://github.com/himasaigandham/progressgrid/tree/main/Back-End/src/main/java/com/progressgrid/api/repository): `Back-End/src/main/java/com/progressgrid/api/repository`
- [Application database](https://github.com/himasaigandham/progressgrid/blob/main/Data-Base/schema.sql): `Data-Base/schema.sql`

### Other components

- **Student**
- **Resend email service**
- **SMTP mail service**

## Connections

- Student → Habit dashboard: tracks habits (evidence: `README.md`)
- Student → Account interface: signs in (evidence: `README.md`)
- Habit dashboard → Habit endpoints: uses habit API (evidence: `README.md`)
- Account interface → Account endpoints: uses account API (evidence: `README.md`)
- Habit endpoints → Habit rules and stats: delegates to (evidence: `Back-End/src/main/java/com/progressgrid/api/controller/HabitController.java`)
- Habit rules and stats → Habit data transfer: maps data (evidence: `Back-End/src/main/java/com/progressgrid/api/service/HabitService.java`)
- Habit rules and stats → JPA repositories: reads and writes (evidence: `Back-End/src/main/java/com/progressgrid/api/service/HabitService.java`)
- Habit domain records → Habit domain records: relates records (evidence: `Back-End/src/main/java/com/progressgrid/api/model/Habit.java`)
- Account endpoints → Account and reset flow: delegates to (evidence: `Back-End/src/main/java/com/progressgrid/api/controller/AuthController.java`)
- Account and reset flow → JPA repositories: reads and writes users (evidence: `Back-End/src/main/java/com/progressgrid/api/service/AuthService.java`)
- Account and reset flow → Session tokens: issues tokens (evidence: `Back-End/src/main/java/com/progressgrid/api/service/AuthService.java`)
- Account and reset flow → OTP verification: verifies codes (evidence: `Back-End/src/main/java/com/progressgrid/api/service/AuthService.java`)
- Account and reset flow → Reset email delivery: sends reset code (evidence: `Back-End/src/main/java/com/progressgrid/api/service/AuthService.java`)
- Reset email delivery → Resend email service: sends via API (evidence: `Back-End/src/main/java/com/progressgrid/api/service/EmailService.java`)
- Reset email delivery → SMTP mail service: sends by mail (evidence: `Back-End/src/main/java/com/progressgrid/api/service/EmailService.java`)
- API access rules → Session tokens: validates tokens (evidence: `Back-End/src/main/java/com/progressgrid/api/security/AuthConfig.java`)
- JPA repositories → Application database: persists records (evidence: `README.md`)
- Habit rules and stats → Habit dashboard: returns progress data (evidence: `README.md`)
