# yassine-chabab/devpulse-fullstack architecture

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

- Interactive diagram: https://gitdiagram.com/yassine-chabab/devpulse-fullstack
- Repository: https://github.com/yassine-chabab/devpulse-fullstack

## Overview

DevPulse is a starter for a developer workspace: users can register and sign in, then reach a protected dashboard. The frontend’s authentication context stores session data locally and sends authentication requests to a Spring Boot API. The dashboard is currently a placeholder for a future Kanban feature; the backend tree contains task and user domain, service, repository, and security areas, but their implementation and connections were not sampled. Consequently, the graph shows only evidenced frontend calls and leaves backend internals unconnected.

Main entry points: [`frontend/src/context/AuthContext.jsx`](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/context/AuthContext.jsx) (Auth context), [`frontend/src/App.jsx`](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/App.jsx) (Route guard), [`frontend/src/pages/Login.jsx`](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Login.jsx) (Login form), [`frontend/src/pages/Register.jsx`](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Register.jsx) (Registration form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Frontend UI"]
  node_app["Route guard<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_auth["Authentication"]
  node_login["Login form<br/>[Login.jsx]"]
  node_register["Registration form<br/>[Register.jsx]"]
  node_authcontext["Auth context<br/>[AuthContext.jsx]"]
  node_api["HTTP client<br/>[api.js]"]
  node_local[("Browser storage")]
end

subgraph group_backend["Backend"]
  node_backendapi["Spring API"]
  node_taskcontroller["Task controller"]
  node_taskservice["Task service<br/>[TaskService.java]"]
  node_taskrepo["Task repository"]
  node_taskmodel["Task model<br/>[Task.java]"]
  node_userrepo["User repository"]
  node_usermodel["User model<br/>[User.java]"]
  node_security["Security config"]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_user -->|"registers"| node_register
node_login -->|"calls login"| node_authcontext
node_register -->|"calls register"| node_authcontext
node_app -->|"checks session"| node_authcontext
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"protects route"| node_dashboard
node_dashboard -->|"uses session"| node_authcontext
node_authcontext -->|"sends requests"| node_api
node_authcontext -->|"reads and writes"| node_local
node_api -->|"sends HTTP"| node_backendapi

click node_app "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Dashboard.jsx"
click node_login "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Login.jsx"
click node_register "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Register.jsx"
click node_authcontext "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/services/api.js"
click node_backendapi "https://github.com/yassine-chabab/devpulse-fullstack/tree/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend"
click node_taskcontroller "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/controller/TaskController.java"
click node_taskservice "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/service/TaskService.java"
click node_taskrepo "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/repository/TaskRepository.java"
click node_taskmodel "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/model/Task.java"
click node_userrepo "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/repository/UserRepository.java"
click node_usermodel "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/model/User.java"
click node_security "https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/security/SecurityConfig.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_dashboard,node_user toneBlue
class node_login,node_register,node_authcontext,node_api,node_local toneAmber
class node_backendapi,node_taskcontroller,node_taskservice,node_taskrepo,node_taskmodel,node_userrepo,node_usermodel,node_security toneMint
```

## Components

### Frontend UI

- [Route guard](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Dashboard](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`

### Authentication

- [Login form](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Registration form](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/pages/Register.jsx): `frontend/src/pages/Register.jsx`
- [Auth context](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [HTTP client](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- **Browser storage**

### Backend

- [Spring API](https://github.com/yassine-chabab/devpulse-fullstack/tree/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend`
- [Task controller](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/controller/TaskController.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/controller/TaskController.java`
- [Task service](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/service/TaskService.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/service/TaskService.java`
- [Task repository](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/repository/TaskRepository.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/repository/TaskRepository.java`
- [Task model](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/model/Task.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/model/Task.java`
- [User repository](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/repository/UserRepository.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/repository/UserRepository.java`
- [User model](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/model/User.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/model/User.java`
- [Security config](https://github.com/yassine-chabab/devpulse-fullstack/blob/main/backend/devpulse-backend/src/main/java/com/example/devpulse_backend/security/SecurityConfig.java): `backend/devpulse-backend/src/main/java/com/example/devpulse_backend/security/SecurityConfig.java`

### Other components

- **User**

## Connections

- User → Login form: signs in (evidence: `frontend/src/pages/Login.jsx`)
- User → Registration form: registers (evidence: `frontend/src/pages/Register.jsx`)
- Login form → Auth context: calls login (evidence: `frontend/src/pages/Login.jsx`)
- Registration form → Auth context: calls register (evidence: `frontend/src/pages/Register.jsx`)
- Route guard → Auth context: checks session (evidence: `frontend/src/App.jsx`)
- Route guard → Login form: routes to (evidence: `frontend/src/App.jsx`)
- Route guard → Registration form: routes to (evidence: `frontend/src/App.jsx`)
- Route guard → Dashboard: protects route (evidence: `frontend/src/App.jsx`)
- Dashboard → Auth context: uses session (evidence: `frontend/src/pages/Dashboard.jsx`)
- Auth context → HTTP client: sends requests (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth context → Browser storage: reads and writes (evidence: `frontend/src/context/AuthContext.jsx`)
- HTTP client → Spring API: sends HTTP (evidence: `frontend/src/services/api.js`)
