How nareshparab/ai-assistant-healthcare works
This repository combines a healthcare document-processing backend with a Fire TV client and a separately scoped P4 rendering POC. The backend workflow extracts PDF text spans, structures them as AI proposals, applies a deterministic evidence gate, and persists extraction state; the sampled API also exposes evidence and device-pairing routes. The Fire TV tree shows a focus-validation screen, navigation, and local activity storage. Edges reflect explicit excerpts or SOURCE INDEX references; several client-to-backend and app-entry links are not shown, so they are omitted.
Main entry points: orchestrator.py Extraction job · main.py HTTP routes · deps.py API dependencies · document_structuring.py AI structuring
Components 33
Backend API
- HTTP routes
backend/api/main.py - Error envelope
backend/api/errors.py - API dependencies
backend/api/deps.py
Document Extraction
- PDF evidence
backend/documents/pdf_evidence.py - Synthetic documents
backend/documents/synthetic_data.py - PDF text spans
backend/documents/spans.py - Extraction job
backend/extraction/orchestrator.py - AI structuring
backend/ai/assist/document_structuring.py - Proposal schema
backend/ai/schemas/document_structuring.py - LLM client
backend/ai/client/base.py - Anthropic provider
backend/ai/client/anthropic_client.py - Evidence gate
backend/guardrail/extraction_gate.py - Routine validator
backend/guardrail/routine_validator.py
Backend Persistence
- Device pairing
backend/storage/devices.py - SQLite database
backend/storage/db.py - Document storage
backend/storage/documents.py - Document state
backend/storage/document_state.py - Extraction records
backend/storage/extraction.py
Fire TV Client
- Activity entry
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/MainActivity.kt - Focus validation
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/P2FocusValidationScreen.kt - App navigation
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/nav/AppShell.kt - Navigation state
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/nav/NavigationState.kt - Destinations
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/nav/Destination.kt - Shell screens
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/ui/ShellScreens.kt - Activity DAO
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/data/local/ActivityRecordDao.kt - Activity record
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/data/local/ActivityRecordEntity.kt - Local database
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/data/local/AppDatabase.kt - UI theme
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/design/Theme.kt - Safe zone
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/design/SafeZone.kt
Transfer POC
- POC HTTP routes
p4-transfer-package/p4-transfer-package/backend/app/main.py - POC span extraction
p4-transfer-package/p4-transfer-package/backend/app/documents/extract.py - POC highlighting
p4-transfer-package/p4-transfer-package/backend/app/documents/render.py
Other components
- TV user
Connections 29
- HTTP routes → API dependencies: uses dependencies
backend/api/main.py - HTTP routes → Error envelope: registers errors
backend/api/main.py - HTTP routes → Device pairing: creates pairing code
backend/api/main.py - HTTP routes → PDF evidence: builds evidence image
backend/api/main.py - HTTP routes → Synthetic documents: loads demo data
backend/api/main.py - API dependencies → Device pairing: uses device storage
backend/api/deps.py - API dependencies → SQLite database: opens connection
backend/api/deps.py - Extraction job → PDF text spans: extracts spans
backend/extraction/orchestrator.py - Extraction job → AI structuring: builds model input
backend/extraction/orchestrator.py - Extraction job → LLM client: calls structured model
backend/extraction/orchestrator.py - Extraction job → Evidence gate: applies gate
backend/extraction/orchestrator.py - Extraction job → Extraction records: persists extraction
backend/extraction/orchestrator.py - Extraction job → Document state: updates state
backend/extraction/orchestrator.py - Extraction job → SQLite database: opens connection
backend/extraction/orchestrator.py - AI structuring → Proposal schema: uses schema
backend/ai/assist/document_structuring.py - AI structuring → PDF text spans: serializes spans
backend/ai/assist/document_structuring.py - Evidence gate → Proposal schema: revalidates output
backend/guardrail/extraction_gate.py - Evidence gate → PDF text spans: checks cited evidence
backend/guardrail/extraction_gate.py - LLM client → Anthropic provider
backend/ai/client/anthropic_client.py - App navigation → Navigation state: uses navigation state
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/nav/AppShell.kt - App navigation → Destinations: uses destinations
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/nav/AppShell.kt - Navigation state → Destinations: uses destinations
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/nav/NavigationState.kt - Local database → Activity DAO: provides DAO
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/data/local/AppDatabase.kt - Local database → Activity record: stores entity
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/data/local/AppDatabase.kt - Activity DAO → Activity record: queries records
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/data/local/ActivityRecordDao.kt - UI theme → Safe zone: uses safe zone
firetv/app/src/main/java/com/aiassistanthealthcare/firetv/design/Theme.kt - TV user → Focus validation: uses screen
- POC HTTP routes → POC span extraction: extracts matching span
p4-transfer-package/p4-transfer-package/backend/app/main.py - POC HTTP routes → POC highlighting: renders highlight
p4-transfer-package/p4-transfer-package/backend/app/main.py