How sanjeev-rs/nexus-campus works
NEXUS is a campus intelligence platform combining student, faculty, and management experiences with a FastAPI backend for academic records, projects, opportunities, and intelligence services. The student workflow spans browsing projects and knowledge, managing a profile, and accessing campus services; the backend exposes these capabilities through versioned API routes and PostgreSQL-backed models. Knowledge ingestion is a distinct workflow: authorized requests schedule research-file processing, while a generic service chunks text, generates embeddings, and stores them. The excerpts establish routing and ingestion relationships; frontend-to-backend calls and most service internals were not shown.
Main entry points: App.jsx Web app · knowledge_ingestion_service.py Knowledge ingestion · router.py Versioned routes · knowledge_ingestion.py Ingestion routes
Components 27
Campus experience
- Web app
frontend/src/App.jsx - Landing
frontend/src/campus/pages/Landing/Landing.jsx - Student projects
frontend/src/campus/pages/Student/StudentProjects.jsx - Project details
frontend/src/campus/pages/Student/ProjectDetails/ProjectDetails.jsx - Project upload
frontend/src/campus/pages/Student/ProjectUpload/ProjectUpload.jsx - Knowledge pages
frontend/src/campus/pages/Student/Knowledge - Student profile
frontend/src/campus/pages/Student/StudentProfile/StudentProfile.jsx - Faculty dashboard
frontend/src/campus/pages/Faculty/FacultyDashboard.jsx - Management dashboard
frontend/src/campus/pages/Management/ManagementDashboard.jsx - Knowledge catalogue
frontend/src/campus/pages/Student/Knowledge/knowledgeData.js
Backend API
- FastAPI app
backend/app/main.py - Versioned routes
backend/app/api/v1/router.py - Domain routes
backend/app/api - Ingestion routes
backend/app/api/knowledge_ingestion.py
Intelligence services
- Campus intelligence
backend/app/services/campus_intelligence_engine.py - Student twin
backend/app/services/student_twin_engine.py - Graph intelligence
backend/app/services/graph_intelligence_engine.py
Knowledge system
- Knowledge ingestion
backend/app/services/knowledge_ingestion_service.py - Ingestion status
backend/app/services/knowledge_ingestion_status_service.py - Research processor
backend/app/services/research_ingestion_processor.py - RAG context
backend/app/services/rag_context_service.py - Text chunking
backend/app/services/knowledge_chunking_service.py - Embedding generation
backend/app/services/embedding_service.py - Embedding storage
backend/app/services/knowledge_embedding_service.py
Data layer
- PostgreSQL models
backend/app/models - Database connection
backend/app/database/connection.py
Other components
- Campus user
Connections 19
- Campus user → Web app: opens
frontend/src/App.jsx - Web app → Landing: routes to
frontend/src/App.jsx - Web app → Student projects: routes to
frontend/src/App.jsx - Web app → Project details: routes to
frontend/src/App.jsx - Web app → Knowledge pages: routes to
frontend/src/App.jsx - Web app → Student profile: routes to
frontend/src/App.jsx - Web app → Faculty dashboard: routes to
frontend/src/App.jsx - Knowledge pages → Knowledge catalogue: reads catalogue
frontend/src/campus/pages/Student/Knowledge/KnowledgeResearch.jsx - FastAPI app → Versioned routes: mounts routes
backend/app/main.py - Versioned routes → Domain routes: registers
backend/app/api/v1/router.py - Versioned routes → Ingestion routes: registers
backend/app/api/v1/router.py - Ingestion routes → Ingestion status: checks status
backend/app/api/knowledge_ingestion.py - Ingestion routes → Research processor: schedules processing
backend/app/api/knowledge_ingestion.py - Ingestion status → PostgreSQL models: reads/writes records
backend/app/services/knowledge_ingestion_status_service.py - Knowledge ingestion → Text chunking: chunks text
backend/app/services/knowledge_ingestion_service.py - Knowledge ingestion → Embedding generation: generates vectors
backend/app/services/knowledge_ingestion_service.py - Knowledge ingestion → Embedding storage: stores vectors
backend/app/services/knowledge_ingestion_service.py - Embedding storage → PostgreSQL models: persists embeddings
- Database connection → PostgreSQL models: registers models
backend/app/database/connection.py