How munu-784/sop-agent works
SOP-Agent is a web application for user/admin access to SOPs, with a backend query endpoint and a separately represented AI/RAG subsystem. The visible workflow covers login, admin PDF upload and SOP management, and authenticated queries; the query handler currently returns a count-based placeholder and logs it. The README provides no capability detail, and the sampled query path does not invoke the AI services, so no connection to them is asserted.
Main entry points: App.jsx Route application · server.js HTTP server · sopRoutes.js SOP routes · queryRoutes.js Query routes
Components 28
Web interface
- Route application
frontend/src/App.jsx - Login and signup
frontend/src/pages - Admin panel
frontend/src/pages/AdminPanel.jsx - SOP dashboard
frontend/src/pages/Dashboard.jsx - SOP upload page
frontend/src/pages/UploadSOP.jsx
Backend API
- HTTP server
backend/server.js - Auth routes
backend/routes/authRoutes.js - Auth controller
backend/controllers/authController.js - Access middleware
backend/middleware/authMiddleware.js - SOP routes
backend/routes/sopRoutes.js - SOP controller
backend/controllers/sopController.js - Query routes
backend/routes/queryRoutes.js - Query handler
backend/controllers/queryController.js - PDF upload filter
backend/utils/upload.js
Application data
- Database connection
backend/config/db.js - User records
backend/models/User.js - SOP records
backend/models/SOP.js - Query logs
backend/models/Log.js - Chat records
backend/models/Chat.js - Embedding records
backend/models/Embedding.js
AI pipeline
- Embedding generation
ai-pipeline/embedding.py - RAG pipeline
ai-pipeline/rag_pipeline.py - Vector index
ai-pipeline/vector_index.py - Embedding service
backend/services/embeddingService.js - RAG service
backend/services/ragService.js - Vector search
backend/services/vectorSearchService.js - Language model
backend/services/llmService.js
Other components
- User or admin
Connections 20
- User or admin → Route application: opens
frontend/src/App.jsx - Route application → Login and signup: routes to
frontend/src/App.jsx - Route application → Admin panel: routes to
frontend/src/App.jsx - Route application → SOP dashboard: routes to
frontend/src/App.jsx - Route application → SOP upload page: routes to
frontend/src/App.jsx - HTTP server → Database connection: connects
backend/server.js - HTTP server → Auth routes: mounts
backend/server.js - HTTP server → SOP routes: mounts
backend/server.js - HTTP server → Query routes: mounts
backend/server.js - Auth routes → Auth controller: dispatches to
backend/routes/authRoutes.js - Auth controller → User records: reads and creates
backend/controllers/authController.js - SOP routes → Access middleware: protects routes
backend/routes/sopRoutes.js - SOP routes → PDF upload filter: accepts PDF
backend/routes/sopRoutes.js - SOP routes → SOP controller: dispatches to
backend/routes/sopRoutes.js - SOP controller → SOP records: reads and writes
backend/controllers/sopController.js - Query routes → Access middleware: protects route
backend/routes/queryRoutes.js - Query routes → Query handler: dispatches to
backend/routes/queryRoutes.js - Query handler → SOP records: reads
backend/controllers/queryController.js - Query handler → Query logs: writes
backend/controllers/queryController.js - Access middleware → User records: loads user
backend/middleware/authMiddleware.js