AI-powered trend analyzer for the Moroccan E-commerce & COD market. Uses Deep Learning and Darija NLP to detect purchase intent and predict winning products.
# 🛍️ SoukAI – AI Winning Product Analyzer for Moroccan COD E-commerce
> **SoukAI** is an AI-powered system that analyzes Moroccan COD (Cash-on-Delivery) e-commerce products, detects purchase intent from Darija/French/Arabic comments, and predicts winning products for the Moroccan market.
---
## 📐 Architecture
```
┌─────────────────────────────────────────────────────────┐
│ Browser / Client │
│ React 18 + Tailwind CSS + Vite │
│ localhost:3000 │
└───────────────────────┬─────────────────────────────────┘
│ HTTP / REST
▼
┌─────────────────────────────────────────────────────────┐
│ FastAPI Backend │
│ Python 3.11 · Uvicorn ASGI │
│ localhost:8000 │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ │
│ │ /products │ │ /analysis │ │ /dashboard │ │
│ │ CRUD router │ │ NLP + Score │ │ Stats API │ │
│ └──────────────┘ └──────────────┘ └─────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ AI / ML Services │ │
│ │ NLP (Darija intent) · Scoring · Recommendation │ │
│ └──────────────────────────────────────────────────┘ │
└──────────────────────┬──────────────────────────────────┘
│
┌────────────┴────────────┐
▼ ▼
┌─────────────┐ ┌──────────────┐
│ SQLite DB │ │ data/*.csv │
│ soukai.db │ │ Sample data │
└─────────────┘ └──────────────┘
```
---
## ✨ Features
| # | Feature | Description |
|---|---------|-------------|
| 1 | 🔍 **Product Scoring** | Composite AI score based on trend growth, competition level and profit margin |
| 2 | 💬 **Darija NLP** | Purchase-intent …