How bhumika-aga/urbannexus works
UrbanNexus is a residential-operations platform: administrators provision accounts, users authenticate and work through role-specific portals, and backend services manage residents, technicians, bookings, payments, and audit history. The documented backend layers are controllers, transactional services, repositories, and JPA models; the React client calls the REST API through Axios. The graph preserves major README capabilities, but several feature-specific controller and service links are documented rather than verified in sampled implementation excerpts.
Main entry points: axiosClient.ts Axios client · repository JPA repositories · ResidentService.java Resident management · TechnicianService.java Technician management
Components 23
React Portals
- Login view
frontend/src/views/Login.tsx - Role portals
frontend/src/views - Axios client
frontend/src/api/axiosClient.ts
Identity & Security
- Auth endpoints
backend/src/main/java/com/urbannexus/controller/AuthController.java - Authentication service
backend/src/main/java/com/urbannexus/service/AuthService.java - JWT security
backend/src/main/java/com/urbannexus/security/JwtAuthenticationFilter.java
Community Operations
- Admin endpoints
backend/src/main/java/com/urbannexus/controller/AdminController.java - Resident endpoints
backend/src/main/java/com/urbannexus/controller/ResidentController.java - Technician endpoints
backend/src/main/java/com/urbannexus/controller/TechnicianController.java - Resident management
backend/src/main/java/com/urbannexus/service/ResidentService.java - Technician management
backend/src/main/java/com/urbannexus/service/TechnicianService.java - Audit trail
backend/src/main/java/com/urbannexus/service/AuditService.java
Bookings & Finance
- Amenity endpoints
backend/src/main/java/com/urbannexus/controller/AmenityController.java - Amenity management
backend/src/main/java/com/urbannexus/service/AmenityService.java - Booking endpoints
backend/src/main/java/com/urbannexus/controller/BookingController.java - Booking operations
backend/src/main/java/com/urbannexus/service/BookingService.java - Payment endpoints
backend/src/main/java/com/urbannexus/controller/PaymentController.java - Payment tracking
backend/src/main/java/com/urbannexus/service/PaymentService.java
Persistence
- JPA repositories
backend/src/main/java/com/urbannexus/repository - Domain entities
backend/src/main/java/com/urbannexus/model - H2 / PostgreSQL
Other components
- Community user
- Administrator
Connections 32
- Community user → Login view: signs in
- Administrator → Role portals: provisions accounts
- Login view → Axios client: submits credentials
- Role portals → Axios client: calls API
frontend/src/views/resident/DuesManager.tsx - Axios client → Auth endpoints: sends REST requests
- Axios client → Admin endpoints: sends REST requests
- Axios client → Resident endpoints: sends REST requests
- Axios client → Technician endpoints: sends REST requests
- Axios client → Amenity endpoints: sends REST requests
- Axios client → Booking endpoints: sends REST requests
- Axios client → Payment endpoints: sends REST requests
- Auth endpoints → Authentication service: delegates login
backend/src/main/java/com/urbannexus/controller/AuthController.java - Authentication service → JPA repositories: looks up accounts
backend/src/main/java/com/urbannexus/service/AuthService.java - Authentication service → JWT security: issues tokens
backend/src/main/java/com/urbannexus/service/AuthService.java - Auth endpoints → Resident management: serves profile
backend/src/main/java/com/urbannexus/controller/AuthController.java - Admin endpoints → Resident management: manages residents
- Admin endpoints → Technician management: manages technicians
- Resident endpoints → Resident management: delegates operations
- Technician endpoints → Technician management: delegates operations
- Amenity endpoints → Amenity management: delegates amenity work
- Booking endpoints → Booking operations: delegates bookings
- Payment endpoints → Payment tracking: delegates payments
- Resident management → JPA repositories: reads and writes
backend/src/main/java/com/urbannexus/service/ResidentService.java - Technician management → JPA repositories: reads and writes
backend/src/main/java/com/urbannexus/service/TechnicianService.java - Resident management → Audit trail: records changes
backend/src/main/java/com/urbannexus/service/ResidentService.java - Technician management → Audit trail: records changes
backend/src/main/java/com/urbannexus/service/TechnicianService.java - Booking operations → JPA repositories: persists bookings
- Amenity management → JPA repositories: persists facilities
- Payment tracking → JPA repositories: tracks invoices
- JPA repositories → Domain entities: maps entities
- Domain entities → H2 / PostgreSQL: stores records
- Payment tracking → Community user: supports payment reporting