# dh1506/qlxdbe architecture

> Architecture diagram of the GitHub repository dh1506/qlxdbe, 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/dh1506/qlxdbe
- Repository: https://github.com/dh1506/qlxdbe

## Overview

QLXDBE is a Spring backend for user accounts and project work, including projects, membership, tasks, materials, and material usage. The principal workflow is an API client sending requests to controllers, which delegate to service contracts and return domain responses; services use repositories to access persisted entities. Account flows also cover JWT authentication, profile management, and password reset email. The README is empty, so product scope is inferred from the source tree. Edges are limited to controller/service references and sampled source evidence; unsampled service internals are not treated as verified calls.

Main entry points: [`src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java`](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java) (Account workflows), [`src/main/java/com/huy/QLXDBE/repository`](https://github.com/dh1506/qlxdbe/tree/main/src/main/java/com/huy/QLXDBE/repository) (Repositories), [`src/main/java/com/huy/QLXDBE/service/interf/UserService.java`](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/interf/UserService.java) (User service contract), [`src/main/java/com/huy/QLXDBE/controller/AuthController.java`](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/AuthController.java) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_auth_api["Auth API"]
  node_material_api["Material API"]
  node_usage_api["Material usage API"]
  node_project_api["Project API"]
  node_member_api["Membership API"]
  node_task_api["Task API"]
  node_user_api["User API"]
end

subgraph group_accounts["Accounts and security"]
  node_user_service["User service contract<br/>[UserService.java]"]
  node_user_impl["Account workflows"]
  node_email_service["Email service"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
  node_security["Request security<br/>[JwtAuthFilter.java]"]
  node_user_details["User lookup"]
end

subgraph group_projects["Project delivery"]
  node_project_service["Project workflows"]
  node_member_service["Membership workflows"]
  node_task_service["Task workflows"]
end

subgraph group_resources["Materials"]
  node_material_service["Material workflows"]
  node_usage_service["Usage workflows"]
end

subgraph group_persistence["Persistence"]
  node_domain["Domain entities"]
  node_repositories[("Repositories")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_auth_api
node_client -->|"sends requests"| node_material_api
node_client -->|"sends requests"| node_usage_api
node_client -->|"sends requests"| node_project_api
node_client -->|"sends requests"| node_member_api
node_client -->|"sends requests"| node_task_api
node_client -->|"sends requests"| node_user_api
node_auth_api -->|"delegates to"| node_user_service
node_material_api -->|"delegates to"| node_material_service
node_project_api -->|"delegates to"| node_project_service
node_task_api -->|"delegates to"| node_task_service
node_member_api -.->|"delegates to"| node_member_service
node_usage_api -.->|"delegates to"| node_usage_service
node_user_api -.->|"delegates to"| node_user_service
node_user_service -.->|"implemented by"| node_user_impl
node_user_impl -->|"reads and writes"| node_repositories
node_user_impl -->|"generates token"| node_jwt
node_user_impl -->|"sends reset email"| node_email_service
node_user_details -->|"loads user"| node_repositories
node_task_service -->|"queries and updates"| node_repositories
node_repositories -.->|"persists entities"| node_domain

click node_auth_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/AuthController.java"
click node_material_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/MaterialController.java"
click node_usage_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/MaterialUsageController.java"
click node_project_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/ProjectController.java"
click node_member_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/ProjectMemberController.java"
click node_task_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/TaskController.java"
click node_user_api "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/UserController.java"
click node_user_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/interf/UserService.java"
click node_user_impl "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java"
click node_email_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/EmailServiceImpl.java"
click node_jwt "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/security/JwtUtils.java"
click node_security "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/security/JwtAuthFilter.java"
click node_user_details "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/security/CustomUserDetailsService.java"
click node_project_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/ProjectServiceImpl.java"
click node_member_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/ProjectMemberServiceImpl.java"
click node_task_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/TaskServiceImpl.java"
click node_material_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/MaterialServiceImpl.java"
click node_usage_service "https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/MaterialUsageServiceImpl.java"
click node_domain "https://github.com/dh1506/qlxdbe/tree/main/src/main/java/com/huy/QLXDBE/entity"
click node_repositories "https://github.com/dh1506/qlxdbe/tree/main/src/main/java/com/huy/QLXDBE/repository"

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_material_api,node_usage_api,node_project_api,node_member_api,node_task_api,node_user_api,node_client toneBlue
class node_user_service,node_user_impl,node_email_service,node_jwt,node_security,node_user_details toneAmber
class node_project_service,node_member_service,node_task_service toneMint
class node_material_service,node_usage_service toneRose
class node_domain,node_repositories toneIndigo
```

## Components

### API

- [Auth API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/AuthController.java): `src/main/java/com/huy/QLXDBE/controller/AuthController.java`
- [Material API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/MaterialController.java): `src/main/java/com/huy/QLXDBE/controller/MaterialController.java`
- [Material usage API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/MaterialUsageController.java): `src/main/java/com/huy/QLXDBE/controller/MaterialUsageController.java`
- [Project API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/ProjectController.java): `src/main/java/com/huy/QLXDBE/controller/ProjectController.java`
- [Membership API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/ProjectMemberController.java): `src/main/java/com/huy/QLXDBE/controller/ProjectMemberController.java`
- [Task API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/TaskController.java): `src/main/java/com/huy/QLXDBE/controller/TaskController.java`
- [User API](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/controller/UserController.java): `src/main/java/com/huy/QLXDBE/controller/UserController.java`

### Accounts and security

- [User service contract](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/interf/UserService.java): `src/main/java/com/huy/QLXDBE/service/interf/UserService.java`
- [Account workflows](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java`
- [Email service](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/EmailServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/EmailServiceImpl.java`
- [JWT utilities](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/security/JwtUtils.java): `src/main/java/com/huy/QLXDBE/security/JwtUtils.java`
- [Request security](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/security/JwtAuthFilter.java): `src/main/java/com/huy/QLXDBE/security/JwtAuthFilter.java`
- [User lookup](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/security/CustomUserDetailsService.java): `src/main/java/com/huy/QLXDBE/security/CustomUserDetailsService.java`

### Project delivery

- [Project workflows](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/ProjectServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/ProjectServiceImpl.java`
- [Membership workflows](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/ProjectMemberServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/ProjectMemberServiceImpl.java`
- [Task workflows](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/TaskServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/TaskServiceImpl.java`

### Materials

- [Material workflows](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/MaterialServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/MaterialServiceImpl.java`
- [Usage workflows](https://github.com/dh1506/qlxdbe/blob/main/src/main/java/com/huy/QLXDBE/service/impl/MaterialUsageServiceImpl.java): `src/main/java/com/huy/QLXDBE/service/impl/MaterialUsageServiceImpl.java`

### Persistence

- [Domain entities](https://github.com/dh1506/qlxdbe/tree/main/src/main/java/com/huy/QLXDBE/entity): `src/main/java/com/huy/QLXDBE/entity`
- [Repositories](https://github.com/dh1506/qlxdbe/tree/main/src/main/java/com/huy/QLXDBE/repository): `src/main/java/com/huy/QLXDBE/repository`

### Other components

- **API client**

## Connections

- API client → Auth API: sends requests
- API client → Material API: sends requests
- API client → Material usage API: sends requests
- API client → Project API: sends requests
- API client → Membership API: sends requests
- API client → Task API: sends requests
- API client → User API: sends requests
- Auth API → User service contract: delegates to (evidence: `src/main/java/com/huy/QLXDBE/controller/AuthController.java`)
- Material API → Material workflows: delegates to (evidence: `src/main/java/com/huy/QLXDBE/controller/MaterialController.java`)
- Project API → Project workflows: delegates to (evidence: `src/main/java/com/huy/QLXDBE/controller/ProjectController.java`)
- Task API → Task workflows: delegates to (evidence: `src/main/java/com/huy/QLXDBE/controller/TaskController.java`)
- Membership API → Membership workflows: delegates to
- Material usage API → Usage workflows: delegates to
- User API → User service contract: delegates to (evidence: `src/main/java/com/huy/QLXDBE/controller/UserController.java`)
- User service contract → Account workflows: implemented by (evidence: `src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java`)
- Account workflows → Repositories: reads and writes (evidence: `src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java`)
- Account workflows → JWT utilities: generates token (evidence: `src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java`)
- Account workflows → Email service: sends reset email (evidence: `src/main/java/com/huy/QLXDBE/service/impl/UserServiceImpl.java`)
- User lookup → Repositories: loads user (evidence: `src/main/java/com/huy/QLXDBE/security/CustomUserDetailsService.java`)
- Task workflows → Repositories: queries and updates (evidence: `src/main/java/com/huy/QLXDBE/service/impl/TaskServiceImpl.java`)
- Repositories → Domain entities: persists entities (evidence: `src/main/java/com/huy/QLXDBE/repository/ProjectRepository.java`)
