# devopstem/sp_backend_web architecture

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

- Interactive diagram: https://gitdiagram.com/devopstem/sp_backend_web
- Repository: https://github.com/devopstem/sp_backend_web

## Overview

Smart Planogram Control Center is a multi-tenant retail planogram management platform. Its core workflow is managing stores, departments, products, equipment and shelf placements, then exporting store/catalog data to Firebase for a mobile client. The graph also preserves floor-plan editing, authentication and two-factor verification, tenant billing, and chat as documented capabilities. Source excerpts and the index confirm several controller-to-service and model relationships; other documented subsystems are included without asserting unsampled internal call paths.

Main entry points: [`app/Http/Controllers/PlanogramController.php`](https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/PlanogramController.php) (Planogram Management), [`app/Http/Controllers/ExportController.php`](https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/ExportController.php) (Export Requests), [`app/Http/Controllers/Auth/TwoFactorChallengeController.php`](https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/Auth/TwoFactorChallengeController.php) (Two-Factor Login), [`app/Jobs/SyncStoreToFirebase.php`](https://github.com/devopstem/sp_backend_web/blob/main/app/Jobs/SyncStoreToFirebase.php) (Store Sync Job)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Retail Catalog"]
  node_stores[("Store Records<br/>[Store.php]")]
  node_departments[("Departments<br/>[Department.php]")]
  node_shelves[("Shelf Equipment<br/>[Shelf.php]")]
  node_coolers[("Cooler Equipment<br/>[Cooler.php]")]
  node_stands[("Stand Equipment<br/>[Stand.php]")]
  node_products[("Product Catalog<br/>[Product.php]")]
end

subgraph group_planning["Store Planning"]
  node_planograms["Planogram Management"]
  node_placements[("Product Placements<br/>[Placement.php]")]
  node_floorplans["Floor Plans"]
end

subgraph group_sync["Export and Sync"]
  node_export["Export Requests"]
  node_storeexport["Store Export"]
  node_firebase["Firebase Integration"]
  node_syncjob["Store Sync Job"]
end

subgraph group_admin["Accounts and Admin"]
  node_login["Two-Factor Login"]
  node_twofactor["Two-Factor Service"]
  node_authactivity["Login Activity"]
  node_users[("Users and Roles<br/>[User.php]")]
  node_tenants[("Tenant Accounts<br/>[Tenant.php]")]
  node_billing["Billing and Plans<br/>[BillingService.php]"]
end

subgraph group_platform["Application Platform"]
  node_chat["Team Chat<br/>[ChatService.php]"]
  node_inertia["Inertia React UI<br/>[app.jsx]"]
end

node_operator(("Store Operator"))
node_mobile(("Mobile Client"))

node_operator -.->|"manages layouts"| node_planograms
node_planograms -->|"queries stores"| node_stores
node_planograms -->|"queries departments"| node_departments
node_planograms -->|"queries equipment"| node_shelves
node_planograms -->|"queries equipment"| node_coolers
node_planograms -->|"queries equipment"| node_stands
node_planograms -->|"manages placements"| node_placements
node_planograms -.->|"renders page"| node_inertia
node_operator -.->|"maps store layout"| node_floorplans
node_operator -.->|"requests export"| node_export
node_export -->|"uses export service"| node_storeexport
node_export -->|"uses Firebase"| node_firebase
node_export -->|"dispatches sync"| node_syncjob
node_syncjob -->|"uses export service"| node_storeexport
node_syncjob -->|"uses Firebase"| node_firebase
node_firebase -.->|"exports data"| node_mobile
node_operator -.->|"signs in"| node_login
node_login -->|"verifies code"| node_twofactor
node_login -->|"records session"| node_authactivity
node_login -->|"loads account"| node_users
node_operator -.->|"administers tenant"| node_tenants
node_operator -.->|"manages subscription"| node_billing
node_operator -.->|"communicates"| node_chat

click node_planograms "https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/PlanogramController.php"
click node_stores "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Store.php"
click node_departments "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Department.php"
click node_shelves "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Shelf.php"
click node_coolers "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Cooler.php"
click node_stands "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Stand.php"
click node_products "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Product.php"
click node_placements "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Placement.php"
click node_floorplans "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/FloorPlanService.php"
click node_export "https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/ExportController.php"
click node_storeexport "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/StoreExportService.php"
click node_firebase "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/FirebaseService.php"
click node_syncjob "https://github.com/devopstem/sp_backend_web/blob/main/app/Jobs/SyncStoreToFirebase.php"
click node_login "https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/Auth/TwoFactorChallengeController.php"
click node_twofactor "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/TwoFactorService.php"
click node_authactivity "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/AuthActivityService.php"
click node_users "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/User.php"
click node_tenants "https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Tenant.php"
click node_billing "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/BillingService.php"
click node_chat "https://github.com/devopstem/sp_backend_web/blob/main/app/Services/ChatService.php"
click node_inertia "https://github.com/devopstem/sp_backend_web/blob/main/resources/js/app.jsx"

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_stores,node_departments,node_shelves,node_coolers,node_stands,node_products,node_mobile toneBlue
class node_planograms,node_placements,node_floorplans toneAmber
class node_export,node_storeexport,node_firebase,node_syncjob toneMint
class node_login,node_twofactor,node_authactivity,node_users,node_tenants,node_billing toneRose
class node_chat,node_inertia,node_operator toneIndigo
```

## Components

### Retail Catalog

- [Store Records](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Store.php): `app/Models/Store.php`
- [Departments](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Department.php): `app/Models/Department.php`
- [Shelf Equipment](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Shelf.php): `app/Models/Shelf.php`
- [Cooler Equipment](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Cooler.php): `app/Models/Cooler.php`
- [Stand Equipment](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Stand.php): `app/Models/Stand.php`
- [Product Catalog](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Product.php): `app/Models/Product.php`

### Store Planning

- [Planogram Management](https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/PlanogramController.php): `app/Http/Controllers/PlanogramController.php`
- [Product Placements](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Placement.php): `app/Models/Placement.php`
- [Floor Plans](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/FloorPlanService.php): `app/Services/FloorPlanService.php`

### Export and Sync

- [Export Requests](https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/ExportController.php): `app/Http/Controllers/ExportController.php`
- [Store Export](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/StoreExportService.php): `app/Services/StoreExportService.php`
- [Firebase Integration](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/FirebaseService.php): `app/Services/FirebaseService.php`
- [Store Sync Job](https://github.com/devopstem/sp_backend_web/blob/main/app/Jobs/SyncStoreToFirebase.php): `app/Jobs/SyncStoreToFirebase.php`

### Accounts and Admin

- [Two-Factor Login](https://github.com/devopstem/sp_backend_web/blob/main/app/Http/Controllers/Auth/TwoFactorChallengeController.php): `app/Http/Controllers/Auth/TwoFactorChallengeController.php`
- [Two-Factor Service](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/TwoFactorService.php): `app/Services/TwoFactorService.php`
- [Login Activity](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/AuthActivityService.php): `app/Services/AuthActivityService.php`
- [Users and Roles](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/User.php): `app/Models/User.php`
- [Tenant Accounts](https://github.com/devopstem/sp_backend_web/blob/main/app/Models/Tenant.php): `app/Models/Tenant.php`
- [Billing and Plans](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/BillingService.php): `app/Services/BillingService.php`

### Application Platform

- [Team Chat](https://github.com/devopstem/sp_backend_web/blob/main/app/Services/ChatService.php): `app/Services/ChatService.php`
- [Inertia React UI](https://github.com/devopstem/sp_backend_web/blob/main/resources/js/app.jsx): `resources/js/app.jsx`

### Other components

- **Store Operator**
- **Mobile Client**

## Connections

- Store Operator → Planogram Management: manages layouts (evidence: `README.md`)
- Planogram Management → Store Records: queries stores (evidence: `app/Http/Controllers/PlanogramController.php`)
- Planogram Management → Departments: queries departments (evidence: `app/Http/Controllers/PlanogramController.php`)
- Planogram Management → Shelf Equipment: queries equipment (evidence: `app/Http/Controllers/PlanogramController.php`)
- Planogram Management → Cooler Equipment: queries equipment (evidence: `app/Http/Controllers/PlanogramController.php`)
- Planogram Management → Stand Equipment: queries equipment (evidence: `app/Http/Controllers/PlanogramController.php`)
- Planogram Management → Product Placements: manages placements (evidence: `app/Http/Controllers/PlanogramController.php`)
- Planogram Management → Inertia React UI: renders page (evidence: `app/Http/Controllers/PlanogramController.php`)
- Store Operator → Floor Plans: maps store layout (evidence: `README.md`)
- Store Operator → Export Requests: requests export (evidence: `README.md`)
- Export Requests → Store Export: uses export service (evidence: `app/Http/Controllers/ExportController.php`)
- Export Requests → Firebase Integration: uses Firebase (evidence: `app/Http/Controllers/ExportController.php`)
- Export Requests → Store Sync Job: dispatches sync (evidence: `app/Http/Controllers/ExportController.php`)
- Store Sync Job → Store Export: uses export service (evidence: `app/Jobs/SyncStoreToFirebase.php`)
- Store Sync Job → Firebase Integration: uses Firebase (evidence: `app/Jobs/SyncStoreToFirebase.php`)
- Firebase Integration → Mobile Client: exports data (evidence: `README.md`)
- Store Operator → Two-Factor Login: signs in (evidence: `README.md`)
- Two-Factor Login → Two-Factor Service: verifies code (evidence: `app/Http/Controllers/Auth/TwoFactorChallengeController.php`)
- Two-Factor Login → Login Activity: records session (evidence: `app/Http/Controllers/Auth/TwoFactorChallengeController.php`)
- Two-Factor Login → Users and Roles: loads account (evidence: `app/Http/Controllers/Auth/TwoFactorChallengeController.php`)
- Store Operator → Tenant Accounts: administers tenant (evidence: `README.md`)
- Store Operator → Billing and Plans: manages subscription (evidence: `README.md`)
- Store Operator → Team Chat: communicates (evidence: `README.md`)
