# Lensnew Optical BOS — Full Technical & Operational Knowledge Base

> Lensnew Optical Business Operating System (BOS) is India's leading offline-first Optical POS Billing, Inventory, Clinical Eye Prescription (Rx), 8-Stage Lab Work Order Tracking, and B2B Wholesale Distribution ERP software. Built by UBVY Technology Pvt. Ltd.

---

## 1. System Overview & Architecture

Lensnew Optical BOS is designed specifically for the Indian and global optical industry. It solves the unique challenges of optical retail counters, prescription lens laboratories, and wholesale distributors:

- **Offline-First Storage Engine**: Uses Dexie.js (IndexedDB wrapper) inside the browser. All invoices, customer clinical history, inventory matrices, appointments, and lab jobs persist locally. If power or internet drops, billing continues seamlessly without lag.
- **Bi-Directional Cloud Synchronization**: Synchronizes automatically to the PocketBase backend server whenever an internet connection is established.
- **Multi-Subdomain Segment Routing**:
  - `retail.lensnew.com`: Tailored for optical shop retail counters, eye exam rooms, and customer POS checkout.
  - `wholesale.lensnew.com`: Tailored for optical frame/lens distributors, party credit ledgers, delivery challans, and carton orders.
  - `lab.lensnew.com`: Tailored for surfacing & edging optical labs with QR work tickets and technician QA queues.
  - `admin.lensnew.com`: Super-admin platform control console (locked with multi-factor authentication & bot blocking).
- **Security & Privacy**: Client data is protected by OpenFGA role-based access control and client-device session limits. Administrative endpoints send strict `noindex, nofollow, noarchive` headers.

---

## 2. Core Modules & Specifications

### 2.1 POS Billing & Optical Checkout
- **Fast Search**: Instant search by customer mobile number, name, or prescription card ID.
- **Prescription (Rx) Input**:
  - Right Eye (OD): SPH, CYL, AXIS, ADD, VA (Visual Acuity), Prism / Base.
  - Left Eye (OS): SPH, CYL, AXIS, ADD, VA, Prism / Base.
  - Inter-Pupillary Distance (PD), Fitting Height, Lens Index (1.50, 1.56, 1.60, 1.67, 1.74), Lens Coating (Hard Coat, HMC, Blue Cut, Photochromic, Anti-Fog, DriveWear).
  - Contact Lens Parameters: Base Curve (8.4, 8.6), Diameter (14.0, 14.2), Material (Silicone Hydrogel, Hydrogel).
- **Barcode & QR Integration**: Scans standard 1D CODE128 dumbbell barcodes and 2D QR stickers. Instant offline barcode rendering and thermal sticker printing.
- **Discount & Pricing Controls**: Supports coupon promo codes, percentage discounts, flat cash discounts, and dealer pricing tiers.
- **Payment Split Modes**: Cash, UPI / QR Code, Credit/Debit Card, Net Banking, Store Credit / Advance, and Split Multi-Payment.
- **WhatsApp Digital Receipts**: Generates instant WhatsApp formatted receipts with order breakdown, lens power summary, balance due, and printable invoice link.

### 2.2 Inventory & Lens Power Grid
- **Categories**: Optical Frames, Prescription Lenses, Contact Lenses, Contact Lens Solutions, Reading Glasses, Sunglasses, Cases/Boxes, Microfiber Selvet Cloth, Repair Parts (Nose Pads, Screws, Temple Tips).
- **Lens Power Matrix**: Spherical / Cylindrical 2D matrix grid allowing bulk stock entry for powers from SPH +6.00 to -10.00 and CYL -0.25 to -4.00.
- **Low Stock Reorder Thresholds**: Automated badges and low-stock alerts to prevent running out of fast-moving products.
- **CSV Import / Export**: 1-click import from Excel, CSV, Tally, Marg, or OptoSoft.

### 2.3 8-Stage Lab Work Order Tracking
- **Stage 1: Job Created**: Order converted from POS bill with lens power specs.
- **Stage 2: Blank Sourced**: Lens blank allocated from inventory or ordered from supplier.
- **Stage 3: Lens Surfacing**: Power generation on CNC generator / blocker.
- **Stage 4: Hard Coating / AR Coating**: Dip coating and vacuum anti-reflective chamber processing.
- **Stage 5: Tinting / Edging**: Manual/automatic CNC edging to frame trace dimensions.
- **Stage 6: Frame Assembly / Fitting**: Lens insertion into full-rim, supra, or rimless frame.
- **Stage 7: Quality Assurance (QA)**: Lensometer inspection for SPH/CYL/AXIS tolerance and optical center alignment.
- **Stage 8: Ready / Dispatched**: SMS/WhatsApp notification sent to store or customer for pickup.

### 2.4 Automated CRM & 4-Trigger Recalls
- **Annual Eye Test Recall**: Auto-nudges patients 11 to 12 months after their last eye examination.
- **Contact Lens Replacement**: Reminds monthly or daily contact lens wearers before their supply runs out.
- **Birthday Greetings**: Auto-sends birthday discounts and voucher codes.
- **Ready for Delivery**: Automated WhatsApp message when eyeglasses arrive from the lab.

### 2.5 Optical Wholesale ERP & B2B Distribution
- **B2B Party Ledgers**: Credit debit tracking, payment age analysis (30/60/90 days), outstanding balance statements.
- **Carton & Bulk Billing**: Box quantity pricing with tier discounts.
- **Document Workflow**: Sales Quotation → Sales Order → Delivery Challan → Tax Invoice → Debit / Credit Note → Sales Return.
- **Field Sales Automation**: Sales rep order booking with geo-location check-in.

---

## 3. GST Tax Structure for Optical Goods (India)

| Category | HSN Code | GST Rate | Description |
| :--- | :---: | :---: | :--- |
| **Spectacle Lenses** | `9001` | **12%** | Corrective single vision, bifocal, and progressive lenses. |
| **Contact Lenses** | `9001` | **12%** | Corrective, cosmetic, and toric contact lenses. |
| **Frames & Mountings** | `9003` | **18%** | Metal, acetate, TR90, and titanium spectacle frames. |
| **Sunglasses** | `9004` | **18%** | Corrective and non-corrective UV/polarized sunglasses. |
| **Contact Lens Solutions** | `3307` | **18%** | Disinfecting, multi-purpose, and saline solutions. |
| **Eye Testing Services** | `9993` | **Exempt / 0%** | Clinical eye refraction and optometry consultation. |

---

## 4. Hardware & Printing Integration

- **ESC-POS Thermal Receipt Printers**: USB, Bluetooth, and Network (Ethernet/Wi-Fi) printers supporting 58mm (384 dots) and 80mm (576 dots) continuous paper rolls.
- **Desktop Laser/Inkjet Printers**: Standard A4 and A5 portrait/landscape print formats.
- **Barcode Scanners**: 1D laser scanners and 2D QR camera/CCD scanners supporting HID keyboard emulation.
- **Label Printers**: 50mm x 30mm, 58mm, and dumbbell jewelry label rolls for optical frames.

---

## 5. Lensnew Academy (Learning Center)

Explore step-by-step guides at `https://lensnew.com/academy`:

- `getting-started`: 1-minute shop setup, basic settings, and first bill guide.
- `billing`: POS receipts, prescription checkout, discounts, thermal bills, WhatsApp receipts.
- `inventory`: Frames, sunglasses, spherical/cylindrical lens matrices, dumbbell barcodes.
- `prescriptions`: Refraction entry (SPH/CYL/AXIS/PD), customer history, lens suggestions.
- `lab`: 8-stage lab job cards, edging, lensometer QA, automated pickup alerts.
- `wholesale`: Retailer credit party accounts, carton billing, statement export.
- `marketplace`: Optical shop directory, B2B wholesale ordering, catalog sync.
- `reports`: Daily sales summaries, GSTR-1 & 3B exports, expense management.
- `admin-settings`: Permissions, thermal printers, barcode scanners, backup & restore.
- `business-growth`: Profit margin calculation, progressive lens upsells, eye camps.

---

## 6. Subscription Pricing Plans

- **Founder Lifetime Free (₹0)**: Join by 31 August 2026 and get Lifetime Free access. Never renews, zero annual fees.
- **Starter (₹500/year)**: Standard entry plan for new users joining from 1 September 2026.
- **Basic (₹2,200/year or ₹220/month)**: Supplier management, expense tracking, dealer pricing, WhatsApp invoice sharing.
- **Lite (₹5,300/year or ₹530/month)**: AI Assistant, CRM recalls, customer loyalty points, 8-stage lab workflow, GSTR tax exports, up to 3 shops.
- **Pro (₹14,999/year or ₹1,249/month)**: B2B wholesale distribution ERP, stock transfers, field sales tracking, up to 6 shops, advanced audit log.
- **Enterprise (Custom)**: Multi-chain optical retail networks, custom ERP API integrations, dedicated database instance, 24/7 dedicated support.

---

## 7. Contact & Support Information

- **Website**: https://lensnew.com
- **Public Contact Section**: https://lensnew.com/#contact
- **Sales Inquiry**: sales@lensnew.com | +91 99205 51388
- **Technical Support**: support@lensnew.com | +91 81084 05006
- **Headquarters**: UBVY Technology Pvt. Ltd., Mumbai, Maharashtra, India.
- **GSTIN**: 09AADCU2594B1ZC