# m-a-nofal/projectmanagement architecture

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

- Interactive diagram: https://gitdiagram.com/m-a-nofal/projectmanagement
- Repository: https://github.com/m-a-nofal/projectmanagement

## Overview

This is an authenticated project-and-task management API. Users register or log in to obtain a JWT, then manage owned projects and the tasks nested within them; controllers translate HTTP requests into MediatR messages, and handlers perform use cases with persistence behind application contracts. The graph preserves the documented authentication, project, task, validation, exception, and persistence capabilities. Handler internals and several integrations were not sampled, so uncertain connections are dashed rather than asserted.

Main entry points: [`src/ProjectManagement.Application/Common/Behaviors/ValidationBehavior.cs`](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Behaviors/ValidationBehavior.cs) (Request Validation), [`src/ProjectManagement.Application/Common/Interfaces/IApplicationDbContext.cs`](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Interfaces/IApplicationDbContext.cs) (Persistence Contract), [`src/ProjectManagement.Application/Common/Interfaces/ICurrentUserService.cs`](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Interfaces/ICurrentUserService.cs) (User Context Contract), [`src/ProjectManagement.Application/Features/Projects/Commands`](https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Projects/Commands) (Project Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_auth_controller["Authentication Routes<br/>[AuthController.cs]"]
  node_projects_controller["Project Routes"]
  node_tasks_controller["Task Routes"]
  node_exception_handler["Exception Mapping"]
  node_current_user["Current User Adapter"]
end

subgraph group_application["Application Use Cases"]
  node_auth_usecases["Register and Login<br/>[Authentication]"]
  node_project_commands["Project Commands<br/>[Commands]"]
  node_project_queries["Project Queries<br/>[Queries]"]
  node_task_commands["Task Commands<br/>[Commands]"]
  node_task_queries["Task Queries<br/>[Queries]"]
  node_validation["Request Validation"]
  node_db_contract["Persistence Contract"]
  node_user_contract["User Context Contract"]
end

subgraph group_domain["Domain Model"]
  node_project_model["Project Entity<br/>[Project.cs]"]
  node_task_model["Task Entity<br/>[TaskItem.cs]"]
  node_user_model["User Entity<br/>[User.cs]"]
  node_task_status["Task Status<br/>[TaskItemStatus.cs]"]
  node_task_priority["Task Priority<br/>[TaskPriority.cs]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_jwt["JWT Token Service"]
  node_ef_context["EF Core Context"]
end

node_user(("API User"))
node_sql[("SQL Server")]

node_user -->|"registers or logs in"| node_auth_controller
node_user -->|"manages projects"| node_projects_controller
node_user -->|"manages tasks"| node_tasks_controller
node_auth_controller -->|"sends commands"| node_auth_usecases
node_projects_controller -->|"sends commands"| node_project_commands
node_projects_controller -->|"sends queries"| node_project_queries
node_tasks_controller -->|"sends commands"| node_task_commands
node_tasks_controller -->|"sends query"| node_task_queries
node_validation -.->|"validation errors map"| node_exception_handler
node_project_commands -.->|"validated by pipeline"| node_validation
node_project_queries -.->|"validated by pipeline"| node_validation
node_task_commands -.->|"validated by pipeline"| node_validation
node_task_queries -.->|"validated by pipeline"| node_validation
node_project_commands -.->|"uses persistence"| node_db_contract
node_project_queries -->|"uses persistence"| node_db_contract
node_task_commands -.->|"uses persistence"| node_db_contract
node_task_queries -->|"uses persistence"| node_db_contract
node_project_commands -.->|"checks ownership"| node_user_contract
node_project_queries -->|"checks ownership"| node_user_contract
node_task_commands -.->|"checks ownership"| node_user_contract
node_task_queries -->|"checks ownership"| node_user_contract
node_current_user -->|"implements contract"| node_user_contract
node_auth_usecases -.->|"issues tokens"| node_jwt
node_db_contract -->|"implemented by"| node_ef_context
node_ef_context -->|"reads and writes"| node_sql
node_project_model -->|"owns task collection"| node_task_model
node_task_model -->|"has status"| node_task_status
node_task_model -->|"has priority"| node_task_priority
node_exception_handler -->|"returns API errors"| node_user

click node_auth_controller "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Controllers/AuthController.cs"
click node_projects_controller "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Controllers/ProjectsController.cs"
click node_tasks_controller "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Controllers/ProjectTasksController.cs"
click node_exception_handler "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Middleware/GlobalExceptionHandler.cs"
click node_current_user "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Services/CurrentUserService.cs"
click node_auth_usecases "https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Authentication"
click node_project_commands "https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Projects/Commands"
click node_project_queries "https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Projects/Queries"
click node_task_commands "https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Tasks/Commands"
click node_task_queries "https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Tasks/Queries"
click node_validation "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Behaviors/ValidationBehavior.cs"
click node_db_contract "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Interfaces/IApplicationDbContext.cs"
click node_user_contract "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Interfaces/ICurrentUserService.cs"
click node_project_model "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Entities/Project.cs"
click node_task_model "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Entities/TaskItem.cs"
click node_user_model "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Entities/User.cs"
click node_task_status "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Enums/TaskItemStatus.cs"
click node_task_priority "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Enums/TaskPriority.cs"
click node_jwt "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Infrastructure/Authentication/JwtTokenGenerator.cs"
click node_ef_context "https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Infrastructure/Persistence/ApplicationDbContext.cs"

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_auth_controller,node_projects_controller,node_tasks_controller,node_exception_handler,node_current_user,node_user toneBlue
class node_auth_usecases,node_project_commands,node_project_queries,node_task_commands,node_task_queries,node_validation,node_db_contract,node_user_contract,node_sql toneAmber
class node_project_model,node_task_model,node_user_model,node_task_status,node_task_priority toneMint
class node_jwt,node_ef_context toneRose
```

## Components

### HTTP API

- [Authentication Routes](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Controllers/AuthController.cs): `src/ProjectManagement.API/Controllers/AuthController.cs`
- [Project Routes](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Controllers/ProjectsController.cs): `src/ProjectManagement.API/Controllers/ProjectsController.cs`
- [Task Routes](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Controllers/ProjectTasksController.cs): `src/ProjectManagement.API/Controllers/ProjectTasksController.cs`
- [Exception Mapping](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Middleware/GlobalExceptionHandler.cs): `src/ProjectManagement.API/Middleware/GlobalExceptionHandler.cs`
- [Current User Adapter](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.API/Services/CurrentUserService.cs): `src/ProjectManagement.API/Services/CurrentUserService.cs`

### Application Use Cases

- [Register and Login](https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Authentication): `src/ProjectManagement.Application/Features/Authentication`
- [Project Commands](https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Projects/Commands): `src/ProjectManagement.Application/Features/Projects/Commands`
- [Project Queries](https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Projects/Queries): `src/ProjectManagement.Application/Features/Projects/Queries`
- [Task Commands](https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Tasks/Commands): `src/ProjectManagement.Application/Features/Tasks/Commands`
- [Task Queries](https://github.com/m-a-nofal/projectmanagement/tree/main/src/ProjectManagement.Application/Features/Tasks/Queries): `src/ProjectManagement.Application/Features/Tasks/Queries`
- [Request Validation](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Behaviors/ValidationBehavior.cs): `src/ProjectManagement.Application/Common/Behaviors/ValidationBehavior.cs`
- [Persistence Contract](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Interfaces/IApplicationDbContext.cs): `src/ProjectManagement.Application/Common/Interfaces/IApplicationDbContext.cs`
- [User Context Contract](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Application/Common/Interfaces/ICurrentUserService.cs): `src/ProjectManagement.Application/Common/Interfaces/ICurrentUserService.cs`

### Domain Model

- [Project Entity](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Entities/Project.cs): `src/ProjectManagement.Domain/Entities/Project.cs`
- [Task Entity](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Entities/TaskItem.cs): `src/ProjectManagement.Domain/Entities/TaskItem.cs`
- [User Entity](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Entities/User.cs): `src/ProjectManagement.Domain/Entities/User.cs`
- [Task Status](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Enums/TaskItemStatus.cs): `src/ProjectManagement.Domain/Enums/TaskItemStatus.cs`
- [Task Priority](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Domain/Enums/TaskPriority.cs): `src/ProjectManagement.Domain/Enums/TaskPriority.cs`

### Infrastructure

- [JWT Token Service](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Infrastructure/Authentication/JwtTokenGenerator.cs): `src/ProjectManagement.Infrastructure/Authentication/JwtTokenGenerator.cs`
- [EF Core Context](https://github.com/m-a-nofal/projectmanagement/blob/main/src/ProjectManagement.Infrastructure/Persistence/ApplicationDbContext.cs): `src/ProjectManagement.Infrastructure/Persistence/ApplicationDbContext.cs`

### Other components

- **API User**
- **SQL Server**

## Connections

- API User → Authentication Routes: registers or logs in
- API User → Project Routes: manages projects
- API User → Task Routes: manages tasks
- Authentication Routes → Register and Login: sends commands (evidence: `src/ProjectManagement.API/Controllers/AuthController.cs`)
- Project Routes → Project Commands: sends commands (evidence: `src/ProjectManagement.API/Controllers/ProjectsController.cs`)
- Project Routes → Project Queries: sends queries (evidence: `src/ProjectManagement.API/Controllers/ProjectsController.cs`)
- Task Routes → Task Commands: sends commands (evidence: `src/ProjectManagement.API/Controllers/ProjectTasksController.cs`)
- Task Routes → Task Queries: sends query (evidence: `src/ProjectManagement.API/Controllers/ProjectTasksController.cs`)
- Request Validation → Exception Mapping: validation errors map
- Project Commands → Request Validation: validated by pipeline
- Project Queries → Request Validation: validated by pipeline
- Task Commands → Request Validation: validated by pipeline
- Task Queries → Request Validation: validated by pipeline
- Project Commands → Persistence Contract: uses persistence
- Project Queries → Persistence Contract: uses persistence (evidence: `src/ProjectManagement.Application/Features/Projects/Queries/GetProjects/GetProjectsQueryHandler.cs`)
- Task Commands → Persistence Contract: uses persistence (evidence: `src/ProjectManagement.Application/Features/Tasks/Commands/CreateTask/CreateTaskCommandHandler.cs`)
- Task Queries → Persistence Contract: uses persistence (evidence: `src/ProjectManagement.Application/Features/Tasks/Queries/GetTasksByProject/GetTasksByProjectQueryHandler.cs`)
- Project Commands → User Context Contract: checks ownership
- Project Queries → User Context Contract: checks ownership (evidence: `src/ProjectManagement.Application/Features/Projects/Queries/GetProjects/GetProjectsQueryHandler.cs`)
- Task Commands → User Context Contract: checks ownership (evidence: `src/ProjectManagement.Application/Features/Tasks/Commands/CreateTask/CreateTaskCommandHandler.cs`)
- Task Queries → User Context Contract: checks ownership (evidence: `src/ProjectManagement.Application/Features/Tasks/Queries/GetTasksByProject/GetTasksByProjectQueryHandler.cs`)
- Current User Adapter → User Context Contract: implements contract (evidence: `src/ProjectManagement.API/Services/CurrentUserService.cs`)
- Register and Login → JWT Token Service: issues tokens
- Persistence Contract → EF Core Context: implemented by (evidence: `src/ProjectManagement.Infrastructure/Persistence/ApplicationDbContext.cs`)
- EF Core Context → SQL Server: reads and writes
- Project Entity → Task Entity: owns task collection (evidence: `src/ProjectManagement.Domain/Entities/Project.cs`)
- Task Entity → Task Status: has status (evidence: `src/ProjectManagement.Domain/Entities/TaskItem.cs`)
- Task Entity → Task Priority: has priority (evidence: `src/ProjectManagement.Domain/Entities/TaskItem.cs`)
- Exception Mapping → API User: returns API errors (evidence: `src/ProjectManagement.API/Middleware/GlobalExceptionHandler.cs`)
