How arpitjain-coder/medical-report-simplification works
ReportSamjho AI helps users upload medical reports and review extracted results, risk assessments, simplified explanations, translations, and report-specific chat. The tree shows a Next.js frontend, a Node/Express backend, and a FastAPI ML service; the README describes the backend as a proxy. The clearest evidenced processing flow is in the ML service, which orchestrates seven stages. The repository also contains a separate Express API and a database schema. Some frontend-to-service wiring and backend behavior are not shown in the excerpts, so those links are omitted or marked unverified.
Main entry points: main.py ML API orchestrator · app Next.js application · routes API routes · auth.ts Authentication
Components 22
Web experience
- Next.js application
frontend/app - Report upload
frontend/app/(dashboard)/dashboard/upload/page.tsx - Report views
frontend/app/(dashboard)/dashboard/reports - Chat panel
frontend/components/chat-panel.tsx - Localization
frontend/lib/i18n.ts
Backend services
- Node proxy
backend/server.ts - Express API
backend/artifacts/api-server/src/app.ts - API routes
backend/artifacts/api-server/src/routes - Authentication
backend/artifacts/api-server/src/routes/auth.ts - Report pipeline
backend/artifacts/api-server/src/lib/pipeline.ts
Report processing
- ML API orchestrator
ml/main.py - OCR extraction
ml/stage1_ocr.py - Clinical entity extraction
ml/stage2_ner.py - Risk scoring
ml/stage3_risk_scoring.py - RAG and retrieval
ml/stage4_rag.py - Result simplification
ml/stage5_simplification.py - Translation
ml/stage6_translation.py - Report chatbot
ml/stage7_chatbot.py - Clinical extras
ml/ml_components.py
Report data
- Report database
backend/lib/db/src/schema/reports.ts
Other components
- Patient
- Translation service
Connections 18
- Patient → Next.js application: uses
- Next.js application → Report upload: offers upload
- Next.js application → Report views: shows reports
- Next.js application → Chat panel: offers chat
- Next.js application → Localization: uses translations
- Node proxy → ML API orchestrator: proxies requests
- Express API → API routes: mounts routes
backend/artifacts/api-server/src/app.ts - API routes → Authentication: registers routes
backend/artifacts/api-server/src/routes/index.ts - Authentication → Report database: reads and writes
backend/artifacts/api-server/src/routes/auth.ts - Report pipeline → Report database: updates reports
backend/artifacts/api-server/src/lib/pipeline.ts - ML API orchestrator → OCR extraction: calls OCR
ml/main.py - ML API orchestrator → Clinical entity extraction: calls NER
ml/main.py - ML API orchestrator → Risk scoring: scores results
ml/main.py - ML API orchestrator → RAG and retrieval: builds index
ml/main.py - ML API orchestrator → Result simplification: simplifies results
ml/main.py - ML API orchestrator → Translation: translates separately
ml/main.py - ML API orchestrator → Report chatbot: answers questions
ml/main.py - ML API orchestrator → Translation service: checks health
ml/main.py