# firstkao/mercatoria architecture

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

- Interactive diagram: https://gitdiagram.com/firstkao/mercatoria
- Repository: https://github.com/firstkao/mercatoria

## Overview

Mercatoria is a Laravel storefront for game-related products, with customer accounts, cart and checkout, payment-proof review, and order fulfillment, alongside an administrative back office. The principal workflow runs from catalog browsing through checkout and payment verification to order-status management. The graph also preserves referral/coin rewards, preorder and reseller entry points, and store administration. Edges reflect sampled calls and imports or explicit route registrations; several unsampled feature links are left unconnected rather than inferred.

Main entry points: [`plain/routes/web.php`](https://github.com/firstkao/mercatoria/blob/main/plain/routes/web.php) (Web Routes), [`plain/app/Models/Order.php`](https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Order.php) (Order Data), [`plain/app/Http/Controllers/CatalogController.php`](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CatalogController.php) (Catalog Browsing), [`plain/app/Http/Controllers/CheckoutController.php`](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CheckoutController.php) (Checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_web_routes["Web Routes<br/>[web.php]"]
  node_catalog["Catalog Browsing"]
  node_cart["Shopping Cart<br/>[CartController.php]"]
  node_search["Search"]
  node_sale["Sales<br/>[SaleController.php]"]
  node_preorder["Preorders"]
end

subgraph group_customer["Accounts And Rewards"]
  node_accounts["Authentication"]
  node_profile["Account And Profile"]
  node_referrals["Referral Rewards"]
  node_coins["Coin Balance<br/>[CoinController.php]"]
end

subgraph group_fulfillment["Orders And Payments"]
  node_checkout["Checkout"]
  node_orders["Order Tracking"]
  node_proof_review["Payment Review"]
  node_order_admin["Order Management"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin Operations"]
end

subgraph group_core["Shared Domain"]
  node_products[("Product And Game Data<br/>[Product.php]")]
  node_order_data[("Order Data<br/>[Order.php]")]
  node_pricing["Price Calculation"]
  node_settings[("Store Settings<br/>[Setting.php]")]
  node_notifications["Notifications"]
end

node_shopper(("Shopper"))
node_admin_actor(("Administrator"))

node_web_routes -->|"routes to"| node_catalog
node_web_routes -->|"routes to"| node_cart
node_web_routes -->|"routes to"| node_search
node_web_routes -->|"routes to"| node_sale
node_web_routes -->|"routes to"| node_preorder
node_web_routes -->|"routes to"| node_accounts
node_web_routes -->|"routes to"| node_profile
node_web_routes -->|"routes to"| node_referrals
node_web_routes -->|"routes to"| node_coins
node_web_routes -->|"routes to"| node_checkout
node_web_routes -->|"routes to"| node_orders
node_web_routes -->|"routes to"| node_proof_review
node_web_routes -->|"routes to"| node_order_admin
node_shopper -.->|"uses"| node_web_routes
node_admin_actor -.->|"uses"| node_web_routes
node_catalog -->|"queries"| node_products
node_catalog -->|"uses"| node_pricing
node_pricing -->|"reads"| node_settings
node_checkout -->|"creates"| node_order_data
node_checkout -->|"uses"| node_pricing
node_orders -->|"queries"| node_order_data
node_proof_review -->|"updates"| node_order_data
node_order_admin -->|"updates"| node_order_data
node_order_admin -->|"notifies"| node_notifications
node_notifications -->|"uses"| node_order_data

click node_web_routes "https://github.com/firstkao/mercatoria/blob/main/plain/routes/web.php"
click node_catalog "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CatalogController.php"
click node_cart "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CartController.php"
click node_search "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/SearchController.php"
click node_sale "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/SaleController.php"
click node_preorder "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/PreorderPageController.php"
click node_accounts "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_profile "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/AccountController.php"
click node_referrals "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/ReferralController.php"
click node_coins "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CoinController.php"
click node_checkout "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CheckoutController.php"
click node_orders "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/OrderController.php"
click node_proof_review "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Admin/PaymentProofController.php"
click node_order_admin "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Admin/OrderManagementController.php"
click node_admin_routes "https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Admin/DashboardController.php"
click node_products "https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Product.php"
click node_order_data "https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Order.php"
click node_pricing "https://github.com/firstkao/mercatoria/blob/main/plain/app/Support/PriceCalculator.php"
click node_settings "https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Setting.php"
click node_notifications "https://github.com/firstkao/mercatoria/blob/main/plain/app/Services/NotificationService.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_catalog,node_cart,node_search,node_sale,node_preorder toneBlue
class node_accounts,node_profile,node_referrals,node_coins toneAmber
class node_checkout,node_orders,node_proof_review,node_order_admin toneMint
class node_admin_routes toneRose
class node_products,node_order_data,node_pricing,node_settings,node_notifications,node_shopper,node_admin_actor toneIndigo
```

## Components

### Storefront

- [Web Routes](https://github.com/firstkao/mercatoria/blob/main/plain/routes/web.php): `plain/routes/web.php`
- [Catalog Browsing](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CatalogController.php): `plain/app/Http/Controllers/CatalogController.php`
- [Shopping Cart](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CartController.php): `plain/app/Http/Controllers/CartController.php`
- [Search](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/SearchController.php): `plain/app/Http/Controllers/SearchController.php`
- [Sales](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/SaleController.php): `plain/app/Http/Controllers/SaleController.php`
- [Preorders](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/PreorderPageController.php): `plain/app/Http/Controllers/PreorderPageController.php`

### Accounts And Rewards

- [Authentication](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Auth/RegisteredUserController.php): `plain/app/Http/Controllers/Auth/RegisteredUserController.php`
- [Account And Profile](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/AccountController.php): `plain/app/Http/Controllers/AccountController.php`
- [Referral Rewards](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/ReferralController.php): `plain/app/Http/Controllers/ReferralController.php`
- [Coin Balance](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CoinController.php): `plain/app/Http/Controllers/CoinController.php`

### Orders And Payments

- [Checkout](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/CheckoutController.php): `plain/app/Http/Controllers/CheckoutController.php`
- [Order Tracking](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/OrderController.php): `plain/app/Http/Controllers/OrderController.php`
- [Payment Review](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Admin/PaymentProofController.php): `plain/app/Http/Controllers/Admin/PaymentProofController.php`
- [Order Management](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Admin/OrderManagementController.php): `plain/app/Http/Controllers/Admin/OrderManagementController.php`

### Administration

- [Admin Operations](https://github.com/firstkao/mercatoria/blob/main/plain/app/Http/Controllers/Admin/DashboardController.php): `plain/app/Http/Controllers/Admin/DashboardController.php`

### Shared Domain

- [Product And Game Data](https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Product.php): `plain/app/Models/Product.php`
- [Order Data](https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Order.php): `plain/app/Models/Order.php`
- [Price Calculation](https://github.com/firstkao/mercatoria/blob/main/plain/app/Support/PriceCalculator.php): `plain/app/Support/PriceCalculator.php`
- [Store Settings](https://github.com/firstkao/mercatoria/blob/main/plain/app/Models/Setting.php): `plain/app/Models/Setting.php`
- [Notifications](https://github.com/firstkao/mercatoria/blob/main/plain/app/Services/NotificationService.php): `plain/app/Services/NotificationService.php`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Web Routes → Catalog Browsing: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Shopping Cart: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Search: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Sales: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Preorders: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Authentication: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Account And Profile: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Referral Rewards: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Coin Balance: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Checkout: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Order Tracking: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Payment Review: routes to (evidence: `plain/routes/web.php`)
- Web Routes → Order Management: routes to (evidence: `plain/routes/web.php`)
- Shopper → Web Routes: uses
- Administrator → Web Routes: uses
- Catalog Browsing → Product And Game Data: queries (evidence: `plain/app/Http/Controllers/CatalogController.php`)
- Catalog Browsing → Price Calculation: uses (evidence: `plain/app/Http/Controllers/CatalogController.php`)
- Price Calculation → Store Settings: reads (evidence: `plain/app/Support/PriceCalculator.php`)
- Checkout → Order Data: creates (evidence: `plain/app/Http/Controllers/CheckoutController.php`)
- Checkout → Price Calculation: uses (evidence: `plain/app/Http/Controllers/CheckoutController.php`)
- Order Tracking → Order Data: queries (evidence: `plain/app/Http/Controllers/OrderController.php`)
- Payment Review → Order Data: updates (evidence: `plain/app/Http/Controllers/Admin/PaymentProofController.php`)
- Order Management → Order Data: updates (evidence: `plain/app/Http/Controllers/Admin/OrderManagementController.php`)
- Order Management → Notifications: notifies (evidence: `plain/app/Http/Controllers/Admin/OrderManagementController.php`)
- Notifications → Order Data: uses (evidence: `plain/app/Services/NotificationService.php`)
