> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spn.wtf/llms.txt
> Use this file to discover all available pages before exploring further.

# User Guide

> How to use the Sahyog Heena Jewellers app

## Navigation

| Sidebar Item         | What it does                                        |
| -------------------- | --------------------------------------------------- |
| **Order Drafts**     | Review and process orders that came in via WhatsApp |
| **Client Order**     | View and manage all confirmed client orders         |
| **Takada**           | Track partial deliveries from karigars              |
| **Karigar Account**  | Manage karigar (artisan) accounts and ledgers       |
| **Polisher Account** | Manage polisher accounts and ledgers                |
| **Client Account**   | Manage client accounts and ledgers                  |
| **Bank Account**     | Manage bank accounts and cash transactions          |
| **Bullion Account**  | Manage bullion supplier accounts                    |
| **Khata Upload**     | Upload and import handwritten khata pages           |

***

## Client Orders

<iframe src="https://www.loom.com/embed/34e6da0f5f924112b627fe81eedf779f" width="100%" height="400" frameborder="0" allowfullscreen />

<AccordionGroup>
  <Accordion title="Add an order manually" icon="clipboard-list">
    Go to **Client Order** → **Add Order** → fill in client, slip number, dates, item details → **Save**
  </Accordion>

  <Accordion title="Filter and print orders" icon="print">
    Use the filters at the top (client, karigar, item, delivery date) → click **Print** to download a filtered PDF
  </Accordion>
</AccordionGroup>

***

## Order Management

<iframe src="https://www.loom.com/embed/af8a767708da47b39fddcc1f1425c86d" width="100%" height="400" frameborder="0" allowfullscreen />

<AccordionGroup>
  <Accordion title="Edit an order item" icon="pencil">
    Go to **Client Order** → find the order → click the edit icon → update fields → **Save**
  </Accordion>

  <Accordion title="Delete an order item" icon="trash">
    Go to **Client Order** → find the order → click the delete icon → confirm
  </Accordion>
</AccordionGroup>

***

## Job Management

<iframe src="https://www.loom.com/embed/e52998d7ac7d437592fbfa939d763bb8" width="100%" height="400" frameborder="0" allowfullscreen />

<AccordionGroup>
  <Accordion title="Assign a job while creating an order" icon="plus">
    During order creation, add job details (karigar, type, weight, delivery date) inline — the job is created automatically when the order is saved
  </Accordion>

  <Accordion title="Edit a job" icon="pencil">
    Go to the **Jobs** page → find the job → edit fields → **Save**
  </Accordion>

  <Accordion title="Delete a job" icon="trash">
    Go to the **Jobs** page → delete the job → it is removed from the job page, the karigar/polisher page, and the delivery page
  </Accordion>
</AccordionGroup>

***

## Order Drafts (WhatsApp Orders)

When a customer sends an order via WhatsApp it arrives here as a **draft** for review.

<AccordionGroup>
  <Accordion title="WhatsApp text / image order" icon="message">
    <iframe src="https://www.loom.com/embed/dd40119ba3164f6881289b485d7776cf" width="100%" height="400" frameborder="0" allowfullscreen />

    Send the order details as text or image via WhatsApp → it appears automatically under **Order Drafts**
  </Accordion>

  <Accordion title="WhatsApp voice note order" icon="microphone">
    <iframe src="https://www.loom.com/embed/5d8992c160dc49b2a703fd2947bffb61" width="100%" height="400" frameborder="0" allowfullscreen />

    Send a voice note describing the order → AI transcribes and parses it into a draft
  </Accordion>

  <Accordion title="Incomplete / draft order" icon="circle-half-stroke">
    <iframe src="https://www.loom.com/embed/72793ea827d9454a8c77fc3c6d6142b0" width="100%" height="400" frameborder="0" allowfullscreen />

    If the WhatsApp message is incomplete, it lands under **Order Drafts** for manual review
  </Accordion>

  <Accordion title="Review and edit a draft" icon="pencil">
    1. Click on a draft to open it
    2. For each row, fill in: item name, weight, pieces, karigar, purity, making charges, delivery dates
    3. Select the **Client** from the dropdown at the top
  </Accordion>

  <Accordion title="Convert to orders" icon="check">
    Click **Convert to Orders** → system validates all entries → confirm → Client Orders are created automatically and the draft is removed
  </Accordion>

  <Accordion title="Recalculate slip numbers" icon="arrow-rotate-right">
    Click **Recalculate Slip Numbers** to group entries by karigar and reassign slip numbers in order
  </Accordion>
</AccordionGroup>

***

## Delivery System

<iframe src="https://www.loom.com/embed/ccbea18f05c14fe68a94b87f4f7d5c67" width="100%" height="400" frameborder="0" allowfullscreen />

<iframe src="https://www.loom.com/embed/e142277bade943999c2c5cf217bba47b" width="100%" height="400" frameborder="0" allowfullscreen />

<AccordionGroup>
  <Accordion title="Pending deliveries in notifications" icon="bell">
    Deliveries due soon appear in the **Notifications** page automatically
  </Accordion>

  <Accordion title="Sort by delivery date" icon="sort">
    On the **Delivery** page, use the date sort to prioritize upcoming deliveries
  </Accordion>

  <Accordion title="Mark as delivered" icon="check-circle">
    Click **Mark Delivered** on a job — it is removed from the delivery queue
  </Accordion>

  <Accordion title="Takadas (partial deliveries)" icon="box-open">
    Go to **Takada** → **Add Takada** → fill in client, karigar, slip number, items, weight, date → **Save**
  </Accordion>
</AccordionGroup>

***

## Karigar & Polisher Management

<iframe src="https://www.loom.com/embed/3bd8c16f23ea44ac95291fc40477975e" width="100%" height="400" frameborder="0" allowfullscreen />

<AccordionGroup>
  <Accordion title="Add a new karigar" icon="user-plus">
    Go to **Karigar Account** → click **Add Karigar** → enter the name → **Save**
  </Accordion>

  <Accordion title="Add a karigar ledger entry" icon="plus">
    1. Open the karigar's ledger → click **Add Entry**
    2. Fill in:
       * **IN** (jewelry received back): item name, pure weight, fine %, wastage %, other charges
       * **OUT** (gold/silver given): item name, weight, touch, fine weight
    3. Click **Save**
  </Accordion>

  <Accordion title="Download karigar ledger as PDF" icon="file-pdf">
    Open the karigar's ledger → click **Print / PDF** → choose **IN** or **OUT** side
  </Accordion>

  <Accordion title="Add a new polisher" icon="user-plus">
    Go to **Polisher Account** → **Add Polisher** → enter name, select type (Regular / Meena / Rodium) → **Save**
  </Accordion>

  <Accordion title="Add a polisher ledger entry" icon="plus">
    Open the polisher's ledger → **Add Entry** → fill in date, item, pieces, weights, touch, wastage, making charges, wages → **Save**
  </Accordion>
</AccordionGroup>

***

## Khata Upload

<iframe src="https://www.loom.com/embed/4808205a93ff4a51abfc01205052b5a1" width="100%" height="400" frameborder="0" allowfullscreen />

Import handwritten or scanned ledger pages.

1. Go to **Khata Upload**
2. **Upload** — select image or PDF
3. **Review** — correct OCR-extracted transactions
4. **Assign** — map each entry to the correct party
5. Click **Submit**

<AccordionGroup>
  <Accordion title="Job assignment via Khata" icon="list-check">
    <iframe src="https://www.loom.com/embed/ec70c17dc83a4d3da76d9f0e74e5d353" width="100%" height="400" frameborder="0" allowfullscreen />

    Jobs mentioned in the uploaded image are parsed and displayed — review and confirm to add them
  </Accordion>
</AccordionGroup>

***

## Client Accounts

<AccordionGroup>
  <Accordion title="Add a new client" icon="user-plus">
    1. Go to **Client Account** → click **Add Client**
    2. Enter the client's name and click **Save**

    The client appears in the list with a ₹0 balance.
  </Accordion>

  <Accordion title="View a client's ledger" icon="table">
    Click on any client's name to see all transactions with a running cash and crystal balance.
  </Accordion>

  <Accordion title="Add a ledger entry" icon="plus">
    1. Open a client's ledger → click **Add Entry**
    2. Fill in the date, amount, and whether it is **IN** (received) or **OUT** (given)
    3. Click **Save** — the balance updates automatically
  </Accordion>

  <Accordion title="Edit or delete an entry" icon="pencil">
    * **Edit**: Click the edit icon on any ledger row
    * **Delete IN only**: Click the delete button on the IN side
    * **Delete OUT only**: Click the delete button on the OUT side
    * **Delete whole row**: Use the row-level delete button
  </Accordion>
</AccordionGroup>

***

## Bank & Bullion Accounts

<AccordionGroup>
  <Accordion title="Add a bank account" icon="building-columns">
    Go to **Bank Account** → **Add Bank** → enter the name → **Save**
  </Accordion>

  <Accordion title="Record a bank transaction" icon="arrow-right-arrow-left">
    Open a bank account → **Add Entry** → fill in date, IN (deposited) and OUT (paid) entries → **Save**

    The running balance updates automatically.
  </Accordion>

  <Accordion title="Add a bullion account" icon="coins">
    Go to **Bullion Account** → **Add Bullion** → enter supplier name → **Save**
  </Accordion>

  <Accordion title="Add a bullion ledger entry" icon="plus">
    Open the account → **Add Entry** → fill in date, amount, IN (purchased) or OUT (sold/used) → **Save**
  </Accordion>
</AccordionGroup>

***

## Quick Reference

| Task                         | Where to go                                 |
| ---------------------------- | ------------------------------------------- |
| Add a new client             | Client Account → Add Client                 |
| Record a client payment      | Client Account → client → Add Entry         |
| Add a karigar                | Karigar Account → Add Karigar               |
| Record gold given to karigar | Karigar Account → karigar → Add Entry (OUT) |
| Record jewelry received back | Karigar Account → karigar → Add Entry (IN)  |
| Add a polisher               | Polisher Account → Add Polisher             |
| Add a bank account           | Bank Account → Add Bank                     |
| Record a bank transaction    | Bank Account → bank → Add Entry             |
| Print a karigar's ledger     | Karigar Account → karigar → Print           |
| Create order from WhatsApp   | Order Drafts → draft → Convert to Orders    |
| Manually create an order     | Client Order → Add Order                    |
| Record a partial delivery    | Takada → Add Takada                         |
| Import a handwritten ledger  | Khata Upload                                |
