# mohamed-hussein-dev/task-team-management-system architecture

> Architecture diagram of the GitHub repository mohamed-hussein-dev/task-team-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohamed-hussein-dev/task-team-management-system
- Repository: https://github.com/mohamed-hussein-dev/task-team-management-system

## Overview

This is a .NET Web API for team identity, project membership and leadership, and project task collaboration. Users register or log in, then authenticated users create and manage projects and tasks; leaders can manage project tasks and assignments. Controllers dispatch requests through MediatR to application handlers, which use repository and unit-of-work abstractions backed by EF Core and Identity. The README documents role-based authorization and the domain relationships. Several handler and configuration paths are represented by their existing directories because their individual implementations were not sampled.

Main entry points: [`src/TaskTeamManagementSystem.Application/Features/Projects`](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Projects) (Project workflows), [`src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs`](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs) (EF Identity store), [`src/TaskTeamManagementSystem.Application/Features/Tasks`](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Tasks) (Task workflows), [`src/TaskTeamManagementSystem.Application/Features/Auth/Commands`](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Auth/Commands) (Auth workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_auth_api["Auth endpoints<br/>[AuthController.cs]"]
  node_project_api["Project endpoints"]
  node_task_api["Task endpoints<br/>[TaskController.cs]"]
  node_access["Leader policy"]
end

subgraph group_application["Application workflows"]
  node_auth_flow["Auth workflows<br/>[Commands]"]
  node_jwt_contract["JWT contract<br/>[IJwtGenerator.cs]"]
  node_project_flow["Project workflows<br/>[Projects]"]
  node_task_flow["Task workflows<br/>[Tasks]"]
  node_response["API responses<br/>[BaseResponse.cs]"]
  node_uow_contract["Unit of work<br/>[IUnitOfWork.cs]"]
  node_repository_contracts["Repository contracts<br/>[Repositories]"]
end

subgraph group_domain["Domain model"]
  node_project_entity["Project<br/>[Project.cs]"]
  node_task_entity["Project task<br/>[ProjectTask.cs]"]
  node_user_entity["Identity user<br/>[AppUser.cs]"]
end

subgraph group_infrastructure["Persistence and identity"]
  node_db[("EF Identity store")]
  node_generic_repo["Generic repository"]
  node_project_repo["Project repository"]
  node_task_repo["Task repository<br/>[TaskRepository.cs]"]
  node_uow_impl["Unit of work implementation<br/>[UnitOfWork.cs]"]
  node_jwt_impl["JWT generator<br/>[JwtGenerator.cs]"]
end

node_client(("API client"))

node_client -->|"registers or logs in"| node_auth_api
node_client -.->|"manages projects"| node_project_api
node_client -.->|"manages tasks"| node_task_api
node_auth_api -->|"sends requests"| node_auth_flow
node_project_api -->|"sends requests"| node_project_flow
node_project_api -->|"requests project tasks"| node_task_flow
node_task_api -->|"sends requests"| node_task_flow
node_auth_flow -->|"uses contract"| node_jwt_contract
node_auth_flow -->|"creates user"| node_user_entity
node_auth_flow -.->|"generates token"| node_jwt_impl
node_project_flow -->|"uses"| node_uow_contract
node_project_flow -->|"creates project"| node_project_entity
node_task_flow -->|"uses"| node_uow_contract
node_project_flow -->|"returns"| node_response
node_task_flow -->|"returns"| node_response
node_project_flow -.->|"queries project tasks"| node_task_flow
node_access -->|"checks project leader"| node_db
node_uow_contract -->|"exposes repositories"| node_repository_contracts
node_uow_impl -.->|"coordinates"| node_project_repo
node_uow_impl -.->|"coordinates"| node_task_repo
node_generic_repo -->|"reads and writes"| node_db
node_project_repo -->|"extends"| node_generic_repo
node_task_repo -->|"extends"| node_generic_repo
node_project_entity -->|"has many"| node_task_entity
node_user_entity -->|"leads and joins"| node_project_entity
node_user_entity -->|"may be assigned"| node_task_entity
node_db -->|"stores identity"| node_user_entity
node_db -->|"stores"| node_project_entity
node_db -->|"stores"| node_task_entity

click node_auth_api "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Controllers/AuthController.cs"
click node_project_api "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Controllers/ProjectController.cs"
click node_task_api "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Controllers/TaskController.cs"
click node_access "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Policies/TeamLeader/ProjectLeaderHandler.cs"
click node_auth_flow "https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Auth/Commands"
click node_jwt_contract "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Application/Features/Auth/Interfaces/IJwtGenerator.cs"
click node_project_flow "https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Projects"
click node_task_flow "https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Tasks"
click node_response "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Application/Features/Common/Responses/BaseResponse.cs"
click node_uow_contract "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Application/Interfaces/IUnitOfWork.cs"
click node_repository_contracts "https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Interfaces/Repositories"
click node_project_entity "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Domain/Entities/Project.cs"
click node_task_entity "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Domain/Entities/ProjectTask.cs"
click node_user_entity "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Domain/Entities/Identtity/AppUser.cs"
click node_db "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs"
click node_generic_repo "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/GenericRepository.cs"
click node_project_repo "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/ProjectRepository.cs"
click node_task_repo "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/TaskRepository.cs"
click node_uow_impl "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/UnitOfWork.cs"
click node_jwt_impl "https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Identity/JwtGenerator.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_api,node_project_api,node_task_api,node_access,node_client toneBlue
class node_auth_flow,node_jwt_contract,node_project_flow,node_task_flow,node_response,node_uow_contract,node_repository_contracts toneAmber
class node_project_entity,node_task_entity,node_user_entity toneMint
class node_db,node_generic_repo,node_project_repo,node_task_repo,node_uow_impl,node_jwt_impl toneRose
```

## Components

### API and access

- [Auth endpoints](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Controllers/AuthController.cs): `src/TaskTeamManagementSystem.Api/Controllers/AuthController.cs`
- [Project endpoints](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Controllers/ProjectController.cs): `src/TaskTeamManagementSystem.Api/Controllers/ProjectController.cs`
- [Task endpoints](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Controllers/TaskController.cs): `src/TaskTeamManagementSystem.Api/Controllers/TaskController.cs`
- [Leader policy](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Api/Policies/TeamLeader/ProjectLeaderHandler.cs): `src/TaskTeamManagementSystem.Api/Policies/TeamLeader/ProjectLeaderHandler.cs`

### Application workflows

- [Auth workflows](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Auth/Commands): `src/TaskTeamManagementSystem.Application/Features/Auth/Commands`
- [JWT contract](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Application/Features/Auth/Interfaces/IJwtGenerator.cs): `src/TaskTeamManagementSystem.Application/Features/Auth/Interfaces/IJwtGenerator.cs`
- [Project workflows](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Projects): `src/TaskTeamManagementSystem.Application/Features/Projects`
- [Task workflows](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Features/Tasks): `src/TaskTeamManagementSystem.Application/Features/Tasks`
- [API responses](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Application/Features/Common/Responses/BaseResponse.cs): `src/TaskTeamManagementSystem.Application/Features/Common/Responses/BaseResponse.cs`
- [Unit of work](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Application/Interfaces/IUnitOfWork.cs): `src/TaskTeamManagementSystem.Application/Interfaces/IUnitOfWork.cs`
- [Repository contracts](https://github.com/mohamed-hussein-dev/task-team-management-system/tree/main/src/TaskTeamManagementSystem.Application/Interfaces/Repositories): `src/TaskTeamManagementSystem.Application/Interfaces/Repositories`

### Domain model

- [Project](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Domain/Entities/Project.cs): `src/TaskTeamManagementSystem.Domain/Entities/Project.cs`
- [Project task](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Domain/Entities/ProjectTask.cs): `src/TaskTeamManagementSystem.Domain/Entities/ProjectTask.cs`
- [Identity user](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Domain/Entities/Identtity/AppUser.cs): `src/TaskTeamManagementSystem.Domain/Entities/Identtity/AppUser.cs`

### Persistence and identity

- [EF Identity store](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs): `src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs`
- [Generic repository](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/GenericRepository.cs): `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/GenericRepository.cs`
- [Project repository](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/ProjectRepository.cs): `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/ProjectRepository.cs`
- [Task repository](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/TaskRepository.cs): `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/TaskRepository.cs`
- [Unit of work implementation](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/UnitOfWork.cs): `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/UnitOfWork.cs`
- [JWT generator](https://github.com/mohamed-hussein-dev/task-team-management-system/blob/main/src/TaskTeamManagementSystem.Infrastructure/Identity/JwtGenerator.cs): `src/TaskTeamManagementSystem.Infrastructure/Identity/JwtGenerator.cs`

### Other components

- **API client**

## Connections

- API client → Auth endpoints: registers or logs in (evidence: `src/TaskTeamManagementSystem.Api/Controllers/AuthController.cs`)
- API client → Project endpoints: manages projects (evidence: `README.md`)
- API client → Task endpoints: manages tasks (evidence: `README.md`)
- Auth endpoints → Auth workflows: sends requests (evidence: `src/TaskTeamManagementSystem.Api/Controllers/AuthController.cs`)
- Project endpoints → Project workflows: sends requests (evidence: `src/TaskTeamManagementSystem.Api/Controllers/ProjectController.cs`)
- Project endpoints → Task workflows: requests project tasks (evidence: `src/TaskTeamManagementSystem.Api/Controllers/ProjectController.cs`)
- Task endpoints → Task workflows: sends requests (evidence: `src/TaskTeamManagementSystem.Api/Controllers/TaskController.cs`)
- Auth workflows → JWT contract: uses contract (evidence: `src/TaskTeamManagementSystem.Application/Features/Auth/Commands/RegisterUserCommandHandler.cs`)
- Auth workflows → Identity user: creates user (evidence: `src/TaskTeamManagementSystem.Application/Features/Auth/Commands/RegisterUserCommandHandler.cs`)
- Auth workflows → JWT generator: generates token (evidence: `src/TaskTeamManagementSystem.Application/Features/Auth/Commands/LoginUserCommandHandler.cs`)
- Project workflows → Unit of work: uses (evidence: `src/TaskTeamManagementSystem.Application/Features/Projects/Commands/CreateProjectCommandHandler.cs`)
- Project workflows → Project: creates project (evidence: `src/TaskTeamManagementSystem.Application/Features/Projects/Commands/CreateProjectCommandHandler.cs`)
- Task workflows → Unit of work: uses (evidence: `src/TaskTeamManagementSystem.Application/Features/Tasks/Handlers/UpdateTaskHandler.cs`)
- Project workflows → API responses: returns (evidence: `src/TaskTeamManagementSystem.Application/Features/Projects/Commands/CreateProjectCommandHandler.cs`)
- Task workflows → API responses: returns (evidence: `src/TaskTeamManagementSystem.Application/Features/Tasks/Handlers/UpdateTaskHandler.cs`)
- Project workflows → Task workflows: queries project tasks
- Leader policy → EF Identity store: checks project leader (evidence: `src/TaskTeamManagementSystem.Api/Policies/TeamLeader/ProjectLeaderHandler.cs`)
- Unit of work → Repository contracts: exposes repositories (evidence: `src/TaskTeamManagementSystem.Application/Interfaces/IUnitOfWork.cs`)
- Unit of work implementation → Project repository: coordinates
- Unit of work implementation → Task repository: coordinates
- Generic repository → EF Identity store: reads and writes (evidence: `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/GenericRepository.cs`)
- Project repository → Generic repository: extends (evidence: `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/ProjectRepository.cs`)
- Task repository → Generic repository: extends (evidence: `src/TaskTeamManagementSystem.Infrastructure/Persistence/Repositories/TaskRepository.cs`)
- Project → Project task: has many (evidence: `README.md`)
- Identity user → Project: leads and joins (evidence: `README.md`)
- Identity user → Project task: may be assigned (evidence: `README.md`)
- EF Identity store → Identity user: stores identity (evidence: `src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs`)
- EF Identity store → Project: stores (evidence: `src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs`)
- EF Identity store → Project task: stores (evidence: `src/TaskTeamManagementSystem.Infrastructure/Persistence/ApplicationDbContext.cs`)
