# ad-winner/app-loja-digital architecture

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

- Interactive diagram: https://gitdiagram.com/ad-winner/app-loja-digital
- Repository: https://github.com/ad-winner/app-loja-digital

## Overview

This appears to be a Laravel business-management application for partners (colaboradores), stores, users and related records, with role/permission administration and authentication. The main workflow is a browser request routed to a controller, which validates or scopes the operation and reads or changes domain models. The tree also shows inventory/products, expenses, transactions, suppliers, customers, and geographic classifications. The README describes Laravel rather than application-specific behavior; several links below are supported only by the SOURCE INDEX, so unsampled behavior is not inferred.

Main entry points: [`routes/web.php`](https://github.com/ad-winner/app-loja-digital/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/LojaController.php`](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/LojaController.php) (Store management), [`app/Models/Loja.php`](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Loja.php) (Stores), [`app/Http/Controllers/UserController.php`](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/UserController.php) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_routes["Web routes<br/>[web.php]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication"]
  node_users_ctrl["User management<br/>[UserController.php]"]
  node_roles_ctrl["Role management<br/>[RoleController.php]"]
  node_permissions_ctrl["Permission management"]
  node_users[("Users and roles<br/>[User.php]")]
  node_roles[("Roles<br/>[Role.php]")]
  node_permissions[("Permissions<br/>[Permission.php]")]
end

subgraph group_organization["Organization"]
  node_partners_ctrl["Partner management"]
  node_stores_ctrl["Store management<br/>[LojaController.php]"]
  node_regions_ctrl["Region management"]
  node_sectors_ctrl["Sector management"]
  node_store_types_ctrl["Store types"]
  node_staff_types_ctrl["Staff types"]
  node_partners[("Partners<br/>[Colaborador.php]")]
  node_stores[("Stores<br/>[Loja.php]")]
  node_regions[("Regions<br/>[Regiao.php]")]
  node_sectors[("Sectors<br/>[Sector.php]")]
  node_store_types[("Store types<br/>[TipoLoja.php]")]
  node_staff_types[("Staff types")]
end

subgraph group_business["Business records"]
  node_products_ctrl["Product management"]
  node_expenses_ctrl["Expense management"]
  node_transactions_ctrl["Transactions"]
  node_suppliers_ctrl["Supplier management"]
  node_customers_ctrl["Customer management"]
  node_products[("Products<br/>[Produto.php]")]
  node_expenses[("Expenses<br/>[Despesa.php]")]
  node_transactions[("Transactions<br/>[Transacao.php]")]
  node_suppliers[("Suppliers<br/>[Fornecedor.php]")]
  node_customers[("Customers<br/>[Cliente.php]")]
end

node_browser(("Browser user"))

node_browser -->|"requests pages"| node_routes
node_routes -->|"routes auth"| node_auth
node_routes -->|"routes requests"| node_users_ctrl
node_routes -->|"routes requests"| node_roles_ctrl
node_routes -->|"routes requests"| node_permissions_ctrl
node_routes -->|"routes requests"| node_partners_ctrl
node_routes -->|"routes requests"| node_stores_ctrl
node_routes -->|"routes requests"| node_regions_ctrl
node_routes -->|"routes requests"| node_sectors_ctrl
node_routes -->|"routes requests"| node_store_types_ctrl
node_routes -->|"routes requests"| node_staff_types_ctrl
node_routes -->|"routes requests"| node_products_ctrl
node_routes -->|"routes requests"| node_expenses_ctrl
node_routes -->|"routes requests"| node_transactions_ctrl
node_routes -->|"routes requests"| node_suppliers_ctrl
node_routes -->|"routes requests"| node_customers_ctrl
node_users_ctrl -->|"queries and updates"| node_users
node_users_ctrl -->|"queries roles"| node_roles
node_users_ctrl -->|"queries stores"| node_stores
node_users_ctrl -->|"queries partners"| node_partners
node_roles_ctrl -->|"manages roles"| node_roles
node_roles_ctrl -->|"uses permissions"| node_permissions
node_permissions_ctrl -->|"uses roles"| node_roles
node_permissions_ctrl -->|"manages permissions"| node_permissions
node_partners_ctrl -->|"creates and updates"| node_partners
node_partners_ctrl -->|"creates account"| node_users
node_stores_ctrl -->|"creates and queries"| node_stores
node_stores_ctrl -->|"queries regions"| node_regions
node_stores_ctrl -->|"queries sectors"| node_sectors
node_stores_ctrl -->|"queries types"| node_store_types
node_stores_ctrl -->|"queries partners"| node_partners
node_stores_ctrl -->|"queries users"| node_users
node_stores -->|"looks up region code"| node_regions
node_stores -->|"looks up sector code"| node_sectors
node_regions -->|"has many sectors"| node_sectors
node_regions -->|"has many stores"| node_stores
node_sectors -->|"belongs to"| node_regions
node_products_ctrl -->|"manages products"| node_products
node_expenses_ctrl -->|"manages expenses"| node_expenses
node_transactions_ctrl -->|"manages transactions"| node_transactions
node_suppliers_ctrl -->|"manages suppliers"| node_suppliers
node_customers_ctrl -->|"manages customers"| node_customers
node_stores -->|"has many products"| node_products
node_stores -->|"has many expenses"| node_expenses

click node_routes "https://github.com/ad-winner/app-loja-digital/blob/main/routes/web.php"
click node_auth "https://github.com/ad-winner/app-loja-digital/tree/main/app/Http/Controllers/Auth"
click node_users_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/UserController.php"
click node_roles_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/RoleController.php"
click node_permissions_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/PermissionController.php"
click node_users "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/User.php"
click node_roles "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Role.php"
click node_permissions "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Permission.php"
click node_partners_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/ColaboradorController.php"
click node_stores_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/LojaController.php"
click node_regions_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/RegiaoController.php"
click node_sectors_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/SectorController.php"
click node_store_types_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/TipoLojaController.php"
click node_staff_types_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/TipoColaboradorController.php"
click node_partners "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Colaborador.php"
click node_stores "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Loja.php"
click node_regions "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Regiao.php"
click node_sectors "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Sector.php"
click node_store_types "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/TipoLoja.php"
click node_staff_types "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/TipoColaborador.php"
click node_products_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/ProdutoController.php"
click node_expenses_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/DespesaController.php"
click node_transactions_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/TransacaoController.php"
click node_suppliers_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/FornecedorController.php"
click node_customers_ctrl "https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/ClienteController.php"
click node_products "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Produto.php"
click node_expenses "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Despesa.php"
click node_transactions "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Transacao.php"
click node_suppliers "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Fornecedor.php"
click node_customers "https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Cliente.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_routes,node_browser toneBlue
class node_auth,node_users_ctrl,node_roles_ctrl,node_permissions_ctrl,node_users,node_roles,node_permissions toneAmber
class node_partners_ctrl,node_stores_ctrl,node_regions_ctrl,node_sectors_ctrl,node_store_types_ctrl,node_staff_types_ctrl,node_partners,node_stores,node_regions,node_sectors,node_store_types,node_staff_types toneMint
class node_products_ctrl,node_expenses_ctrl,node_transactions_ctrl,node_suppliers_ctrl,node_customers_ctrl,node_products,node_expenses,node_transactions,node_suppliers,node_customers toneRose
```

## Components

### Web entry

- [Web routes](https://github.com/ad-winner/app-loja-digital/blob/main/routes/web.php): `routes/web.php`

### Identity and access

- [Authentication](https://github.com/ad-winner/app-loja-digital/tree/main/app/Http/Controllers/Auth): `app/Http/Controllers/Auth`
- [User management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [Role management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/RoleController.php): `app/Http/Controllers/RoleController.php`
- [Permission management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/PermissionController.php): `app/Http/Controllers/PermissionController.php`
- [Users and roles](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/User.php): `app/Models/User.php`
- [Roles](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Role.php): `app/Models/Role.php`
- [Permissions](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Permission.php): `app/Models/Permission.php`

### Organization

- [Partner management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/ColaboradorController.php): `app/Http/Controllers/ColaboradorController.php`
- [Store management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/LojaController.php): `app/Http/Controllers/LojaController.php`
- [Region management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/RegiaoController.php): `app/Http/Controllers/RegiaoController.php`
- [Sector management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/SectorController.php): `app/Http/Controllers/SectorController.php`
- [Store types](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/TipoLojaController.php): `app/Http/Controllers/TipoLojaController.php`
- [Staff types](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/TipoColaboradorController.php): `app/Http/Controllers/TipoColaboradorController.php`
- [Partners](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Colaborador.php): `app/Models/Colaborador.php`
- [Stores](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Loja.php): `app/Models/Loja.php`
- [Regions](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Regiao.php): `app/Models/Regiao.php`
- [Sectors](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Sector.php): `app/Models/Sector.php`
- [Store types](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/TipoLoja.php): `app/Models/TipoLoja.php`
- [Staff types](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/TipoColaborador.php): `app/Models/TipoColaborador.php`

### Business records

- [Product management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/ProdutoController.php): `app/Http/Controllers/ProdutoController.php`
- [Expense management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/DespesaController.php): `app/Http/Controllers/DespesaController.php`
- [Transactions](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/TransacaoController.php): `app/Http/Controllers/TransacaoController.php`
- [Supplier management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/FornecedorController.php): `app/Http/Controllers/FornecedorController.php`
- [Customer management](https://github.com/ad-winner/app-loja-digital/blob/main/app/Http/Controllers/ClienteController.php): `app/Http/Controllers/ClienteController.php`
- [Products](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Produto.php): `app/Models/Produto.php`
- [Expenses](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Despesa.php): `app/Models/Despesa.php`
- [Transactions](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Transacao.php): `app/Models/Transacao.php`
- [Suppliers](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Fornecedor.php): `app/Models/Fornecedor.php`
- [Customers](https://github.com/ad-winner/app-loja-digital/blob/main/app/Models/Cliente.php): `app/Models/Cliente.php`

### Other components

- **Browser user**

## Connections

- Browser user → Web routes: requests pages
- Web routes → Authentication: routes auth (evidence: `routes/web.php`)
- Web routes → User management: routes requests (evidence: `routes/web.php`)
- Web routes → Role management: routes requests (evidence: `routes/web.php`)
- Web routes → Permission management: routes requests (evidence: `routes/web.php`)
- Web routes → Partner management: routes requests (evidence: `routes/web.php`)
- Web routes → Store management: routes requests (evidence: `routes/web.php`)
- Web routes → Region management: routes requests (evidence: `routes/web.php`)
- Web routes → Sector management: routes requests (evidence: `routes/web.php`)
- Web routes → Store types: routes requests (evidence: `routes/web.php`)
- Web routes → Staff types: routes requests (evidence: `routes/web.php`)
- Web routes → Product management: routes requests (evidence: `routes/web.php`)
- Web routes → Expense management: routes requests (evidence: `routes/web.php`)
- Web routes → Transactions: routes requests (evidence: `routes/web.php`)
- Web routes → Supplier management: routes requests (evidence: `routes/web.php`)
- Web routes → Customer management: routes requests (evidence: `routes/web.php`)
- User management → Users and roles: queries and updates (evidence: `app/Http/Controllers/UserController.php`)
- User management → Roles: queries roles (evidence: `app/Http/Controllers/UserController.php`)
- User management → Stores: queries stores (evidence: `app/Http/Controllers/UserController.php`)
- User management → Partners: queries partners (evidence: `app/Http/Controllers/UserController.php`)
- Role management → Roles: manages roles (evidence: `app/Http/Controllers/RoleController.php`)
- Role management → Permissions: uses permissions (evidence: `app/Http/Controllers/RoleController.php`)
- Permission management → Roles: uses roles (evidence: `app/Http/Controllers/PermissionController.php`)
- Permission management → Permissions: manages permissions (evidence: `app/Http/Controllers/PermissionController.php`)
- Partner management → Partners: creates and updates (evidence: `app/Http/Controllers/ColaboradorController.php`)
- Partner management → Users and roles: creates account (evidence: `app/Http/Controllers/ColaboradorController.php`)
- Store management → Stores: creates and queries (evidence: `app/Http/Controllers/LojaController.php`)
- Store management → Regions: queries regions (evidence: `app/Http/Controllers/LojaController.php`)
- Store management → Sectors: queries sectors (evidence: `app/Http/Controllers/LojaController.php`)
- Store management → Store types: queries types (evidence: `app/Http/Controllers/LojaController.php`)
- Store management → Partners: queries partners (evidence: `app/Http/Controllers/LojaController.php`)
- Store management → Users and roles: queries users (evidence: `app/Http/Controllers/LojaController.php`)
- Stores → Regions: looks up region code (evidence: `app/Models/Loja.php`)
- Stores → Sectors: looks up sector code (evidence: `app/Models/Loja.php`)
- Regions → Sectors: has many sectors (evidence: `app/Models/Regiao.php`)
- Regions → Stores: has many stores (evidence: `app/Models/Regiao.php`)
- Sectors → Regions: belongs to (evidence: `app/Models/Sector.php`)
- Product management → Products: manages products (evidence: `app/Http/Controllers/ProdutoController.php`)
- Expense management → Expenses: manages expenses (evidence: `app/Http/Controllers/DespesaController.php`)
- Transactions → Transactions: manages transactions
- Supplier management → Suppliers: manages suppliers (evidence: `app/Http/Controllers/FornecedorController.php`)
- Customer management → Customers: manages customers (evidence: `app/Http/Controllers/ClienteController.php`)
- Stores → Products: has many products (evidence: `app/Models/Loja.php`)
- Stores → Expenses: has many expenses (evidence: `app/Models/Loja.php`)
