chriskambimbi/dukaai

An offline-first AI shop manager for African informal retailers # Duka.AI - Intelligent Inventory & Sales Manager for Zambian Retailers **Duka.AI** is an offline-first, AI-powered inventory and sales management system designed specifically for informal retailers in Zambia. It replaces traditional paper ledgers with intelligent camera scanning, voice commands in local languages, and automated inventory tracking. ## 🎯 Project Vision Transform how small shop owners (kantemba operators) in Zambia manage their businesses by providing: - **Offline-First AI**: All features work without internet connectivity - **Multimodal Input**: Camera scanning + voice commands in Nyanja, Bemba, and English - **Smart Inventory**: Automatic stock tracking and low-stock alerts - **Credit Management**: Digital ledger for "pa ng'ong'ole" (buy on credit) - **Local Product Recognition**: AI trained on Zambian products (Mosi, Boom, Jikelele, etc.) - **Battery Efficient**: Optimized for Transsion smartphones (Tecno, Infinix) ## 📱 Key Features ### ✅ MVP (Phase 1) - Implementation Status #### Core Product Management - [x] **Add Product Screen** - Complete with validation, profit calculator, and barcode integration - [x] **Product List Screen** - Browse and manage all products - [x] **Product Detail Screen** - View and edit product information - [x] **Barcode Scanner** - Real-time scanning with ML Kit + CameraX integration - [x] **Low stock alerts** - Automatic threshold-based notifications #### Credit & Customer Management - [x] **Add Customer Screen** - Zambian phone validation, auto-normalization - [x] **Customer Detail Screen** - View customer profile and credit history - [x] **Credit Ledger** - Track all credit transactions - [x] **Record Payment Screen** - Process payments with automatic debt calculation - [x] **Payment Repository** - JOIN queries for customer payment analytics #### Sales & Analytics - [x] **Quick Sale Screen** - Fast product sales logging - [x] **Dashboard** - Real-time sales overview and metrics - [x] **Analytics Screen** - Sa …