# mauricio-junior-dev/sistemaadegags architecture

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

- Interactive diagram: https://gitdiagram.com/mauricio-junior-dev/sistemaadegags
- Repository: https://github.com/mauricio-junior-dev/sistemaadegags

## Overview

Adega is an e-commerce and point-of-sale system: customers browse products and combos, place orders, and follow payment/order status; employees process sales and orders, while administrators manage catalog, stock, delivery, and store settings. Laravel provides the API and persistent domain models, and an optional local .NET Print Bridge turns order data into thermal-printer output. The excerpts show routing, order-to-print behavior, and printer dispatch; other capability branches are retained from the README and tree, with unverified links omitted.

Main entry points: [`backend/app/Http/Controllers/Api/OrderController.php`](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/OrderController.php) (Order API), [`frontend/src/app/app.routes.ts`](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/app.routes.ts) (Storefront routes), [`backend/app/Models/Product.php`](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Product.php) (Product model), [`frontend/src/app/admin/pages/dashboard/dashboard.component.ts`](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/admin/pages/dashboard/dashboard.component.ts) (Admin console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_storefront["Storefront routes<br/>[app.routes.ts]"]
  node_catalog["Catalog browsing"]
  node_combo["Combo shopping"]
  node_cart["Shopping cart<br/>[cart.component.ts]"]
  node_checkout["Order checkout"]
  node_order_tracking["Order tracking"]
  node_auth["Customer identity<br/>[auth.service.ts]"]
end

subgraph group_operations["Store operations"]
  node_employee["Employee POS<br/>[caixa.component.ts]"]
  node_employee_orders["Order operations"]
  node_admin["Admin console"]
  node_admin_catalog["Catalog management"]
  node_admin_combos["Combo management"]
  node_admin_reports["Reports"]
  node_inventory["Stock operations<br/>[StockService.php]"]
  node_delivery["Delivery configuration"]
end

subgraph group_backend["Laravel API"]
  node_order_api["Order API"]
  node_product_api["Product API"]
  node_combo_api["Combo API"]
  node_webhook["Payment webhooks"]
  node_domain_models[("Commerce models<br/>[Order.php]")]
  node_product_model["Product model<br/>[Product.php]"]
  node_category_model["Category model<br/>[Category.php]"]
  node_combo_model["Bundle models<br/>[ProductBundle.php]"]
  node_print_service["Print dispatch<br/>[PrintService.php]"]
end

subgraph group_printing["Thermal printing"]
  node_print_bridge["Print HTTP service<br/>[Program.cs]"]
  node_printer_service["Receipt rendering<br/>[PrinterService.cs]"]
  node_raw_printer["Raw printer output"]
end

node_customer(("Customer"))
node_printer(("Thermal printer"))

node_customer -->|"uses"| node_storefront
node_storefront -->|"routes to"| node_catalog
node_storefront -->|"routes to"| node_combo
node_storefront -->|"routes to"| node_cart
node_storefront -->|"routes to"| node_checkout
node_storefront -.->|"routes to"| node_order_tracking
node_customer -.->|"submits"| node_checkout
node_checkout -.->|"creates order"| node_order_api
node_order_api -->|"reads/writes"| node_domain_models
node_order_api -->|"dispatches print"| node_print_service
node_order_api -->|"checks delivery"| node_delivery
node_order_api -->|"uses products"| node_product_model
node_product_api -->|"queries"| node_product_model
node_product_api -->|"queries"| node_category_model
node_admin_catalog -->|"manages"| node_product_model
node_admin_combos -->|"manages"| node_combo_model
node_combo_model -->|"relates products"| node_product_model
node_product_model -->|"belongs to"| node_category_model
node_employee -.->|"handles sales"| node_order_api
node_employee_orders -.->|"operates orders"| node_order_api
node_admin -.->|"manages catalog"| node_admin_catalog
node_admin -.->|"manages combos"| node_admin_combos
node_admin -.->|"views reports"| node_admin_reports
node_inventory -.->|"updates stock"| node_product_model
node_webhook -.->|"updates payments"| node_domain_models
node_print_service -.->|"posts order"| node_print_bridge
node_print_bridge -->|"invokes"| node_printer_service
node_printer_service -->|"sends bytes"| node_raw_printer
node_raw_printer -.->|"prints receipt"| node_printer

click node_storefront "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/app.routes.ts"
click node_catalog "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/products/pages/product-list-page/product-list-page.component.ts"
click node_combo "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/combos/pages/combos-page/combos-page.component.ts"
click node_cart "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/store/components/cart/cart.component.ts"
click node_checkout "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/checkout/pages/checkout/checkout.component.ts"
click node_order_tracking "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/orders/pages/orders-list/orders-list.component.ts"
click node_auth "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/core/services/auth.service.ts"
click node_employee "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/employee/pages/caixa/caixa.component.ts"
click node_employee_orders "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/employee/pages/pedidos/pedidos.component.ts"
click node_admin "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/admin/pages/dashboard/dashboard.component.ts"
click node_admin_catalog "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ProductController.php"
click node_admin_combos "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ComboController.php"
click node_admin_reports "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ReportController.php"
click node_inventory "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Services/StockService.php"
click node_delivery "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/DeliveryZoneController.php"
click node_order_api "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/OrderController.php"
click node_product_api "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/ProductController.php"
click node_combo_api "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ComboController.php"
click node_webhook "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/WebhookController.php"
click node_domain_models "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Order.php"
click node_product_model "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Product.php"
click node_category_model "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Category.php"
click node_combo_model "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/ProductBundle.php"
click node_print_service "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Services/PrintService.php"
click node_print_bridge "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/print-bridge/Program.cs"
click node_printer_service "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/print-bridge/Services/PrinterService.cs"
click node_raw_printer "https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/print-bridge/Helpers/RawPrinterHelper.cs"

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_catalog,node_combo,node_cart,node_checkout,node_order_tracking,node_auth toneBlue
class node_employee,node_employee_orders,node_admin,node_admin_catalog,node_admin_combos,node_admin_reports,node_inventory,node_delivery toneAmber
class node_order_api,node_product_api,node_combo_api,node_webhook,node_domain_models,node_product_model,node_category_model,node_combo_model,node_print_service toneMint
class node_print_bridge,node_printer_service,node_raw_printer toneRose
class node_customer,node_printer toneIndigo
```

## Components

### Customer storefront

- [Storefront routes](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Catalog browsing](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/products/pages/product-list-page/product-list-page.component.ts): `frontend/src/app/products/pages/product-list-page/product-list-page.component.ts`
- [Combo shopping](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/combos/pages/combos-page/combos-page.component.ts): `frontend/src/app/combos/pages/combos-page/combos-page.component.ts`
- [Shopping cart](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/store/components/cart/cart.component.ts): `frontend/src/app/store/components/cart/cart.component.ts`
- [Order checkout](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/checkout/pages/checkout/checkout.component.ts): `frontend/src/app/checkout/pages/checkout/checkout.component.ts`
- [Order tracking](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/orders/pages/orders-list/orders-list.component.ts): `frontend/src/app/orders/pages/orders-list/orders-list.component.ts`
- [Customer identity](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/core/services/auth.service.ts): `frontend/src/app/core/services/auth.service.ts`

### Store operations

- [Employee POS](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/employee/pages/caixa/caixa.component.ts): `frontend/src/app/employee/pages/caixa/caixa.component.ts`
- [Order operations](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/employee/pages/pedidos/pedidos.component.ts): `frontend/src/app/employee/pages/pedidos/pedidos.component.ts`
- [Admin console](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/frontend/src/app/admin/pages/dashboard/dashboard.component.ts): `frontend/src/app/admin/pages/dashboard/dashboard.component.ts`
- [Catalog management](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ProductController.php): `backend/app/Http/Controllers/Api/Admin/ProductController.php`
- [Combo management](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ComboController.php): `backend/app/Http/Controllers/Api/Admin/ComboController.php`
- [Reports](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ReportController.php): `backend/app/Http/Controllers/Api/Admin/ReportController.php`
- [Stock operations](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Services/StockService.php): `backend/app/Services/StockService.php`
- [Delivery configuration](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/DeliveryZoneController.php): `backend/app/Http/Controllers/DeliveryZoneController.php`

### Laravel API

- [Order API](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/OrderController.php): `backend/app/Http/Controllers/Api/OrderController.php`
- [Product API](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/ProductController.php): `backend/app/Http/Controllers/Api/ProductController.php`
- [Combo API](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/Admin/ComboController.php): `backend/app/Http/Controllers/Api/Admin/ComboController.php`
- [Payment webhooks](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Http/Controllers/Api/WebhookController.php): `backend/app/Http/Controllers/Api/WebhookController.php`
- [Commerce models](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Order.php): `backend/app/Models/Order.php`
- [Product model](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Product.php): `backend/app/Models/Product.php`
- [Category model](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/Category.php): `backend/app/Models/Category.php`
- [Bundle models](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Models/ProductBundle.php): `backend/app/Models/ProductBundle.php`
- [Print dispatch](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/backend/app/Services/PrintService.php): `backend/app/Services/PrintService.php`

### Thermal printing

- [Print HTTP service](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/print-bridge/Program.cs): `print-bridge/Program.cs`
- [Receipt rendering](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/print-bridge/Services/PrinterService.cs): `print-bridge/Services/PrinterService.cs`
- [Raw printer output](https://github.com/mauricio-junior-dev/sistemaadegags/blob/main/print-bridge/Helpers/RawPrinterHelper.cs): `print-bridge/Helpers/RawPrinterHelper.cs`

### Other components

- **Customer**
- **Thermal printer**

## Connections

- Customer → Storefront routes: uses (evidence: `frontend/src/app/app.routes.ts`)
- Storefront routes → Catalog browsing: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Storefront routes → Combo shopping: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Storefront routes → Shopping cart: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Storefront routes → Order checkout: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Storefront routes → Order tracking: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Customer → Order checkout: submits
- Order checkout → Order API: creates order
- Order API → Commerce models: reads/writes (evidence: `backend/app/Http/Controllers/Api/OrderController.php`)
- Order API → Print dispatch: dispatches print (evidence: `backend/app/Http/Controllers/Api/OrderController.php`)
- Order API → Delivery configuration: checks delivery (evidence: `backend/app/Http/Controllers/Api/OrderController.php`)
- Order API → Product model: uses products (evidence: `backend/app/Http/Controllers/Api/OrderController.php`)
- Product API → Product model: queries (evidence: `backend/app/Http/Controllers/Api/ProductController.php`)
- Product API → Category model: queries (evidence: `backend/app/Http/Controllers/Api/ProductController.php`)
- Catalog management → Product model: manages (evidence: `backend/app/Http/Controllers/Api/Admin/ProductController.php`)
- Combo management → Bundle models: manages (evidence: `backend/app/Http/Controllers/Api/Admin/ComboController.php`)
- Bundle models → Product model: relates products
- Product model → Category model: belongs to (evidence: `backend/app/Models/Product.php`)
- Employee POS → Order API: handles sales
- Order operations → Order API: operates orders
- Admin console → Catalog management: manages catalog
- Admin console → Combo management: manages combos
- Admin console → Reports: views reports
- Stock operations → Product model: updates stock
- Payment webhooks → Commerce models: updates payments
- Print dispatch → Print HTTP service: posts order
- Print HTTP service → Receipt rendering: invokes (evidence: `print-bridge/Program.cs`)
- Receipt rendering → Raw printer output: sends bytes (evidence: `print-bridge/Services/PrinterService.cs`)
- Raw printer output → Thermal printer: prints receipt
