# lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5 architecture

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

- Interactive diagram: https://gitdiagram.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5
- Repository: https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5

## Overview

Tienda is a Laravel storefront and Filament administration panel for manual Yape/Plin payments. The customer journey runs from catalog browsing and a session cart through checkout, payment-proof submission, and order tracking; orders also reserve stock until payment or expiry. The graph includes admin operations, customer-data protection, notifications, audit, and backup capabilities. Sampled source supports the storefront and model interactions; the admin panel and several operational flows are represented from the supplied product description, with unverified links left dashed.

Main entry points: [`routes/web.php`](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/Store/CheckoutController.php`](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CheckoutController.php) (Checkout), [`app/Models/Order.php`](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Order.php) (Order lifecycle), [`app/Models/Product.php`](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Product.php) (Products and stock)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_auth["Customer accounts<br/>[AuthController.php]"]
  node_catalog["Catalog browsing"]
  node_catalog_views["Catalog views<br/>[index.blade.php]"]
  node_cart_controller["Cart actions<br/>[CartController.php]"]
  node_cart["Session cart<br/>[Cart.php]"]
end

subgraph group_orders["Orders and inventory"]
  node_checkout["Checkout"]
  node_proof["Payment proof"]
  node_order_views["Order tracking"]
  node_orders_model["Order lifecycle<br/>[Order.php]"]
  node_order_items["Order items<br/>[OrderItem.php]"]
end

subgraph group_admin["Administration"]
  node_admin_panel["Admin panel"]
  node_admin_resources["Management resources"]
  node_dashboard["Dashboard metrics"]
  node_audit["Activity audit<br/>[Auditable.php]"]
end

subgraph group_operations["Notifications and backups"]
  node_store_notifier["Store notifications<br/>[StoreNotifier.php]"]
  node_internal_notifier["Internal notices"]
  node_recipients[("Email recipients<br/>[EmailRecipient.php]")]
  node_backup_job["Backup email job"]
  node_backup_zip["Encrypted database ZIP"]
  node_backup_download["Backup download"]
end

subgraph group_domain["Domain services"]
  node_products[("Products and stock<br/>[Product.php]")]
  node_customers[("Customer records<br/>[Customer.php]")]
  node_categories[("Categories<br/>[Category.php]")]
end

node_customer(("Customer"))
node_operations_team(("Store team"))

node_customer -->|"requests pages"| node_web_routes
node_web_routes -->|"routes to"| node_auth
node_web_routes -->|"routes to"| node_catalog
node_web_routes -->|"routes to"| node_cart_controller
node_web_routes -->|"routes to"| node_checkout
node_web_routes -->|"routes to"| node_proof
node_web_routes -->|"routes to"| node_order_views
node_catalog -->|"queries"| node_products
node_catalog -->|"queries"| node_categories
node_catalog -->|"renders"| node_catalog_views
node_cart_controller -->|"uses"| node_cart
node_cart_controller -->|"queries"| node_products
node_checkout -->|"reads and clears"| node_cart
node_checkout -->|"checks availability"| node_products
node_checkout -->|"updates"| node_customers
node_checkout -->|"creates order"| node_orders_model
node_checkout -->|"creates items"| node_order_items
node_proof -->|"updates payment"| node_orders_model
node_order_views -->|"queries orders"| node_orders_model
node_orders_model -->|"notifies lifecycle"| node_store_notifier
node_order_items -->|"recalculates total"| node_orders_model
node_order_items -->|"reads product"| node_products
node_products -->|"signals low stock"| node_store_notifier
node_store_notifier -->|"sends notices"| node_internal_notifier
node_internal_notifier -->|"selects recipients"| node_recipients
node_operations_team -.->|"manages store"| node_admin_panel
node_admin_panel -.->|"provides management"| node_admin_resources
node_admin_panel -.->|"shows metrics"| node_dashboard
node_admin_resources -.->|"records changes"| node_audit
node_backup_job -.->|"builds archive"| node_backup_zip
node_backup_job -->|"emails recipients"| node_recipients
node_web_routes -->|"routes to"| node_backup_download

click node_web_routes "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/routes/web.php"
click node_auth "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/AuthController.php"
click node_catalog "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CatalogController.php"
click node_catalog_views "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/resources/views/store/index.blade.php"
click node_cart_controller "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CartController.php"
click node_cart "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/Cart.php"
click node_checkout "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CheckoutController.php"
click node_proof "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/PaymentProofController.php"
click node_order_views "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/OrderController.php"
click node_orders_model "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Order.php"
click node_order_items "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/OrderItem.php"
click node_products "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Product.php"
click node_customers "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Customer.php"
click node_categories "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Category.php"
click node_admin_panel "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Providers/Filament/AdminPanelProvider.php"
click node_admin_resources "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/tree/main/app/Filament/Resources"
click node_dashboard "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/tree/main/app/Filament/Widgets"
click node_audit "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Concerns/Auditable.php"
click node_store_notifier "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/StoreNotifier.php"
click node_internal_notifier "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/InternalNotifier.php"
click node_recipients "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/EmailRecipient.php"
click node_backup_job "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Jobs/SendBackupEmailJob.php"
click node_backup_zip "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/DatabaseBackupZip.php"
click node_backup_download "https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Admin/BackupEmailDownloadController.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_web_routes,node_auth,node_catalog,node_catalog_views,node_cart_controller,node_cart toneBlue
class node_checkout,node_proof,node_order_views,node_orders_model,node_order_items toneAmber
class node_admin_panel,node_admin_resources,node_dashboard,node_audit toneMint
class node_store_notifier,node_internal_notifier,node_recipients,node_backup_job,node_backup_zip,node_backup_download toneRose
class node_products,node_customers,node_categories,node_customer,node_operations_team toneIndigo
```

## Components

### Customer storefront

- [Web routes](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/routes/web.php): `routes/web.php`
- [Customer accounts](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/AuthController.php): `app/Http/Controllers/Store/AuthController.php`
- [Catalog browsing](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CatalogController.php): `app/Http/Controllers/Store/CatalogController.php`
- [Catalog views](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/resources/views/store/index.blade.php): `resources/views/store/index.blade.php`
- [Cart actions](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CartController.php): `app/Http/Controllers/Store/CartController.php`
- [Session cart](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/Cart.php): `app/Support/Cart.php`

### Orders and inventory

- [Checkout](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/CheckoutController.php): `app/Http/Controllers/Store/CheckoutController.php`
- [Payment proof](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/PaymentProofController.php): `app/Http/Controllers/Store/PaymentProofController.php`
- [Order tracking](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Store/OrderController.php): `app/Http/Controllers/Store/OrderController.php`
- [Order lifecycle](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Order items](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/OrderItem.php): `app/Models/OrderItem.php`

### Administration

- [Admin panel](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Providers/Filament/AdminPanelProvider.php): `app/Providers/Filament/AdminPanelProvider.php`
- [Management resources](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/tree/main/app/Filament/Resources): `app/Filament/Resources`
- [Dashboard metrics](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/tree/main/app/Filament/Widgets): `app/Filament/Widgets`
- [Activity audit](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Concerns/Auditable.php): `app/Models/Concerns/Auditable.php`

### Notifications and backups

- [Store notifications](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/StoreNotifier.php): `app/Support/StoreNotifier.php`
- [Internal notices](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/InternalNotifier.php): `app/Support/InternalNotifier.php`
- [Email recipients](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/EmailRecipient.php): `app/Models/EmailRecipient.php`
- [Backup email job](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Jobs/SendBackupEmailJob.php): `app/Jobs/SendBackupEmailJob.php`
- [Encrypted database ZIP](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Support/DatabaseBackupZip.php): `app/Support/DatabaseBackupZip.php`
- [Backup download](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Http/Controllers/Admin/BackupEmailDownloadController.php): `app/Http/Controllers/Admin/BackupEmailDownloadController.php`

### Domain services

- [Products and stock](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Product.php): `app/Models/Product.php`
- [Customer records](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Customer.php): `app/Models/Customer.php`
- [Categories](https://github.com/lewolfdx-art/29-09-2026-proyecto-tienda-filamentv5/blob/main/app/Models/Category.php): `app/Models/Category.php`

### Other components

- **Customer**
- **Store team**

## Connections

- Customer → Web routes: requests pages (evidence: `routes/web.php`)
- Web routes → Customer accounts: routes to (evidence: `routes/web.php`)
- Web routes → Catalog browsing: routes to (evidence: `routes/web.php`)
- Web routes → Cart actions: routes to (evidence: `routes/web.php`)
- Web routes → Checkout: routes to (evidence: `routes/web.php`)
- Web routes → Payment proof: routes to (evidence: `routes/web.php`)
- Web routes → Order tracking: routes to (evidence: `routes/web.php`)
- Catalog browsing → Products and stock: queries (evidence: `app/Http/Controllers/Store/CatalogController.php`)
- Catalog browsing → Categories: queries (evidence: `app/Http/Controllers/Store/CatalogController.php`)
- Catalog browsing → Catalog views: renders (evidence: `app/Http/Controllers/Store/CatalogController.php`)
- Cart actions → Session cart: uses (evidence: `app/Http/Controllers/Store/CartController.php`)
- Cart actions → Products and stock: queries (evidence: `app/Http/Controllers/Store/CartController.php`)
- Checkout → Session cart: reads and clears (evidence: `app/Http/Controllers/Store/CheckoutController.php`)
- Checkout → Products and stock: checks availability (evidence: `app/Http/Controllers/Store/CheckoutController.php`)
- Checkout → Customer records: updates (evidence: `app/Http/Controllers/Store/CheckoutController.php`)
- Checkout → Order lifecycle: creates order (evidence: `app/Http/Controllers/Store/CheckoutController.php`)
- Checkout → Order items: creates items (evidence: `app/Http/Controllers/Store/CheckoutController.php`)
- Payment proof → Order lifecycle: updates payment (evidence: `app/Http/Controllers/Store/PaymentProofController.php`)
- Order tracking → Order lifecycle: queries orders (evidence: `app/Http/Controllers/Store/OrderController.php`)
- Order lifecycle → Store notifications: notifies lifecycle (evidence: `app/Models/Order.php`)
- Order items → Order lifecycle: recalculates total (evidence: `app/Models/OrderItem.php`)
- Order items → Products and stock: reads product (evidence: `app/Models/OrderItem.php`)
- Products and stock → Store notifications: signals low stock (evidence: `app/Models/Product.php`)
- Store notifications → Internal notices: sends notices (evidence: `app/Support/StoreNotifier.php`)
- Internal notices → Email recipients: selects recipients (evidence: `app/Support/InternalNotifier.php`)
- Store team → Admin panel: manages store
- Admin panel → Management resources: provides management
- Admin panel → Dashboard metrics: shows metrics
- Management resources → Activity audit: records changes
- Backup email job → Encrypted database ZIP: builds archive
- Backup email job → Email recipients: emails recipients (evidence: `app/Jobs/SendBackupEmailJob.php`)
- Web routes → Backup download: routes to (evidence: `routes/web.php`)
