hervekubanadev/curuza-hw-shop

Multi-tenant SaaS for hardware retailers in Rwanda. Inventory, POS, credit tracking, and business intelligence. CURUZA · Fintech Infrastructure Platform for African Retail Multi-tenant SaaS purpose-built for hardware & construction material retailers in emerging markets Architecture • API • Getting Started • Deployment • Roadmap --- ## The Problem **African hardware retailers operate on paper and trust.** A typical shop in Kigali, Nairobi, or Lagos runs on: - Handwritten ledgers for sales and credit - WhatsApp messages for order tracking - Memory-based inventory management - No digital record of customer debt This leads to stock shrinkage, uncollected debts (30–50% of revenue), no credit history, and an inability to access working capital from financial institutions. **CURUZA solves this** by providing a complete digital operations platform — inventory, POS, credit tracking, and professional document generation — with a clear upgrade path to fintech services. --- ## Architecture ``` ┌─────────────────────────────────────────────────────────────────┐ │ React 19 + TanStack Start (SSR) │ │ ┌──────────┐ ┌────────┐ ┌───────────┐ ┌────────────────────┐ │ │ │ Inventory│ │ POS │ │ Credit │ │ Proformas / DNs │ │ │ │ Mgmt │ │ Sales │ │ Tracking │ │ + PDF Generation │ │ │ └────┬─────┘ └───┬────┘ └─────┬─────┘ └─────────┬──────────┘ │ │ └───────────┴────────────┴─────────────────┘ │ │ │ │ │ TanStack Query + Supabase Client │ │ (RLS-secured, JWT-authenticated) │ └─────────────────────────┬───────────────────────────────────────┘ │ ┌───────────┴───────────┐ │ │ ▼ ▼ ┌─────────────────────┐ ┌───────────────────────────┐ │ Supabase Auth │ │ Supabase REST + GraphQL │ │ (GoTrue) │ │ PostgreSQL 16 + RLS │ │ JWT Sessions │ │ 17 tables, 12 RPCs │ └─────────────────────┘ └────────── …