onghstev/shopysh

AI-Powered Business Management Platform for African SMEs # 🛍️ SHOPYSH **AI-Powered Business Management Platform for African SMEs** Shopysh helps small and medium businesses in Africa manage their products, orders, customers, finances, and marketing campaigns — all powered by AI. ## ✨ Features - **Dashboard** — Real-time business analytics and KPIs - **Products** — Inventory management with variants and categories - **Orders** — Order processing, tracking, and fulfillment - **Customers** — CRM with segmentation and communication history - **Payments** — Payment tracking with NGN/USD support - **Campaigns** — SMS & email marketing campaigns - **Finance** — Revenue tracking, expenses, and financial reports - **Team** — Multi-user roles and permissions - **AI Assistant** — Powered by DeepSeek (or any OpenAI-compatible API) - **Storefront** — Public-facing online store per tenant - **WhatsApp** — Webhook integration for customer messaging ## 🏗️ Architecture - **Framework**: Next.js 14 (App Router) - **Database**: PostgreSQL + Prisma ORM - **Auth**: NextAuth.js (Credentials + Google SSO) - **Styling**: Tailwind CSS + shadcn/ui - **AI**: Local Qwen2.5 3B via llama.cpp (CPU) — or any OpenAI-compatible API - **Multi-tenant**: Row-level isolation with tenant subdomain routing ## 🧪 Local Development To run the full 5-container stack (db · llm · app · nginx · certbot) on your laptop before pushing to production, see **LOCAL_DEV.md**. Quick version: ```bash cp .env.local.example .env.local docker compose -p shopysh -f docker-compose.local.yml up -d --build # then open localhost ``` ## 🚀 Self-Hosted Deployment (Docker) > ⚠️ **Security note:** earlier exports of this project committed a real `.env` > with live credentials (database URL, `NEXTAUTH_SECRET`, Google OAuth client > secret, API keys). Those are now removed and `.env` is git-ignored. **Rotate > every one of those secrets** if the old file ever reached a remote/GitHub. ### Prerequisites - Docker & Docker Compose - A domain name (e.g., `www.shopysh.com`) …