Loshgos/Shop_yanga

# Shop Yanga POS **Run Your Business Smarter.** A mobile-first, offline-first Point of Sale and Inventory Management System for small and medium-sized businesses in Malawi and across Africa — built to replace the paper record book with a simple, beautiful digital till. This repository is the investor/pilot-ready MVP: a fully functional Flutter app with realistic demo data (100+ products, 300+ transactions) so it looks and feels like a live business the moment it's opened. --- ## ✨ What's in this MVP | Module | Status | |---|---| | Splash, Onboarding, Login, Register, Forgot Password, Business Registration | ✅ Complete | | Dashboard (stat cards, quick actions, daily/weekly charts, recent sales, top products) | ✅ Complete | | Product Management (add/edit/delete/search, categories, stock value) | ✅ Complete | | Sales / POS (search, cart, quantities, discount, 4 payment methods, receipt, success animation) | ✅ Complete | | Sales History (filters by date/receipt/customer/cashier, full sale detail) | ✅ Complete | | Inventory (stock overview, low/out-of-stock tabs, restock, manual adjustment, stock history) | ✅ Complete | | Reports (daily/weekly/monthly, sales/profit/transactions/average sale, top products, payment breakdown, PDF export placeholder) | ✅ Complete | | Settings (business profile, currency, language, password/PIN, dark mode, reset demo data, logout) | ✅ Complete | | Demo Mode (100+ products, 300+ transactions, believable weekday/weekend sales curve) | ✅ Complete | | Cloud sync to Firestore | 🔜 Scaffolded, not wired (see Architecture) | | User roles (Admin vs Cashier) enforcement in UI | 🟡 Modeled in data layer; UI gating is on the roadmap | | Multi-language (Chichewa, Portuguese) | 🔜 Roadmap | --- ## 🖥️ Tech Stack - **Frontend:** Flutter (Material 3) - **State management:** Riverpod - **Routing:** go_router (with a `StatefulShellRoute` bottom-nav shell) - **Local database (offline-first):** Hive - **Cloud (planned):** Firebase Authentication + Cloud F …