Markkimotho/edusight-africa

# EduSight Africa AI-powered student risk assessment and educational analytics platform for African schools. --- ## Stack | Layer | Technology | |-------|-----------| | Frontend | Next.js 14 (App Router), TypeScript, Tailwind CSS, Recharts | | Backend | FastAPI, SQLAlchemy (async), Alembic, asyncpg | | Database | PostgreSQL 16 | | Cache | Redis 7 | | ML | XGBoost + RandomForest, scikit-learn, Pandas | | Auth | NextAuth.js (JWT, credentials provider) | | Infra | Docker Compose, GitHub Actions CI/CD | --- ## Features - **Risk Assessment** — ML model scores students across attendance, academic, behavioral, and socioeconomic indicators; outputs low / medium / high / critical risk tiers - **Student Management** — full CRUD with school-level scoping and paginated list views - **Dashboard** — real-time stats, risk distribution charts, and trend history - **Parent Portal** — structured observation forms flowing into assessment history - **Multilingual** — EN, SW, FR, AR, AM, HA, YO, ZU, PT, RW (via next-intl) - **Cultural Context** — regional weighting profiles for East, West, North, South Africa - **Role-based Access** — teacher, parent, admin, superadmin --- ## Quick Start See **INSTALLATION.md** for the full setup guide. **TL;DR (Docker):** ```bash git clone edusight-africa cd edusight-africa cp .env.example .env # fill in the three secret keys docker compose up --build # starts postgres + redis + backend + frontend # in a second terminal: docker compose exec backend alembic upgrade head ``` | Service | URL | |---------|-----| | Frontend | localhost | | Backend API | localhost | | Swagger docs | localhost | --- ## Project Structure ``` edusight-africa/ ├── backend/ # FastAPI application │ ├── app/ │ │ ├── api/v1/ # Route handlers │ │ ├── models/ # SQLAlchemy ORM models │ │ ├── schemas/ # Pydantic schemas │ │ ├── services/ …