# wajid-901/ai-habit-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/wajid-901/ai-habit-tracker
- Repository: https://github.com/wajid-901/ai-habit-tracker

## Overview

AI Habit Tracker is a full-stack routine-building app. Users sign in, create habits, record daily completions, and review streaks and analytics; AI features analyze habit history and provide chat, reports, and suggestions. The React client communicates with an Express API backed by MongoDB. A scheduled backend job also sends push reminders, though the README describes push support as still in development. Edges for unsampled features rely on README or SOURCE INDEX references; their detailed implementations were not inspected.

Main entry points: [`backend/routes`](https://github.com/wajid-901/ai-habit-tracker/tree/main/backend/routes) (API route dispatch), [`frontend/ai-habit-tracker/src/api/axios.js`](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/api/axios.js) (HTTP API client), [`backend/server.js`](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/server.js) (Express API server), [`backend/controllers/aiController.js`](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/aiController.js) (AI analysis workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["React app routes<br/>[App.jsx]"]
  node_authctx["Auth context<br/>[AuthContext.jsx]"]
  node_api_client["HTTP API client<br/>[axios.js]"]
  node_habit_ui["Habit and log UI<br/>[Habits.jsx]"]
  node_analytics_ui["Progress views<br/>[Stats.jsx]"]
  node_ai_ui["AI insights UI<br/>[Insights.jsx]"]
  node_push_ui["Push subscription UI"]
end

subgraph group_api["API and identity"]
  node_server["Express API server<br/>[server.js]"]
  node_routes["API route dispatch"]
  node_auth["JWT authentication<br/>[auth.js]"]
  node_auth_controller["Account operations<br/>[authController.js]"]
end

subgraph group_tracking["Habit tracking"]
  node_habit_controller["Habit operations<br/>[habitController.js]"]
  node_log_controller["Completion and stats<br/>[logController.js]"]
  node_habit_data[("Habit and log records<br/>[Habit.js]")]
end

subgraph group_insights["Insights and reminders"]
  node_ai_controller["AI analysis workflows<br/>[aiController.js]"]
  node_ai_service["Groq prompt service<br/>[aiService.js]"]
  node_insight_data[("Saved AI insights<br/>[AIInsight.js]")]
  node_cron["Reminder scheduler<br/>[reminderCron.js]"]
  node_push_service["Push delivery<br/>[pushService.js]"]
  node_push_data[("Push subscriptions")]
end

node_person(("Habit tracker user"))
node_mongo[("MongoDB")]
node_groq{{"Groq AI"}}
node_push_network{{"Push service network"}}

node_person -->|"uses"| node_app
node_app -->|"reads identity"| node_authctx
node_authctx -->|"requests account"| node_api_client
node_habit_ui -->|"calls API"| node_api_client
node_analytics_ui -->|"calls API"| node_api_client
node_ai_ui -->|"calls API"| node_api_client
node_push_ui -->|"subscribes"| node_api_client
node_api_client -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -->|"protects endpoints"| node_auth
node_routes -->|"dispatches account"| node_auth_controller
node_routes -->|"dispatches habits"| node_habit_controller
node_routes -->|"dispatches logs"| node_log_controller
node_routes -->|"dispatches AI"| node_ai_controller
node_auth_controller -.->|"reads and writes users"| node_mongo
node_habit_controller -.->|"manages habits"| node_habit_data
node_log_controller -->|"reads and writes logs"| node_habit_data
node_ai_controller -->|"reads habit history"| node_habit_data
node_ai_controller -->|"requests completions"| node_ai_service
node_ai_service -->|"generates responses"| node_groq
node_ai_controller -->|"saves results"| node_insight_data
node_server -->|"loads scheduler"| node_cron
node_cron -->|"builds and sends"| node_push_service
node_cron -->|"loads subscriptions"| node_push_data
node_push_service -->|"removes expired"| node_push_data
node_push_service -->|"delivers notifications"| node_push_network
node_server -->|"connects database"| node_mongo

click node_app "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/App.jsx"
click node_authctx "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/context/AuthContext.jsx"
click node_api_client "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/api/axios.js"
click node_habit_ui "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/pages/Habits.jsx"
click node_analytics_ui "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/pages/Stats.jsx"
click node_ai_ui "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/pages/Insights.jsx"
click node_push_ui "https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/components/NotificationPermission.jsx"
click node_server "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/server.js"
click node_routes "https://github.com/wajid-901/ai-habit-tracker/tree/main/backend/routes"
click node_auth "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/middleware/auth.js"
click node_auth_controller "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/authController.js"
click node_habit_controller "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/habitController.js"
click node_log_controller "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/logController.js"
click node_habit_data "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/models/Habit.js"
click node_ai_controller "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/aiController.js"
click node_ai_service "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/utils/aiService.js"
click node_insight_data "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/models/AIInsight.js"
click node_cron "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/cron/reminderCron.js"
click node_push_service "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/services/pushService.js"
click node_push_data "https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/models/PushSubscription.js"

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_authctx,node_api_client,node_habit_ui,node_analytics_ui,node_ai_ui,node_push_ui,node_person toneBlue
class node_server,node_routes,node_auth,node_auth_controller,node_mongo toneAmber
class node_habit_controller,node_log_controller,node_habit_data toneMint
class node_ai_controller,node_ai_service,node_insight_data,node_cron,node_push_service,node_push_data toneRose
class node_groq,node_push_network toneIndigo
```

## Components

### Web client

- [React app routes](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/App.jsx): `frontend/ai-habit-tracker/src/App.jsx`
- [Auth context](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/context/AuthContext.jsx): `frontend/ai-habit-tracker/src/context/AuthContext.jsx`
- [HTTP API client](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/api/axios.js): `frontend/ai-habit-tracker/src/api/axios.js`
- [Habit and log UI](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/pages/Habits.jsx): `frontend/ai-habit-tracker/src/pages/Habits.jsx`
- [Progress views](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/pages/Stats.jsx): `frontend/ai-habit-tracker/src/pages/Stats.jsx`
- [AI insights UI](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/pages/Insights.jsx): `frontend/ai-habit-tracker/src/pages/Insights.jsx`
- [Push subscription UI](https://github.com/wajid-901/ai-habit-tracker/blob/main/frontend/ai-habit-tracker/src/components/NotificationPermission.jsx): `frontend/ai-habit-tracker/src/components/NotificationPermission.jsx`

### API and identity

- [Express API server](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/server.js): `backend/server.js`
- [API route dispatch](https://github.com/wajid-901/ai-habit-tracker/tree/main/backend/routes): `backend/routes`
- [JWT authentication](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Account operations](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`

### Habit tracking

- [Habit operations](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/habitController.js): `backend/controllers/habitController.js`
- [Completion and stats](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/logController.js): `backend/controllers/logController.js`
- [Habit and log records](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/models/Habit.js): `backend/models/Habit.js`

### Insights and reminders

- [AI analysis workflows](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/controllers/aiController.js): `backend/controllers/aiController.js`
- [Groq prompt service](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/utils/aiService.js): `backend/utils/aiService.js`
- [Saved AI insights](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/models/AIInsight.js): `backend/models/AIInsight.js`
- [Reminder scheduler](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/cron/reminderCron.js): `backend/cron/reminderCron.js`
- [Push delivery](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/services/pushService.js): `backend/services/pushService.js`
- [Push subscriptions](https://github.com/wajid-901/ai-habit-tracker/blob/main/backend/models/PushSubscription.js): `backend/models/PushSubscription.js`

### Other components

- **Habit tracker user**
- **MongoDB**
- **Groq AI**
- **Push service network**

## Connections

- Habit tracker user → React app routes: uses (evidence: `README.md`)
- React app routes → Auth context: reads identity (evidence: `frontend/ai-habit-tracker/src/App.jsx`)
- Auth context → HTTP API client: requests account (evidence: `frontend/ai-habit-tracker/src/context/AuthContext.jsx`)
- Habit and log UI → HTTP API client: calls API (evidence: `frontend/ai-habit-tracker/src/pages/Habits.jsx`)
- Progress views → HTTP API client: calls API
- AI insights UI → HTTP API client: calls API (evidence: `frontend/ai-habit-tracker/src/pages/Insights.jsx`)
- Push subscription UI → HTTP API client: subscribes
- HTTP API client → Express API server: sends requests (evidence: `README.md`)
- Express API server → API route dispatch: mounts routes (evidence: `backend/server.js`)
- API route dispatch → JWT authentication: protects endpoints (evidence: `backend/routes/auth.js`)
- API route dispatch → Account operations: dispatches account (evidence: `backend/routes/auth.js`)
- API route dispatch → Habit operations: dispatches habits (evidence: `backend/routes/habits.js`)
- API route dispatch → Completion and stats: dispatches logs (evidence: `backend/routes/logs.js`)
- API route dispatch → AI analysis workflows: dispatches AI (evidence: `backend/routes/ai.js`)
- Account operations → MongoDB: reads and writes users
- Habit operations → Habit and log records: manages habits (evidence: `backend/controllers/habitController.js`)
- Completion and stats → Habit and log records: reads and writes logs (evidence: `backend/controllers/logController.js`)
- AI analysis workflows → Habit and log records: reads habit history (evidence: `backend/controllers/aiController.js`)
- AI analysis workflows → Groq prompt service: requests completions (evidence: `backend/controllers/aiController.js`)
- Groq prompt service → Groq AI: generates responses (evidence: `README.md`)
- AI analysis workflows → Saved AI insights: saves results (evidence: `backend/controllers/aiController.js`)
- Express API server → Reminder scheduler: loads scheduler (evidence: `backend/server.js`)
- Reminder scheduler → Push delivery: builds and sends (evidence: `backend/cron/reminderCron.js`)
- Reminder scheduler → Push subscriptions: loads subscriptions (evidence: `backend/cron/reminderCron.js`)
- Push delivery → Push subscriptions: removes expired (evidence: `backend/services/pushService.js`)
- Push delivery → Push service network: delivers notifications (evidence: `backend/services/pushService.js`)
- Express API server → MongoDB: connects database (evidence: `backend/server.js`)
