# SwarnaDesk (https://swarnadesk.in)

> SwarnaDesk is an enterprise local-first jewellery showroom operating system, 36-district Maharashtra bullion rate board, and zero-knowledge air-gapped Girvi (pawn-lending) ERP deployed on Cloudflare Pages, Cloudflare Workers, and Cloudflare D1 SQLite.

## Core Architectural Capabilities
- **Local-First Offline Continuity (Partitioned DAG Engine):** Eliminates primary key collisions and split-brain forks during peak festival rushes (Dhanteras/Diwali). Every terminal generates deterministic partitioned IDs (`SS-YYYY-Cn-SEQ` for Girvi tickets and `INV-YYYY-Cn-SEQ` for GST invoices) and reconciles via Lamport clocks (`SortKey = (LamportClock, CounterId, Seq)`).
- **Zero-Knowledge Air-Gapped Girvi Vault:** Provides cryptographic privacy under Sections 132 & 133A of the Indian Income Tax Act, 1961. Encrypts the 31-column traditional Saraf loan register client-side inside a dedicated Web Worker (`crypto.worker.ts`) using **AES-256-GCM** with **250,000 PBKDF2-HMAC-SHA256 iterations**. The Cloudflare D1 blind relay (`relay_mailboxes`) stores strictly opaque ciphertext blobs with zero plaintext PII.
- **0.001g Milligram Scale & 4-Part Deduction Hierarchy:** Decommissions flaky serial drivers in favor of a precision touchpad (`ZeroDriverScaleEntry.tsx`) enforcing `Net Weight = Gross - Stones - Wax/Lac - Tanka (Solder Cut)` at `0.001g` resolution.
- **Indian Statutory & Tax Guardrails:**
  - **GST HSN 7113:** 3% GST split symmetrically into 1.5% CGST + 1.5% SGST calculated in exact integer paise.
  - **Income Tax Act Sec 269ST:** Hard programmatic block on cash tenders ≥ ₹2,00,000.
  - **Income Tax Rule 114B:** Mandatory 10-character PAN regex validation (`^[A-Z]{5}[0-9]{4}[A-Z]{1}$`) for bills ≥ ₹2,00,000.
  - **Indian Contract Act Sec 176:** 30-day default demand notice tracking, automated auction surplus refund accounting (`auctionAccounting.ts`), and dual-part legal laser Pavtis (`GirviPavtiTemplate.tsx`).
  - **BIS Hallmarking:** Mandatory 6-character alphanumeric HUID (`A7K9M3`) tracking alongside 6-character micro-QR dumbbell tags (`K9X4M2`).
- **Ed25519 Offline Licensing & Read-Only Settlement Grace Mode:** Guarantees 100% legal access to search loans, calculate interest, release pledged customer collateral, and export `.swarna` USB or `.xlsx` backups even when a software subscription expires.

## Public Entry Coordinates & Agent Endpoints
- **Main Showcase & Interactive Sandbox:** https://swarnadesk.in/
- **Public Bullion Rate Board:** https://swarnadesk.in/rates
- **Live Demo Showroom Workspace:** https://swarnadesk.in/app/sarafjewellers
- **Universal Hardware UUID Enrollment Portal:** https://swarnadesk.in/device
- **Machine-Readable Agent Capabilities:** https://swarnadesk.in/.well-known/agent-capabilities.json

## Official Contact & Engineering Support
- **Developer / Engineering Desk:** VS TechWorks (https://vstechworks.co.in)
- **WhatsApp Support Desk:** +91 94043 11580 (https://wa.me/919404311580)
- **Email:** contact@vstechworks.co.in