fitzroypet/lighthouse

Building the data backbone of African education, helping schools grow, teachers teach better, and parents feel empowered. # LightHouse - AI-Powered Education Platform LightHouse is a data-driven education platform that digitises learning resources and student results, builds academic profiles over time, and uses AI to deliver personalised insights to schools, teachers, and parents in Nigeria. ## 🎯 Vision To build the data backbone of African education, helping schools grow, teachers teach better, and parents feel empowered. ## 🧭 Platform Overview This repository hosts the AI engine for LightHouse. The wider product teams embed these services into the full learning platform so schools can manage students, parents, and classrooms while benefiting from AI insights. PostgreSQL with pgvector powers both transactional storage and retrieval-augmented generation in a single stack. ## 🏗️ Architecture Highlights - **PostgreSQL ERD** covering Nigeria's 6-3-3 education system with read-only roles and RLS - **Vector-backed RAG pipeline** for curriculum-aware responses and embeddings - **CrewAI agents** (Teacher, Parent, Orchestrator) orchestrated through the Lighthouse MCP tools - **FastAPI backend** exposing REST + SSE endpoints secured with JWTs ## 🛣️ Roadmap Snapshot - **Phase 1 – MVP (Aug/Sept 2025):** Schema design, bulk import flows, class/subject setup, result entry, student profiles - **Phase 2 – Parent & Insights (Sept/Oct 2025):** Parent portal, dashboards, automated performance updates - **Phase 3 – AI Features (Oct 2025):** RAG pipeline, conversational assistant, personalised learning suggestions - **Phase 4 – Scale (Dec/Jan 2026):** Multi-school onboarding, government/NGO reporting, strategic partnerships ## 🏗️ Current Project Structure ``` /Users/petgrave/lighthouse/ ├── 📋 docs/ # Project documentation & roadmaps │ ├── README.md # Detailed product documentation │ ├── PRODUCT.md # Product strategy and roadmap │ ├── PRODUCT_ROADMAP.md # Development roadmap │ ├── AI_ML_COMPONENTS.md …