# alzamo12/focushub architecture

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

- Interactive diagram: https://gitdiagram.com/alzamo12/focushub
- Repository: https://github.com/alzamo12/focushub

## Overview

FocusHub is a student productivity app spanning a React client and Express API. A student signs in through Firebase, enters protected dashboard routes, and uses study tools; the client sends authenticated API requests and the server serves domain endpoints backed by MongoDB. The README also documents AI-assisted notes and question generation, class scheduling, task management, budgeting, and dashboard summaries. Sampled code shows the task and class paths in more detail; several other feature implementations were not sampled, so their internal links are not inferred.

Main entry points: [`focus-hub-server/src/app.js`](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/app.js) (Express API), [`focus-hub-client/src/router/router.jsx`](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/router/router.jsx) (Client routes), [`focus-hub-server/src/config/db.js`](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/config/db.js) (MongoDB connection), [`focus-hub-client/src/hooks/useAxiosSecure.jsx`](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/hooks/useAxiosSecure.jsx) (Secure API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_client_routes["Client routes<br/>[router.jsx]"]
  node_dashboard["Study dashboard<br/>[Dashboard.jsx]"]
  node_class_ui["Class schedule"]
  node_task_ui["Task manager<br/>[Tasks.jsx]"]
  node_task_feature["Task data view<br/>[TasksSuspense.jsx]"]
  node_notes_ui["Smart notes<br/>[Notes.jsx]"]
  node_ai_ui["AI study tools"]
  node_budget_ui["Budget tracker<br/>[Budget.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_provider["Auth provider<br/>[AuthProvider.jsx]"]
  node_firebase_client["Firebase client auth<br/>[firebase.config.js]"]
  node_secure_http["Secure API client<br/>[useAxiosSecure.jsx]"]
  node_firebase(("Firebase Authentication"))
end

subgraph group_server["API and domain services"]
  node_api_app["Express API<br/>[app.js]"]
  node_class_routes["Class endpoints<br/>[class.routes.js]"]
  node_class_controller["Class handlers"]
  node_class_service["Class operations<br/>[class.service.js]"]
  node_task_routes["Task endpoints<br/>[task.routes.js]"]
  node_task_controller["Task handlers"]
  node_ai_routes["AI endpoints<br/>[ai.routes.js]"]
  node_budget_routes["Budget endpoints<br/>[budget.routes.js]"]
  node_note_routes["Note endpoints<br/>[note.routes.js]"]
  node_dashboard_routes["Dashboard endpoints"]
end

subgraph group_data["Persistence and AI"]
  node_db_config["MongoDB connection<br/>[db.js]"]
  node_mongodb[("MongoDB")]
  node_gemini(("Gemini AI"))
end

node_student(("Student"))

node_student -->|"uses"| node_client_routes
node_client_routes -->|"routes to"| node_dashboard
node_client_routes -->|"routes to"| node_class_ui
node_client_routes -->|"routes to"| node_task_ui
node_client_routes -->|"routes to"| node_notes_ui
node_client_routes -->|"routes to"| node_ai_ui
node_client_routes -->|"routes to"| node_budget_ui
node_student -->|"authenticates with"| node_firebase
node_auth_provider -->|"configures"| node_firebase_client
node_firebase_client -->|"authenticates"| node_firebase
node_task_ui -->|"renders"| node_task_feature
node_task_feature -->|"requests tasks"| node_secure_http
node_secure_http -->|"sends API requests"| node_api_app
node_secure_http -->|"gets ID token"| node_firebase_client
node_api_app -->|"mounts"| node_class_routes
node_api_app -->|"mounts"| node_task_routes
node_api_app -->|"mounts"| node_ai_routes
node_api_app -->|"mounts"| node_budget_routes
node_api_app -->|"mounts"| node_note_routes
node_api_app -->|"mounts"| node_dashboard_routes
node_class_routes -->|"dispatches"| node_class_controller
node_class_controller -->|"calls"| node_class_service
node_task_routes -->|"dispatches"| node_task_controller
node_task_controller -->|"reads today tasks"| node_db_config
node_class_controller -->|"reads today classes"| node_db_config
node_class_service -->|"accesses collections"| node_db_config
node_db_config -->|"connects"| node_mongodb
node_class_ui -->|"uses classes API"| node_api_app
node_dashboard -->|"loads overview"| node_api_app
node_notes_ui -->|"uses notes API"| node_api_app
node_ai_ui -->|"uses AI API"| node_api_app
node_budget_ui -->|"uses budget API"| node_api_app
node_api_app -.->|"generates study content"| node_gemini

click node_client_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/router/router.jsx"
click node_dashboard "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/dashboard/Dashboard.jsx"
click node_class_ui "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/classScheduleTracker/ClassScheduleTracker.jsx"
click node_task_ui "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/Tasks/Tasks.jsx"
click node_task_feature "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/features/Tasks/TasksSuspense.jsx"
click node_notes_ui "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/Note/Notes.jsx"
click node_ai_ui "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/GenerateQuestions/GenerateQuestions.jsx"
click node_budget_ui "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/Budget/Budget.jsx"
click node_auth_provider "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/providers/AuthProvider/AuthProvider.jsx"
click node_firebase_client "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/services/firebase/firebase.config.js"
click node_secure_http "https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/hooks/useAxiosSecure.jsx"
click node_api_app "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/app.js"
click node_class_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/class.routes.js"
click node_class_controller "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/controllers/class.controllers.js"
click node_class_service "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/services/class.service.js"
click node_task_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/task.routes.js"
click node_task_controller "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/controllers/task.controllers.js"
click node_ai_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/ai.routes.js"
click node_budget_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/budget.routes.js"
click node_note_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/note.routes.js"
click node_dashboard_routes "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/dashboard.routes.js"
click node_db_config "https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/config/db.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_client_routes,node_dashboard,node_class_ui,node_task_ui,node_task_feature,node_notes_ui,node_ai_ui,node_budget_ui toneBlue
class node_auth_provider,node_firebase_client,node_secure_http,node_firebase toneAmber
class node_api_app,node_class_routes,node_class_controller,node_class_service,node_task_routes,node_task_controller,node_ai_routes,node_budget_routes,node_note_routes,node_dashboard_routes toneMint
class node_db_config,node_mongodb,node_gemini toneRose
class node_student toneIndigo
```

## Components

### Client experience

- [Client routes](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/router/router.jsx): `focus-hub-client/src/router/router.jsx`
- [Study dashboard](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/dashboard/Dashboard.jsx): `focus-hub-client/src/pages/dashboard/Dashboard.jsx`
- [Class schedule](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/classScheduleTracker/ClassScheduleTracker.jsx): `focus-hub-client/src/pages/classScheduleTracker/ClassScheduleTracker.jsx`
- [Task manager](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/Tasks/Tasks.jsx): `focus-hub-client/src/pages/Tasks/Tasks.jsx`
- [Task data view](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/features/Tasks/TasksSuspense.jsx): `focus-hub-client/src/features/Tasks/TasksSuspense.jsx`
- [Smart notes](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/Note/Notes.jsx): `focus-hub-client/src/pages/Note/Notes.jsx`
- [AI study tools](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/GenerateQuestions/GenerateQuestions.jsx): `focus-hub-client/src/pages/GenerateQuestions/GenerateQuestions.jsx`
- [Budget tracker](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/pages/Budget/Budget.jsx): `focus-hub-client/src/pages/Budget/Budget.jsx`

### Identity and access

- [Auth provider](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/providers/AuthProvider/AuthProvider.jsx): `focus-hub-client/src/providers/AuthProvider/AuthProvider.jsx`
- [Firebase client auth](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/services/firebase/firebase.config.js): `focus-hub-client/src/services/firebase/firebase.config.js`
- [Secure API client](https://github.com/alzamo12/focushub/blob/main/focus-hub-client/src/hooks/useAxiosSecure.jsx): `focus-hub-client/src/hooks/useAxiosSecure.jsx`
- **Firebase Authentication**

### API and domain services

- [Express API](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/app.js): `focus-hub-server/src/app.js`
- [Class endpoints](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/class.routes.js): `focus-hub-server/src/routes/class.routes.js`
- [Class handlers](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/controllers/class.controllers.js): `focus-hub-server/src/controllers/class.controllers.js`
- [Class operations](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/services/class.service.js): `focus-hub-server/src/services/class.service.js`
- [Task endpoints](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/task.routes.js): `focus-hub-server/src/routes/task.routes.js`
- [Task handlers](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/controllers/task.controllers.js): `focus-hub-server/src/controllers/task.controllers.js`
- [AI endpoints](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/ai.routes.js): `focus-hub-server/src/routes/ai.routes.js`
- [Budget endpoints](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/budget.routes.js): `focus-hub-server/src/routes/budget.routes.js`
- [Note endpoints](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/note.routes.js): `focus-hub-server/src/routes/note.routes.js`
- [Dashboard endpoints](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/routes/dashboard.routes.js): `focus-hub-server/src/routes/dashboard.routes.js`

### Persistence and AI

- [MongoDB connection](https://github.com/alzamo12/focushub/blob/main/focus-hub-server/src/config/db.js): `focus-hub-server/src/config/db.js`
- **MongoDB**
- **Gemini AI**

### Other components

- **Student**

## Connections

- Student → Client routes: uses (evidence: `focus-hub-client/src/router/router.jsx`)
- Client routes → Study dashboard: routes to (evidence: `focus-hub-client/src/router/router.jsx`)
- Client routes → Class schedule: routes to (evidence: `focus-hub-client/src/router/router.jsx`)
- Client routes → Task manager: routes to (evidence: `focus-hub-client/src/router/router.jsx`)
- Client routes → Smart notes: routes to (evidence: `focus-hub-client/src/router/router.jsx`)
- Client routes → AI study tools: routes to (evidence: `focus-hub-client/src/router/router.jsx`)
- Client routes → Budget tracker: routes to (evidence: `focus-hub-client/src/router/router.jsx`)
- Student → Firebase Authentication: authenticates with
- Auth provider → Firebase client auth: configures (evidence: `focus-hub-client/src/providers/AuthProvider/AuthProvider.jsx`)
- Firebase client auth → Firebase Authentication: authenticates
- Task manager → Task data view: renders (evidence: `focus-hub-client/src/pages/Tasks/Tasks.jsx`)
- Task data view → Secure API client: requests tasks (evidence: `focus-hub-client/src/features/Tasks/TasksSuspense.jsx`)
- Secure API client → Express API: sends API requests
- Secure API client → Firebase client auth: gets ID token (evidence: `focus-hub-client/src/hooks/useAxiosSecure.jsx`)
- Express API → Class endpoints: mounts (evidence: `focus-hub-server/src/app.js`)
- Express API → Task endpoints: mounts (evidence: `focus-hub-server/src/app.js`)
- Express API → AI endpoints: mounts (evidence: `focus-hub-server/src/app.js`)
- Express API → Budget endpoints: mounts (evidence: `focus-hub-server/src/app.js`)
- Express API → Note endpoints: mounts (evidence: `focus-hub-server/src/app.js`)
- Express API → Dashboard endpoints: mounts (evidence: `focus-hub-server/src/app.js`)
- Class endpoints → Class handlers: dispatches (evidence: `focus-hub-server/src/routes/class.routes.js`)
- Class handlers → Class operations: calls (evidence: `focus-hub-server/src/controllers/class.controllers.js`)
- Task endpoints → Task handlers: dispatches (evidence: `focus-hub-server/src/routes/task.routes.js`)
- Task handlers → MongoDB connection: reads today tasks (evidence: `focus-hub-server/src/controllers/task.controllers.js`)
- Class handlers → MongoDB connection: reads today classes (evidence: `focus-hub-server/src/controllers/class.controllers.js`)
- Class operations → MongoDB connection: accesses collections (evidence: `focus-hub-server/src/services/class.service.js`)
- MongoDB connection → MongoDB: connects (evidence: `focus-hub-server/src/config/db.js`)
- Class schedule → Express API: uses classes API
- Study dashboard → Express API: loads overview
- Smart notes → Express API: uses notes API
- AI study tools → Express API: uses AI API
- Budget tracker → Express API: uses budget API
- Express API → Gemini AI: generates study content
