azzzou/algerian-school-ai4

# 🎓 Algerian School Support Platform A **production-ready, multi-service** platform for an Algerian school-support (tutoring) business targeting the **BAC** (Baccalauréat) and **BEM** (Brevet) national exams. It connects a **Meta (Facebook) Messenger bot**, a **CrewAI + Google Gemini** conversational agent that speaks **Algerian Darija & French**, and a **Laravel school-management dashboard** — all wired together with a shared Docker stack and Redis. --- ## ✨ Highlights - 🤖 **AI Agent (CrewAI + Gemini)** that replies in **Algerian Darija / French** with a warm, professional tone, and extracts structured pre-registration data. - 🔒 **Meta Messenger Gateway (FastAPI)** that **verifies `X-Hub-Signature-256`** (HMAC-SHA256) and responds **asynchronously** to avoid webhook timeouts. - 🏫 **Laravel School Dashboard** (ready-made School Management System). - 🐳 **Docker Compose** stack wiring Gateway + AI Engine + Dashboard + Redis + MySQL. - 🧱 **Deterministic JSON output** (`reply_text` + `extracted_info`) from the AI — stable contract for downstream systems. --- ## 🗂 Architecture ``` ┌─────────────────────────────┐ ┌──────────────────────────────┐ │ Meta Messenger (FB) │ │ CrewAI AI Engine │ │ ┌───────────────────────┐ │ HTTP │ ┌────────────────────────┐ │ │ │ Gateway (FastAPI) │◄┼───────┼──►│ /v1/reply │ │ │ │ · X-Hub-Signature │ │ │ └────────────────────────┘ │ │ │ · Async background │ │ │ AlgerianSupportCrew (crew) │ │ └──────────┬────────────┘ │ │ Agent (Gemini, Darija) │ │ │ reply │ └──────────────────────────────┘ │ ▼ │ │ ┌───────────────────────┐ │ │ │ Redis (cache/queue) │ │ │ └───────────────────────┘ │ └─────────────────────────────┘ │ ▼ ┌───────────────────────┐ │ Dashboard (Laravel) │ — school/student/result management └───────────────────────┘ ``` | Service | Tech | Port | Pur …