You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
sims-hq/docs/17-SCALE-AND-INTEGRATIONS.md

71 lines
3.8 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 17 — Scale-Readiness Commitments & Integrations Catalog
Founder call (2026-07-10): **all seven scale gaps are committed work**, and every
integration the product needs is catalogued here with status. Per R13/R25, none of these
close without a load test or end-to-end verification.
## The seven commitments (all accepted — none optional)
| # | Gap | What must be built | Edition it unblocks | Target |
|---|-----|--------------------|--------------------:|--------|
| S1 | Catalog scale | `@sims/search-core` (indexed + phonetic search), delta-refreshed item cache, no silent LIMIT (R13) | Pro (100k SKUs) | Next block |
| S2 | Print coverage | A4/A5 GST invoice templates, label printing (queue → printer), Indic raster receipts (09 §5.3) | Standard+ | Next block |
| S3 | B2B at the counter | Buyer GSTIN + place-of-supply on POS (IGST flows), B2B invoice print, e-Invoice hook later | Standard+ | Next block |
| S4 | Counter resilience | Browser POS offline queue (service worker + IndexedDB), reconnect drain, Electron kiosk fallback | All | High |
| S5 | Batch/expiry | Batch capture at purchase, batch pick at billing, expiry dashboard flows | Pro | High |
| S6 | Volume plumbing | Pagination on bills/audit/purchases lists; day-partitioned queries | Pro | Medium |
| S7 | Load verification | Scripted load test: 10 counters × 2,500 bills/day against one store-server; publish numbers | Pro/Ent | With S1 |
## Integrations catalog (everything the system must speak to)
### Hardware
| Integration | Purpose | Status | Phase |
|---|---|---|---|
| Thermal printers 2"/3" (ESC/POS, TCP 9100) | Receipts, drawer kick | **Built** (network); USB raw pending | now / P1 |
| A4/A5 laser printers | B2B/GST invoices | Planned (S2) | next |
| Label printers | Barcode/MRP labels | Planned (S2) | next |
| Barcode scanners (wedge) | Item entry | **Built** (wedge detector) | — |
| Weighing scales (label EAN-13 2x) | Supermarket produce | **Built** (parse); direct RS-232 port planned | P2 |
| Cash drawer | Kick on cash | **Built** (via printer pulse) | — |
| Customer display | Second screen | Planned | P3 |
| EDC/card terminals | Card payments | Planned (record-only today) | P2 |
| UPS/power-cut recovery | Crash-safe counters | Partial (WAL journaling); S4 completes | high |
### Payments & money
| Integration | Purpose | Status | Phase |
|---|---|---|---|
| UPI PSP (dynamic QR + webhook auto-confirm) | Counter UPI | Planned (D14 cloud) | P2 |
| Cash / khata / split tender | Core tenders | **Built** (split pending) | — |
| Tally XML export | The CA's world | Planned (D6) | P2 |
### Compliance
| Integration | Purpose | Status | Phase |
|---|---|---|---|
| GSP (e-Invoice IRN, e-Way) | B2B legal mandate | Planned — vendor = D4, behind our interface (R26) | P2 |
| GSTR-1/3B JSON export | Filing | Planned | P2 |
| GSTR-2B pull & reconcile | ITC safety | Planned | P3 |
### Messaging & cloud
| Integration | Purpose | Status | Phase |
|---|---|---|---|
| WhatsApp Business API | e-bills, khata reminders, digests | Planned (D14 cloud) | P2/3 |
| SMS gateway | Fallback messaging | Planned | P3 |
| Email (SMTP) | Purchase Inbox intake, reports | Planned | P3 |
| Claude API | Purchase Inbox AI parsing | Planned | P3 |
| Cloud tier (Postgres + sync agent) | Multi-store, owner app, backups | Designed, dormant outbox already written (D14) | staged |
| Telemetry & crash reporting | Fleet health | Planned | P1-2 |
| ONDC / e-commerce bridges | Future commerce | Evaluate | P4 |
### Data in/out
| Integration | Purpose | Status | Phase |
|---|---|---|---|
| Excel/CSV import-export | Masters, reports | Partial (planned full) | P1 |
| Classic Oracle migration tool | The beachhead | Blocked on Classic DDL | P1 |
| Oracle 12c store adapter | D12 store master | Repos ready; adapter on DDL arrival | P1 |
| API access (REST) | Enterprise integrations | Internal API built; external tokens planned | P4 |