How varadpatil5005/rag-copilot-for-call-reports works
Tathyx is an enterprise call-report decision-intelligence copilot. Analysts upload reports, which the API processes into searchable evidence; they then query the copilot and review grounded answers, citations, and related graph insights. The map also includes documented learning, administration, and observability capabilities. Some subsystem connections come from README documentation because their source was not sampled; uncertain internal wiring is omitted.
Main entry points: main.py FastAPI Gateway · pipeline.py Ingestion Workers · copilot.py Copilot Routes · api.ts Web API Client
Components 22
Analyst Experience
- Web Workspace
apps/web/src/app/copilot/page.tsx - Document Center
apps/web/src/app/documents/page.tsx - Web API Client
apps/web/src/lib/api.ts
API and Identity
- FastAPI Gateway
apps/api/app/main.py - Authentication
apps/api/app/routers/auth.py - Document Routes
apps/api/app/routers/documents.py - Copilot Routes
apps/api/app/routers/copilot.py
Document Ingestion
- Ingestion Workers
apps/api/app/services/pipeline.py - Layout Extraction
apps/api/app/services/extraction.py - Chunking and Embeddings
apps/api/app/services/chunking.py - Raw and Derived Files
apps/api/app/services/storage.py - Metadata and FTS Store
apps/api/app/db.py
Decision Intelligence
- Hybrid Retrieval
apps/api/app/services/search_index.py - Agentic Retrieval
apps/api/app/services/agentic_retrieval.py - Answer and Citations
apps/api/app/services/generation.py - GraphRAG
apps/api/app/services/graph_store.py
Learning and Operations
- Self-Learning
apps/api/app/services/learning.py - Memory and Skills
apps/api/app/services/memory_manager.py - Evaluation
apps/api/app/routers/evaluation.py - Observability
apps/api/app/routers/observability.py
Other components
- Analyst
- Model Provider
Connections 24
- Analyst → Web Workspace: uses
- Analyst → Document Center: uploads reports
- Web Workspace → Web API Client: requests
- Document Center → Web API Client: uploads via
- Web API Client → FastAPI Gateway: calls API
- FastAPI Gateway → Authentication: dispatches
- FastAPI Gateway → Document Routes: dispatches
- FastAPI Gateway → Copilot Routes: dispatches
- FastAPI Gateway → Ingestion Workers: starts workers
- Document Routes → Ingestion Workers: queues documents
- Ingestion Workers → Layout Extraction: extracts layout
- Ingestion Workers → Chunking and Embeddings: chunks and embeds
- Ingestion Workers → Raw and Derived Files: stores files
- Ingestion Workers → Metadata and FTS Store: writes records
- Copilot Routes → Agentic Retrieval: retrieves evidence
- Agentic Retrieval → Hybrid Retrieval: searches index
- Copilot Routes → Answer and Citations: generates answer
- Copilot Routes → GraphRAG: traverses graph
- Hybrid Retrieval → Metadata and FTS Store: reads indexed data
- Answer and Citations → Model Provider: uses when reachable
- FastAPI Gateway → Self-Learning: registers routes
- Self-Learning → Memory and Skills: uses persistent context
- FastAPI Gateway → Evaluation: registers routes
- FastAPI Gateway → Observability: registers routes