How humaima/campus-compass works
Campus Compass is an interactive campus exploration and guidance application. Students enter through the campus UI, move a player through the deterministic campus engine, request destinations or information, and receive routes, building results, or grounded knowledge answers. The sampled server entry point classifies and routes queries between structured campus search and RAG retrieval. Quests, achievements, mobile controls, and shared campus state are represented from the documented product and tree; some UI wiring is inferred only from component responsibilities.
Components 28
Campus Experience
- Home Screen
components/home/HomeScreen.tsx - Campus Map
components/campus/CampusMap.tsx - Player Controller
components/campus/PlayerController.tsx - AI Assistant
components/assistant/AssistantWindow.tsx - Quest Panel
components/quests/QuestPanel.tsx - Mobile Controls
components/campus/MobileControls.tsx - Route Overlay
components/campus/Route.tsx
Campus Engine
- Shared Campus State
components/campus/CampusProvider.tsx - Player Movement
lib/routing/movePlayer.ts - Route Finding
lib/routing/findRoute.ts - Campus Clock
lib/campus/useCampusClock.ts - Quest Progress
lib/quests/handleQuestProgress.ts
AI And Search
- Query Handler
lib/ai/handleCampusQuery.ts - Intent Classifier
lib/ai/classifyIntent.ts - Intent Parser
lib/ai/parseIntent.ts - Query Router
lib/ai/routeQuery.ts - Campus Search
lib/search/searchCampus.ts - Knowledge Query
lib/rag/queryKnowledgeBase.ts - Semantic Retriever
lib/rag/retriever.ts - Vector Store
lib/rag/vectorStore.ts - Embeddings
lib/rag/embeddings.ts - LLM Intent
lib/ai/llmIntent.ts
Campus Domain
- Building Catalog
data/buildings.ts - Route Network
data/routes.ts - Quest Definitions
data/quests.ts
Other components
- Student
- Google AI
- Anthropic API
Connections 28
- Student → Home Screen: opens
- Student → Campus Map: explores
- Student → AI Assistant: asks guide
- Student → Quest Panel: starts quests
- Shared Campus State → Campus Map: provides state
- Campus Map → Player Controller: mounts controller
- Mobile Controls → Player Controller: controls movement
- Player Controller → Player Movement: moves player
- Campus Map → Route Finding: requests route
- Route Finding → Route Network: reads network
- Route Overlay → Building Catalog: reads positions
- Campus Map → Route Overlay: renders route
- Campus Clock → Campus Map: drives lighting
- Quest Panel → Quest Progress: reports progress
- Quest Progress → Quest Definitions: reads definitions
- AI Assistant → Query Handler: submits query
- Query Handler → Intent Classifier: classifies query
- Query Handler → Query Router: routes query
- Query Handler → Intent Parser: resolves target
- Query Handler → Campus Search: searches campus
- Campus Search → Building Catalog: reads catalog
- Query Handler → Knowledge Query: queries knowledge
- Knowledge Query → Semantic Retriever: retrieves chunks
- Semantic Retriever → Vector Store: reads vectors
- Semantic Retriever → Embeddings: creates embeddings
- Embeddings → Google AI: calls embeddings
- LLM Intent → Anthropic API: classifies remotely
- Query Handler → AI Assistant: returns outcome