Enockdeghost/soko_safi

Soko Safi is a digital marketplace for Tanzanian small merchants to track sales, manage inventory, record expenses, and connect with suppliers. Buyers can browse products, pay via mobile money (M‑Pesa, TigoPesa, Airtel Money), and earn loyalty points. Works offline, supports Swahili/English with voice input, and empowers local commerce. # Soko Safi – Vendor Digitisation Web Soko Safi is a digital marketplace and business management platform designed for small merchants in Tanzania. It helps vendors manage inventory, track sales, connect with suppliers, and accept mobile money payments through a simple, mobile-first interface available in Swahili and English. The platform also includes a buyer marketplace, supplier portal, and admin dashboard. --- ## Features ### Vendors - Inventory management (products, pricing, stock, expiry) - Sales and expense tracking - Low-stock alerts - Supplier ordering system - Dashboard quick actions - Reports (PDF/CSV export) - Promotions and discounts - Offline mode with auto-sync ### Buyers - Product catalog with search and filters - Product details with reviews - Shopping cart and checkout - Mobile money payments (M-Pesa, Tigo Pesa, Airtel Money) - Order tracking - Wishlist and loyalty points ### Suppliers - Product catalog management - Order request handling - Supplier analytics ### Admin - User management - Shop and supplier verification - Voucher system - Training and grants management - System logs and reports ### General - Multi-language (Swahili / English) - Voice input support - Dark/light theme - Mobile-first design - Secure authentication and request handling --- ## Technology Stack - Backend: Python, Flask - Database: SQLite (dev), PostgreSQL (prod) - ORM: SQLAlchemy - Authentication: Flask-Login - Frontend: Bootstrap, Chart.js - Security: Flask-Talisman, Bcrypt - PWA: Service Worker, IndexedDB - Deployment: Gunicorn, Nginx --- ## Project Structure ``` soko_safi/ ├── app/ │ ├── __init__.py │ ├── extensions.py │ ├── models.py │ ├── forms.py │ ├── utils.py │ ├── decorators.py │ ├── translations/ │ ├── static/ │ │ ├── css/ │ │ ├── js/ │ │ ├── sw.js │ │ └── manifest.json │ ├── templates/ │ │ ├── base.html │ │ ├── auth/ │ │ ├── vendor/ │ │ ├── buyer/ │ │ ├── supplier/ │ │ └── admin/ │ └── r …