# puneethkumar-tech/vl-silks architecture

> Architecture diagram of the GitHub repository puneethkumar-tech/vl-silks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/puneethkumar-tech/vl-silks
- Repository: https://github.com/puneethkumar-tech/vl-silks

## Overview

VL Silks is a Flask-based garment-shop management system for catalog, stock, purchasing, point-of-sale, customer credit, returns, and business reporting. Users authenticate and work through server-rendered screens or API endpoints; Flask routes handle requests, business services apply domain logic, and database utilities access MySQL. The README documents the full capability set, but only selected source excerpts were provided, so connections between unsampled route and service modules are not asserted.

Main entry points: [`backend/app.py`](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/app.py) (Flask application), [`backend/routes/products.py`](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/routes/products.py) (Product routes), [`backend/services`](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services) (Domain services), [`backend/utils/database.py`](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/utils/database.py) (Database utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interface"]
  node_screens["Shop screens"]
end

subgraph group_web["Request handling"]
  node_application["Flask application<br/>[app.py]"]
  node_authentication["Authentication<br/>[auth.py]"]
  node_product_routes["Product routes<br/>[products.py]"]
  node_other_routes["Other module routes"]
end

subgraph group_domain["Business capabilities"]
  node_catalog["Catalog and categories"]
  node_inventory["Inventory"]
  node_suppliers["Suppliers and purchasing"]
  node_sales["Sales and billing"]
  node_customers["Customer records"]
  node_credit["Credit and payments"]
  node_returns["Returns and exchanges<br/>[return_service.py]"]
  node_reporting["Dashboard and reports"]
  node_statements["Credit statement PDFs<br/>[pdf_service.py]"]
  node_user_management["User management"]
  node_service_layer["Domain services"]
end

subgraph group_data["Persistence"]
  node_database_access["Database utilities<br/>[database.py]"]
end

node_staff(("Shop staff"))
node_mysql[("MySQL database")]

node_staff -->|"uses"| node_screens
node_application -->|"registers"| node_authentication
node_application -->|"registers"| node_product_routes
node_application -->|"registers"| node_other_routes
node_product_routes -->|"calls product service"| node_service_layer
node_service_layer -->|"queries"| node_database_access
node_database_access -->|"connects"| node_mysql

click node_screens "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/templates"
click node_application "https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/app.py"
click node_authentication "https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/routes/auth.py"
click node_product_routes "https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/routes/products.py"
click node_other_routes "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/routes"
click node_catalog "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_inventory "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_suppliers "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_sales "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_customers "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_credit "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_returns "https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/services/return_service.py"
click node_reporting "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_statements "https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/services/pdf_service.py"
click node_user_management "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_service_layer "https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services"
click node_database_access "https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/utils/database.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_screens toneBlue
class node_application,node_authentication,node_product_routes,node_other_routes,node_mysql toneAmber
class node_catalog,node_inventory,node_suppliers,node_sales,node_customers,node_credit,node_returns,node_reporting,node_statements,node_user_management,node_service_layer toneMint
class node_database_access toneRose
class node_staff toneIndigo
```

## Components

### User interface

- [Shop screens](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/templates): `backend/templates`

### Request handling

- [Flask application](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/app.py): `backend/app.py`
- [Authentication](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/routes/auth.py): `backend/routes/auth.py`
- [Product routes](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/routes/products.py): `backend/routes/products.py`
- [Other module routes](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/routes): `backend/routes`

### Business capabilities

- [Catalog and categories](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Inventory](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Suppliers and purchasing](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Sales and billing](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Customer records](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Credit and payments](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Returns and exchanges](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/services/return_service.py): `backend/services/return_service.py`
- [Dashboard and reports](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Credit statement PDFs](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/services/pdf_service.py): `backend/services/pdf_service.py`
- [User management](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`
- [Domain services](https://github.com/puneethkumar-tech/vl-silks/tree/main/backend/services): `backend/services`

### Persistence

- [Database utilities](https://github.com/puneethkumar-tech/vl-silks/blob/main/backend/utils/database.py): `backend/utils/database.py`

### Other components

- **Shop staff**
- **MySQL database**

## Connections

- Shop staff → Shop screens: uses
- Flask application → Authentication: registers
- Flask application → Product routes: registers
- Flask application → Other module routes: registers
- Product routes → Domain services: calls product service
- Domain services → Database utilities: queries
- Database utilities → MySQL database: connects