COMMERCE + OPERATIONS OS · LIVE

The Commerce + Operations OS

QuantumOS X3 is a single-tenant operating system that runs your entire commerce + operations stack from one Supabase Postgres backend. Three live apps, ten admin modules, fifty plus tables, fully type-safe end-to-end via tRPC v11.

0
LIVE APPS
0+
DB TABLES
0
ADMIN MODULES
0%
TYPE-SAFE TRPC
Launch Admin Console →View Storefront
POSTGRES
Supabase
50+ tables
Admin Console
command.qosx3.space
Storefront X3
store.qosx3.space
API Gateway
api.qosx3.space
03 LIVE APPS · ONE BACKEND

Three planes. One Postgres.

Admin controls. Storefront sells. Gateway integrates. Each plane is independently deployed on Vercel, all sharing a single Supabase Transaction Pooler.

CONTROL-PLANE

Admin Command Console

command.qosx3.space

The operating cockpit. 10 modules, 50+ tRPC routers, RBAC-gated procedures, real-time analytics across PIM, POS, Sell, CRM, Operations and AI.

  • 10 admin modules · all routed through tRPC v11
  • Role-gated procedures: super-admin / admin / owner
  • Server actions for mutations, RSC for reads
  • Realtime tenant context pin via PLATFORM_TENANT_ID
CUSTOMER-FACING

Storefront X3

store.qosx3.space

The shopping surface. Server-side cart, saved addresses, wishlist, pincode serviceability with EDD, coupons, reviews and GST-compliant PDF invoices.

  • Milestone 1 complete — 4 phases shipped
  • x3_cart · x3_addresses · x3_wishlist tables
  • Chennai 5-zone delivery + slot picker
  • Razorpay-backed checkout, GST invoice generator
INTEGRATION-PLANE

API Gateway

api.qosx3.space

Public commerce APIs, webhook delivery and rate-limited integration endpoints. Upstash Redis fronts every hot read; tRPC v11 procedures power every write.

  • REST + tRPC dual-surface gateway
  • Webhook delivery with retry + dead-letter
  • Rate limiting via Upstash Redis sliding window
  • Bearer token auth fallback for API clients
10 ADMIN MODULES · 50+ tRPC ROUTERS

One console. Every operation.

Click a module to inspect its routers, pages and a representative tRPC procedure. Every procedure is RBAC-gated and type-safe end to end.

pim.router.ts

PIM module

Products, categories, brands, attributes, bundles, quality checks, compliance flags and an asset manager with R2 upload/delete and a 13-filter advanced panel.

KEY PAGES
/pim/products/pim/categories/pim/brands/pim/attributes/pim/bundles/pim/quality/pim/compliance/pim/import/pim/assets--13-filter-
pim.router.ts
// admin-web/src/server/routers/pim.ts export const pimRouter = router({ list: adminProcedure .input(z.object({ q: z.string().optional(), brand: z.string().uuid().optional(), status: z.enum(["active","draft","archived"]).optional(), limit: z.number().min(1).max(100).default(25), })) .query(async ({ ctx, input }) => { return ctx.db.query.x2_pim_products.findMany({ where: buildWhere(input), limit: input.limit, }); }), upload: adminProcedure .input(z.object({ key: z.string(), bytes: z.number() })) .mutation(({ ctx, input }) => r2.put(input.key, ctx.user.tenantId)), });
POINT OF SALE

Full Odoo + Zoho
feature parity.

The POS module is not a checkbox — it is a full retail + restaurant operating layer. Ten sub-features that ship the moment you log into command.qosx3.space.

50 LOYALTY TEMPLATES SEEDED
Points, tiers, perks, milestones, gamified earn-rules — all live on day one. Clone, fork, run.
POS
Terminals
Register cash drawers, printers, scanners. Per-store terminal config.
SES
Sessions
Open/close shift with float reconciliation and Z-report.
TXN
Transactions
Sales, refunds, exchanges, split-tender. Offline-tolerant.
RPT
Reports
X-report, Z-report, daily sales, payment method breakdown.
KSK
Kiosk
Self-order kiosk surface for QSR + retail self-checkout.
KDS
KDS
Kitchen Display System. Live ticket flow with bump and recall.
LYL
Loyalty
50 loyalty program templates seeded. Points, tiers, perks.
CPN
Coupons
Validation, stacking rules, single-use enforcement.
GFT
Gift Cards
Issue, redeem, partial-balance, expiry policy.
PRL
Pricelists
Channel + customer-group pricing, time-windowed promos.
ROI CALCULATOR · LIVE INPUTS

Run the numbers on your stack.

Move the sliders. We model your current OpenCart + Zoho + per-terminal POS license stack against a single qosx3.space managed deployment.

YOUR INPUTS
Number of stores3 stores
Monthly orders1,500 orders/mo
Avg order value1,800 INR
Monthly ad spend1,20,000 INR
PROJECTED ANNUAL IMPACT
7,20,000
SAVED PER YEAR · LICENSING + MARGIN + AD EFFICIENCY
Legacy stack license2,16,000
qosx3.space managed1,80,000
LICENSE
36,000
MARGIN LIFT
5,83,200
ADMIN HRS/WK
16h
+ ad-efficiency uplift ≈ ₹1,00,800/yr from AI bundling, churn-targeting, and unified attribution.
model assumptions: OpenCart hosting ₹60k/yr · Zoho POS+Inventory ₹84k/yr · per-terminal POS license ₹24k/yr · qosx3.space managed ₹180k/yr flat · 1.8% blended margin uplift from unified pricing engine + loyalty · 7% ad-efficiency from AI churn + bundle targeting.
KITCHEN DISPLAY SYSTEM · REAL-TIME

The line moves at WebSocket speed.

For F&B clients: orders fire from POS, kiosk, storefront and aggregators into one real-time queue. Fire-time stamping, course pacing, sound alerts. No paper, no shouting.

Incoming4
T-040:32
Margherita · Coke ×2
T-110:58
Pad Thai · Spring Roll
Kiosk-21:12
Burger Combo
Online-3811:45
Biryani ×2 · Raita
In Progress3
T-024:21
Pizza Veg · Garlic Bread
T-076:05
Pasta Alfredo
Online-3797:18
Sushi Plate
Ready3
T-09▲ Bump
Cappuccino ×2 · Croissant
Online-377▲ Bump
Wraps ×3
Kiosk-1▲ Bump
Sandwich Combo
WEBSOCKET SYNC
< 80 ms
FIRE-TIME STAMP
ISO 8601 · UTC
COURSE PACING
appetiser → main → dessert
SOUND ALERTS
per-station tones
LOYALTY ENGINE · 50 TEMPLATES SEEDED

Twelve of fifty. Clone, fork, run.

Every QuantumOS X3 deployment ships with 50 loyalty templates pre-seeded into pos_loyalty_templates. Here are twelve of the most popular.

TPL-101
Birthday Bonus
2x points on birthday week
Re-engage dormant VIPs
TPL-102
Refer-a-Friend
₹500 each on first order
Viral acquisition loop
TPL-103
Tier Climb
Silver → Gold → Platinum
LTV ladder
TPL-104
Reactivation
20% off after 90 days idle
Win-back lapsed buyers
TPL-105
VIP Early Access
48-hr drop preview
Reward top decile
TPL-106
Cart Abandonment
Auto-reward + reminder
Recover lost carts
TPL-107
Win-Back
Stacked coupon + free ship
180-day churn save
TPL-108
Anniversary
Gift on signup-date
Emotional retention
TPL-109
Streak Reward
3 orders in 30 days = ×3
Habit formation
TPL-110
Spend Threshold
Cross ₹5k → unlock perk
AOV uplift
TPL-111
Category Multiplier
5x on slow-moving SKUs
Inventory rotation
TPL-112
Geo-fenced Drop
Pincode-only flash perks
Local micro-launch
+ 38 MORE TEMPLATES
Tiered programs, referral chains, gamified streaks, partner rewards.
Browse all 50 →
STOREFRONT X3 · MILESTONE 1

4 phases shipped. Live on store.qosx3.space.

PHASE 1Live

Orders

  • /api/x3/orders endpoint
  • Order history with status timeline
  • Line items + receipts
PHASE 2Live

Addresses / Cart / Wishlist

  • x3_cart server-side cart
  • x3_addresses saved book
  • x3_wishlist sync across devices
PHASE 3Live

Serviceability

  • Real pincode engine
  • Chennai 5-zone coverage
  • EDD + delivery slot picker
PHASE 4Live

Reviews / Coupons / GST Invoice

  • Product reviews + ratings
  • Coupon validation engine
  • GST-compliant PDF invoices
GST COMPLIANCE ENGINE · INDIA-NATIVE

GSTIN-native from day zero.

IGST · CGST · SGST split, e-invoice IRN generation, GSTR-1 / 3B / 9 report-ready exports, HSN/SAC auto-classification and place-of-supply detection. Indian tax law isn't a plugin — it's the substrate.

Tax Invoice
QOSX3 / TI / 2025-26 / 00417
IRN
a8c4…7e91
GSTIN (supplier)33ABCDE1234F1Z5Place of supplyTamil Nadu (33)HSN6109 — Cotton Apparel
Taxable value₹4,237.29
CGST @ 6%₹254.24
SGST @ 6%₹254.24
IGST₹0.00 (intra-state)
Invoice total₹4,745.77
ENGINE CAPABILITIES
IGST / CGST / SGST split
Automatic, by place-of-supply detection.
Reverse charge mechanism
RCM auto-applied for unregistered vendor input.
e-Invoice (IRN) generation
NIC IRP submission, QR + acknowledgement stored.
GSTR-1 / 3B / 9 exports
JSON-ready filings, period-locked snapshots.
HSN / SAC auto-classification
Per-SKU and per-service code on every line.
TDS 194Q tracking
Buyer-side TDS applied on ₹50L+ thresholds.
GST
GSTIN-native
e-INV
IRN e-Invoice
194Q
TDS 194Q
DL
Drug License (Pharma)
FSSAI
FSSAI (F&B)
PINCODE SERVICEABILITY · CHENNAI SEED

Five zones. Every pincode mapped.

Every Chennai pincode is seeded into x3_pincodes with serving warehouse, EDD, delivery slots and charge tier. The storefront refuses to take an order it can't fulfil.

CHENNAI · 5 ZONES
CHENNAI 600001ABCDE
ZONE TABLE
Zone A · ExpressSame day
pincodes: 600001-600020charge: ₹0 (free)slots: 4 windows
Zone B · StandardNext day
pincodes: 600021-600060charge: ₹0 (free)slots: 3 windows
Zone C · Standard1-2 days
pincodes: 600061-600100charge: ₹40slots: 2 windows
Zone D · Extended2-3 days
pincodes: 600101-600119charge: ₹80slots: 1 window
Zone E · Outstation3-5 days
pincodes: 600120+charge: ₹120slots: 1 window
// admin-web/src/db/schema/x3_pincodes.ts
export const x3_pincodes = pgTable("x3_pincodes", {
id: uuid().primaryKey(),
pincode: text().notNull().unique(), // 600001..600119
zone: text().notNull(), // A | B | C | D | E
warehouse_id: uuid().notNull(),
edd_days: integer().notNull(),
charge_paise: integer().notNull(),
delivery_slots: jsonb().$type<DeliverySlot[]>(),
tier: text().$type<"express" | "standard" | "extended">().notNull(),
});
// trpc query
await trpc.serviceability.check.query({ pincode: "600028" });
// → { ok: true, zone: "B", edd: "Next day", charge: 0, slots: [...] }
10 PERF OPTIMISATIONS

Built for sub-second.

Storefront performance is a feature, not an afterthought. Every layer of the stack — Postgres, Redis, Vercel edge, service worker — is tuned.

01
unstable_cache on API routes
Tag-based revalidation: products, categories, brands.
02
next/font self-hosted
Zero render-blocking font requests. Subset to weights used.
03
preconnect + preload
Origin warm-up for Supabase, R2, Razorpay before idle.
04
Dynamic ssr:false shells
Heavy client components hydrate lazily under loading skeletons.
05
AVIF + WebP images
next/image with art-direction breakpoints. Eager LCP, lazy rest.
06
Service Worker v2
API response cache + install-time warming of catalog index.
07
Brotli + critical CSS
Inline above-fold CSS, defer the rest. Brotli on Vercel edge.
08
Vary header correctness
Separate cache keys per Accept-Encoding and per cookie tier.
09
Immutable static cache
Hashed assets served with max-age=31536000, immutable.
10
pgPool max:10
postgres.js pool tuned to Supabase Transaction Pooler limits.
LIGHTHOUSE TARGET
0
Performance · Accessibility · Best Practices · SEO
PIM · ASSET MANAGER

13-filter advanced panel.

Catalog teams browse thousands of SKUs and millions of assets. The PIM panel makes that survivable — every filter is a Postgres index in disguise.

command.qosx3.space / pim / assets
↑ Upload to R2
ACTIVE FILTERS · 13
Status: ActiveCategory: ApparelBrand: HyperBridgeDate: Last 30 daysFile Type: image/webpSort: Newest firstHas variants: YesStock: > 0Compliance: VerifiedQuality: PassAsset: R2 ✓Tags: featuredChannel: storefront
SKU-2401
r2://assets/img_1.webp
SKU-2402
r2://assets/img_2.webp
SKU-2403
r2://assets/img_3.webp
SKU-2404
r2://assets/img_4.webp
SKU-2405
r2://assets/img_5.webp
SKU-2406
r2://assets/img_6.webp
SKU-2407
r2://assets/img_7.webp
SKU-2408
r2://assets/img_8.webp
OPENCART → SUPABASE

Migration kit. Five steps.

The oc-migration-kit package is a complete OpenCart-to-QuantumOS migration pipeline. From OpenCart export to live storefront in days, not months.

01
Export OpenCart
Snapshot oc_product, oc_category, oc_manufacturer and assets via oc-migration-kit.
02
Map to x2_pim_*
Categories → x2_pim_categories, brands → x2_pim_brands, prices → x2_pim_prices.
03
Upload assets to R2
Streamed multipart upload to Cloudflare R2 with checksum verification.
04
Apply Drizzle migrations
Schema parity with the live admin/storefront. Tenant pin enforced.
05
Verify in command.qosx3.space
Spot-check PIM list, brand grid, asset browser. Flip storefront origin.
$ npm install @hyperbridge/oc-migration-kit
$ npx oc-migrate --source ./opencart-export --target postgresql://...supabase
MIGRATION TIMELINE · 8-WEEK PLAN

Eight weeks. OpenCart to qosx3.space.

A managed migration runs from kickoff to go-live in eight weeks, with a 30-day stabilization tail. Each phase has named deliverables and an explicit exit criteria.

WK1
PHASE 01
Discovery & Data Audit
  • OpenCart schema scan
  • SKU + asset count
  • GST history pull
  • Pincode list
WK2
PHASE 02
Schema Mapping
  • oc-migration-kit run
  • x2_pim_* mapping
  • Attribute normalization
  • Drizzle migration apply
WK3
PHASE 03
Catalog Import
  • Products + categories
  • Brands + attributes
  • Prices + pricelists
  • R2 asset upload
WK4
PHASE 04
Customer + Order History
  • Customer book migrate
  • Order history backfill
  • Loyalty point seed
  • Address book port
WK5
PHASE 05
Storefront Design
  • Theme tokens
  • Banner uploads
  • Pincode zone seed
  • Collections + hero
WK6
PHASE 06
POS Configuration
  • Terminal register
  • Cashier RBAC
  • Loyalty template clone
  • Pricelist channel split
WK7
PHASE 07
Training + UAT
  • Cashier walkthrough
  • Admin RBAC drill
  • End-to-end UAT
  • Bug triage cycle
WK8
PHASE 08
Go-Live + Stabilization
  • DNS flip to qosx3.space
  • 30-day on-call
  • Daily metric review
  • Post-launch retro
DISCOVERY EXIT
Signed data audit + SKU/order counts
MIGRATION EXIT
All SKUs visible in command.qosx3.space
UAT EXIT
Zero P0 defects, sign-off from store ops
GO-LIVE EXIT
DNS flip + 30-day on-call retainer
THE STACK

Modern. Type-safe. Boring (in the good way).

Next.js 15
React 19
tRPC v11
Supabase Postgres
postgres.js
Upstash Redis
Cloudflare R2
Vercel
Drizzle ORM
MSG91 (SMS)
SendGrid (Email)
Razorpay
PLATFORM_TENANT_ID
a61b3ea5-a408-…
DB POOLER PORT
6543 (txn pool)
CACHE
Upstash + unstable_cache
AUTH
Supabase + Bearer fallback
OTPs
MSG91 + SendGrid
PAYMENTS
Razorpay (prod-grade)
WHO RUNS QUANTUMOS X3

Four shapes of commerce.

Retail

Multi-store retail brands running web + physical POS off one Supabase backend. PIM is the source of truth.

  • Per-store inventory
  • Channel pricing
  • Loyalty across web + store
  • GST invoices

F&B / Restaurants

QSR + dine-in. Kiosk for self-order, KDS for the kitchen line, POS for the cashier, storefront for delivery.

  • Kiosk + KDS bundle
  • Modifier groups
  • Table-mapped tickets
  • Delivery slots

Multi-Brand Marketplaces

Operate multiple brands under one platform tenant. Brand-scoped admin views with shared catalog primitives.

  • Brand-scoped RBAC
  • Shared PIM core
  • Per-brand storefront themes
  • Cross-brand analytics

Single-Brand DTC

A direct-to-consumer brand that wants its own commerce OS — not Shopify, not WooCommerce. Own the stack.

  • Own the data
  • Own the gateway
  • Own the cache layer
  • No platform fee
CUSTOMER JOURNEY · CLICK TO REORDER

Ten steps. One tRPC graph.

Every customer touchpoint maps to a named router. From SEO landing to loyalty accrual, the entire flow is one type-safe graph — no leaky integrations, no orphaned event buses.

12345678910
STEP 01
Discovery
storefront.seo
SEO + sitemap + OG image
STEP 02
Browse
storefront.catalog
AVIF/WebP via next/image
STEP 03
Add to Cart
x3_cart.add
Server-side cart, no flicker
STEP 04
Checkout
x3_checkout.create
Razorpay-backed, OTP-protected
STEP 05
Confirmation
x3_invoices.generate
GST-compliant PDF
STEP 06
Fulfillment
x3_pincodes.serviceability
EDD + warehouse pick
STEP 07
Delivery
x3_orders.dispatch
Slot-pinned delivery
STEP 08
Review
x3_reviews.submit
Photo + rating + verified-buyer
STEP 09
Loyalty
pos.loyalty.accrue
Points credited, tier nudge
STEP 10
Reorder
grow.journey.replenish
Smart reorder reminders
MULTI-CHANNEL SALES · ONE SOURCE OF TRUTH

Seven channels. One catalog.

POS, storefront, marketplaces, social commerce, wholesale — all read from the same x2_pim_products spine, all write to the same x3_orders ledger.

QuantumOSX3qosx3.spacePOS Terminalsx3_pos_sessionsStorefrontstore.qosx3.spaceAmazonvia api.qosx3.spaceFlipkartvia api.qosx3.spaceWhatsApp CommerceMSG91 broadcastInstagram Shopcatalog feed syncWholesale PortalB2B pricelist gated
SHARED · CATALOG
x2_pim_products
SHARED · INVENTORY
x3_inventory_levels
SHARED · PRICING
x3_pricelists
SHARED · CUSTOMERS
x3_customers
SHARED · ORDERS
x3_orders
AI MODULE · ai.* tRPC ROUTER

Seven capabilities. One router.

The ai router hangs off the same tRPC tree as every other module. Every call is RBAC-gated, usage-metered, and Claude-backed under the hood.

AI-01
Product Description Generator
ai.describe()
Feed an SKU + attributes; get a brand-tuned long-form description with SEO meta.
AI-02
Smart Bundling
ai.bundle()
Mines frequent-together baskets and suggests bundle SKUs with optimal price points.
AI-03
Dynamic Pricing
ai.repricing()
Recommends price adjustments from elasticity, competitor scrape, inventory velocity.
AI-04
Churn Prediction
ai.churn()
Customer-level 30/60/90-day churn score; feeds Grow journey triggers.
AI-05
Reorder Forecasting
ai.forecast()
Per-SKU lead-time-aware reorder quantity with safety stock and seasonality.
AI-06
SEO Meta Generator
ai.seo()
Title, description, og-image alt — generated for every product, every category.
AI-07
Multi-language Translation
ai.translate()
Tamil, Hindi, English listing translation with brand voice preservation.
DEPLOYMENT · SELF-HOST OR MANAGED

Own the box, or rent the cloud.

QuantumOS X3 is offered two ways. Self-host on your own Docker + Supabase, or run it as a managed deployment on qosx3.space. Same codebase, same APIs, different operational contract.

BYO Infra

Self-Host

docker compose up
INFRA COSTYour AWS / GCP / Hetzner bill
SUPABASESelf-managed Postgres + Auth
DEPLOYMENTDocker compose · Kubernetes · Coolify
SLAYou own it
SUPPORTCommunity + paid retainer
COMPLIANCEYour audit perimeter
SOURCE ACCESSFull repo access on contract
BEST FORRegulated · sovereign data · cost-curve at scale
qosx3.space

Managed Cloud

we run it. you sell.
INFRA COSTBundled in flat monthly
SUPABASEManaged Supabase, region of choice
DEPLOYMENTVercel + Supabase + Cloudflare R2
SLA99.9% uptime, incident-credit on breach
SUPPORTTier-2 helpdesk + 30-day on-call
COMPLIANCEISO/SOC inherited from upstreams
SOURCE ACCESSAPI + admin console only
BEST FORMove fast · no ops team · India-first DTC
ESCAPE HATCH · BOTH DIRECTIONS
Start managed, graduate to self-host. Or self-host now, hand it back when you scale.
Get a deployment quote →
SEE IT LIVE

Three URLs. Three planes. One Postgres.

All three apps are deployed and serving traffic. Open each in a new tab and inspect the network — same backend, three surfaces.