# vennhuu/vtit_taskmanagementsystem architecture

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

- Interactive diagram: https://gitdiagram.com/vennhuu/vtit_taskmanagementsystem
- Repository: https://github.com/vennhuu/vtit_taskmanagementsystem

## Overview

This is a Spring Boot REST API for project and task management. Users register or sign in, manage projects and members, create and assign tasks, update task status, and review activity history. The sampled task service shows validation, persistence, status-change logging, caching, filtering, and queued assignment-email requests. The README also documents token rotation, role-based permissions, Redis, and asynchronous email. Some controller and integration wiring is not sampled, so those connections are omitted rather than inferred.

Main entry points: [`src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java) (Task service), [`src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectRepository.java`](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectRepository.java) (Project repository), [`src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectMemberRepository.java`](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectMemberRepository.java) (Membership repository), [`src/main/java/com/vennhuu/TaskManagementSystem/Repository/UserRepository.java`](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_user["Users<br/>[User.java]"]
  node_auth["Authentication"]
  node_refresh["Token rotation"]
end

subgraph group_projects["Projects and membership"]
  node_project["Projects<br/>[Project.java]"]
  node_project_service["Project service"]
  node_membership["Membership<br/>[ProjectMember.java]"]
  node_membership_service["Member service"]
  node_project_role["Project roles<br/>[ProjectRole.java]"]
end

subgraph group_tasks["Tasks and activity"]
  node_task_controller["Task API"]
  node_task_service["Task service<br/>[TaskService.java]"]
  node_task["Tasks and status<br/>[Task.java]"]
  node_task_status["Task statuses<br/>[TaskStatus.java]"]
  node_task_filter["Task filtering"]
  node_activity["Activity history"]
end

subgraph group_platform["Persistence and messaging"]
  node_project_repo["Project repository"]
  node_member_repo["Membership repository"]
  node_task_repo["Task repository"]
  node_user_repo["User repository"]
  node_project_cache["Project cache"]
  node_task_cache["Task cache"]
  node_email_queue["Email producer"]
end

node_postgres[("PostgreSQL")]
node_redis[("Redis")]
node_rabbitmq["RabbitMQ"]
node_actor(("API user"))

node_actor -.->|"registers / signs in"| node_auth
node_actor -.->|"manages tasks"| node_task_controller
node_task_controller -->|"delegates to"| node_task_service
node_auth -->|"rotates tokens"| node_refresh
node_project_service -->|"queries / saves"| node_project_repo
node_project_service -->|"checks membership"| node_member_repo
node_project_service -->|"loads users"| node_user_repo
node_project_service -->|"uses cache"| node_project_cache
node_membership_service -->|"loads projects"| node_project_repo
node_membership_service -->|"manages membership"| node_member_repo
node_membership_service -->|"loads users"| node_user_repo
node_task_service -->|"queries / saves"| node_task_repo
node_task_service -->|"loads projects"| node_project_repo
node_task_service -->|"checks membership"| node_member_repo
node_task_service -->|"loads users"| node_user_repo
node_task_service -->|"combines filters"| node_task_filter
node_task_service -->|"reads / evicts"| node_task_cache
node_task_service -->|"records status changes"| node_activity
node_task_service -->|"publishes assignment email"| node_email_queue
node_activity -->|"loads user"| node_user_repo
node_activity -->|"checks project"| node_project_repo
node_activity -->|"checks membership"| node_member_repo
node_project_repo -.->|"persists projects"| node_postgres
node_task_repo -.->|"persists tasks"| node_postgres
node_member_repo -.->|"persists membership"| node_postgres
node_user_repo -.->|"persists users"| node_postgres
node_project_cache -.->|"caches project data"| node_redis
node_task_cache -.->|"caches task data"| node_redis
node_email_queue -.->|"publishes messages"| node_rabbitmq

click node_user "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/User.java"
click node_auth "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Controller/AuthController.java"
click node_refresh "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/RefreshTokenService.java"
click node_project "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/Project.java"
click node_project_service "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java"
click node_membership "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/ProjectMember.java"
click node_membership_service "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectMemberService.java"
click node_project_role "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Utils/constant/ProjectRole.java"
click node_task_controller "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Controller/TaskController.java"
click node_task_service "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java"
click node_task "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/Task.java"
click node_task_status "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Utils/constant/TaskStatus.java"
click node_task_filter "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Spec/TaskSpecification.java"
click node_activity "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/ActivityLogService.java"
click node_project_repo "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectRepository.java"
click node_member_repo "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectMemberRepository.java"
click node_task_repo "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/TaskRepository.java"
click node_user_repo "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/UserRepository.java"
click node_project_cache "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/cache/ProjectCacheService.java"
click node_task_cache "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/cache/TaskCacheService.java"
click node_email_queue "https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/producer/RabbitMQProducer.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_user,node_auth,node_refresh,node_actor toneBlue
class node_project,node_project_service,node_membership,node_membership_service,node_project_role,node_postgres,node_redis toneAmber
class node_task_controller,node_task_service,node_task,node_task_status,node_task_filter,node_activity toneMint
class node_project_repo,node_member_repo,node_task_repo,node_user_repo,node_project_cache,node_task_cache,node_email_queue toneRose
class node_rabbitmq toneIndigo
```

## Components

### Identity and access

- [Users](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/User.java): `src/main/java/com/vennhuu/TaskManagementSystem/Entity/User.java`
- [Authentication](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Controller/AuthController.java): `src/main/java/com/vennhuu/TaskManagementSystem/Controller/AuthController.java`
- [Token rotation](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/RefreshTokenService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/RefreshTokenService.java`

### Projects and membership

- [Projects](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/Project.java): `src/main/java/com/vennhuu/TaskManagementSystem/Entity/Project.java`
- [Project service](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java`
- [Membership](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/ProjectMember.java): `src/main/java/com/vennhuu/TaskManagementSystem/Entity/ProjectMember.java`
- [Member service](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectMemberService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectMemberService.java`
- [Project roles](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Utils/constant/ProjectRole.java): `src/main/java/com/vennhuu/TaskManagementSystem/Utils/constant/ProjectRole.java`

### Tasks and activity

- [Task API](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Controller/TaskController.java): `src/main/java/com/vennhuu/TaskManagementSystem/Controller/TaskController.java`
- [Task service](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`
- [Tasks and status](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Entity/Task.java): `src/main/java/com/vennhuu/TaskManagementSystem/Entity/Task.java`
- [Task statuses](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Utils/constant/TaskStatus.java): `src/main/java/com/vennhuu/TaskManagementSystem/Utils/constant/TaskStatus.java`
- [Task filtering](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Spec/TaskSpecification.java): `src/main/java/com/vennhuu/TaskManagementSystem/Spec/TaskSpecification.java`
- [Activity history](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/ActivityLogService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/ActivityLogService.java`

### Persistence and messaging

- [Project repository](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectRepository.java): `src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectRepository.java`
- [Membership repository](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectMemberRepository.java): `src/main/java/com/vennhuu/TaskManagementSystem/Repository/ProjectMemberRepository.java`
- [Task repository](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/TaskRepository.java): `src/main/java/com/vennhuu/TaskManagementSystem/Repository/TaskRepository.java`
- [User repository](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Repository/UserRepository.java): `src/main/java/com/vennhuu/TaskManagementSystem/Repository/UserRepository.java`
- [Project cache](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/cache/ProjectCacheService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/cache/ProjectCacheService.java`
- [Task cache](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/cache/TaskCacheService.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/cache/TaskCacheService.java`
- [Email producer](https://github.com/vennhuu/vtit_taskmanagementsystem/blob/main/src/main/java/com/vennhuu/TaskManagementSystem/Service/producer/RabbitMQProducer.java): `src/main/java/com/vennhuu/TaskManagementSystem/Service/producer/RabbitMQProducer.java`

### Other components

- **PostgreSQL**
- **Redis**
- **RabbitMQ**
- **API user**

## Connections

- API user → Authentication: registers / signs in
- API user → Task API: manages tasks
- Task API → Task service: delegates to (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Controller/TaskController.java`)
- Authentication → Token rotation: rotates tokens (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Controller/AuthController.java`)
- Project service → Project repository: queries / saves (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java`)
- Project service → Membership repository: checks membership (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java`)
- Project service → User repository: loads users (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java`)
- Project service → Project cache: uses cache (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectService.java`)
- Member service → Project repository: loads projects (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectMemberService.java`)
- Member service → Membership repository: manages membership (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectMemberService.java`)
- Member service → User repository: loads users (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ProjectMemberService.java`)
- Task service → Task repository: queries / saves (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → Project repository: loads projects (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → Membership repository: checks membership (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → User repository: loads users (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → Task filtering: combines filters (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → Task cache: reads / evicts (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → Activity history: records status changes (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Task service → Email producer: publishes assignment email (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/TaskService.java`)
- Activity history → User repository: loads user (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ActivityLogService.java`)
- Activity history → Project repository: checks project (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ActivityLogService.java`)
- Activity history → Membership repository: checks membership (evidence: `src/main/java/com/vennhuu/TaskManagementSystem/Service/ActivityLogService.java`)
- Project repository → PostgreSQL: persists projects
- Task repository → PostgreSQL: persists tasks
- Membership repository → PostgreSQL: persists membership
- User repository → PostgreSQL: persists users
- Project cache → Redis: caches project data
- Task cache → Redis: caches task data
- Email producer → RabbitMQ: publishes messages
