# saudexgpt/daylizstores-new architecture

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

- Interactive diagram: https://gitdiagram.com/saudexgpt/daylizstores-new
- Repository: https://github.com/saudexgpt/daylizstores-new

## Overview

Laravue is a Laravel/Vue enterprise management application with a customer storefront and an administrative dashboard. A principal customer workflow is browsing products, submitting an order, and having inventory reserved; the backend also supports stock receiving and FIFO costing, accounting, reporting, and user/role administration. The graph combines sampled controller/service relationships with documented product scope. Several frontend-to-backend links are dashed because the relevant HTTP wiring was not excerpted.

Main entry points: [`app/Http/Controllers/Order/OrdersController.php`](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Order/OrdersController.php) (Order handling), [`app/Http/Controllers/Costing/ReceiptsController.php`](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Costing/ReceiptsController.php) (Stock receiving), [`app/Http/Controllers/Accounting/TransactionsController.php`](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Accounting/TransactionsController.php) (Transactions), [`app/Http/Controllers/UserController.php`](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/UserController.php) (User administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Storefront and orders"]
  node_storefront["Storefront<br/>[index.vue]"]
  node_checkout["Checkout<br/>[CheckOut.vue]"]
  node_order_ui["Order screens<br/>[Create.vue]"]
  node_orders["Order handling"]
  node_order_records[("Order records<br/>[Order.php]")]
end

subgraph group_inventory["Catalog and inventory"]
  node_catalog_ui["Catalog screens<br/>[ManageItem.vue]"]
  node_catalog["Catalog management"]
  node_items[("Products and stock<br/>[Item.php]")]
  node_receiving["Stock receiving"]
  node_costing["FIFO costing<br/>[Costing.php]"]
end

subgraph group_finance["Finance and reporting"]
  node_accounting_ui["Accounting screens<br/>[Overview.vue]"]
  node_transactions["Transactions"]
  node_ledger["Ledger service<br/>[Ledger.php]"]
  node_accounts[("Accounts<br/>[Account.php]")]
  node_report_ui["Report centre<br/>[ReportCentre.vue]"]
  node_reports["Report generation"]
  node_report_registry["Report definitions<br/>[ReportRegistry.php]"]
end

subgraph group_platform["Administration and identity"]
  node_admin_ui["Admin dashboard<br/>[index.vue]"]
  node_users["User administration<br/>[UserController.php]"]
  node_user_model[("Users and roles<br/>[User.php]")]
  node_acl["Access control<br/>[Acl.php]"]
end

node_shopper(("Shopper"))
node_staff(("Staff user"))

node_shopper -->|"browses"| node_storefront
node_storefront -.->|"opens checkout"| node_checkout
node_checkout -.->|"submits order"| node_orders
node_staff -.->|"manages orders"| node_order_ui
node_order_ui -.->|"requests changes"| node_orders
node_orders -->|"reads and writes"| node_order_records
node_orders -->|"requests costing"| node_costing
node_staff -.->|"maintains catalog"| node_catalog_ui
node_catalog_ui -.->|"requests updates"| node_catalog
node_catalog -->|"reads and writes"| node_items
node_staff -.->|"records receipts"| node_receiving
node_receiving -->|"records stock receipt"| node_costing
node_receiving -.->|"updates stock"| node_items
node_costing -->|"posts entries"| node_ledger
node_staff -.->|"uses accounting"| node_accounting_ui
node_accounting_ui -.->|"requests transactions"| node_transactions
node_transactions -->|"posts transactions"| node_ledger
node_transactions -->|"reads accounts"| node_accounts
node_staff -.->|"runs reports"| node_report_ui
node_report_ui -.->|"requests report"| node_reports
node_reports -->|"resolves definitions"| node_report_registry
node_staff -.->|"views dashboard"| node_admin_ui
node_staff -.->|"manages access"| node_users
node_users -->|"reads and updates"| node_user_model
node_users -->|"checks permissions"| node_acl

click node_storefront "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/pages/index.vue"
click node_checkout "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/pages/CheckOut.vue"
click node_order_ui "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/order/Create.vue"
click node_orders "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Order/OrdersController.php"
click node_order_records "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Models/Order/Order.php"
click node_catalog_ui "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/stock/item/ManageItem.vue"
click node_catalog "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Stock/ItemsController.php"
click node_items "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Models/Stock/Item.php"
click node_receiving "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Costing/ReceiptsController.php"
click node_costing "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Services/Costing/Costing.php"
click node_accounting_ui "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/accounting/Overview.vue"
click node_transactions "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Accounting/TransactionsController.php"
click node_ledger "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Services/Accounting/Ledger.php"
click node_accounts "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Models/Accounting/Account.php"
click node_report_ui "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/reports/ReportCentre.vue"
click node_reports "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Reports/ReportCenterController.php"
click node_report_registry "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Services/Reports/ReportRegistry.php"
click node_admin_ui "https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/dashboard/admin/index.vue"
click node_users "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/UserController.php"
click node_user_model "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Laravue/Models/User.php"
click node_acl "https://github.com/saudexgpt/daylizstores-new/blob/main/app/Laravue/Acl.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_storefront,node_checkout,node_order_ui,node_orders,node_order_records,node_staff toneBlue
class node_catalog_ui,node_catalog,node_items,node_receiving,node_costing toneAmber
class node_accounting_ui,node_transactions,node_ledger,node_accounts,node_report_ui,node_reports,node_report_registry toneMint
class node_admin_ui,node_users,node_user_model,node_acl toneRose
class node_shopper toneIndigo
```

## Components

### Storefront and orders

- [Storefront](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/pages/index.vue): `resources/js/pages/index.vue`
- [Checkout](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/pages/CheckOut.vue): `resources/js/pages/CheckOut.vue`
- [Order screens](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/order/Create.vue): `resources/js/app/order/Create.vue`
- [Order handling](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Order/OrdersController.php): `app/Http/Controllers/Order/OrdersController.php`
- [Order records](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Models/Order/Order.php): `app/Models/Order/Order.php`

### Catalog and inventory

- [Catalog screens](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/stock/item/ManageItem.vue): `resources/js/app/stock/item/ManageItem.vue`
- [Catalog management](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Stock/ItemsController.php): `app/Http/Controllers/Stock/ItemsController.php`
- [Products and stock](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Models/Stock/Item.php): `app/Models/Stock/Item.php`
- [Stock receiving](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Costing/ReceiptsController.php): `app/Http/Controllers/Costing/ReceiptsController.php`
- [FIFO costing](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Services/Costing/Costing.php): `app/Services/Costing/Costing.php`

### Finance and reporting

- [Accounting screens](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/accounting/Overview.vue): `resources/js/app/accounting/Overview.vue`
- [Transactions](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Accounting/TransactionsController.php): `app/Http/Controllers/Accounting/TransactionsController.php`
- [Ledger service](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Services/Accounting/Ledger.php): `app/Services/Accounting/Ledger.php`
- [Accounts](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Models/Accounting/Account.php): `app/Models/Accounting/Account.php`
- [Report centre](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/reports/ReportCentre.vue): `resources/js/app/reports/ReportCentre.vue`
- [Report generation](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/Reports/ReportCenterController.php): `app/Http/Controllers/Reports/ReportCenterController.php`
- [Report definitions](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Services/Reports/ReportRegistry.php): `app/Services/Reports/ReportRegistry.php`

### Administration and identity

- [Admin dashboard](https://github.com/saudexgpt/daylizstores-new/blob/main/resources/js/app/dashboard/admin/index.vue): `resources/js/app/dashboard/admin/index.vue`
- [User administration](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [Users and roles](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Laravue/Models/User.php): `app/Laravue/Models/User.php`
- [Access control](https://github.com/saudexgpt/daylizstores-new/blob/main/app/Laravue/Acl.php): `app/Laravue/Acl.php`

### Other components

- **Shopper**
- **Staff user**

## Connections

- Shopper → Storefront: browses (evidence: `README.md`)
- Storefront → Checkout: opens checkout
- Checkout → Order handling: submits order
- Staff user → Order screens: manages orders
- Order screens → Order handling: requests changes
- Order handling → Order records: reads and writes (evidence: `app/Http/Controllers/Order/OrdersController.php`)
- Order handling → FIFO costing: requests costing (evidence: `app/Http/Controllers/Order/OrdersController.php`)
- Staff user → Catalog screens: maintains catalog
- Catalog screens → Catalog management: requests updates
- Catalog management → Products and stock: reads and writes (evidence: `app/Http/Controllers/Stock/ItemsController.php`)
- Staff user → Stock receiving: records receipts
- Stock receiving → FIFO costing: records stock receipt (evidence: `app/Http/Controllers/Costing/ReceiptsController.php`)
- Stock receiving → Products and stock: updates stock (evidence: `app/Http/Controllers/Costing/ReceiptsController.php`)
- FIFO costing → Ledger service: posts entries (evidence: `app/Services/Costing/Costing.php`)
- Staff user → Accounting screens: uses accounting
- Accounting screens → Transactions: requests transactions
- Transactions → Ledger service: posts transactions (evidence: `app/Http/Controllers/Accounting/TransactionsController.php`)
- Transactions → Accounts: reads accounts (evidence: `app/Http/Controllers/Accounting/TransactionsController.php`)
- Staff user → Report centre: runs reports
- Report centre → Report generation: requests report
- Report generation → Report definitions: resolves definitions (evidence: `app/Http/Controllers/Reports/ReportCenterController.php`)
- Staff user → Admin dashboard: views dashboard
- Staff user → User administration: manages access
- User administration → Users and roles: reads and updates (evidence: `app/Http/Controllers/UserController.php`)
- User administration → Access control: checks permissions (evidence: `app/Http/Controllers/UserController.php`)