How akg-git/rbac-based-rag-assistant works
DocuFi is an internal, role-based RAG assistant with document ingestion, SQL and document-grounded chat, user/role administration, and audit monitoring. A user authenticates, submits a question, and the chat route classifies it for SQL or RAG (with SQL-to-RAG fallback) before returning an answer. Administrators can upload documents and manage users; documents are stored and indexed for retrieval. The repository also includes a substantial evaluation suite for answer quality, retrieval, security, latency, vector DB, SQL, and audit behavior. Several evaluation links rely on the source index because those implementation excerpts were not supplied.
Main entry points: evaluation_pipelines.py Evaluation pipeline · main.py API application · landing_page.py Frontend pages · document_routes.py Document management
Components 29
User interface
- Frontend pages
app/DocuFi-Frontend/landing_page.py - Login UI
app/DocuFi-Frontend/login_handler.py - Role definitions
app/DocuFi-Frontend/roles.py
Assistant application
- API application
app/main.py - User administration
app/routes/user_routes.py - Document management
app/routes/document_routes.py - Chat routing
app/routes/chat_routes.py - Authentication
app/authentication/auth.py - Password hashing
app/authentication/hashing.py - Request audit context
app/utils/audit_context.py - Query classifier
app/utils/query_classifier.py - Natural-language SQL
app/utils/sql_query.py - RAG response handler
app/utils/rag_chain.py - Document indexing
app/utils/rag_module.py - RAG response cache
app/utils/response_cache.py
Data and audit
- User and document store
app/schemas/sqlitedb.py - Structured data store
app/schemas/duckdb.py - Audit event log
app/utils/audit_events.py
Evaluation suite
- Evaluation pipeline
app/rag_evaluator/evaluation_pipelines.py - Evaluation datasets
app/rag_evaluator/evaluation_dataset_builder.py - Answer quality
app/rag_evaluator/answer_quality/evaluator.py - Retrieval quality
app/rag_evaluator/retrieval/evaluator.py - RBAC security
app/rag_evaluator/rbac_security/evaluator.py - Latency
app/rag_evaluator/latency/evaluator.py - Vector DB
app/rag_evaluator/vector_db/evaluator.py - Text-to-SQL
app/rag_evaluator/text_to_sql/evaluator.py - Audit monitoring
app/rag_evaluator/audit_monitoring/evaluator.py - Evaluation reports
app/rag_evaluator/reports/evaluation_report.py
Other components
- Internal user
Connections 36
- Internal user → Frontend pages: uses
- Frontend pages → Login UI: uses
app/DocuFi-Frontend/landing_page.py - Frontend pages → Role definitions: uses
app/DocuFi-Frontend/landing_page.py - Frontend pages → API application: calls API
- API application → Chat routing: registers
app/main.py - API application → Document management: registers
app/main.py - API application → User administration: registers
app/main.py - User administration → Authentication: authenticates
app/routes/user_routes.py - User administration → User and document store: reads/writes
app/routes/user_routes.py - Authentication → User and document store: reads credentials
app/authentication/auth.py - Authentication → Password hashing: verifies password
app/authentication/auth.py - API application → Request audit context: initializes
app/main.py - Request audit context → Authentication: authenticates
app/utils/audit_context.py - Request audit context → Audit event log: emits events
app/utils/audit_context.py - Document management → User and document store: stores metadata
app/routes/document_routes.py - Document management → Structured data store: stores table metadata
app/routes/document_routes.py - Document management → Document indexing: indexes documents
app/routes/document_routes.py - Chat routing → Query classifier: classifies query
app/routes/chat_routes.py - Chat routing → Natural-language SQL: routes SQL
app/routes/chat_routes.py - Chat routing → RAG response handler: routes RAG/fallback
app/routes/chat_routes.py - Natural-language SQL → Structured data store: queries schema
app/utils/sql_query.py - Natural-language SQL → RAG response cache: uses cache
app/utils/sql_query.py - Natural-language SQL → Audit event log: emits events
app/utils/sql_query.py - RAG response handler → Document indexing: invokes RAG chain
app/utils/rag_chain.py - RAG response handler → RAG response cache: uses cache
app/utils/rag_chain.py - RAG response handler → Audit event log: emits events
app/utils/rag_chain.py - Document indexing → User and document store: reads document metadata
app/utils/rag_module.py - Evaluation pipeline → Evaluation datasets: builds datasets
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Answer quality: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Retrieval quality: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → RBAC security: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Latency: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Vector DB: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Text-to-SQL: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Audit monitoring: runs evaluation
app/rag_evaluator/evaluation_pipelines.py - Evaluation pipeline → Evaluation reports: generates reports
app/rag_evaluator/evaluation_pipelines.py