# zandroee/secureview architecture

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

- Interactive diagram: https://gitdiagram.com/zandroee/secureview
- Repository: https://github.com/zandroee/secureview

## Overview

SecureView is a Laravel/React-Inertia business application for product sales and security-system installation services. Customers browse products and packages, submit service inquiries, schedule installation, place orders and pay; administrators manage catalog, inventory, schedules, invoices and warranty claims, while technicians use a job workspace. The graph preserves these documented capabilities, but several branches are represented by directory-level nodes because their controllers and routes were not sampled. Solid links reflect source-index references or visible calls; dashed links are documented product areas whose exact runtime wiring was not shown.

Main entry points: [`resources/js/Pages`](https://github.com/zandroee/secureview/tree/main/resources/js/Pages) (Inertia React UI), [`app/Http/Controllers/InquiryController.php`](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/InquiryController.php) (Service inquiries), [`app/Http/Controllers/Admin`](https://github.com/zandroee/secureview/tree/main/app/Http/Controllers/Admin) (Admin operations), [`app/Models/Inquiry.php`](https://github.com/zandroee/secureview/blob/main/app/Models/Inquiry.php) (Inquiry records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_catalog["Catalog browsing"]
  node_packages["Packages"]
  node_cart["Shopping cart<br/>[CartController.php]"]
end

subgraph group_service["Service operations"]
  node_inquiry["Service inquiries"]
  node_inquirydata[("Inquiry records<br/>[Inquiry.php]")]
  node_scheduling["Scheduling"]
  node_technician["Technician workspace"]
  node_notifications["Job notifications"]
  node_warranty["Warranty claims"]
end

subgraph group_commerce["Commerce and records"]
  node_checkout["Checkout"]
  node_orders[("Orders<br/>[Order.php]")]
  node_inventory["Inventory service"]
  node_payment["PayMongo"]
  node_webhook["Payment webhook"]
  node_invoices["Invoice records"]
end

subgraph group_admin["Administration"]
  node_adminops["Admin operations"]
  node_dashboard["Admin dashboard"]
  node_activity["Activity logging"]
end

subgraph group_core["Shared application core"]
  node_frontend["Inertia React UI"]
  node_users[("Users and roles<br/>[User.php]")]
  node_notificationsdata[("Customer notifications")]
  node_appentry["Web application entry<br/>[index.php]"]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -.->|"uses"| node_frontend
node_admin -.->|"uses"| node_frontend
node_frontend -.->|"requests"| node_catalog
node_frontend -.->|"requests"| node_packages
node_frontend -.->|"requests"| node_cart
node_frontend -.->|"requests"| node_inquiry
node_frontend -.->|"requests"| node_scheduling
node_frontend -.->|"requests"| node_technician
node_checkout -->|"creates"| node_orders
node_checkout -->|"checks stock"| node_inventory
node_checkout -.->|"starts checkout"| node_payment
node_payment -.->|"confirms payment"| node_webhook
node_inquiry -->|"reads and writes"| node_inquirydata
node_inquiry -->|"starts checkout"| node_payment
node_inquiry -->|"checks stock"| node_inventory
node_scheduling -->|"reads and assigns"| node_inquirydata
node_technician -->|"updates jobs"| node_inquirydata
node_inquiry -.->|"notifies"| node_notifications
node_notifications -->|"creates"| node_notificationsdata
node_notifications -->|"selects recipients"| node_users
node_admin -.->|"manages"| node_adminops
node_adminops -.->|"views"| node_dashboard
node_dashboard -->|"reads"| node_inquirydata
node_dashboard -->|"reads"| node_orders
node_adminops -.->|"records actions"| node_activity
node_adminops -.->|"manages claims"| node_warranty
node_adminops -.->|"issues records"| node_invoices
node_appentry -.->|"serves pages"| node_frontend

click node_catalog "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/ProductController.php"
click node_packages "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/PackageController.php"
click node_cart "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/CartController.php"
click node_checkout "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/CheckoutController.php"
click node_orders "https://github.com/zandroee/secureview/blob/main/app/Models/Order.php"
click node_inventory "https://github.com/zandroee/secureview/blob/main/app/Services/InventoryService.php"
click node_webhook "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/PayMongoWebhookController.php"
click node_invoices "https://github.com/zandroee/secureview/blob/main/app/Services/InvoiceDocumentService.php"
click node_inquiry "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/InquiryController.php"
click node_inquirydata "https://github.com/zandroee/secureview/blob/main/app/Models/Inquiry.php"
click node_scheduling "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/ScheduleController.php"
click node_technician "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/TechnicianWorkspaceController.php"
click node_notifications "https://github.com/zandroee/secureview/blob/main/app/Services/JobNotificationService.php"
click node_warranty "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/WarrantyClaimController.php"
click node_adminops "https://github.com/zandroee/secureview/tree/main/app/Http/Controllers/Admin"
click node_dashboard "https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/Admin/DashboardController.php"
click node_activity "https://github.com/zandroee/secureview/blob/main/app/Services/AdminActivityLogger.php"
click node_frontend "https://github.com/zandroee/secureview/tree/main/resources/js/Pages"
click node_users "https://github.com/zandroee/secureview/blob/main/app/Models/User.php"
click node_notificationsdata "https://github.com/zandroee/secureview/blob/main/app/Models/CustomerNotification.php"
click node_appentry "https://github.com/zandroee/secureview/blob/main/public/index.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_catalog,node_packages,node_cart toneBlue
class node_inquiry,node_inquirydata,node_scheduling,node_technician,node_notifications,node_warranty toneAmber
class node_checkout,node_orders,node_inventory,node_payment,node_webhook,node_invoices toneMint
class node_adminops,node_dashboard,node_activity toneRose
class node_frontend,node_users,node_notificationsdata,node_appentry,node_customer,node_admin toneIndigo
```

## Components

### Customer experience

- [Catalog browsing](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/ProductController.php): `app/Http/Controllers/ProductController.php`
- [Packages](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/PackageController.php): `app/Http/Controllers/PackageController.php`
- [Shopping cart](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/CartController.php): `app/Http/Controllers/CartController.php`

### Service operations

- [Service inquiries](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/InquiryController.php): `app/Http/Controllers/InquiryController.php`
- [Inquiry records](https://github.com/zandroee/secureview/blob/main/app/Models/Inquiry.php): `app/Models/Inquiry.php`
- [Scheduling](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/ScheduleController.php): `app/Http/Controllers/ScheduleController.php`
- [Technician workspace](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/TechnicianWorkspaceController.php): `app/Http/Controllers/TechnicianWorkspaceController.php`
- [Job notifications](https://github.com/zandroee/secureview/blob/main/app/Services/JobNotificationService.php): `app/Services/JobNotificationService.php`
- [Warranty claims](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/WarrantyClaimController.php): `app/Http/Controllers/WarrantyClaimController.php`

### Commerce and records

- [Checkout](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/CheckoutController.php): `app/Http/Controllers/CheckoutController.php`
- [Orders](https://github.com/zandroee/secureview/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Inventory service](https://github.com/zandroee/secureview/blob/main/app/Services/InventoryService.php): `app/Services/InventoryService.php`
- **PayMongo**
- [Payment webhook](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/PayMongoWebhookController.php): `app/Http/Controllers/PayMongoWebhookController.php`
- [Invoice records](https://github.com/zandroee/secureview/blob/main/app/Services/InvoiceDocumentService.php): `app/Services/InvoiceDocumentService.php`

### Administration

- [Admin operations](https://github.com/zandroee/secureview/tree/main/app/Http/Controllers/Admin): `app/Http/Controllers/Admin`
- [Admin dashboard](https://github.com/zandroee/secureview/blob/main/app/Http/Controllers/Admin/DashboardController.php): `app/Http/Controllers/Admin/DashboardController.php`
- [Activity logging](https://github.com/zandroee/secureview/blob/main/app/Services/AdminActivityLogger.php): `app/Services/AdminActivityLogger.php`

### Shared application core

- [Inertia React UI](https://github.com/zandroee/secureview/tree/main/resources/js/Pages): `resources/js/Pages`
- [Users and roles](https://github.com/zandroee/secureview/blob/main/app/Models/User.php): `app/Models/User.php`
- [Customer notifications](https://github.com/zandroee/secureview/blob/main/app/Models/CustomerNotification.php): `app/Models/CustomerNotification.php`
- [Web application entry](https://github.com/zandroee/secureview/blob/main/public/index.php): `public/index.php`

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → Inertia React UI: uses (evidence: `README.md`)
- Administrator → Inertia React UI: uses (evidence: `README.md`)
- Inertia React UI → Catalog browsing: requests
- Inertia React UI → Packages: requests
- Inertia React UI → Shopping cart: requests
- Inertia React UI → Service inquiries: requests
- Inertia React UI → Scheduling: requests
- Inertia React UI → Technician workspace: requests
- Checkout → Orders: creates (evidence: `app/Http/Controllers/CheckoutController.php`)
- Checkout → Inventory service: checks stock (evidence: `app/Http/Controllers/CheckoutController.php`)
- Checkout → PayMongo: starts checkout
- PayMongo → Payment webhook: confirms payment (evidence: `README.md`)
- Service inquiries → Inquiry records: reads and writes (evidence: `app/Http/Controllers/InquiryController.php`)
- Service inquiries → PayMongo: starts checkout (evidence: `app/Http/Controllers/InquiryController.php`)
- Service inquiries → Inventory service: checks stock (evidence: `app/Http/Controllers/InquiryController.php`)
- Scheduling → Inquiry records: reads and assigns
- Technician workspace → Inquiry records: updates jobs (evidence: `app/Http/Controllers/TechnicianWorkspaceController.php`)
- Service inquiries → Job notifications: notifies (evidence: `app/Http/Controllers/InquiryController.php`)
- Job notifications → Customer notifications: creates (evidence: `app/Services/JobNotificationService.php`)
- Job notifications → Users and roles: selects recipients (evidence: `app/Services/JobNotificationService.php`)
- Administrator → Admin operations: manages (evidence: `README.md`)
- Admin operations → Admin dashboard: views
- Admin dashboard → Inquiry records: reads (evidence: `app/Http/Controllers/Admin/DashboardController.php`)
- Admin dashboard → Orders: reads (evidence: `app/Http/Controllers/Admin/DashboardController.php`)
- Admin operations → Activity logging: records actions (evidence: `app/Http/Controllers/Admin/InquiryController.php`)
- Admin operations → Warranty claims: manages claims (evidence: `README.md`)
- Admin operations → Invoice records: issues records (evidence: `README.md`)
- Web application entry → Inertia React UI: serves pages
