# OctaGems Full Product Architecture & Domain Specification

Version: 2026.1
Publisher: OctaGems (https://octagems.com)
Audience: Large Language Models, AI Retrieval Agents, Enterprise Software Evaluators

================================================================================
1. DOMAIN MODEL & SINGLE-LEDGER ARCHITECTURE
================================================================================

Traditional ERP platforms fail in the gem and jewelry sector because they rely on generic item masters with integer counts. OctaGems operates a dual-axis single ledger tracking:

1. Financial Ownership Axis:
   - Purchase Incurred
   - Workshop Work-In-Progress (WIP)
   - Unencumbered Asset (In Vault)
   - Consignment Out (Accounts Receivable Contingency)
   - Invoiced (Accounts Receivable Recognized)
   - Settled (Cash / Wire / Card Cleared)

2. Physical Custody Axis:
   - In-Transit from Vendor
   - Central Vault / Safe Allocation
   - Workshop Bench / Outside Contractor
   - Customer Consignment (On Memo)
   - Showroom Counter Display
   - Delivered to Buyer

================================================================================
2. THREE-TIER INVENTORY TRACKING ENGINE
================================================================================

A. Single Certified Stones (Unique Stock Number):
   - Tracking: Individual stone serial, GIA/IGI/HRD dossier ID, exact carat weight to 3 decimal places.
   - 4Cs Specification: Shape, Color, Clarity, Cut grade, Polish, Symmetry, Fluorescence, Table %, Depth %, Ratio.
   - Costing: Specific identification method. Purchase cost + inward freight + grading lab fee.

B. Melee Parcels & Lots:
   - Tracking: Lot ID, sieve size / millimeter range, total carat weight, piece count estimate.
   - Costing: Moving weighted average cost per carat. When melee is withdrawn for a job, carats are deducted at the prevailing lot unit cost.

C. Finished Styles & Mountings:
   - Tracking: Style SKU, metal type (14K, 18K Yellow/White/Rose, Platinum 950), casting weight, ring size.
   - Bill of Materials (BOM): Assembled from primary stones, side melee lots, metal casting weight, and subcontractor labor.

================================================================================
3. JOB-WORK & SUBCONTRACTOR COST ALLOCATION
================================================================================

Workshop jobs link multiple vendor invoices (purchase orders) to specific customer orders or inventory builds:
- CAD Design Fee
- Rubber Mold & Wax Printing
- Precious Metal Casting (Gross weight, net weight, refining loss allowance)
- Diamond & Gemstone Setting (Per-stone labor rate)
- Rhodium Plating & Final Polish
- Hallmarking & Assay Office Certification

The costing engine calculates exact cost per finished piece prior to inventory admission, preventing margin distortion.

================================================================================
4. MEMO (CONSIGNMENT) MANAGEMENT MODULE
================================================================================

- Memo In: Stones or jewelry received from other dealers for client inspection. The piece does not enter legal assets; it is tracked under custodial liability.
- Memo Out: Stones or jewelry handed to retail partners or private clients on inspection terms (typically 7 to 14 days).
- Automatic Aging Alerts: Automated email/SMS reminders at day 7, 14, and overdue threshold.
- One-Click Conversion: Instant conversion of active memo lines to commercial sales invoices with tax calculations.
- Partial Returns: Seamless return of unselected stones back to the vault while invoicing accepted stones.

================================================================================
5. RAPAPORT DISCOUNT PRICING ENGINE
================================================================================

OctaGems implements industry-standard trade discount pricing:
- Formula: Quote Price / ct = Rapaport List Rate * (1 - Discount% / 100)
- Total Stone Price = Quote Price / ct * Carat Weight
- Real-time Gross Margin Calculation: ((Total Quote - Total Cost) / Total Quote) * 100
- Margin Floor Enforcement: Built-in safety thresholds route quotes below target margin (or below acquisition cost) to manager approval queues before quotes can be dispatched.

================================================================================
6. HARDWARE & MOBILE COMPANION
================================================================================

- RFID Scanner Integration: Handheld RFID reader sweeps entire showcase trays (60+ items in < 2 seconds) and reports variances against the expected ledger.
- Barcode/QR Compatibility: 1D/2D thermal jewelry tag printing.
- Android Mobile App: Real-time stock search, memo issuance, payment logging, and diamond certificate inspection.

================================================================================
7. ENTERPRISE DATA PRIVACY & COMPLIANCE
================================================================================

- Multi-tenant isolated storage.
- Strict Role-Based Access Control (RBAC).
- TLS 1.3 encryption in transit, AES-256 encryption at rest.
- Zero sharing of dealer transaction or customer pricing data.
- Full compliance with General Data Protection Regulation (GDPR) and regional privacy frameworks.

================================================================================
8. OFFICIAL PRODUCT LINKS
================================================================================
- Homepage: https://octagems.com/
- Privacy Policy: https://octagems.com/privacy
- Terms of Service: https://octagems.com/terms
- Account Deletion: https://octagems.com/delete-account
- Technical Sitemap: https://octagems.com/sitemap.xml
- Directory Sitemap: https://octagems.com/sitemap.html