# seaseole/highblossom architecture

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

- Interactive diagram: https://gitdiagram.com/seaseole/highblossom
- Repository: https://github.com/seaseole/highblossom

## Overview

This is Highblossom’s Laravel application for an automotive-glass business, with public service/content pages, appointment booking, quotes and contact, plus administrative content and operations tools. The clearest evidenced customer workflow is availability lookup followed by booking submission and persistence; the app also includes authentication/session management, SEO, and a reusable content-block package. The README is empty, and several subsystems are represented from the file tree or SOURCE INDEX rather than inspected implementation, so their internal links are omitted.

Main entry points: [`app/Http/Controllers/BookingController.php`](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/BookingController.php) (Booking controller), [`app/Actions/StoreBookingAction.php`](https://github.com/seaseole/highblossom/blob/main/app/Actions/StoreBookingAction.php) (Booking action), [`app/Services/Contracts/AvailabilityServiceInterface.php`](https://github.com/seaseole/highblossom/blob/main/app/Services/Contracts/AvailabilityServiceInterface.php) (Availability contract), [`app/Http/Controllers/Api/BookingAvailabilityController.php`](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Api/BookingAvailabilityController.php) (Availability API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Booking and service"]
  node_booking_entry["Booking controller"]
  node_availability_api["Availability API"]
  node_availability["Slot availability"]
  node_availability_contract["Availability contract"]
  node_calendar["Booking calendar"]
  node_store_booking["Booking action"]
  node_booking_model[("Booking record<br/>[Booking.php]")]
  node_booking_events[("Booking events<br/>[BookingEvent.php]")]
  node_quote_controller["Quote intake"]
  node_quote_record[("Quote record<br/>[Quote.php]")]
end

subgraph group_public["Public site and content"]
  node_site_controller["Site pages<br/>[SiteController.php]"]
  node_blog_search["Blog search"]
  node_seo["SEO metadata<br/>[SeoService.php]"]
  node_sitemap["Sitemap generation<br/>[BuildSitemap.php]"]
  node_content_blocks["Content block registry<br/>[BlockRegistry.php]"]
  node_block_renderer["Block renderer<br/>[BlockRenderer.php]"]
  node_sanitizer["HTML sanitizer<br/>[HtmlSanitizer.php]"]
  node_service_catalog[("Service catalog<br/>[Service.php]")]
end

subgraph group_admin["Administration"]
  node_admin_posts["Post administration<br/>[PostController.php]"]
  node_admin_bookings["Booking administration"]
  node_admin_media["Media library"]
  node_admin_overview["System overview<br/>[ProbeRunner.php]"]
end

subgraph group_platform["Identity and platform"]
  node_user_model[("User accounts<br/>[User.php]")]
  node_sign_in["Sign-in identity"]
  node_session_tracking["Session tracking"]
  node_session_records[("Session records<br/>[UserSession.php]")]
  node_settings["Company settings"]
  node_settings_store[("Settings records<br/>[CompanySetting.php]")]
  node_base_controller["Controller base<br/>[Controller.php]"]
end

node_visitor(("Customer"))

node_visitor -->|"submits booking"| node_booking_entry
node_booking_entry -->|"executes action"| node_store_booking
node_booking_entry -->|"loads calendar"| node_calendar
node_booking_entry -->|"loads open days"| node_availability_contract
node_availability_api -->|"requests slots"| node_availability_contract
node_availability_api -->|"requests calendar"| node_calendar
node_store_booking -->|"creates booking"| node_booking_model
node_store_booking -->|"records events"| node_booking_events
node_booking_entry -->|"loads booking"| node_booking_model
node_availability -->|"implements"| node_availability_contract
node_content_blocks -->|"provides registry"| node_block_renderer
node_block_renderer -.->|"sanitizes output"| node_sanitizer
node_site_controller -.->|"presents services"| node_service_catalog
node_sitemap -.->|"includes content"| node_service_catalog
node_sign_in -->|"resolves identity"| node_user_model
node_session_tracking -->|"manages sessions"| node_session_records
node_settings -->|"reads settings"| node_settings_store

click node_booking_entry "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/BookingController.php"
click node_availability_api "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Api/BookingAvailabilityController.php"
click node_availability "https://github.com/seaseole/highblossom/blob/main/app/Services/AvailabilityService.php"
click node_availability_contract "https://github.com/seaseole/highblossom/blob/main/app/Services/Contracts/AvailabilityServiceInterface.php"
click node_calendar "https://github.com/seaseole/highblossom/blob/main/app/Services/BookingCalendarService.php"
click node_store_booking "https://github.com/seaseole/highblossom/blob/main/app/Actions/StoreBookingAction.php"
click node_booking_model "https://github.com/seaseole/highblossom/blob/main/app/Models/Booking.php"
click node_booking_events "https://github.com/seaseole/highblossom/blob/main/app/Models/BookingEvent.php"
click node_quote_controller "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/BookingController.php"
click node_quote_record "https://github.com/seaseole/highblossom/blob/main/app/Models/Quote.php"
click node_site_controller "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/SiteController.php"
click node_blog_search "https://github.com/seaseole/highblossom/blob/main/app/Services/BlogSearchService.php"
click node_seo "https://github.com/seaseole/highblossom/blob/main/app/Services/SeoService.php"
click node_sitemap "https://github.com/seaseole/highblossom/blob/main/app/Actions/Seo/BuildSitemap.php"
click node_content_blocks "https://github.com/seaseole/highblossom/blob/main/packages/ContentBlocks/src/Services/BlockRegistry.php"
click node_block_renderer "https://github.com/seaseole/highblossom/blob/main/packages/ContentBlocks/src/Services/BlockRenderer.php"
click node_sanitizer "https://github.com/seaseole/highblossom/blob/main/packages/ContentBlocks/src/Services/HtmlSanitizer.php"
click node_service_catalog "https://github.com/seaseole/highblossom/blob/main/app/Models/Service.php"
click node_admin_posts "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Admin/PostController.php"
click node_admin_bookings "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Admin/BookingController.php"
click node_admin_media "https://github.com/seaseole/highblossom/blob/main/app/Services/MediaLibraryService.php"
click node_admin_overview "https://github.com/seaseole/highblossom/blob/main/app/Support/SystemOverview/ProbeRunner.php"
click node_user_model "https://github.com/seaseole/highblossom/blob/main/app/Models/User.php"
click node_sign_in "https://github.com/seaseole/highblossom/blob/main/app/Support/SignInIdentifier.php"
click node_session_tracking "https://github.com/seaseole/highblossom/blob/main/app/Services/UserSessionService.php"
click node_session_records "https://github.com/seaseole/highblossom/blob/main/app/Models/UserSession.php"
click node_settings "https://github.com/seaseole/highblossom/blob/main/app/Services/Settings/SettingsManager.php"
click node_settings_store "https://github.com/seaseole/highblossom/blob/main/app/Models/CompanySetting.php"
click node_base_controller "https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Controller.php"

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_booking_entry,node_availability_api,node_availability,node_availability_contract,node_calendar,node_store_booking,node_booking_model,node_booking_events,node_quote_controller,node_quote_record toneBlue
class node_site_controller,node_blog_search,node_seo,node_sitemap,node_content_blocks,node_block_renderer,node_sanitizer,node_service_catalog toneAmber
class node_admin_posts,node_admin_bookings,node_admin_media,node_admin_overview toneMint
class node_user_model,node_sign_in,node_session_tracking,node_session_records,node_settings,node_settings_store,node_base_controller toneRose
class node_visitor toneIndigo
```

## Components

### Booking and service

- [Booking controller](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/BookingController.php): `app/Http/Controllers/BookingController.php`
- [Availability API](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Api/BookingAvailabilityController.php): `app/Http/Controllers/Api/BookingAvailabilityController.php`
- [Slot availability](https://github.com/seaseole/highblossom/blob/main/app/Services/AvailabilityService.php): `app/Services/AvailabilityService.php`
- [Availability contract](https://github.com/seaseole/highblossom/blob/main/app/Services/Contracts/AvailabilityServiceInterface.php): `app/Services/Contracts/AvailabilityServiceInterface.php`
- [Booking calendar](https://github.com/seaseole/highblossom/blob/main/app/Services/BookingCalendarService.php): `app/Services/BookingCalendarService.php`
- [Booking action](https://github.com/seaseole/highblossom/blob/main/app/Actions/StoreBookingAction.php): `app/Actions/StoreBookingAction.php`
- [Booking record](https://github.com/seaseole/highblossom/blob/main/app/Models/Booking.php): `app/Models/Booking.php`
- [Booking events](https://github.com/seaseole/highblossom/blob/main/app/Models/BookingEvent.php): `app/Models/BookingEvent.php`
- [Quote intake](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/BookingController.php): `app/Http/Controllers/BookingController.php`
- [Quote record](https://github.com/seaseole/highblossom/blob/main/app/Models/Quote.php): `app/Models/Quote.php`

### Public site and content

- [Site pages](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/SiteController.php): `app/Http/Controllers/SiteController.php`
- [Blog search](https://github.com/seaseole/highblossom/blob/main/app/Services/BlogSearchService.php): `app/Services/BlogSearchService.php`
- [SEO metadata](https://github.com/seaseole/highblossom/blob/main/app/Services/SeoService.php): `app/Services/SeoService.php`
- [Sitemap generation](https://github.com/seaseole/highblossom/blob/main/app/Actions/Seo/BuildSitemap.php): `app/Actions/Seo/BuildSitemap.php`
- [Content block registry](https://github.com/seaseole/highblossom/blob/main/packages/ContentBlocks/src/Services/BlockRegistry.php): `packages/ContentBlocks/src/Services/BlockRegistry.php`
- [Block renderer](https://github.com/seaseole/highblossom/blob/main/packages/ContentBlocks/src/Services/BlockRenderer.php): `packages/ContentBlocks/src/Services/BlockRenderer.php`
- [HTML sanitizer](https://github.com/seaseole/highblossom/blob/main/packages/ContentBlocks/src/Services/HtmlSanitizer.php): `packages/ContentBlocks/src/Services/HtmlSanitizer.php`
- [Service catalog](https://github.com/seaseole/highblossom/blob/main/app/Models/Service.php): `app/Models/Service.php`

### Administration

- [Post administration](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Admin/PostController.php): `app/Http/Controllers/Admin/PostController.php`
- [Booking administration](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Admin/BookingController.php): `app/Http/Controllers/Admin/BookingController.php`
- [Media library](https://github.com/seaseole/highblossom/blob/main/app/Services/MediaLibraryService.php): `app/Services/MediaLibraryService.php`
- [System overview](https://github.com/seaseole/highblossom/blob/main/app/Support/SystemOverview/ProbeRunner.php): `app/Support/SystemOverview/ProbeRunner.php`

### Identity and platform

- [User accounts](https://github.com/seaseole/highblossom/blob/main/app/Models/User.php): `app/Models/User.php`
- [Sign-in identity](https://github.com/seaseole/highblossom/blob/main/app/Support/SignInIdentifier.php): `app/Support/SignInIdentifier.php`
- [Session tracking](https://github.com/seaseole/highblossom/blob/main/app/Services/UserSessionService.php): `app/Services/UserSessionService.php`
- [Session records](https://github.com/seaseole/highblossom/blob/main/app/Models/UserSession.php): `app/Models/UserSession.php`
- [Company settings](https://github.com/seaseole/highblossom/blob/main/app/Services/Settings/SettingsManager.php): `app/Services/Settings/SettingsManager.php`
- [Settings records](https://github.com/seaseole/highblossom/blob/main/app/Models/CompanySetting.php): `app/Models/CompanySetting.php`
- [Controller base](https://github.com/seaseole/highblossom/blob/main/app/Http/Controllers/Controller.php): `app/Http/Controllers/Controller.php`

### Other components

- **Customer**

## Connections

- Customer → Booking controller: submits booking (evidence: `app/Http/Controllers/BookingController.php`)
- Booking controller → Booking action: executes action (evidence: `app/Http/Controllers/BookingController.php`)
- Booking controller → Booking calendar: loads calendar (evidence: `app/Http/Controllers/BookingController.php`)
- Booking controller → Availability contract: loads open days (evidence: `app/Http/Controllers/BookingController.php`)
- Availability API → Availability contract: requests slots (evidence: `app/Http/Controllers/Api/BookingAvailabilityController.php`)
- Availability API → Booking calendar: requests calendar (evidence: `app/Http/Controllers/Api/BookingAvailabilityController.php`)
- Booking action → Booking record: creates booking (evidence: `app/Actions/StoreBookingAction.php`)
- Booking action → Booking events: records events (evidence: `app/Actions/StoreBookingAction.php`)
- Booking controller → Booking record: loads booking (evidence: `app/Http/Controllers/BookingController.php`)
- Slot availability → Availability contract: implements (evidence: `app/Services/Contracts/AvailabilityServiceInterface.php`)
- Content block registry → Block renderer: provides registry
- Block renderer → HTML sanitizer: sanitizes output
- Site pages → Service catalog: presents services
- Sitemap generation → Service catalog: includes content
- Sign-in identity → User accounts: resolves identity (evidence: `app/Actions/Fortify/AuthenticateSignIn.php`)
- Session tracking → Session records: manages sessions (evidence: `app/Services/UserSessionService.php`)
- Company settings → Settings records: reads settings (evidence: `app/Services/Settings/SettingsManager.php`)
