# doanhvan-creator/24ct2_doanhvan_cnpm architecture

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

- Interactive diagram: https://gitdiagram.com/doanhvan-creator/24ct2_doanhvan_cnpm
- Repository: https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm

## Overview

This Spring MVC application manages rental rooms, tenants, invoices and repair requests, with separate admin, landlord and tenant capabilities. Users enter through role-oriented web controllers; controllers delegate work to services, which use repositories for persistence. The tenant workflow includes viewing assigned rooms and bills, paying a bill, and submitting a repair request. Admin overview, account and statistics features are documented, but their detailed implementation was not sampled. Template dispatch and database wiring are not shown in the excerpts, so those links are omitted.

Main entry points: [`src/main/java/com/nhatro/service/UserService.java`](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/UserService.java) (User management), [`src/main/java/com/nhatro/service/PhongService.java`](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/PhongService.java) (Room management), [`src/main/java/com/nhatro/controller/AdminController.java`](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/AdminController.java) (Admin actions), [`src/main/java/com/nhatro/controller/ChuTroController.java`](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/ChuTroController.java) (Landlord actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and access"]
  node_admin["Admin actions"]
  node_landlord["Landlord actions"]
  node_tenant["Tenant actions"]
  node_auth["Sign-in and registration"]
  node_home["Home page"]
  node_security["Access control"]
end

subgraph group_operations["Rental operations"]
  node_usersvc["User management<br/>[UserService.java]"]
  node_roomsvc["Room management<br/>[PhongService.java]"]
  node_billsvc["Invoice management<br/>[HoaDonService.java]"]
  node_repairsvc["Repair requests"]
end

subgraph group_domain["Domain and persistence"]
  node_user["User records<br/>[User.java]"]
  node_room["Room records<br/>[Phong.java]"]
  node_bill["Invoice records<br/>[HoaDon.java]"]
  node_repair["Repair records<br/>[SuaChua.java]"]
  node_userrepo["User repository"]
  node_roomrepo["Room repository"]
  node_billrepo["Invoice repository"]
  node_repairrepo["Repair repository"]
end

subgraph group_setup["Application setup"]
  node_initializer["Sample data setup"]
  node_app["Application entry"]
end

node_adminactor(("Administrator"))
node_landlordactor(("Landlord"))
node_tenantactor(("Tenant"))

node_adminactor -.->|"uses"| node_admin
node_landlordactor -.->|"uses"| node_landlord
node_tenantactor -.->|"uses"| node_tenant
node_admin -->|"delegates to"| node_usersvc
node_admin -->|"delegates to"| node_roomsvc
node_admin -->|"delegates to"| node_billsvc
node_admin -->|"delegates to"| node_repairsvc
node_landlord -->|"delegates to"| node_usersvc
node_landlord -->|"delegates to"| node_roomsvc
node_landlord -->|"delegates to"| node_billsvc
node_landlord -->|"delegates to"| node_repairsvc
node_tenant -->|"looks up user"| node_usersvc
node_tenant -->|"requests rooms"| node_roomsvc
node_tenant -->|"requests bills"| node_billsvc
node_tenant -->|"requests repairs"| node_repairsvc
node_auth -->|"delegates to"| node_usersvc
node_security -.->|"loads users"| node_userrepo
node_usersvc -->|"queries and saves"| node_userrepo
node_usersvc -->|"updates rooms"| node_roomrepo
node_usersvc -->|"deletes requests"| node_repairrepo
node_roomsvc -->|"queries and saves"| node_roomrepo
node_roomsvc -->|"deletes invoices"| node_billrepo
node_roomsvc -->|"deletes requests"| node_repairrepo
node_billsvc -->|"queries and saves"| node_billrepo
node_repairsvc -->|"queries and saves"| node_repairrepo
node_userrepo -->|"persists"| node_user
node_roomrepo -->|"persists"| node_room
node_billrepo -->|"persists"| node_bill
node_repairrepo -->|"persists"| node_repair
node_initializer -->|"initializes users"| node_userrepo
node_initializer -->|"initializes rooms"| node_roomrepo
node_initializer -->|"initializes invoices"| node_billrepo

click node_admin "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/AdminController.java"
click node_landlord "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/ChuTroController.java"
click node_tenant "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/NguoiThueController.java"
click node_auth "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/AuthController.java"
click node_home "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/HomeController.java"
click node_security "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/config/SecurityConfig.java"
click node_usersvc "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/UserService.java"
click node_roomsvc "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/PhongService.java"
click node_billsvc "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/HoaDonService.java"
click node_repairsvc "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/SuaChuaService.java"
click node_user "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/User.java"
click node_room "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/Phong.java"
click node_bill "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/HoaDon.java"
click node_repair "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/SuaChua.java"
click node_userrepo "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/UserRepository.java"
click node_roomrepo "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/PhongRepository.java"
click node_billrepo "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/HoaDonRepository.java"
click node_repairrepo "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/SuaChuaRepository.java"
click node_initializer "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/config/DataInitializer.java"
click node_app "https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/QuanLyNhaTroApplication.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_admin,node_landlord,node_tenant,node_auth,node_home,node_security toneBlue
class node_usersvc,node_roomsvc,node_billsvc,node_repairsvc toneAmber
class node_user,node_room,node_bill,node_repair,node_userrepo,node_roomrepo,node_billrepo,node_repairrepo toneMint
class node_initializer,node_app toneRose
class node_adminactor,node_landlordactor,node_tenantactor toneIndigo
```

## Components

### Web and access

- [Admin actions](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/AdminController.java): `src/main/java/com/nhatro/controller/AdminController.java`
- [Landlord actions](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/ChuTroController.java): `src/main/java/com/nhatro/controller/ChuTroController.java`
- [Tenant actions](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/NguoiThueController.java): `src/main/java/com/nhatro/controller/NguoiThueController.java`
- [Sign-in and registration](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/AuthController.java): `src/main/java/com/nhatro/controller/AuthController.java`
- [Home page](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/controller/HomeController.java): `src/main/java/com/nhatro/controller/HomeController.java`
- [Access control](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/config/SecurityConfig.java): `src/main/java/com/nhatro/config/SecurityConfig.java`

### Rental operations

- [User management](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/UserService.java): `src/main/java/com/nhatro/service/UserService.java`
- [Room management](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/PhongService.java): `src/main/java/com/nhatro/service/PhongService.java`
- [Invoice management](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/HoaDonService.java): `src/main/java/com/nhatro/service/HoaDonService.java`
- [Repair requests](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/service/SuaChuaService.java): `src/main/java/com/nhatro/service/SuaChuaService.java`

### Domain and persistence

- [User records](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/User.java): `src/main/java/com/nhatro/model/User.java`
- [Room records](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/Phong.java): `src/main/java/com/nhatro/model/Phong.java`
- [Invoice records](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/HoaDon.java): `src/main/java/com/nhatro/model/HoaDon.java`
- [Repair records](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/model/SuaChua.java): `src/main/java/com/nhatro/model/SuaChua.java`
- [User repository](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/UserRepository.java): `src/main/java/com/nhatro/repository/UserRepository.java`
- [Room repository](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/PhongRepository.java): `src/main/java/com/nhatro/repository/PhongRepository.java`
- [Invoice repository](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/HoaDonRepository.java): `src/main/java/com/nhatro/repository/HoaDonRepository.java`
- [Repair repository](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/repository/SuaChuaRepository.java): `src/main/java/com/nhatro/repository/SuaChuaRepository.java`

### Application setup

- [Sample data setup](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/config/DataInitializer.java): `src/main/java/com/nhatro/config/DataInitializer.java`
- [Application entry](https://github.com/doanhvan-creator/24ct2_doanhvan_cnpm/blob/main/src/main/java/com/nhatro/QuanLyNhaTroApplication.java): `src/main/java/com/nhatro/QuanLyNhaTroApplication.java`

### Other components

- **Administrator**
- **Landlord**
- **Tenant**

## Connections

- Administrator → Admin actions: uses (evidence: `README.md`)
- Landlord → Landlord actions: uses (evidence: `README.md`)
- Tenant → Tenant actions: uses (evidence: `README.md`)
- Admin actions → User management: delegates to (evidence: `src/main/java/com/nhatro/controller/AdminController.java`)
- Admin actions → Room management: delegates to (evidence: `src/main/java/com/nhatro/controller/AdminController.java`)
- Admin actions → Invoice management: delegates to (evidence: `src/main/java/com/nhatro/controller/AdminController.java`)
- Admin actions → Repair requests: delegates to (evidence: `src/main/java/com/nhatro/controller/AdminController.java`)
- Landlord actions → User management: delegates to (evidence: `src/main/java/com/nhatro/controller/ChuTroController.java`)
- Landlord actions → Room management: delegates to (evidence: `src/main/java/com/nhatro/controller/ChuTroController.java`)
- Landlord actions → Invoice management: delegates to (evidence: `src/main/java/com/nhatro/controller/ChuTroController.java`)
- Landlord actions → Repair requests: delegates to (evidence: `src/main/java/com/nhatro/controller/ChuTroController.java`)
- Tenant actions → User management: looks up user (evidence: `src/main/java/com/nhatro/controller/NguoiThueController.java`)
- Tenant actions → Room management: requests rooms (evidence: `src/main/java/com/nhatro/controller/NguoiThueController.java`)
- Tenant actions → Invoice management: requests bills (evidence: `src/main/java/com/nhatro/controller/NguoiThueController.java`)
- Tenant actions → Repair requests: requests repairs (evidence: `src/main/java/com/nhatro/controller/NguoiThueController.java`)
- Sign-in and registration → User management: delegates to (evidence: `src/main/java/com/nhatro/controller/AuthController.java`)
- Access control → User repository: loads users (evidence: `src/main/java/com/nhatro/config/SecurityConfig.java`)
- User management → User repository: queries and saves (evidence: `src/main/java/com/nhatro/service/UserService.java`)
- User management → Room repository: updates rooms (evidence: `src/main/java/com/nhatro/service/UserService.java`)
- User management → Repair repository: deletes requests (evidence: `src/main/java/com/nhatro/service/UserService.java`)
- Room management → Room repository: queries and saves (evidence: `src/main/java/com/nhatro/service/PhongService.java`)
- Room management → Invoice repository: deletes invoices (evidence: `src/main/java/com/nhatro/service/PhongService.java`)
- Room management → Repair repository: deletes requests (evidence: `src/main/java/com/nhatro/service/PhongService.java`)
- Invoice management → Invoice repository: queries and saves (evidence: `src/main/java/com/nhatro/service/HoaDonService.java`)
- Repair requests → Repair repository: queries and saves (evidence: `src/main/java/com/nhatro/service/SuaChuaService.java`)
- User repository → User records: persists (evidence: `src/main/java/com/nhatro/repository/UserRepository.java`)
- Room repository → Room records: persists (evidence: `src/main/java/com/nhatro/repository/PhongRepository.java`)
- Invoice repository → Invoice records: persists (evidence: `src/main/java/com/nhatro/repository/HoaDonRepository.java`)
- Repair repository → Repair records: persists (evidence: `src/main/java/com/nhatro/repository/SuaChuaRepository.java`)
- Sample data setup → User repository: initializes users (evidence: `src/main/java/com/nhatro/config/DataInitializer.java`)
- Sample data setup → Room repository: initializes rooms (evidence: `src/main/java/com/nhatro/config/DataInitializer.java`)
- Sample data setup → Invoice repository: initializes invoices (evidence: `src/main/java/com/nhatro/config/DataInitializer.java`)
