# th3sabbir/on-demand-service-platform architecture

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

- Interactive diagram: https://gitdiagram.com/th3sabbir/on-demand-service-platform
- Repository: https://github.com/th3sabbir/on-demand-service-platform

## Overview

Sebanow is a Laravel marketplace connecting customers who book home services with providers who manage offerings and bookings, under admin oversight. The README establishes the booking, provider approval, profile/document, and payment capabilities; the source index identifies the principal domain modules. The graph groups the main workflow with communications and platform administration. Some modules were not sampled, so links supported only by README-level product descriptions are dashed; unsampled implementation details are not inferred.

Main entry points: [`app/Models/Bookings.php`](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Models/Bookings.php) (Bookings), [`app/Http/Controllers/TransactionController.php`](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/TransactionController.php) (Payments), [`Modules/Leads/app/Http/Controllers/LeadsController.php`](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Leads/app/Http/Controllers/LeadsController.php) (Service leads), [`app/Http/Controllers/UserController.php`](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/UserController.php) (Provider approval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_marketplace["Marketplace workflow"]
  node_service_catalog["Service catalog<br/>[Service.php]"]
  node_products["Products and categories<br/>[Product.php]"]
  node_bookings["Bookings<br/>[Bookings.php]"]
  node_transactions["Payments"]
  node_leads["Service leads"]
  node_provider_approval["Provider approval<br/>[UserController.php]"]
end

subgraph group_engagement["Customer engagement"]
  node_chat["Chat<br/>[ChatController.php]"]
  node_communication["Email and notifications"]
  node_newsletter["Newsletter"]
  node_content["Pages and FAQs<br/>[Page.php]"]
end

subgraph group_administration["Platform administration"]
  node_settings[("Platform settings<br/>[GlobalSetting.php]")]
  node_storage_settings["File storage settings"]
  node_categories["Service categories<br/>[Categories.php]"]
end

subgraph group_identity["Accounts and access"]
  node_user_accounts["Accounts and profiles<br/>[UserController.php]"]
  node_auth["Authentication<br/>[AuthRepository.php]"]
  node_documents["Provider documents<br/>[UserDocument.php]"]
  node_roles["Roles and permissions"]
end

node_customer(("Customer"))
node_provider(("Service provider"))
node_admin(("Administrator"))
node_mysql[("MySQL / MariaDB")]
node_payment_gateway["Payment gateway"]

node_customer -.->|"signs in"| node_auth
node_provider -.->|"signs in"| node_auth
node_auth -->|"identifies"| node_user_accounts
node_customer -.->|"browses services"| node_service_catalog
node_customer -.->|"books service"| node_bookings
node_provider -.->|"manages bookings"| node_bookings
node_customer -.->|"requests service"| node_leads
node_provider -.->|"receives leads"| node_leads
node_provider -.->|"submits profile"| node_provider_approval
node_admin -.->|"approves providers"| node_provider_approval
node_provider_approval -.->|"supports review"| node_documents
node_customer -.->|"pays for service"| node_transactions
node_transactions -.->|"integrates payments"| node_payment_gateway
node_customer -.->|"chats"| node_chat
node_provider -.->|"chats"| node_chat
node_admin -.->|"manages messaging"| node_communication
node_leads -->|"sends notifications"| node_communication
node_customer -.->|"subscribes"| node_newsletter
node_admin -.->|"manages content"| node_content
node_admin -.->|"manages access"| node_roles
node_admin -.->|"configures platform"| node_settings
node_admin -->|"configures storage"| node_storage_settings
node_storage_settings -->|"reads and updates"| node_settings
node_admin -.->|"manages categories"| node_categories
node_settings -.->|"persists settings"| node_mysql
node_bookings -.->|"supports payment"| node_transactions

click node_user_accounts "https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/UserController.php"
click node_auth "https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Repositories/Eloquent/AuthRepository.php"
click node_service_catalog "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Service/app/Models/Service.php"
click node_products "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Product/app/Models/Product.php"
click node_bookings "https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Models/Bookings.php"
click node_transactions "https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/TransactionController.php"
click node_leads "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Leads/app/Http/Controllers/LeadsController.php"
click node_provider_approval "https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/UserController.php"
click node_documents "https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Models/UserDocument.php"
click node_chat "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Chat/app/Http/Controllers/ChatController.php"
click node_communication "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Communication/app/Http/Controllers/CommunicationController.php"
click node_newsletter "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Newsletter/app/Http/Controllers/NewsletterController.php"
click node_content "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Page/app/Models/Page.php"
click node_roles "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/RolesPermissions/app/Http/Controllers/RolesPermissionsController.php"
click node_settings "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/GlobalSetting/Entities/GlobalSetting.php"
click node_storage_settings "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/GlobalSetting/app/Http/Controllers/FileStorageController.php"
click node_categories "https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Categories/app/Models/Categories.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_service_catalog,node_products,node_bookings,node_transactions,node_leads,node_provider_approval toneBlue
class node_chat,node_communication,node_newsletter,node_content,node_mysql toneAmber
class node_settings,node_storage_settings,node_categories toneMint
class node_user_accounts,node_auth,node_documents,node_roles toneRose
class node_customer,node_provider,node_admin,node_payment_gateway toneIndigo
```

## Components

### Marketplace workflow

- [Service catalog](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Service/app/Models/Service.php): `Modules/Service/app/Models/Service.php`
- [Products and categories](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Product/app/Models/Product.php): `Modules/Product/app/Models/Product.php`
- [Bookings](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Models/Bookings.php): `app/Models/Bookings.php`
- [Payments](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/TransactionController.php): `app/Http/Controllers/TransactionController.php`
- [Service leads](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Leads/app/Http/Controllers/LeadsController.php): `Modules/Leads/app/Http/Controllers/LeadsController.php`
- [Provider approval](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`

### Customer engagement

- [Chat](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Chat/app/Http/Controllers/ChatController.php): `Modules/Chat/app/Http/Controllers/ChatController.php`
- [Email and notifications](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Communication/app/Http/Controllers/CommunicationController.php): `Modules/Communication/app/Http/Controllers/CommunicationController.php`
- [Newsletter](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Newsletter/app/Http/Controllers/NewsletterController.php): `Modules/Newsletter/app/Http/Controllers/NewsletterController.php`
- [Pages and FAQs](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Page/app/Models/Page.php): `Modules/Page/app/Models/Page.php`

### Platform administration

- [Platform settings](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/GlobalSetting/Entities/GlobalSetting.php): `Modules/GlobalSetting/Entities/GlobalSetting.php`
- [File storage settings](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/GlobalSetting/app/Http/Controllers/FileStorageController.php): `Modules/GlobalSetting/app/Http/Controllers/FileStorageController.php`
- [Service categories](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/Categories/app/Models/Categories.php): `Modules/Categories/app/Models/Categories.php`

### Accounts and access

- [Accounts and profiles](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [Authentication](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Repositories/Eloquent/AuthRepository.php): `app/Repositories/Eloquent/AuthRepository.php`
- [Provider documents](https://github.com/th3sabbir/on-demand-service-platform/blob/main/app/Models/UserDocument.php): `app/Models/UserDocument.php`
- [Roles and permissions](https://github.com/th3sabbir/on-demand-service-platform/blob/main/Modules/RolesPermissions/app/Http/Controllers/RolesPermissionsController.php): `Modules/RolesPermissions/app/Http/Controllers/RolesPermissionsController.php`

### Other components

- **Customer**
- **Service provider**
- **Administrator**
- **MySQL / MariaDB**
- **Payment gateway**

## Connections

- Customer → Authentication: signs in
- Service provider → Authentication: signs in
- Authentication → Accounts and profiles: identifies (evidence: `app/Repositories/Eloquent/AuthRepository.php`)
- Customer → Service catalog: browses services
- Customer → Bookings: books service
- Service provider → Bookings: manages bookings
- Customer → Service leads: requests service
- Service provider → Service leads: receives leads
- Service provider → Provider approval: submits profile
- Administrator → Provider approval: approves providers
- Provider approval → Provider documents: supports review (evidence: `app/Http/Controllers/UserController.php`)
- Customer → Payments: pays for service
- Payments → Payment gateway: integrates payments
- Customer → Chat: chats
- Service provider → Chat: chats
- Administrator → Email and notifications: manages messaging
- Service leads → Email and notifications: sends notifications (evidence: `Modules/Leads/app/Http/Controllers/LeadsController.php`)
- Customer → Newsletter: subscribes
- Administrator → Pages and FAQs: manages content
- Administrator → Roles and permissions: manages access
- Administrator → Platform settings: configures platform
- Administrator → File storage settings: configures storage
- File storage settings → Platform settings: reads and updates (evidence: `Modules/GlobalSetting/app/Http/Controllers/FileStorageController.php`)
- Administrator → Service categories: manages categories
- Platform settings → MySQL / MariaDB: persists settings
- Bookings → Payments: supports payment
