# mohsinalisheliya/billofy architecture

> Architecture diagram of the GitHub repository mohsinalisheliya/billofy, 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/billofy
- Repository: https://github.com/mohsinalisheliya/billofy

## Overview

Billofy is a Django-based, offline-capable POS and inventory system. A store operator scans or enters items, completes a sale using a supported payment mode, and produces an invoice; the README also describes returns, stock tracking, product setup, analytics, and role-based access. The graph preserves those documented capabilities, but source excerpts do not show the application handlers or model interactions, so unverified links are dashed and have no evidence path.

Main entry points: [`Apps/billApp`](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp) (Point of sale), [`bill_inventry_system/urls.py`](https://github.com/mohsinalisheliya/billofy/blob/main/bill_inventry_system/urls.py) (Django application), [`Apps/App_Inventory`](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory) (Product catalog), [`static/js/zxing.js`](https://github.com/mohsinalisheliya/billofy/blob/main/static/js/zxing.js) (Barcode scanning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["Sales and billing"]
  node_pos["Point of sale"]
  node_payments["Payment modes"]
  node_invoices["Invoices and printing"]
  node_returns["Sales returns"]
  node_customers["Customer management"]
  node_analytics["Sales analytics"]
end

subgraph group_inventory["Inventory"]
  node_stock["Stock tracking"]
  node_products["Product catalog"]
  node_suppliers["Supplier and brand setup"]
  node_barcodes["Barcode scanning<br/>[zxing.js]"]
end

subgraph group_access["Access and analytics"]
  node_accounts["Users and roles<br/>[models.py]"]
  node_authentication["Authentication"]
end

subgraph group_platform["Application platform"]
  node_database[("SQLite database")]
  node_django["Django application<br/>[urls.py]"]
end

node_operator(("Store operator"))

node_operator -.->|"starts checkout"| node_pos
node_barcodes -.->|"scans items"| node_pos
node_pos -.->|"selects payment"| node_payments
node_pos -.->|"produces invoice"| node_invoices
node_operator -.->|"handles returns"| node_returns
node_operator -.->|"manages customers"| node_customers
node_operator -.->|"manages products"| node_products
node_operator -.->|"sets up suppliers"| node_suppliers
node_products -.->|"uses barcodes"| node_barcodes
node_pos -.->|"updates stock"| node_stock
node_operator -.->|"views analytics"| node_analytics
node_operator -.->|"signs in"| node_authentication
node_authentication -.->|"applies roles"| node_accounts
node_django -.->|"serves app"| node_pos
node_django -.->|"persists records"| node_database

click node_pos "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp"
click node_payments "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp"
click node_invoices "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp"
click node_returns "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp"
click node_customers "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp"
click node_stock "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory"
click node_products "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory"
click node_suppliers "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory"
click node_barcodes "https://github.com/mohsinalisheliya/billofy/blob/main/static/js/zxing.js"
click node_analytics "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Sales"
click node_accounts "https://github.com/mohsinalisheliya/billofy/blob/main/Apps/App_Auth/models.py"
click node_authentication "https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Auth"
click node_django "https://github.com/mohsinalisheliya/billofy/blob/main/bill_inventry_system/urls.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_pos,node_payments,node_invoices,node_returns,node_customers,node_analytics toneBlue
class node_stock,node_products,node_suppliers,node_barcodes toneAmber
class node_accounts,node_authentication toneMint
class node_database,node_django toneRose
class node_operator toneIndigo
```

## Components

### Sales and billing

- [Point of sale](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp): `Apps/billApp`
- [Payment modes](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp): `Apps/billApp`
- [Invoices and printing](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp): `Apps/billApp`
- [Sales returns](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp): `Apps/billApp`
- [Customer management](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/billApp): `Apps/billApp`
- [Sales analytics](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Sales): `Apps/App_Sales`

### Inventory

- [Stock tracking](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory): `Apps/App_Inventory`
- [Product catalog](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory): `Apps/App_Inventory`
- [Supplier and brand setup](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Inventory): `Apps/App_Inventory`
- [Barcode scanning](https://github.com/mohsinalisheliya/billofy/blob/main/static/js/zxing.js): `static/js/zxing.js`

### Access and analytics

- [Users and roles](https://github.com/mohsinalisheliya/billofy/blob/main/Apps/App_Auth/models.py): `Apps/App_Auth/models.py`
- [Authentication](https://github.com/mohsinalisheliya/billofy/tree/main/Apps/App_Auth): `Apps/App_Auth`

### Application platform

- **SQLite database**
- [Django application](https://github.com/mohsinalisheliya/billofy/blob/main/bill_inventry_system/urls.py): `bill_inventry_system/urls.py`

### Other components

- **Store operator**

## Connections

- Store operator → Point of sale: starts checkout
- Barcode scanning → Point of sale: scans items
- Point of sale → Payment modes: selects payment
- Point of sale → Invoices and printing: produces invoice
- Store operator → Sales returns: handles returns
- Store operator → Customer management: manages customers
- Store operator → Product catalog: manages products
- Store operator → Supplier and brand setup: sets up suppliers
- Product catalog → Barcode scanning: uses barcodes
- Point of sale → Stock tracking: updates stock (evidence: `Apps/App_Inventory/views.py`)
- Store operator → Sales analytics: views analytics
- Store operator → Authentication: signs in
- Authentication → Users and roles: applies roles
- Django application → Point of sale: serves app
- Django application → SQLite database: persists records
