How israa-husain/homehub works
HomeHub is a home-service marketplace and booking-management API for homeowners, providers, and administrators. Its central workflow is: a homeowner manages a home, discovers an active service, checks provider availability, creates a booking, and receives booking updates; providers maintain profiles, services, availability, and booking status. Authentication, email verification, user administration, categories, and audit activity are supporting capabilities. The graph uses the README for product scope and sampled files/SOURCE INDEX references for confirmed calls; dashed edges mark major relationships whose implementation was not shown.
Main entry points: BookingService.java Booking workflow · UserService.java User profiles · AuthService.java Account authentication · AdminController.java Admin API
Components 24
Identity & accounts
- Authentication API
src/main/java/com/ga/HomeHub/controller/AuthController.java - Account authentication
src/main/java/com/ga/HomeHub/service/AuthService.java - User API
src/main/java/com/ga/HomeHub/controller/UserController.java - User profiles
src/main/java/com/ga/HomeHub/service/UserService.java - User records
src/main/java/com/ga/HomeHub/repository/UserRepository.java - Email delivery
src/main/java/com/ga/HomeHub/service/EmailService.java
Marketplace setup
- Homes API
src/main/java/com/ga/HomeHub/controller/HomeController.java - Home management
src/main/java/com/ga/HomeHub/service/HomeService.java - Provider API
src/main/java/com/ga/HomeHub/controller/ProviderController.java - Provider profiles
src/main/java/com/ga/HomeHub/service/ProviderService.java - Services API
src/main/java/com/ga/HomeHub/controller/ServiceOfferingController.java - Service catalog
src/main/java/com/ga/HomeHub/service/ServiceOfferingService.java - Categories API
src/main/java/com/ga/HomeHub/controller/CategoryController.java - Availability API
src/main/java/com/ga/HomeHub/controller/AvailabilityController.java - Provider availability
src/main/java/com/ga/HomeHub/service/AvailabilityService.java - Marketplace entities
src/main/java/com/ga/HomeHub/model
Booking lifecycle
- Bookings API
src/main/java/com/ga/HomeHub/controller/BookingController.java - Booking workflow
src/main/java/com/ga/HomeHub/service/BookingService.java - Booking notifications
src/main/java/com/ga/HomeHub/service/NotificationService.java
Administration & activity
- Admin API
src/main/java/com/ga/HomeHub/controller/AdminController.java - Audit activity
src/main/java/com/ga/HomeHub/service/AuditLogService.java
Other components
- Homeowner
- Service provider
- Administrator
Connections 30
- Homeowner → Authentication API: registers or logs in
- Service provider → Authentication API: registers or logs in
- Authentication API → Account authentication: delegates
src/main/java/com/ga/HomeHub/controller/AuthController.java - Account authentication → User records: reads and saves
src/main/java/com/ga/HomeHub/service/AuthService.java - Account authentication → Email delivery: sends messages
src/main/java/com/ga/HomeHub/service/AuthService.java - Homeowner → User API: manages profile
- User API → User profiles: delegates
src/main/java/com/ga/HomeHub/controller/UserController.java - User profiles → User records: reads and saves
src/main/java/com/ga/HomeHub/service/UserService.java - Homeowner → Homes API: manages homes
- Homes API → Home management: delegates
src/main/java/com/ga/HomeHub/controller/HomeController.java - Service provider → Provider API: manages profile
- Provider API → Provider profiles: delegates
- Service provider → Services API: manages services
- Services API → Service catalog: delegates
src/main/java/com/ga/HomeHub/controller/ServiceOfferingController.java - Service catalog → Provider profiles: gets current profile
src/main/java/com/ga/HomeHub/service/ServiceOfferingService.java - Homeowner → Categories API: browses services
- Service provider → Availability API: sets availability
- Availability API → Provider availability: delegates
src/main/java/com/ga/HomeHub/controller/AvailabilityController.java - Homeowner → Bookings API: books a service
- Bookings API → Booking workflow: delegates
src/main/java/com/ga/HomeHub/controller/BookingController.java - Booking workflow → Provider availability: checks time slot
src/main/java/com/ga/HomeHub/service/BookingService.java - Booking workflow → Booking notifications: sends updates
src/main/java/com/ga/HomeHub/service/BookingService.java - Booking workflow → Email delivery: emails updates
src/main/java/com/ga/HomeHub/service/BookingService.java - Service provider → Bookings API: updates status
- Administrator → Admin API: administers platform
- Admin API → User profiles: manages accounts
- Admin API → Categories API: manages categories
- User profiles → Audit activity: records deactivation
src/main/java/com/ga/HomeHub/service/UserService.java - Booking workflow → Audit activity: records booking actions
src/main/java/com/ga/HomeHub/service/BookingService.java - Homeowner → Marketplace entities: uses homes and services