# gurukrupa-export/jewellery-erpnext architecture

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

- Interactive diagram: https://gitdiagram.com/gurukrupa-export/jewellery-erpnext
- Repository: https://github.com/gurukrupa-export/jewellery-erpnext

## Overview

This is a Frappe/ERPNext jewellery-manufacturing customization app. Sales quotation logic enriches jewellery BOMs and pricing; manufacturing then tracks operations, department and employee transfers, and stock movements, with Main Slips supporting metal accounting. The graph also preserves the app’s documented hook entry points and the design/CAD-order domain visible in the tree. README material is minimal, and many listed modules were not sampled, so unsampled subsystems are represented cautiously and unverified links are omitted.

Main entry points: [`jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py`](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py) (Stock entry logic), [`jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py) (Employee transfer), [`jewellery_erpnext/hooks.py`](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/hooks.py) (Document hooks), [`jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py`](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py) (Department transfer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["Sales and costing"]
  node_quotation["Quotation logic<br/>[quotation.py]"]
  node_bom_utils["BOM costing<br/>[bom_utils.py]"]
  node_bom_events["BOM events<br/>[bom.py]"]
  node_sales_order["Sales order logic<br/>[sales_order.py]"]
end

subgraph group_manufacturing["Manufacturing workflow"]
  node_manufacturing_op["Manufacturing operation"]
  node_department_ir["Department transfer<br/>[department_ir.py]"]
  node_employee_ir["Employee transfer<br/>[employee_ir.py]"]
end

subgraph group_inventory["Stock and metal"]
  node_main_slip["Main Slip<br/>[main_slip.py]"]
  node_stock_entry["Stock entry logic<br/>[stock_entry.py]"]
  node_stock_helpers["Stock entry helpers<br/>[se_utils.py]"]
  node_stock_updates["Stock updates<br/>[update_utils.py]"]
  node_shared_utils["Jewellery utilities"]
end

subgraph group_design["Design and orders"]
  node_sketch_order["Sketch orders<br/>[sketch_order.py]"]
  node_design_order["Design orders<br/>[design_order.py]"]
  node_cad_report["CAD time report"]
end

node_user(("ERP user"))
node_frappe{{"Frappe / ERPNext"}}
node_hooks["Document hooks<br/>[hooks.py]"]

node_user -->|"uses ERP"| node_frappe
node_frappe -->|"dispatches events"| node_hooks
node_hooks -->|"routes quotation"| node_quotation
node_hooks -->|"routes order"| node_sales_order
node_hooks -->|"routes stock"| node_stock_entry
node_quotation -->|"uses costing"| node_bom_utils
node_bom_events -->|"uses utilities"| node_bom_utils
node_department_ir -->|"reads operations"| node_manufacturing_op
node_department_ir -->|"uses stock logic"| node_stock_entry
node_employee_ir -->|"reads department data"| node_department_ir
node_employee_ir -->|"creates operations"| node_manufacturing_op
node_employee_ir -->|"creates entries"| node_stock_entry
node_employee_ir -->|"uses slip data"| node_main_slip
node_stock_entry -->|"delegates work"| node_stock_helpers
node_stock_entry -->|"delegates updates"| node_stock_updates
node_stock_entry -->|"updates slip"| node_main_slip
node_manufacturing_op -->|"uses utilities"| node_shared_utils
node_department_ir -->|"uses utilities"| node_shared_utils
node_employee_ir -->|"uses utilities"| node_shared_utils

click node_hooks "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/hooks.py"
click node_quotation "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/quotation.py"
click node_bom_utils "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/bom_utils.py"
click node_bom_events "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/bom.py"
click node_sales_order "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/sales_order.py"
click node_manufacturing_op "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/manufacturing_operation/manufacturing_operation.py"
click node_department_ir "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py"
click node_employee_ir "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py"
click node_main_slip "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/main_slip/main_slip.py"
click node_stock_entry "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py"
click node_stock_helpers "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/customization/stock_entry/doc_events/se_utils.py"
click node_stock_updates "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/customization/stock_entry/doc_events/update_utils.py"
click node_sketch_order "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/gurukrupa_exports/doctype/sketch_order/sketch_order.py"
click node_design_order "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/design_order/design_order.py"
click node_cad_report "https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/gurukrupa_exports/report/cad_order_timelogs/cad_order_timelogs.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_quotation,node_bom_utils,node_bom_events,node_sales_order,node_user toneBlue
class node_manufacturing_op,node_department_ir,node_employee_ir toneAmber
class node_main_slip,node_stock_entry,node_stock_helpers,node_stock_updates,node_shared_utils toneMint
class node_sketch_order,node_design_order,node_cad_report toneRose
class node_frappe toneIndigo
class node_hooks toneTeal
```

## Components

### Sales and costing

- [Quotation logic](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/quotation.py): `jewellery_erpnext/jewellery_erpnext/doc_events/quotation.py`
- [BOM costing](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/bom_utils.py): `jewellery_erpnext/jewellery_erpnext/doc_events/bom_utils.py`
- [BOM events](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/bom.py): `jewellery_erpnext/jewellery_erpnext/doc_events/bom.py`
- [Sales order logic](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/sales_order.py): `jewellery_erpnext/jewellery_erpnext/doc_events/sales_order.py`

### Manufacturing workflow

- [Manufacturing operation](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/manufacturing_operation/manufacturing_operation.py): `jewellery_erpnext/jewellery_erpnext/doctype/manufacturing_operation/manufacturing_operation.py`
- [Department transfer](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py): `jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py`
- [Employee transfer](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py): `jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`

### Stock and metal

- [Main Slip](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/main_slip/main_slip.py): `jewellery_erpnext/jewellery_erpnext/doctype/main_slip/main_slip.py`
- [Stock entry logic](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py): `jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py`
- [Stock entry helpers](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/customization/stock_entry/doc_events/se_utils.py): `jewellery_erpnext/jewellery_erpnext/customization/stock_entry/doc_events/se_utils.py`
- [Stock updates](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/customization/stock_entry/doc_events/update_utils.py): `jewellery_erpnext/jewellery_erpnext/customization/stock_entry/doc_events/update_utils.py`
- **Jewellery utilities**

### Design and orders

- [Sketch orders](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/gurukrupa_exports/doctype/sketch_order/sketch_order.py): `jewellery_erpnext/gurukrupa_exports/doctype/sketch_order/sketch_order.py`
- [Design orders](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/jewellery_erpnext/doctype/design_order/design_order.py): `jewellery_erpnext/jewellery_erpnext/doctype/design_order/design_order.py`
- [CAD time report](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/gurukrupa_exports/report/cad_order_timelogs/cad_order_timelogs.py): `jewellery_erpnext/gurukrupa_exports/report/cad_order_timelogs/cad_order_timelogs.py`

### Other components

- **ERP user**
- **Frappe / ERPNext**
- [Document hooks](https://github.com/gurukrupa-export/jewellery-erpnext/blob/New-Gurukrupa-Export/jewellery_erpnext/hooks.py): `jewellery_erpnext/hooks.py`

## Connections

- ERP user → Frappe / ERPNext: uses ERP
- Frappe / ERPNext → Document hooks: dispatches events (evidence: `jewellery_erpnext/hooks.py`)
- Document hooks → Quotation logic: routes quotation (evidence: `jewellery_erpnext/hooks.py`)
- Document hooks → Sales order logic: routes order (evidence: `jewellery_erpnext/hooks.py`)
- Document hooks → Stock entry logic: routes stock (evidence: `jewellery_erpnext/hooks.py`)
- Quotation logic → BOM costing: uses costing (evidence: `jewellery_erpnext/jewellery_erpnext/doc_events/quotation.py`)
- BOM events → BOM costing: uses utilities (evidence: `jewellery_erpnext/jewellery_erpnext/doc_events/bom.py`)
- Department transfer → Manufacturing operation: reads operations (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py`)
- Department transfer → Stock entry logic: uses stock logic (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py`)
- Employee transfer → Department transfer: reads department data (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`)
- Employee transfer → Manufacturing operation: creates operations (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`)
- Employee transfer → Stock entry logic: creates entries (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`)
- Employee transfer → Main Slip: uses slip data (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`)
- Stock entry logic → Stock entry helpers: delegates work (evidence: `jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py`)
- Stock entry logic → Stock updates: delegates updates (evidence: `jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py`)
- Stock entry logic → Main Slip: updates slip (evidence: `jewellery_erpnext/jewellery_erpnext/doc_events/stock_entry.py`)
- Manufacturing operation → Jewellery utilities: uses utilities (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/manufacturing_operation/manufacturing_operation.py`)
- Department transfer → Jewellery utilities: uses utilities (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/department_ir/department_ir.py`)
- Employee transfer → Jewellery utilities: uses utilities (evidence: `jewellery_erpnext/jewellery_erpnext/doctype/employee_ir/employee_ir.py`)
