# V360 / D360 Platform - Complete LLM Architectural & Technical Reference

This document provides complete machine-readable technical specifications, data models, API conventions, and architectural reference for the V360 / D360 platform.

---

## 1. Executive Summary & Capabilities

V360 / D360 is an integrated technology platform serving the international diamond and fine jewelry industry. 

### Key Capabilities & Statistics:
- **350,000+ Items Processed**: Certified diamonds and fine jewelry captured in 360-degree interactive format.
- **$6 Billion+ Inventory Value**: Photographed and cataloged for 200+ global diamond manufacturers, dealers, and retailers.
- **Dual Operating Locations**: Physical capture studios in New York City (47th Street Diamond District) and Surat, India.
- **Cloudflare R2 Edge Proxy**: Media delivery routed through `https://media.d360.us/` ensuring $0 GCS egress fees and sub-50ms global asset load times.
- **In-Browser Zero-Cost Exporters**: Client-side Web Crypto AES decryption and HTML5 Canvas encoding for 10-second 360° MP4 videos and RAW V360 ZIP packages.
- **Diamond-Assist Conversational AI**: Natural language query processor for diamond search, pricing distribution analysis, competitor price benchmarking, and automated sales client proposals.

---

## 2. Item ID Nomenclature & System Conventions

Every item processed on the V360 / D360 platform uses a strict hyphen-separated identifier:

```
Item ID Format: {Company Prefix}-{Lot ID}-{Customer SKU/Barcode}
Hosted ID Format: YY-{Customer Code}-{Lot ID}-{Customer SKU/Barcode}
```

### Format Parameters:
- **Company Prefix**: 2–3 digit code mapping to a registered corporate client account (e.g., `113`, `222`, `YY-102`).
- **Lot ID**: Alphabetic batch index (`A` to `Z`, `AA` to `ZZ`).
- **Customer SKU / Barcode**: Client's unique product identifier (e.g., `8009129`, `710812`).

*Example*: `113-FG-710812` -> Client `113`, Lot `FG`, SKU `710812`.

---

## 3. Media Packaging & Progressive 360° Player

### 256-Frame Progressive Loading Structure:
1. **256 High-Resolution RAW Frames** captured per full 360-degree rotation.
2. **Exponential Chunk Packaging**:
   - `0.json`: Front master frame + player configuration + AES `scramble` decryption key.
   - `1.json` through `7.json`: Remaining 255 progressive frames distributed exponentially for low-latency client rendering.
3. **AES Scramble Key Protection**: Progressive frame JSON files (`1.json`–`7.json`) are encrypted server-side with AES-CBC scramble key to prevent unauthorized bulk scraping.
4. **Client Decryption**: The viewer (`aview.html` & `viewer.html`) fetches `0.json`, extracts the Web Crypto key, and decrypts progressive frame chunks client-side.
5. **Zero-Scrollbar Embed Mode**: URL query parameter `btn=0` or `btn=false` hides UI overlay buttons and zoom controls, automatically sizing container bounds to fit host iframe without scrollbars.

---

## 4. Diamond-Assist Conversational AI Specification

Diamond-Assist (`/assist`) provides diamond sales representatives and business owners with natural language search, pricing analytics, and market comparison.

### Natural Language Syntax & Abbreviations:
- **Shape Abbreviations**:
  - `rd` / `round` -> Round Brilliant
  - `ov` / `oval` -> Oval
  - `mq` / `marquise` -> Marquise
  - `ps` / `pear` -> Pear
  - `pr` / `princess` -> Princess
  - `cu` / `cushion` -> Cushion
  - `em` / `emerald` -> Emerald
  - `ra` / `radiant` -> Radiant
  - `hs` / `heart` -> Heart
  - `as` / `asscher` -> Asscher
- **Color Ranges**: `D`, `E`, `F`, `G`, `H`, `I`, `J`, `K`, `L`, `M` or shorthand ranges `DEF`, `GH`.
- **Clarity Ranges**: `FL`, `IF`, `VVS1`, `VVS2`, `VS1`, `VS2`, `SI1`, `SI2`, `I1`, `I2`, `I3` or shorthand `VVS`, `VS`, `SI`.
- **Fluorescence**: `none` / `NON`, `faint` / `FNT`, `medium` / `MED`, `strong` / `SLT`, `very strong`.
- **Sample Agent Query**: `RD 1.2 VVS DEF none`
  - *Parsed Parameters*: Shape: Round | Carat: 1.2ct | Clarity: VVS1, VVS2 | Color: D, E, F | Fluorescence: None.

---

## 5. Automated Data Enrichment Pipeline

1. **Headless Report Scraping**:
   - GIA scraper queries official verification portal with certificate number.
   - IGI scraper queries report portal through Cloudflare polling bypass.
   - Extracted attributes: Carat Weight, Color, Clarity, Cut, Polish, Symmetry, Measurements, Table %, Depth %, Inscription, Comments.
2. **Gemini Multimodal AI Copy Generator**:
   - Evaluates top 4 high-resolution stills + extracted certificate metadata.
   - Generates structured marketing descriptions saved to `gs://d360us/imaged/{Item_ID}/description.json`.
3. **In-Browser Video & ZIP Engines**:
   - `useClientVideoGenerator`: Canvas-rendered 10-second 1080x1080 360° MP4 compiler encoded via MediaRecorder API at 8 Mbps.
   - `useClientZipGenerator`: Packages 8 progressive frame JSONs, master still, side angle photos, certificate PDF, and converted `properties.csv` into `{diamondId}_raw_v360_files.zip`.

---

## 6. Endpoints & System URLs

| Function / Resource | Route / URL | Access |
|---|---|---|
| **Primary Website** | `https://d360.tech/` | Public |
| **Interactive 360° Player** | `https://d360.tech/aview.html?d={Item_ID}` | Public (requires Item ID) |
| **Owner Media Viewer & Exporter** | `https://d360.tech/viewer?d={Item_ID}` | Firebase Auth / Admin Gate |
| **Diamond-Assist AI Portal** | `https://d360.tech/assist` | Firebase Auth |
| **Media CDN Edge Proxy** | `https://media.d360.us/imaged/{Item_ID}/` | Public CDN |
| **Catalog API Base** | `https://us-central1-v360studio-e1956.cloudfunctions.net/` | REST / JWT Auth |
| **Sitemap** | `https://d360.tech/sitemap.xml` | Public |
| **LLM Machine Specs** | `https://d360.tech/llms.txt` | Public |
| **AI Plugin Manifest** | `https://d360.tech/.well-known/ai-plugin.json` | Public |

---

## 7. Organization & Contact Information

- **Legal Entity**: V360 / D360 Technology Inc.
- **HQ Address**: 47th Street Diamond District, New York, NY 10036, USA
- **Surat Studio**: Surat Diamond Bourse / Mahidharpura, Surat, Gujarat, India
- **Contact Email**: `sales@d360.tech`, `kalpesh@d360.tech`
- **Domain**: `d360.tech`