How chugwanisahil-eng/astra_intel-sahil_chugwani- works
Astra Intel is a PDF document-intelligence application. Users upload documents, which are extracted page by page (using OCR when needed), chunked, embedded, and stored; they then search or ask questions, receiving grounded answers with page citations. Separate workflows provide summaries, comparisons, and persistent conversation management. The graph follows evidenced Flask route ownership and frontend API/state calls. README-described OCR and other capabilities are retained where their implementation exists in the tree; edges without direct source evidence are omitted.
Main entry points: app.py Flask app · document_routes.py Document routes · retrieval_service.py Hybrid retrieval · AppContext.jsx App state
Components 25
Web workspace
- Workspace shell
src/App.jsx - App state
src/context/AppContext.jsx - API client
src/api/client.js - Workspace panels
src/components/Sidebar.jsx - Chat and summaries
src/components/ChatPanel.jsx - Search panel
src/components/SearchPanel.jsx - PDF viewer
src/components/PdfViewer.jsx
Flask API
- Flask app
app.py - Document routes
routes/document_routes.py - Chat routes
routes/chat_routes.py - Conversation routes
routes/conversation_routes.py - Search routes
routes/search_routes.py - Summary routes
routes/summary_routes.py - Comparison routes
routes/compare_routes.py
Document processing
- PDF extraction
services/pdf_service.py - OCR
services/ocr_service.py - Text chunking
services/chunk_service.py - Embedding storage
services/embedding_store.py
Search and generation
- Embedding model
services/embedding_service.py - Hybrid retrieval
services/retrieval_service.py - LLM services
services/llm_service.py
Persistent data
- SQLite database
database/db.py
Other components
- User
- OpenRouter
- Uploaded PDFs
uploads
Connections 37
- User → Workspace shell: uses
README.md - Workspace shell → Workspace panels: renders
src/App.jsx - Workspace shell → PDF viewer: renders
src/App.jsx - Workspace shell → Chat and summaries: renders
src/App.jsx - Workspace panels → App state: uses state
src/components/Sidebar.jsx - Chat and summaries → App state: uses state
src/components/ChatPanel.jsx - Search panel → App state: uses state
src/components/SearchPanel.jsx - PDF viewer → App state: uses state
src/components/PdfViewer.jsx - App state → API client: calls
src/context/AppContext.jsx - Search panel → API client: searches via
src/components/SearchPanel.jsx - API client → Flask app: HTTP requests
README.md - Flask app → Document routes: registers
app.py - Flask app → Chat routes: registers
app.py - Flask app → Conversation routes: registers
app.py - Flask app → Search routes: registers
app.py - Flask app → Summary routes: registers
app.py - Flask app → Comparison routes: registers
app.py - Document routes → PDF extraction: extracts pages
routes/document_routes.py - PDF extraction → OCR: uses OCR
services/pdf_service.py - Document routes → Text chunking: chunks pages
routes/document_routes.py - Document routes → Embedding storage: stores vectors
routes/document_routes.py - Embedding storage → Embedding model: creates embeddings
services/embedding_store.py - Document routes → SQLite database: writes metadata
routes/document_routes.py - Document routes → Uploaded PDFs: saves PDF
routes/document_routes.py - Search routes → Hybrid retrieval: retrieves passages
routes/search_routes.py - Chat routes → Hybrid retrieval: retrieves context
routes/chat_routes.py - Conversation routes → Hybrid retrieval: retrieves context
routes/conversation_routes.py - Hybrid retrieval → SQLite database: reads chunks
services/retrieval_service.py - Hybrid retrieval → Embedding model: embeds query
services/retrieval_service.py - Chat routes → LLM services: generates answer
routes/chat_routes.py - Conversation routes → LLM services: generates response
routes/conversation_routes.py - Summary routes → LLM services: generates summary
routes/summary_routes.py - Comparison routes → LLM services: compares documents
routes/compare_routes.py - LLM services → OpenRouter: requests generation
- Summary routes → SQLite database: reads and saves
routes/summary_routes.py - Conversation routes → SQLite database: persists history
routes/conversation_routes.py - Comparison routes → SQLite database: loads documents
routes/compare_routes.py