DreamwiseHUB
Omnichannel Tech Retail POS & Multi-Stage Repair CRM (Commissioned by Dreamwise Computer Enterprise)

Executive Architectural Overview
Enterprise operational operating system and storefront commissioned by Dreamwise Computer Enterprise to unify omnichannel Nigerian tech retail with complex repair workflows. Features dual inventory isolation separating retail products from repair parts, 7-tier PostgreSQL RLS, multi-stage technician lifecycle tracking, persistent floating Gemini AI support intercom with staff takeover, customer self-service /track portal, and Nominatim OpenStreetMap auto-geocoding.
Core Architectural Accomplishments
Deterministic Guarantees
Integrated System Components
7-Tier Hardened RBAC & Automatic Owner Whitelist
Enforces non-negotiable boundaries across Customer, Receptionist, Technician, Accountant, Manager, Owner, and Admin using PostgreSQL RLS and proxy middleware, with automatic owner whitelist triggers.
Dual Inventory Isolation
Strictly separates retail sales products from internal repair workshop stock (screws, IC chips, thermal paste), safeguarding business gross margin analytics.
Multi-Stage Technician Repair CRM
End-to-end device servicing lifecycle (received → diagnosing → waiting_on_parts → completed) with customer self-service tracking codes.
Human-in-the-Loop Gemini Intercom
Floating customer chat grounded in enterprise FAQs with seamless WebSocket escalation to technicians when human expertise is requested.
Automated Nominatim Geocoding
Converts raw business street addresses into verified latitude/longitude coordinates and generates interactive maps without third-party API bloat.
Technology Architecture Matrix
- Next.js 16
- Tailwind CSS
- Server-Side Proxy Layout Guards
- Lucide Icons
- Real-Time Tracking Timeline
- Supabase PostgreSQL
- 7-Tier Row Level Security
- Atomic Stock Decrement Triggers
- Isolated Repair Parts DB
- Customer Lifetime Value RPC (get_customer_metrics)
- Gemini AI Support Intercom
- Knowledge Base FAQ Grounding
- WebSocket Staff Escalation
- Channel Alert Dispatch (needs_attention)
- Paystack Gateway (NGN ₦)
- Idempotent Webhook Verification
- Resend SMTP
- Nominatim OpenStreetMap Geocoding
- Multi-Channel Broadcast (Email, SMS, WhatsApp)