# israa-husain/homehub architecture

> Architecture diagram of the GitHub repository israa-husain/homehub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/israa-husain/homehub
- Repository: https://github.com/israa-husain/homehub

## Overview

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: [`src/main/java/com/ga/HomeHub/service/BookingService.java`](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/BookingService.java) (Booking workflow), [`src/main/java/com/ga/HomeHub/service/UserService.java`](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/UserService.java) (User profiles), [`src/main/java/com/ga/HomeHub/service/AuthService.java`](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AuthService.java) (Account authentication), [`src/main/java/com/ga/HomeHub/controller/AdminController.java`](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AdminController.java) (Admin API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; accounts"]
  node_auth_api["Authentication API"]
  node_auth["Account authentication<br/>[AuthService.java]"]
  node_user_api["User API"]
  node_users["User profiles<br/>[UserService.java]"]
  node_user_store[("User records")]
  node_email["Email delivery<br/>[EmailService.java]"]
end

subgraph group_marketplace["Marketplace setup"]
  node_homes_api["Homes API"]
  node_homes["Home management<br/>[HomeService.java]"]
  node_provider_api["Provider API"]
  node_providers["Provider profiles"]
  node_service_api["Services API"]
  node_services["Service catalog"]
  node_categories_api["Categories API"]
  node_availability_api["Availability API"]
  node_availability["Provider availability"]
  node_domain["Marketplace entities"]
end

subgraph group_booking["Booking lifecycle"]
  node_booking_api["Bookings API"]
  node_bookings["Booking workflow"]
  node_notifications["Booking notifications"]
end

subgraph group_operations["Administration &amp; activity"]
  node_admin_api["Admin API"]
  node_audit["Audit activity"]
end

node_homeowner(("Homeowner"))
node_provider(("Service provider"))
node_admin(("Administrator"))

node_homeowner -->|"registers or logs in"| node_auth_api
node_provider -->|"registers or logs in"| node_auth_api
node_auth_api -.->|"delegates"| node_auth
node_auth -->|"reads and saves"| node_user_store
node_auth -->|"sends messages"| node_email
node_homeowner -->|"manages profile"| node_user_api
node_user_api -.->|"delegates"| node_users
node_users -->|"reads and saves"| node_user_store
node_homeowner -->|"manages homes"| node_homes_api
node_homes_api -->|"delegates"| node_homes
node_provider -->|"manages profile"| node_provider_api
node_provider_api -.->|"delegates"| node_providers
node_provider -->|"manages services"| node_service_api
node_service_api -->|"delegates"| node_services
node_services -->|"gets current profile"| node_providers
node_homeowner -->|"browses services"| node_categories_api
node_provider -->|"sets availability"| node_availability_api
node_availability_api -.->|"delegates"| node_availability
node_homeowner -->|"books a service"| node_booking_api
node_booking_api -->|"delegates"| node_bookings
node_bookings -->|"checks time slot"| node_availability
node_bookings -->|"sends updates"| node_notifications
node_bookings -->|"emails updates"| node_email
node_provider -->|"updates status"| node_booking_api
node_admin -->|"administers platform"| node_admin_api
node_admin_api -.->|"manages accounts"| node_users
node_admin_api -.->|"manages categories"| node_categories_api
node_users -->|"records deactivation"| node_audit
node_bookings -->|"records booking actions"| node_audit
node_homeowner -.->|"uses homes and services"| node_domain

click node_auth_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AuthController.java"
click node_auth "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AuthService.java"
click node_user_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/UserController.java"
click node_users "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/UserService.java"
click node_user_store "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/repository/UserRepository.java"
click node_email "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/EmailService.java"
click node_homes_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/HomeController.java"
click node_homes "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/HomeService.java"
click node_provider_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/ProviderController.java"
click node_providers "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/ProviderService.java"
click node_service_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/ServiceOfferingController.java"
click node_services "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/ServiceOfferingService.java"
click node_categories_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/CategoryController.java"
click node_availability_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AvailabilityController.java"
click node_availability "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AvailabilityService.java"
click node_booking_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/BookingController.java"
click node_bookings "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/BookingService.java"
click node_notifications "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/NotificationService.java"
click node_admin_api "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AdminController.java"
click node_audit "https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AuditLogService.java"
click node_domain "https://github.com/israa-husain/homehub/tree/develop/src/main/java/com/ga/HomeHub/model"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_auth,node_user_api,node_users,node_user_store,node_email toneBlue
class node_homes_api,node_homes,node_provider_api,node_providers,node_service_api,node_services,node_categories_api,node_availability_api,node_availability,node_domain toneAmber
class node_booking_api,node_bookings,node_notifications toneMint
class node_admin_api,node_audit toneRose
class node_homeowner,node_provider,node_admin toneIndigo
```

## Components

### Identity & accounts

- [Authentication API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AuthController.java): `src/main/java/com/ga/HomeHub/controller/AuthController.java`
- [Account authentication](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AuthService.java): `src/main/java/com/ga/HomeHub/service/AuthService.java`
- [User API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/UserController.java): `src/main/java/com/ga/HomeHub/controller/UserController.java`
- [User profiles](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/UserService.java): `src/main/java/com/ga/HomeHub/service/UserService.java`
- [User records](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/repository/UserRepository.java): `src/main/java/com/ga/HomeHub/repository/UserRepository.java`
- [Email delivery](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/EmailService.java): `src/main/java/com/ga/HomeHub/service/EmailService.java`

### Marketplace setup

- [Homes API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/HomeController.java): `src/main/java/com/ga/HomeHub/controller/HomeController.java`
- [Home management](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/HomeService.java): `src/main/java/com/ga/HomeHub/service/HomeService.java`
- [Provider API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/ProviderController.java): `src/main/java/com/ga/HomeHub/controller/ProviderController.java`
- [Provider profiles](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/ProviderService.java): `src/main/java/com/ga/HomeHub/service/ProviderService.java`
- [Services API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/ServiceOfferingController.java): `src/main/java/com/ga/HomeHub/controller/ServiceOfferingController.java`
- [Service catalog](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/ServiceOfferingService.java): `src/main/java/com/ga/HomeHub/service/ServiceOfferingService.java`
- [Categories API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/CategoryController.java): `src/main/java/com/ga/HomeHub/controller/CategoryController.java`
- [Availability API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AvailabilityController.java): `src/main/java/com/ga/HomeHub/controller/AvailabilityController.java`
- [Provider availability](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AvailabilityService.java): `src/main/java/com/ga/HomeHub/service/AvailabilityService.java`
- [Marketplace entities](https://github.com/israa-husain/homehub/tree/develop/src/main/java/com/ga/HomeHub/model): `src/main/java/com/ga/HomeHub/model`

### Booking lifecycle

- [Bookings API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/BookingController.java): `src/main/java/com/ga/HomeHub/controller/BookingController.java`
- [Booking workflow](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/BookingService.java): `src/main/java/com/ga/HomeHub/service/BookingService.java`
- [Booking notifications](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/NotificationService.java): `src/main/java/com/ga/HomeHub/service/NotificationService.java`

### Administration & activity

- [Admin API](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/controller/AdminController.java): `src/main/java/com/ga/HomeHub/controller/AdminController.java`
- [Audit activity](https://github.com/israa-husain/homehub/blob/develop/src/main/java/com/ga/HomeHub/service/AuditLogService.java): `src/main/java/com/ga/HomeHub/service/AuditLogService.java`

### Other components

- **Homeowner**
- **Service provider**
- **Administrator**

## Connections

- Homeowner → Authentication API: registers or logs in
- Service provider → Authentication API: registers or logs in
- Authentication API → Account authentication: delegates (evidence: `src/main/java/com/ga/HomeHub/controller/AuthController.java`)
- Account authentication → User records: reads and saves (evidence: `src/main/java/com/ga/HomeHub/service/AuthService.java`)
- Account authentication → Email delivery: sends messages (evidence: `src/main/java/com/ga/HomeHub/service/AuthService.java`)
- Homeowner → User API: manages profile
- User API → User profiles: delegates (evidence: `src/main/java/com/ga/HomeHub/controller/UserController.java`)
- User profiles → User records: reads and saves (evidence: `src/main/java/com/ga/HomeHub/service/UserService.java`)
- Homeowner → Homes API: manages homes
- Homes API → Home management: delegates (evidence: `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 (evidence: `src/main/java/com/ga/HomeHub/controller/ServiceOfferingController.java`)
- Service catalog → Provider profiles: gets current profile (evidence: `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 (evidence: `src/main/java/com/ga/HomeHub/controller/AvailabilityController.java`)
- Homeowner → Bookings API: books a service
- Bookings API → Booking workflow: delegates (evidence: `src/main/java/com/ga/HomeHub/controller/BookingController.java`)
- Booking workflow → Provider availability: checks time slot (evidence: `src/main/java/com/ga/HomeHub/service/BookingService.java`)
- Booking workflow → Booking notifications: sends updates (evidence: `src/main/java/com/ga/HomeHub/service/BookingService.java`)
- Booking workflow → Email delivery: emails updates (evidence: `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 (evidence: `src/main/java/com/ga/HomeHub/service/UserService.java`)
- Booking workflow → Audit activity: records booking actions (evidence: `src/main/java/com/ga/HomeHub/service/BookingService.java`)
- Homeowner → Marketplace entities: uses homes and services
