# haruto1508/motel-management architecture

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

## Overview

This is a motel-management backend: staff-facing API requests support authentication, room and tenant administration, contracts, utility readings and service pricing, invoices and payments, and dashboard summaries. The principal workflow is managing rooms and occupants, recording lease and utility data, then billing and tracking payment. The tree and excerpts confirm several controller-to-service calls and service-to-repository operations; many controllers and services (including tenant, payment, dashboard) are unsampled, so their internal links are not asserted.

Main entry points: [`motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java`](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java) (Invoice service), [`motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java`](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java) (Room queries), [`motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java`](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java) (Contract service), [`motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java`](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java) (Room service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API access"]
  node_authapi["Authentication API"]
  node_contractapi["Contract API"]
  node_roomapi["Room API"]
  node_tenantapi["Tenant API"]
  node_utilityapi["Utility API"]
  node_invoiceapi["Invoice API"]
  node_paymentapi["Payment API"]
  node_dashboardapi["Dashboard API"]
  node_response["API envelope<br/>[ApiResponse.java]"]
end

subgraph group_leases["Rooms and leases"]
  node_contractservice["Contract service"]
  node_roomservice["Room service<br/>[RoomService.java]"]
  node_tenantservice["Tenant service<br/>[TenantService.java]"]
end

subgraph group_billing["Utilities and billing"]
  node_utilityservice["Utility service"]
  node_invoiceservice["Invoice service"]
end

subgraph group_identity["Identity and overview"]
  node_authservice["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT tokens"]
  node_dashboardservice["Dashboard service"]
end

subgraph group_persistence["Persistence"]
  node_rooms[("Room records<br/>[Room.java]")]
  node_contracts[("Contract records<br/>[Contract.java]")]
  node_tenants[("Tenant records<br/>[Tenant.java]")]
  node_utilities[("Utility readings")]
  node_invoices[("Invoice records<br/>[Invoice.java]")]
  node_contractrepo["Contract queries"]
  node_roomrepo["Room queries"]
  node_invoicerepo["Invoice queries"]
  node_tenantrepo["Tenant queries"]
end

node_staff(("Staff client"))

node_staff -->|"authenticates"| node_authapi
node_staff -->|"manages rooms"| node_roomapi
node_staff -->|"manages leases"| node_contractapi
node_staff -->|"records readings"| node_utilityapi
node_staff -->|"manages billing"| node_invoiceapi
node_authapi -.->|"delegates to"| node_authservice
node_contractapi -->|"delegates to"| node_contractservice
node_roomapi -->|"delegates to"| node_roomservice
node_tenantapi -.->|"delegates to"| node_tenantservice
node_utilityapi -->|"delegates to"| node_utilityservice
node_invoiceapi -.->|"delegates to"| node_invoiceservice
node_paymentapi -.->|"delegates to"| node_invoiceservice
node_dashboardapi -.->|"delegates to"| node_dashboardservice
node_authservice -->|"issues tokens"| node_jwt
node_contractservice -->|"queries and saves"| node_contractrepo
node_contractservice -->|"loads rooms"| node_roomrepo
node_contractservice -->|"loads tenants"| node_tenantrepo
node_roomservice -->|"queries rooms"| node_roomrepo
node_roomservice -->|"loads tenants"| node_tenantrepo
node_utilityservice -->|"loads room"| node_roomrepo
node_utilityservice -->|"records readings"| node_utilities
node_invoiceservice -->|"loads room"| node_roomrepo
node_invoiceservice -->|"finds active lease"| node_contractrepo
node_invoiceservice -->|"queries and saves"| node_invoicerepo
node_invoiceservice -->|"creates invoice"| node_invoices
node_contractrepo -->|"queries"| node_contracts
node_roomrepo -->|"queries"| node_rooms
node_invoicerepo -->|"queries"| node_invoices

click node_authapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/AuthController.java"
click node_contractapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/ContractController.java"
click node_roomapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/RoomController.java"
click node_tenantapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/TenantController.java"
click node_utilityapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/UtilityController.java"
click node_invoiceapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/InvoiceController.java"
click node_paymentapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/PaymentController.java"
click node_dashboardapi "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/DashboardController.java"
click node_authservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/AuthService.java"
click node_jwt "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/config/JwtTokenProvider.java"
click node_contractservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java"
click node_roomservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java"
click node_tenantservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/TenantService.java"
click node_utilityservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java"
click node_invoiceservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java"
click node_dashboardservice "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/DashboardService.java"
click node_rooms "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Room.java"
click node_contracts "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Contract.java"
click node_tenants "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Tenant.java"
click node_utilities "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/UtilityReading.java"
click node_invoices "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Invoice.java"
click node_contractrepo "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/ContractRepository.java"
click node_roomrepo "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java"
click node_invoicerepo "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/InvoiceRepository.java"
click node_tenantrepo "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/TenantRepository.java"
click node_response "https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/dto/ApiResponse.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_authapi,node_contractapi,node_roomapi,node_tenantapi,node_utilityapi,node_invoiceapi,node_paymentapi,node_dashboardapi,node_response,node_staff toneBlue
class node_contractservice,node_roomservice,node_tenantservice toneAmber
class node_utilityservice,node_invoiceservice toneMint
class node_authservice,node_jwt,node_dashboardservice toneRose
class node_rooms,node_contracts,node_tenants,node_utilities,node_invoices,node_contractrepo,node_roomrepo,node_invoicerepo,node_tenantrepo toneIndigo
```

## Components

### API access

- [Authentication API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/AuthController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/AuthController.java`
- [Contract API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/ContractController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/ContractController.java`
- [Room API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/RoomController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/RoomController.java`
- [Tenant API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/TenantController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/TenantController.java`
- [Utility API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/UtilityController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/UtilityController.java`
- [Invoice API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/InvoiceController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/InvoiceController.java`
- [Payment API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/PaymentController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/PaymentController.java`
- [Dashboard API](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/DashboardController.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/DashboardController.java`
- [API envelope](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/dto/ApiResponse.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/dto/ApiResponse.java`

### Rooms and leases

- [Contract service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java`
- [Room service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java`
- [Tenant service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/TenantService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/TenantService.java`

### Utilities and billing

- [Utility service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java`
- [Invoice service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java`

### Identity and overview

- [Auth service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/AuthService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/AuthService.java`
- [JWT tokens](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/config/JwtTokenProvider.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/config/JwtTokenProvider.java`
- [Dashboard service](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/DashboardService.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/DashboardService.java`

### Persistence

- [Room records](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Room.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Room.java`
- [Contract records](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Contract.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Contract.java`
- [Tenant records](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Tenant.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Tenant.java`
- [Utility readings](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/UtilityReading.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/UtilityReading.java`
- [Invoice records](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Invoice.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Invoice.java`
- [Contract queries](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/ContractRepository.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/ContractRepository.java`
- [Room queries](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java`
- [Invoice queries](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/InvoiceRepository.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/InvoiceRepository.java`
- [Tenant queries](https://github.com/haruto1508/motel-management/blob/main/motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/TenantRepository.java): `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/TenantRepository.java`

### Other components

- **Staff client**

## Connections

- Staff client → Authentication API: authenticates
- Staff client → Room API: manages rooms
- Staff client → Contract API: manages leases
- Staff client → Utility API: records readings
- Staff client → Invoice API: manages billing
- Authentication API → Auth service: delegates to
- Contract API → Contract service: delegates to (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/ContractController.java`)
- Room API → Room service: delegates to (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/RoomController.java`)
- Tenant API → Tenant service: delegates to
- Utility API → Utility service: delegates to (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/UtilityController.java`)
- Invoice API → Invoice service: delegates to (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/InvoiceController.java`)
- Payment API → Invoice service: delegates to
- Dashboard API → Dashboard service: delegates to
- Auth service → JWT tokens: issues tokens (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/AuthService.java`)
- Contract service → Contract queries: queries and saves (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java`)
- Contract service → Room queries: loads rooms (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java`)
- Contract service → Tenant queries: loads tenants (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java`)
- Room service → Room queries: queries rooms (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java`)
- Room service → Tenant queries: loads tenants (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java`)
- Utility service → Room queries: loads room (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java`)
- Utility service → Utility readings: records readings (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java`)
- Invoice service → Room queries: loads room (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java`)
- Invoice service → Contract queries: finds active lease (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java`)
- Invoice service → Invoice queries: queries and saves (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java`)
- Invoice service → Invoice records: creates invoice (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java`)
- Contract queries → Contract records: queries (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/ContractRepository.java`)
- Room queries → Room records: queries (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java`)
- Invoice queries → Invoice records: queries (evidence: `motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/InvoiceRepository.java`)
