ifixkart-admin/docs/adr/ADR-002-catalog.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

481 B

ADR-002: Product Catalog Architecture at 50M Scale

Context

Catalog must support 50,000,000 products with dynamic attributes and rapid filtering.

Decision

Use 26-character ULID primary keys across all catalog entities (products, product_variants, variant_attributes). Enforce Keyset Cursor Pagination (WHERE (created_at, product_id) < (...) ORDER BY created_at DESC, product_id DESC LIMIT 50) on all listing endpoints to eliminate O(N) SQL offset scans.