Waypoint

The Problem

FCS Innovation Academy is a dynamic magnet school with a plethora of ongoing events, clubs, shifting rules, and generalized information that can often form a complex web for new and existing students alike. Students, parents, and teachers often faced difficulties navigating through various school pages, handbooks, and announcements just to find simple answers.

The core challenge was to build an interface that could instantaneously deliver context-aware information to the user in a highly intuitive, conversational manner, essentially serving as a centralized brain for the entire school ecosystem.

The Solution: Waypoint

Waypoint was conceived under the non-profit Phoenix Tech Solutions to mitigate these information silos. We built a real-time, smart chat interface that users can query to get accurate answers regarding the school environment. From finding a specific club sponsor to checking the upcoming timeline of events, Waypoint centralizes it all.

System Architecture & RAG Pipeline

The undeniable “brain” of Waypoint is powered by a custom Retrieval-Augmented Generation (RAG) pipeline. Instead of relying solely on the vast, but generalized knowledge of an LLM, we feed it hyper-specific school documents and structured data before it answers.

[ Document Ingestion ] -> [ Chunking ] -> [ Mistral Embeddings ] -> [ Vector Store ]
                                                                          |
                                                                          v
[ User Query ] -------------------------------------------------> [ Context Retrieval ]
                                                                          |
                                                                          v
[ Final Answer ] <------------------------------------------- [ Gemini 3 Flash Preview ]

1. Information Structuring: Data is ingested from data.json and split into meaningful parts using Langchain’s CharacterTextSplitter.
2. Embeddings: We use Mistral AI (@langchain/mistralai) to convert these chunks into numerical vectors.
3. Storage & Retrieval: A custom in-memory vector store (SimpleMemoryVectorStore) handles fast cosine similarity searches. When a user queries Waypoint, the system retrieves the most relevant embedded chunks.
4. Generation: Relevancy context is beamed to Google’s Gemini 3 Flash Preview (via @google/genai) to synthesize a perfectly accurate and grounded response.

Core Features

1. Smart Chat Interface

An intuitive, modern UI built with React 19, Radix UI, and styled fluidly with TailwindCSS 4 and Framer Motion. It supports real-time streaming of AI responses, preserving chat history and displaying it elegantly.

2. Staff & Club Directory

Users don’t just ask questions—they can explicitly look up teachers, read staff bios, and discover clubs efficiently without getting lost in generic school websites.

3. Timeline View

An interactive visual schedule plotting out upcoming events, milestones, and daily bell schedules.

4. Robust User Accounts

Seamless authentication and cloud persistence managed entirely via Supabase. We additionally integrated a custom IP-based request bucket to enforce rate limiting and prevent LLM API spam.

The Outcome & Current Status

What started as a rough prototype quickly captured the interest of school administrators. Waypoint is currently in a rapid collaborative phase with the Fulton County school district, aiming for a full-scale deployment to over 1,800 students, staff members, and thousands of prospective parents.

The seamless integration of a modern React frontend and a meticulously tuned AI backend proves that intelligent, accessible information systems are the future of educational infrastructure.