How wakhungu3000/rentalmanagement works
Nyumba Ledger is a rental-property management application: owners manage houses and tenants, issue invoices, confirm payments, and oversee maintenance; tenants view their own records, report payments, and submit maintenance requests. The Spring web controllers route requests into services, which enforce domain rules and use repositories for persistence; snapshots assemble role-scoped data for the browser. The README documents authentication, MySQL persistence, and the product capabilities. Several feature implementations and browser scripts were not sampled, so their internal links are omitted or marked unverified.
Main entry points: repo JPA repositories · js Web pages · BillingController.java Billing API · CurrentUserService.java Current user
Components 22
Web and access
- Web pages
src/main/resources/static/js - Login and roles
src/main/java/com/nyumba/ledger/config/SecurityConfig.java - Authentication API
src/main/java/com/nyumba/ledger/web/AuthController.java - Current user
src/main/java/com/nyumba/ledger/service/CurrentUserService.java - Snapshot API
src/main/java/com/nyumba/ledger/web/SnapshotController.java - Role-scoped snapshot
src/main/java/com/nyumba/ledger/service/SnapshotService.java - Response mapping
src/main/java/com/nyumba/ledger/service/Mapper.java - Validated requests
src/main/java/com/nyumba/ledger/dto/Requests.java - Response DTOs
src/main/java/com/nyumba/ledger/dto/Dtos.java
Rental operations
- House API
src/main/java/com/nyumba/ledger/web/HouseController.java - House management
src/main/java/com/nyumba/ledger/service/HouseService.java - Tenant API
src/main/java/com/nyumba/ledger/web/TenantController.java - Tenant management
src/main/java/com/nyumba/ledger/service/TenantService.java - Maintenance API
src/main/java/com/nyumba/ledger/web/MaintenanceController.java - Maintenance requests
src/main/java/com/nyumba/ledger/service/MaintenanceService.java
Billing and payments
- Billing API
src/main/java/com/nyumba/ledger/web/BillingController.java - Invoice and payment rules
src/main/java/com/nyumba/ledger/service/BillingService.java - Invoice notifications
src/main/java/com/nyumba/ledger/service/NotificationService.java
Domain and persistence
- Rental entities
src/main/java/com/nyumba/ledger/domain - JPA repositories
src/main/java/com/nyumba/ledger/repo - MySQL database
Other components
- Owner / tenant
Connections 29
- Owner / tenant → Web pages: uses
- Web pages → Authentication API: signs in
- Web pages → House API: manages houses
- Web pages → Tenant API: manages tenants
- Web pages → Billing API: handles billing
- Web pages → Maintenance API: reports issues
- Web pages → Snapshot API: loads records
- Login and roles → Authentication API: secures
- Authentication API → Current user: identifies user
src/main/java/com/nyumba/ledger/web/AuthController.java - Current user → JPA repositories: looks up account
src/main/java/com/nyumba/ledger/service/CurrentUserService.java - Snapshot API → Current user: identifies user
src/main/java/com/nyumba/ledger/web/SnapshotController.java - Snapshot API → Role-scoped snapshot: loads snapshot
src/main/java/com/nyumba/ledger/web/SnapshotController.java - Role-scoped snapshot → JPA repositories: reads records
src/main/java/com/nyumba/ledger/service/SnapshotService.java - Role-scoped snapshot → Response mapping: maps records
src/main/java/com/nyumba/ledger/service/SnapshotService.java - House API → House management: delegates
src/main/java/com/nyumba/ledger/web/HouseController.java - Tenant API → Tenant management: delegates
src/main/java/com/nyumba/ledger/web/TenantController.java - Maintenance API → Maintenance requests: delegates
src/main/java/com/nyumba/ledger/web/MaintenanceController.java - Billing API → Invoice and payment rules: delegates
src/main/java/com/nyumba/ledger/web/BillingController.java - Billing API → Current user: identifies payer
src/main/java/com/nyumba/ledger/web/BillingController.java - Invoice and payment rules → Invoice notifications: notifies invoice
src/main/java/com/nyumba/ledger/service/BillingService.java - Invoice and payment rules → JPA repositories: reads and writes
src/main/java/com/nyumba/ledger/service/BillingService.java - Tenant management → JPA repositories: creates tenant login
src/main/java/com/nyumba/ledger/service/TenantService.java - House management → JPA repositories: reads and writes
src/main/java/com/nyumba/ledger/service/HouseService.java - Maintenance requests → JPA repositories: persists requests
src/main/java/com/nyumba/ledger/service/MaintenanceService.java - Billing API → Response mapping: maps responses
src/main/java/com/nyumba/ledger/web/BillingController.java - Response mapping → Response DTOs: builds response shapes
src/main/java/com/nyumba/ledger/service/Mapper.java - Billing API → Validated requests: accepts input
src/main/java/com/nyumba/ledger/web/BillingController.java - JPA repositories → Rental entities: stores entities
src/main/java/com/nyumba/ledger/repo/TenantRepository.java - JPA repositories → MySQL database: persists data