Classroom Clarity

Classroom Clarity is a full-stack retrieval-augmented generation (RAG) application purpose-built for the education space. Teachers, administrators, and parents can upload school documents — curriculum maps, student handbooks, policy guides — and immediately ask natural-language questions. The system retrieves the most relevant passages using vector similarity search, then generates grounded answers with source citations so users can verify every claim. The backend is a Java 21 Spring Boot service using Spring AI 1.1 with the RetrievalAugmentationAdvisor pattern, backed by PostgreSQL 16 with pgvector for combined relational and vector storage. The frontend is an Astro 5 static site with Tailwind CSS, hosted on Firebase with a Cloud Functions API proxy. The entire stack runs on Google Cloud — Cloud Run for the API, Cloud SQL for the database, Cloud Storage for PDFs, and Vertex AI for embeddings and chat.

School districts produce hundreds of pages of curriculum maps, handbooks, and policy documents every year. These critical documents live as static PDFs buried in shared drives and websites. Finding a specific policy, checking a standards alignment, or answering a parent's question means manually searching through dozens of pages. Teachers waste valuable planning time hunting for information that should be instantly accessible. Traditional keyword search fails because education documents use specialized terminology and the same concept is often described differently across documents.