> ## 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.

# Heena Jewellers

> Overview of the Sahyog Heena Jewellers management system

Sahyog Heena Jewellers is a full-stack jewelry business management system. It handles client orders, artisan (karigar) ledgers, polisher accounts, bank & bullion accounts, and integrates WhatsApp (via Gupshup) for order placement with AI-powered parsing.

| Part     | Technology                   | Port   |
| -------- | ---------------------------- | ------ |
| Backend  | Python FastAPI + PostgreSQL  | `8000` |
| Frontend | React 19 + TypeScript + Vite | `5173` |

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/heena/api/banks">
    Explore all REST endpoints
  </Card>

  <Card title="Architecture" icon="sitemap" href="/heena/architecture">
    Project structure, frontend routes, and state management
  </Card>

  <Card title="Integrations" icon="plug" href="/heena/integrations">
    WhatsApp (Gupshup), OpenAI, and Khata OCR
  </Card>

  <Card title="Internal Docs" icon="lock" href="/internal/overview">
    Setup, deployment, and database — team only
  </Card>
</CardGroup>

***

## Platform Demo

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

***

## Business Entities

| Entity            | Description                                |
| ----------------- | ------------------------------------------ |
| **Clients**       | Customers who place jewelry orders         |
| **Karigars**      | Artisans who make the jewelry              |
| **Polishers**     | Finishing workers (Regular, Meena, Rodium) |
| **Banks**         | Financial bank accounts                    |
| **Bullions**      | Bullion dealer accounts                    |
| **Client Orders** | Orders placed by clients with slip numbers |
| **Takadas**       | Partial deliveries linked to client orders |
| **Order Drafts**  | WhatsApp-parsed orders pending review      |