How haruto1508/motel-management works
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: InvoiceService.java Invoice service · RoomRepository.java Room queries · ContractService.java Contract service · RoomService.java Room service
Components 27
API access
- Authentication API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/AuthController.java - Contract API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/ContractController.java - Room API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/RoomController.java - Tenant API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/TenantController.java - Utility API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/UtilityController.java - Invoice API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/InvoiceController.java - Payment API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/PaymentController.java - Dashboard API
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/DashboardController.java - API envelope
motel-backend/src/main/java/vn/edu/fpt/motelbackend/dto/ApiResponse.java
Rooms and leases
- Contract service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java - Room service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java - Tenant service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/TenantService.java
Utilities and billing
- Utility service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java - Invoice service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java
Identity and overview
- Auth service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/AuthService.java - JWT tokens
motel-backend/src/main/java/vn/edu/fpt/motelbackend/config/JwtTokenProvider.java - Dashboard service
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/DashboardService.java
Persistence
- Room records
motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Room.java - Contract records
motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Contract.java - Tenant records
motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Tenant.java - Utility readings
motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/UtilityReading.java - Invoice records
motel-backend/src/main/java/vn/edu/fpt/motelbackend/entity/Invoice.java - Contract queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/ContractRepository.java - Room queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java - Invoice queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/InvoiceRepository.java - Tenant queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/TenantRepository.java
Other components
- Staff client
Connections 28
- 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
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/ContractController.java - Room API → Room service: delegates to
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/RoomController.java - Tenant API → Tenant service: delegates to
- Utility API → Utility service: delegates to
motel-backend/src/main/java/vn/edu/fpt/motelbackend/controller/UtilityController.java - Invoice API → Invoice service: delegates to
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
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/AuthService.java - Contract service → Contract queries: queries and saves
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java - Contract service → Room queries: loads rooms
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java - Contract service → Tenant queries: loads tenants
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/ContractService.java - Room service → Room queries: queries rooms
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java - Room service → Tenant queries: loads tenants
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/RoomService.java - Utility service → Room queries: loads room
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java - Utility service → Utility readings: records readings
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/UtilityService.java - Invoice service → Room queries: loads room
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java - Invoice service → Contract queries: finds active lease
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java - Invoice service → Invoice queries: queries and saves
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java - Invoice service → Invoice records: creates invoice
motel-backend/src/main/java/vn/edu/fpt/motelbackend/service/InvoiceService.java - Contract queries → Contract records: queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/ContractRepository.java - Room queries → Room records: queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/RoomRepository.java - Invoice queries → Invoice records: queries
motel-backend/src/main/java/vn/edu/fpt/motelbackend/repository/InvoiceRepository.java