# serghinibassim-lgtm/agileflow architecture

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

- Interactive diagram: https://gitdiagram.com/serghinibassim-lgtm/agileflow
- Repository: https://github.com/serghinibassim-lgtm/agileflow

## Overview

AgilFlow is a Scrum/agile project-management backend, with a minimal Angular frontend shell. The intended workflow is users calling REST endpoints to manage organizations, projects, backlogs, sprints, tasks, and collaboration records; backend services map requests to domain entities and repositories. The excerpts directly show user, project, backlog, task, and authentication behavior. Other domain branches are represented from the tree, but their runtime wiring is not verified; the frontend routes are empty.

Main entry points: [`backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java`](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java) (Authentication), [`backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java`](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java) (User API), [`backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java`](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java) (Auth API), [`backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/UserService.java`](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/UserService.java) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and identity"]
  node_user_api["User API"]
  node_auth_api["Auth API"]
  node_user_service["User management<br/>[UserService.java]"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
end

subgraph group_planning["Agile planning"]
  node_projects["Projects"]
  node_product_backlog["Product backlog"]
  node_sprints["Sprint planning<br/>[SprintService.java]"]
  node_sprint_backlog["Sprint backlog"]
  node_tasks["Tasks<br/>[TaskService.java]"]
  node_criteria["Acceptance criteria"]
end

subgraph group_collaboration["Team collaboration"]
  node_teams["Teams and members<br/>[TeamService.java]"]
  node_comments["Comments"]
  node_activity["Activity history"]
  node_notifications["Notifications"]
end

subgraph group_backend["Backend foundations"]
  node_repositories["Persistence repositories"]
  node_database[("Relational database")]
end

subgraph group_client["Frontend shell"]
  node_frontend["Angular shell<br/>[app.ts]"]
end

node_user(("User"))
node_auth_manager["Spring authentication"]

node_user -->|"calls"| node_user_api
node_user_api -->|"delegates to"| node_user_service
node_user_service -->|"reads and writes"| node_repositories
node_repositories -.->|"persists"| node_database
node_user -->|"authenticates"| node_auth_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"authenticates with"| node_auth_manager
node_auth_service -->|"generates token"| node_jwt
node_user -.->|"manages projects"| node_projects
node_user -.->|"manages backlog"| node_product_backlog
node_user -.->|"plans sprints"| node_sprints
node_user -.->|"assigns sprint items"| node_sprint_backlog
node_user -.->|"manages tasks"| node_tasks
node_user -.->|"defines criteria"| node_criteria
node_user -.->|"manages teams"| node_teams
node_user -.->|"adds comments"| node_comments
node_user -.->|"reviews history"| node_activity
node_user -.->|"receives updates"| node_notifications
node_frontend -.->|"user interface"| node_user

click node_user_api "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java"
click node_auth_api "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java"
click node_user_service "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/UserService.java"
click node_auth_service "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java"
click node_jwt "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/JwtService.java"
click node_projects "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ProjectService.java"
click node_product_backlog "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ProductBacklogService.java"
click node_sprints "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/SprintService.java"
click node_sprint_backlog "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/SprintBacklogService.java"
click node_tasks "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/TaskService.java"
click node_criteria "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AcceptanceCriterionService.java"
click node_teams "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/TeamService.java"
click node_comments "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/CommentService.java"
click node_activity "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ActivityService.java"
click node_notifications "https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/NotificationService.java"
click node_repositories "https://github.com/serghinibassim-lgtm/agileflow/tree/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/repositories"
click node_frontend "https://github.com/serghinibassim-lgtm/agileflow/blob/master/frontend/agilflowFrontend/src/app/app.ts"

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_user_api,node_auth_api,node_user_service,node_auth_service,node_jwt,node_user toneBlue
class node_projects,node_product_backlog,node_sprints,node_sprint_backlog,node_tasks,node_criteria toneAmber
class node_teams,node_comments,node_activity,node_notifications toneMint
class node_repositories,node_database toneRose
class node_frontend,node_auth_manager toneIndigo
```

## Components

### Access and identity

- [User API](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java`
- [Auth API](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java`
- [User management](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/UserService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/UserService.java`
- [Authentication](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java`
- [JWT service](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/JwtService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/JwtService.java`

### Agile planning

- [Projects](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ProjectService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ProjectService.java`
- [Product backlog](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ProductBacklogService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ProductBacklogService.java`
- [Sprint planning](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/SprintService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/SprintService.java`
- [Sprint backlog](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/SprintBacklogService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/SprintBacklogService.java`
- [Tasks](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/TaskService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/TaskService.java`
- [Acceptance criteria](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AcceptanceCriterionService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AcceptanceCriterionService.java`

### Team collaboration

- [Teams and members](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/TeamService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/TeamService.java`
- [Comments](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/CommentService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/CommentService.java`
- [Activity history](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ActivityService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/ActivityService.java`
- [Notifications](https://github.com/serghinibassim-lgtm/agileflow/blob/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/NotificationService.java): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/NotificationService.java`

### Backend foundations

- [Persistence repositories](https://github.com/serghinibassim-lgtm/agileflow/tree/master/backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/repositories): `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/repositories`
- **Relational database**

### Frontend shell

- [Angular shell](https://github.com/serghinibassim-lgtm/agileflow/blob/master/frontend/agilflowFrontend/src/app/app.ts): `frontend/agilflowFrontend/src/app/app.ts`

### Other components

- **User**
- **Spring authentication**

## Connections

- User → User API: calls (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java`)
- User API → User management: delegates to (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/UserController.java`)
- User management → Persistence repositories: reads and writes (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/UserService.java`)
- Persistence repositories → Relational database: persists (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/repositories/UserRepository.java`)
- User → Auth API: authenticates (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java`)
- Auth API → Authentication: delegates to (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/web/AuthController.java`)
- Authentication → Spring authentication: authenticates with (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java`)
- Authentication → JWT service: generates token (evidence: `backend/agilFlow-Platforme/src/main/java/com/bassim/agilflowplatforme/services/AuthService.java`)
- User → Projects: manages projects
- User → Product backlog: manages backlog
- User → Sprint planning: plans sprints
- User → Sprint backlog: assigns sprint items
- User → Tasks: manages tasks
- User → Acceptance criteria: defines criteria
- User → Teams and members: manages teams
- User → Comments: adds comments
- User → Activity history: reviews history
- User → Notifications: receives updates
- Angular shell → User: user interface
