# kimithora/veloura-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/kimithora/veloura-dashboard
- Repository: https://github.com/kimithora/veloura-dashboard

## Overview

Veloura is a Django fashion-business management system. Cashiers manage a catalogue and customer records, build a session-based POS cart, create a pending sale, and record payment; confirmation completes payment and triggers stock deduction and ledger entries. Designers manage couture orders through designs, production, fittings, and quality control. The README also describes role-based dashboards, invoices, and future analytics and notifications. Several feature areas are marked coming soon, so their presence in the tree is not evidence that the documented capabilities are complete; links are limited accordingly.

Main entry points: [`sales/service.py`](https://github.com/kimithora/veloura-dashboard/blob/main/sales/service.py) (Sale Processing), [`sales/models.py`](https://github.com/kimithora/veloura-dashboard/blob/main/sales/models.py) (Sales Transactions), [`orders/models.py`](https://github.com/kimithora/veloura-dashboard/blob/main/orders/models.py) (Couture Orders), [`catalog/models.py`](https://github.com/kimithora/veloura-dashboard/blob/main/catalog/models.py) (Products and Barcodes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Operations"]
  node_accounts[("Users and Roles<br/>[models.py]")]
  node_access_control["Role Authorization<br/>[mixins.py]"]
  node_dashboards["Role Dashboards<br/>[views.py]"]
end

subgraph group_retail["Retail and Catalogue"]
  node_catalogue[("Products and Barcodes<br/>[models.py]")]
  node_catalog_views["Catalogue Management<br/>[views.py]"]
  node_customers[("Customer Records<br/>[models.py]")]
  node_suppliers[("Supplier Records<br/>[models.py]")]
  node_pos["POS and Cart<br/>[views.py]"]
  node_sales_service["Sale Processing<br/>[service.py]"]
  node_transactions[("Sales Transactions<br/>[models.py]")]
  node_payments[("Payment Records<br/>[models.py]")]
  node_payment_views["Payment Confirmation<br/>[views.py]"]
  node_invoice["Sales Invoice PDF<br/>[invoice.py]"]
end

subgraph group_stock["Inventory"]
  node_inventory[("Materials and Stock<br/>[models.py]")]
  node_stock_views["Stock Management<br/>[views.py]"]
end

subgraph group_couture["Couture Workflow"]
  node_orders[("Couture Orders<br/>[models.py]")]
  node_designs[("Design Management<br/>[models.py]")]
  node_design_views["Design Workflow<br/>[views.py]"]
  node_production[("Production Workflow<br/>[models.py]")]
  node_production_views["Production Operations<br/>[views.py]"]
end

subgraph group_support["Business Support"]
  node_analytics["Business Analytics<br/>[views.py]"]
  node_notifications["In-app Notifications<br/>[views.py]"]
  node_documents["Additional Reports<br/>[views.py]"]
end

node_staff(("Business Staff"))
node_database[("Django Database")]

node_staff -->|"requests access"| node_access_control
node_access_control -->|"checks roles"| node_accounts
node_staff -->|"operates POS"| node_pos
node_staff -->|"manages catalogue"| node_catalog_views
node_staff -->|"manages stock"| node_stock_views
node_staff -.->|"handles couture"| node_orders
node_staff -.->|"manages designs"| node_design_views
node_pos -->|"creates sales"| node_sales_service
node_sales_service -->|"creates transaction"| node_transactions
node_sales_service -->|"loads variants"| node_catalogue
node_sales_service -->|"records movements"| node_inventory
node_payment_views -->|"records payment"| node_payments
node_payment_views -->|"deducts stock"| node_sales_service
node_payment_views -->|"updates sale status"| node_transactions
node_transactions -->|"produces invoice"| node_invoice
node_catalog_views -->|"manages products"| node_catalogue
node_catalogue -->|"references supplier"| node_suppliers
node_stock_views -->|"updates stock"| node_inventory
node_design_views -->|"manages designs"| node_designs
node_design_views -->|"advances order"| node_orders
node_production_views -->|"manages production"| node_production
node_production_views -->|"tracks order work"| node_orders
node_production_views -->|"records material use"| node_inventory
node_transactions -->|"links customer"| node_customers
node_orders -->|"links customer"| node_customers
node_accounts -->|"persists records"| node_database
node_catalogue -->|"persists records"| node_database
node_transactions -->|"persists records"| node_database
node_payments -->|"persists records"| node_database
node_inventory -->|"persists ledger"| node_database
node_orders -->|"persists records"| node_database
node_designs -->|"persists records"| node_database
node_production -->|"persists records"| node_database
node_analytics -.->|"reads business data"| node_database
node_notifications -.->|"reads records"| node_database
node_documents -.->|"reads records"| node_database

click node_accounts "https://github.com/kimithora/veloura-dashboard/blob/main/accounts/models.py"
click node_access_control "https://github.com/kimithora/veloura-dashboard/blob/main/core/mixins.py"
click node_dashboards "https://github.com/kimithora/veloura-dashboard/blob/main/core/views.py"
click node_catalogue "https://github.com/kimithora/veloura-dashboard/blob/main/catalog/models.py"
click node_catalog_views "https://github.com/kimithora/veloura-dashboard/blob/main/catalog/views.py"
click node_customers "https://github.com/kimithora/veloura-dashboard/blob/main/customers/models.py"
click node_suppliers "https://github.com/kimithora/veloura-dashboard/blob/main/suppliers/models.py"
click node_pos "https://github.com/kimithora/veloura-dashboard/blob/main/sales/views.py"
click node_sales_service "https://github.com/kimithora/veloura-dashboard/blob/main/sales/service.py"
click node_transactions "https://github.com/kimithora/veloura-dashboard/blob/main/sales/models.py"
click node_payments "https://github.com/kimithora/veloura-dashboard/blob/main/payments/models.py"
click node_payment_views "https://github.com/kimithora/veloura-dashboard/blob/main/payments/views.py"
click node_invoice "https://github.com/kimithora/veloura-dashboard/blob/main/sales/invoice.py"
click node_inventory "https://github.com/kimithora/veloura-dashboard/blob/main/inventory/models.py"
click node_stock_views "https://github.com/kimithora/veloura-dashboard/blob/main/inventory/views.py"
click node_orders "https://github.com/kimithora/veloura-dashboard/blob/main/orders/models.py"
click node_designs "https://github.com/kimithora/veloura-dashboard/blob/main/designs/models.py"
click node_design_views "https://github.com/kimithora/veloura-dashboard/blob/main/designs/views.py"
click node_production "https://github.com/kimithora/veloura-dashboard/blob/main/production/models.py"
click node_production_views "https://github.com/kimithora/veloura-dashboard/blob/main/production/views.py"
click node_analytics "https://github.com/kimithora/veloura-dashboard/blob/main/analytics/views.py"
click node_notifications "https://github.com/kimithora/veloura-dashboard/blob/main/notifications/views.py"
click node_documents "https://github.com/kimithora/veloura-dashboard/blob/main/documents/views.py"

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_accounts,node_access_control,node_dashboards toneBlue
class node_catalogue,node_catalog_views,node_customers,node_suppliers,node_pos,node_sales_service,node_transactions,node_payments,node_payment_views,node_invoice,node_database toneAmber
class node_inventory,node_stock_views toneMint
class node_orders,node_designs,node_design_views,node_production,node_production_views toneRose
class node_analytics,node_notifications,node_documents,node_staff toneIndigo
```

## Components

### Access and Operations

- [Users and Roles](https://github.com/kimithora/veloura-dashboard/blob/main/accounts/models.py): `accounts/models.py`
- [Role Authorization](https://github.com/kimithora/veloura-dashboard/blob/main/core/mixins.py): `core/mixins.py`
- [Role Dashboards](https://github.com/kimithora/veloura-dashboard/blob/main/core/views.py): `core/views.py`

### Retail and Catalogue

- [Products and Barcodes](https://github.com/kimithora/veloura-dashboard/blob/main/catalog/models.py): `catalog/models.py`
- [Catalogue Management](https://github.com/kimithora/veloura-dashboard/blob/main/catalog/views.py): `catalog/views.py`
- [Customer Records](https://github.com/kimithora/veloura-dashboard/blob/main/customers/models.py): `customers/models.py`
- [Supplier Records](https://github.com/kimithora/veloura-dashboard/blob/main/suppliers/models.py): `suppliers/models.py`
- [POS and Cart](https://github.com/kimithora/veloura-dashboard/blob/main/sales/views.py): `sales/views.py`
- [Sale Processing](https://github.com/kimithora/veloura-dashboard/blob/main/sales/service.py): `sales/service.py`
- [Sales Transactions](https://github.com/kimithora/veloura-dashboard/blob/main/sales/models.py): `sales/models.py`
- [Payment Records](https://github.com/kimithora/veloura-dashboard/blob/main/payments/models.py): `payments/models.py`
- [Payment Confirmation](https://github.com/kimithora/veloura-dashboard/blob/main/payments/views.py): `payments/views.py`
- [Sales Invoice PDF](https://github.com/kimithora/veloura-dashboard/blob/main/sales/invoice.py): `sales/invoice.py`

### Inventory

- [Materials and Stock](https://github.com/kimithora/veloura-dashboard/blob/main/inventory/models.py): `inventory/models.py`
- [Stock Management](https://github.com/kimithora/veloura-dashboard/blob/main/inventory/views.py): `inventory/views.py`

### Couture Workflow

- [Couture Orders](https://github.com/kimithora/veloura-dashboard/blob/main/orders/models.py): `orders/models.py`
- [Design Management](https://github.com/kimithora/veloura-dashboard/blob/main/designs/models.py): `designs/models.py`
- [Design Workflow](https://github.com/kimithora/veloura-dashboard/blob/main/designs/views.py): `designs/views.py`
- [Production Workflow](https://github.com/kimithora/veloura-dashboard/blob/main/production/models.py): `production/models.py`
- [Production Operations](https://github.com/kimithora/veloura-dashboard/blob/main/production/views.py): `production/views.py`

### Business Support

- [Business Analytics](https://github.com/kimithora/veloura-dashboard/blob/main/analytics/views.py): `analytics/views.py`
- [In-app Notifications](https://github.com/kimithora/veloura-dashboard/blob/main/notifications/views.py): `notifications/views.py`
- [Additional Reports](https://github.com/kimithora/veloura-dashboard/blob/main/documents/views.py): `documents/views.py`

### Other components

- **Business Staff**
- **Django Database**

## Connections

- Business Staff → Role Authorization: requests access (evidence: `README.md`)
- Role Authorization → Users and Roles: checks roles (evidence: `core/mixins.py`)
- Business Staff → POS and Cart: operates POS (evidence: `README.md`)
- Business Staff → Catalogue Management: manages catalogue (evidence: `README.md`)
- Business Staff → Stock Management: manages stock (evidence: `README.md`)
- Business Staff → Couture Orders: handles couture (evidence: `README.md`)
- Business Staff → Design Workflow: manages designs (evidence: `README.md`)
- POS and Cart → Sale Processing: creates sales (evidence: `README.md`)
- Sale Processing → Sales Transactions: creates transaction (evidence: `sales/service.py`)
- Sale Processing → Products and Barcodes: loads variants (evidence: `sales/service.py`)
- Sale Processing → Materials and Stock: records movements (evidence: `sales/service.py`)
- Payment Confirmation → Payment Records: records payment (evidence: `payments/views.py`)
- Payment Confirmation → Sale Processing: deducts stock (evidence: `README.md`)
- Payment Confirmation → Sales Transactions: updates sale status (evidence: `README.md`)
- Sales Transactions → Sales Invoice PDF: produces invoice (evidence: `README.md`)
- Catalogue Management → Products and Barcodes: manages products (evidence: `catalog/views.py`)
- Products and Barcodes → Supplier Records: references supplier (evidence: `catalog/models.py`)
- Stock Management → Materials and Stock: updates stock (evidence: `inventory/views.py`)
- Design Workflow → Design Management: manages designs (evidence: `designs/views.py`)
- Design Workflow → Couture Orders: advances order (evidence: `designs/views.py`)
- Production Operations → Production Workflow: manages production (evidence: `production/views.py`)
- Production Operations → Couture Orders: tracks order work (evidence: `production/views.py`)
- Production Operations → Materials and Stock: records material use (evidence: `production/views.py`)
- Sales Transactions → Customer Records: links customer (evidence: `sales/models.py`)
- Couture Orders → Customer Records: links customer (evidence: `orders/models.py`)
- Users and Roles → Django Database: persists records (evidence: `README.md`)
- Products and Barcodes → Django Database: persists records (evidence: `README.md`)
- Sales Transactions → Django Database: persists records (evidence: `README.md`)
- Payment Records → Django Database: persists records (evidence: `README.md`)
- Materials and Stock → Django Database: persists ledger (evidence: `README.md`)
- Couture Orders → Django Database: persists records (evidence: `README.md`)
- Design Management → Django Database: persists records (evidence: `README.md`)
- Production Workflow → Django Database: persists records (evidence: `README.md`)
- Business Analytics → Django Database: reads business data
- In-app Notifications → Django Database: reads records
- Additional Reports → Django Database: reads records
