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

3.8 KiB

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