How cnpm-svbk-team13/bluemoon-apartment-management-system works
BlueMoon BFMS is a Spring Boot web scaffold for apartment and household administration. The evidenced workflow is an administrator managing apartment records or household-head details: Spring MVC controllers delegate to services, which read and write through Spring Data repositories and JPA-backed domain models. The README also describes fees, invoices, reports, and a future resident portal, but this tree does not show implementations for those capabilities. Several controller and service relationships are supported by the source index; the broader web-to-database layering is documented in the README.
Main entry points: HouseholdHeadService.java Household-head changes · HouseholdDetailsService.java Household details · ApartmentService.java Apartment management · ApartmentRepository.java Apartment repository
Components 21
Web interface
- Spring MVC
src/main/java/com/bluemoon/bfms/controller - Apartment routes
src/main/java/com/bluemoon/bfms/controller/ApartmentController.java - Household routes
src/main/java/com/bluemoon/bfms/controller/HouseholdHeadController.java
Business services
- Apartment management
src/main/java/com/bluemoon/bfms/service/ApartmentService.java - Apartment access
src/main/java/com/bluemoon/bfms/service/ApartmentAccessService.java - Household-head changes
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household details
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java
Persistence
- Apartment repository
src/main/java/com/bluemoon/bfms/repository/ApartmentRepository.java - Household repository
src/main/java/com/bluemoon/bfms/repository/HouseholdRepository.java - Resident repository
src/main/java/com/bluemoon/bfms/repository/ResidentRepository.java - Person repository
src/main/java/com/bluemoon/bfms/repository/PersonRepository.java - Head-history repository
src/main/java/com/bluemoon/bfms/repository/HouseholdHeadHistoryRepository.java - Apartment actor repository
src/main/java/com/bluemoon/bfms/repository/ApartmentActorRepository.java - User repository
src/main/java/com/bluemoon/bfms/repository/UserRepository.java - Audit repository
src/main/java/com/bluemoon/bfms/repository/AuditLogRepository.java
Domain data
- Apartment and household entities
src/main/java/com/bluemoon/bfms/model - People and resident entities
src/main/java/com/bluemoon/bfms/model - Head-change history
src/main/java/com/bluemoon/bfms/model/HouseholdHeadHistory.java - Audit log
src/main/java/com/bluemoon/bfms/model/AuditLog.java
Other components
- Administrator
- PostgreSQL
Connections 34
- Administrator → Spring MVC: uses web app
README.md - Spring MVC → Apartment routes: routes requests
- Spring MVC → Household routes: routes requests
- Apartment routes → Apartment management: delegates to
src/main/java/com/bluemoon/bfms/controller/ApartmentController.java - Apartment routes → Apartment access: checks access
src/main/java/com/bluemoon/bfms/controller/ApartmentController.java - Household routes → Household-head changes: delegates to
src/main/java/com/bluemoon/bfms/controller/HouseholdHeadController.java - Household routes → Household details: loads details
src/main/java/com/bluemoon/bfms/controller/HouseholdHeadController.java - Apartment management → Apartment repository: reads and writes
src/main/java/com/bluemoon/bfms/service/ApartmentService.java - Apartment management → User repository: resolves actor
src/main/java/com/bluemoon/bfms/service/ApartmentService.java - Apartment management → Audit repository: records audit
src/main/java/com/bluemoon/bfms/service/ApartmentService.java - Apartment access → Apartment actor repository: checks editor
src/main/java/com/bluemoon/bfms/service/ApartmentAccessService.java - Household-head changes → Apartment repository: loads apartment
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household-head changes → Household repository: reads and writes
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household-head changes → Person repository: resolves people
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household-head changes → Resident repository: checks residence
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household-head changes → Head-history repository: records changes
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household-head changes → Audit repository: records audit
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household-head changes → User repository: resolves actor
src/main/java/com/bluemoon/bfms/service/HouseholdHeadService.java - Household details → Apartment repository: loads apartment
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java - Household details → Household repository: loads active household
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java - Household details → Resident repository: checks residence
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java - Household details → Head-history repository: loads history
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java - Household details → Person repository: finds person
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java - Apartment repository → Apartment and household entities: persists apartments
src/main/java/com/bluemoon/bfms/repository/ApartmentRepository.java - Household repository → Apartment and household entities: persists households
src/main/java/com/bluemoon/bfms/repository/HouseholdRepository.java - Resident repository → People and resident entities: persists residents
src/main/java/com/bluemoon/bfms/repository/ResidentRepository.java - Person repository → People and resident entities: persists people
src/main/java/com/bluemoon/bfms/service/HouseholdDetailsService.java - Head-history repository → Head-change history: persists history
src/main/java/com/bluemoon/bfms/repository/HouseholdHeadHistoryRepository.java - Audit repository → Audit log: persists audit
src/main/java/com/bluemoon/bfms/service/ApartmentService.java - User repository → People and resident entities: references user model
src/main/java/com/bluemoon/bfms/repository/UserRepository.java - Apartment and household entities → PostgreSQL: stored via JPA
README.md - People and resident entities → PostgreSQL: stored via JPA
README.md - Head-change history → PostgreSQL: stored via JPA
README.md - Audit log → PostgreSQL: stored via JPA
README.md