# mohsinalisheliya/sku_manager architecture

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

- Interactive diagram: https://gitdiagram.com/mohsinalisheliya/sku_manager
- Repository: https://github.com/mohsinalisheliya/sku_manager

## Overview

This is a Django jewelry SKU and stock-management application. Staff sign in, create or edit SKU records, receive stock in batches, manage locations and platform prices, then track inventory and dispatch scanned items; they can also print labels, export CSV, and configure application settings. The sampled URL configuration and views establish routing and model usage, but many individual view bodies were omitted, so feature-specific internal calls are not expanded beyond what the excerpts support.

Main entry points: [`sku_manager/views.py`](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py) (Request handlers), [`sku_manager/models.py`](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py) (SKU records), [`db.sqlite3`](https://github.com/mohsinalisheliya/sku_manager/blob/main/db.sqlite3) (SQLite database), [`sku_manager/admin.py`](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/admin.py) (Django admin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_django_routes["Project routing<br/>[urls.py]"]
  node_app_routes["SKU routes<br/>[urls.py]"]
  node_views["Request handlers<br/>[views.py]"]
  node_templates["Web pages"]
  node_admin["Django admin<br/>[admin.py]"]
end

subgraph group_catalog["Product catalog"]
  node_catalog_ops["SKU catalog<br/>[views.py]"]
  node_sku_data[("SKU records<br/>[models.py]")]
end

subgraph group_stock["Inventory operations"]
  node_inventory_ops["Stock management<br/>[views.py]"]
  node_batch_data[("Stock batches<br/>[models.py]")]
  node_location_ops["Storage locations<br/>[views.py]"]
  node_location_data[("Boxes and platforms<br/>[models.py]")]
end

subgraph group_operations["Dispatch and settings"]
  node_dispatch_ops["Scan and dispatch<br/>[views.py]"]
  node_dispatch_data[("Dispatch logs<br/>[models.py]")]
  node_label_export["Labels and export<br/>[views.py]"]
  node_app_config[("App settings<br/>[models.py]")]
end

node_staff(("Staff user"))
node_sqlite[("SQLite database<br/>[db.sqlite3]")]

node_staff -->|"sends requests"| node_django_routes
node_django_routes -->|"includes routes"| node_app_routes
node_app_routes -->|"dispatches requests"| node_views
node_views -->|"renders pages"| node_templates
node_views -->|"handles catalog"| node_catalog_ops
node_views -->|"handles inventory"| node_inventory_ops
node_views -->|"handles locations"| node_location_ops
node_views -->|"handles dispatch"| node_dispatch_ops
node_views -->|"handles utilities"| node_label_export
node_views -->|"queries and updates"| node_sku_data
node_catalog_ops -->|"creates and edits"| node_sku_data
node_inventory_ops -->|"records stock batches"| node_batch_data
node_inventory_ops -->|"reads and updates stock"| node_sku_data
node_location_ops -->|"reads and updates"| node_location_data
node_dispatch_ops -.->|"records dispatches"| node_dispatch_data
node_dispatch_ops -.->|"updates stock"| node_sku_data
node_label_export -.->|"uses SKU data"| node_sku_data
node_views -->|"loads settings"| node_app_config
node_admin -->|"administers records"| node_sku_data
node_admin -->|"administers platforms"| node_location_data
node_admin -->|"administers logs"| node_dispatch_data
node_sku_data -.->|"persists records"| node_sqlite
node_batch_data -.->|"persists batches"| node_sqlite
node_location_data -.->|"persists records"| node_sqlite
node_dispatch_data -.->|"persists logs"| node_sqlite
node_app_config -.->|"persists settings"| node_sqlite

click node_django_routes "https://github.com/mohsinalisheliya/sku_manager/blob/main/config/urls.py"
click node_app_routes "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/urls.py"
click node_views "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py"
click node_templates "https://github.com/mohsinalisheliya/sku_manager/tree/main/templates/sku_manager"
click node_catalog_ops "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py"
click node_sku_data "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py"
click node_inventory_ops "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py"
click node_batch_data "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py"
click node_location_ops "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py"
click node_location_data "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py"
click node_dispatch_ops "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py"
click node_dispatch_data "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py"
click node_label_export "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py"
click node_app_config "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py"
click node_sqlite "https://github.com/mohsinalisheliya/sku_manager/blob/main/db.sqlite3"
click node_admin "https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/admin.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_django_routes,node_app_routes,node_views,node_templates,node_admin,node_staff toneBlue
class node_catalog_ops,node_sku_data,node_sqlite toneAmber
class node_inventory_ops,node_batch_data,node_location_ops,node_location_data toneMint
class node_dispatch_ops,node_dispatch_data,node_label_export,node_app_config toneRose
```

## Components

### Web application

- [Project routing](https://github.com/mohsinalisheliya/sku_manager/blob/main/config/urls.py): `config/urls.py`
- [SKU routes](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/urls.py): `sku_manager/urls.py`
- [Request handlers](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py): `sku_manager/views.py`
- [Web pages](https://github.com/mohsinalisheliya/sku_manager/tree/main/templates/sku_manager): `templates/sku_manager`
- [Django admin](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/admin.py): `sku_manager/admin.py`

### Product catalog

- [SKU catalog](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py): `sku_manager/views.py`
- [SKU records](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py): `sku_manager/models.py`

### Inventory operations

- [Stock management](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py): `sku_manager/views.py`
- [Stock batches](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py): `sku_manager/models.py`
- [Storage locations](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py): `sku_manager/views.py`
- [Boxes and platforms](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py): `sku_manager/models.py`

### Dispatch and settings

- [Scan and dispatch](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py): `sku_manager/views.py`
- [Dispatch logs](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py): `sku_manager/models.py`
- [Labels and export](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/views.py): `sku_manager/views.py`
- [App settings](https://github.com/mohsinalisheliya/sku_manager/blob/main/sku_manager/models.py): `sku_manager/models.py`

### Other components

- **Staff user**
- [SQLite database](https://github.com/mohsinalisheliya/sku_manager/blob/main/db.sqlite3): `db.sqlite3`

## Connections

- Staff user → Project routing: sends requests (evidence: `config/urls.py`)
- Project routing → SKU routes: includes routes (evidence: `config/urls.py`)
- SKU routes → Request handlers: dispatches requests (evidence: `sku_manager/urls.py`)
- Request handlers → Web pages: renders pages (evidence: `sku_manager/views.py`)
- Request handlers → SKU catalog: handles catalog (evidence: `sku_manager/urls.py`)
- Request handlers → Stock management: handles inventory (evidence: `sku_manager/urls.py`)
- Request handlers → Storage locations: handles locations (evidence: `sku_manager/urls.py`)
- Request handlers → Scan and dispatch: handles dispatch (evidence: `sku_manager/urls.py`)
- Request handlers → Labels and export: handles utilities (evidence: `sku_manager/urls.py`)
- Request handlers → SKU records: queries and updates (evidence: `sku_manager/views.py`)
- SKU catalog → SKU records: creates and edits (evidence: `sku_manager/views.py`)
- Stock management → Stock batches: records stock batches (evidence: `sku_manager/views.py`)
- Stock management → SKU records: reads and updates stock (evidence: `sku_manager/views.py`)
- Storage locations → Boxes and platforms: reads and updates (evidence: `sku_manager/views.py`)
- Scan and dispatch → Dispatch logs: records dispatches (evidence: `sku_manager/views.py`)
- Scan and dispatch → SKU records: updates stock (evidence: `sku_manager/views.py`)
- Labels and export → SKU records: uses SKU data (evidence: `sku_manager/views.py`)
- Request handlers → App settings: loads settings (evidence: `sku_manager/views.py`)
- Django admin → SKU records: administers records (evidence: `sku_manager/admin.py`)
- Django admin → Boxes and platforms: administers platforms (evidence: `sku_manager/admin.py`)
- Django admin → Dispatch logs: administers logs (evidence: `sku_manager/admin.py`)
- SKU records → SQLite database: persists records
- Stock batches → SQLite database: persists batches
- Boxes and platforms → SQLite database: persists records
- Dispatch logs → SQLite database: persists logs
- App settings → SQLite database: persists settings
