How varunb453/acadhub works
AcadHub is an AI-enabled campus management system for students, faculty, and administrators. The main user path is browser navigation through role-aware authentication, into academic and administrative modules, with frontend API calls handled by the Node server and MongoDB-backed routes; registration additionally supports approval. Other documented capabilities include attendance and analytics, complaints, notices, events, uploads, settings, reports, and an AI assistant. The graph follows relationships shown in excerpts, the source index, or README; several feature links are documented rather than confirmed at implementation level.
Main entry points: index.mjs HTTP API router · pages Campus modules · api.ts API client · mongodb.mjs MongoDB access
Components 21
Campus Web App
- Application router
src/App.tsx - Auth forms
src/pages/Auth/hooks/useAuthForm.ts - Session context
src/contexts/AuthContext.tsx - API client
src/integrations/mongodb/api.ts - Campus modules
src/pages - Chat assistant UI
src/components/chatbot/useChat.ts
API and Identity
- HTTP API router
server/index.mjs - Authentication routes
server/routes/auth.mjs - Token security
server/utils/auth.mjs - User authentication
server/middleware/authMiddleware.mjs - Registration approval
server/controllers/registrationController.mjs - Approval service
server/services/approvalService.mjs
Campus Operations
- Campus data routes
server/routes/collections.mjs - MongoDB access
server/database/mongodb.mjs - Academic operations
src/pages/Attendance/index.tsx - File uploads
server/routes/upload.mjs
AI and Insights
- Analytics and reports
server/services/analyticsService.mjs - AI query routes
server/routes/ai.mjs - AI domain tools
server/services/attendanceAITool.mjs
Other components
- Campus user
- AI service
Connections 28
- Campus user → Application router: uses
README.md - Application router → Auth forms: routes to
src/App.tsx - Application router → Campus modules: routes to
src/App.tsx - Auth forms → Session context: signs in
src/pages/Auth/hooks/useAuthForm.ts - Session context → API client: calls auth
src/contexts/AuthContext.tsx - API client → HTTP API router: requests API
- HTTP API router → Authentication routes: dispatches
server/index.mjs - HTTP API router → Registration approval: dispatches
server/index.mjs - HTTP API router → Campus data routes: dispatches
server/index.mjs - HTTP API router → AI query routes: dispatches
server/index.mjs - HTTP API router → Analytics and reports: dispatches
server/index.mjs - HTTP API router → File uploads: dispatches
server/index.mjs - Authentication routes → Token security: uses tokens
server/routes/auth.mjs - User authentication → Token security: verifies token
server/middleware/authMiddleware.mjs - User authentication → MongoDB access: loads user
server/middleware/authMiddleware.mjs - Registration approval → User authentication: gets user
server/controllers/registrationController.mjs - Registration approval → Approval service: manages requests
server/controllers/registrationController.mjs - Approval service → MongoDB access: accesses database
server/services/approvalService.mjs - Authentication routes → MongoDB access: accesses database
server/routes/auth.mjs - Campus data routes → MongoDB access: accesses database
server/routes/collections.mjs - Campus modules → API client: loads data
src/pages/Auth/hooks/useAuthForm.ts - Campus modules → Academic operations: includes attendance
README.md - Academic operations → API client: loads attendance
- Campus modules → Analytics and reports: presents insights
- Chat assistant UI → HTTP API router: sends queries
- AI query routes → AI domain tools: dispatches tools
server/routes/ai.mjs - AI query routes → AI service: may use
- File uploads → Campus user: receives files