How siddrwt/one-front-door works
One Front Door is a student-facing campus assistant: students authenticate, submit single- or multi-domain questions, and receive routed answers with explanations or an escalation ticket. The frontend sends chat requests through the Express backend, which applies conversation context and student-specific grounding before invoking the AI routing service; conversations and turns are stored in MongoDB. The README documents ONNX classification, citations, guardrails, ticketing, feedback, and ticket history. Some implementation files were not sampled, so links for those documented capabilities are limited to README evidence.
Main entry points: chatController.js Chat orchestration · ChatPage.jsx Chat workspace · aiService.js AI adapter · api.js HTTP client
Components 23
Student portal
- Login and identity
frontend/src/context/AuthContext.jsx - Auth API client
frontend/src/services/authService.js - Chat workspace
frontend/src/pages/ChatPage.jsx - Chat state
frontend/src/context/ChatContext.jsx - Chat API client
frontend/src/services/chatService.js - HTTP client
frontend/src/services/api.js - Ticket history
frontend/src/pages/TicketsPage.jsx
Backend services
- Express API
backend/src/app.js - Chat routes
backend/src/routes/chat.js - Chat orchestration
backend/src/controllers/chatController.js - Conversation context
backend/src/services/conversationContextService.js - Student grounding
backend/src/services/studentContextService.js - AI adapter
backend/src/services/aiService.js - Domain mapping
backend/src/config/domains.js - Auth routes
backend/src/routes/auth.js - Auth controller
backend/src/controllers/authController.js
AI routing
- AI routing service
ai_service/app.py - ONNX classifier
ai_service/app.py
State and support
- Conversation and turn records
backend/src/models/Conversation.js - Student records
backend/src/models/User.js - Escalation ticketing
backend/src/services/ticketService.js - MongoDB
Other components
- Student
Connections 24
- Student → Login and identity: signs in
- Login and identity → Auth API client: calls
frontend/src/context/AuthContext.jsx - Auth API client → HTTP client: sends requests
frontend/src/services/authService.js - Student → Chat workspace: asks questions
README.md - Chat workspace → Chat state: submits messages
frontend/src/pages/ChatPage.jsx - Chat state → Chat API client: sends chat
frontend/src/context/ChatContext.jsx - Chat API client → HTTP client: uses
frontend/src/services/chatService.js - HTTP client → Express API: HTTP JSON
README.md - Express API → Chat routes: mounts
backend/src/app.js - Chat routes → Chat orchestration: routes to
backend/src/routes/chat.js - Chat orchestration → Conversation context: builds context
backend/src/controllers/chatController.js - Chat orchestration → Student grounding: retrieves record
backend/src/controllers/chatController.js - Chat orchestration → AI adapter: calls pipeline
backend/src/controllers/chatController.js - Chat orchestration → Escalation ticketing: creates ticket
backend/src/controllers/chatController.js - Chat orchestration → Conversation and turn records: stores turns
backend/src/controllers/chatController.js - Conversation context → Conversation and turn records: reads and updates
backend/src/services/conversationContextService.js - Student grounding → Student records: reads student
backend/src/services/studentContextService.js - AI adapter → AI routing service: HTTP inference
README.md - AI routing service → ONNX classifier: classifies intents
README.md - AI adapter → Domain mapping: maps labels
backend/src/services/aiService.js - Escalation ticketing → MongoDB: persists tickets
README.md - Conversation and turn records → MongoDB: persists records
README.md - Student records → MongoDB: stores student data
README.md - Chat workspace → Ticket history: views ticket history
README.md