How shubhamm-sinha/medxplain-ai works
MedXplain turns a user-selected medical PDF into a language-specific, structured explanation: the API validates and extracts the PDF, cleans its text, requests constrained JSON analysis from Groq, and parses the result. The UI presents summaries, findings, charts, advice, and clinician/map options; users can optionally email the briefing and restore a prior successful session. The README documents the nearby-clinician and email capabilities; source excerpts show the analysis and email orchestration, while some UI integrations are unsampled, so those links are marked unverified.
Main entry points: ReportController.cs Report controller · ReportResults.tsx Results view · App.tsx App workflow · GroqService.cs Groq client
Components 28
React experience
- App workflow
medxplain-ui/src/App.tsx - Upload form
medxplain-ui/src/components/UploadForm.tsx - Report API client
medxplain-ui/src/api/reportApi.ts - Results view
medxplain-ui/src/components/ReportResults.tsx - Executive summary
medxplain-ui/src/components/ExecutiveSummaryCard.tsx - Findings and advice
medxplain-ui/src/components/FindingsSection.tsx - Charts
medxplain-ui/src/components/GraphSection.tsx - Nearby clinicians
medxplain-ui/src/components/NearbyDoctorsSection.tsx - Geolocation
medxplain-ui/src/hooks/useGeolocation.ts - Map links
medxplain-ui/src/utils/mapsLinks.ts - Report schema
medxplain-ui/src/types/report.ts
Analysis API
- Report controller
MedXplain-api/Controllers/ReportController.cs - PDF validation
MedXplain-api/Helpers/PdfFileValidator.cs - PDF extraction
MedXplain-api/Services/PdfExtractionService.cs - Text cleaning
MedXplain-api/Services/TextCleaningService.cs - Language handling
MedXplain-api/Helpers/LanguageHelper.cs - Response parsing
MedXplain-api/Helpers/MedicalAnalysisResponseParser.cs - Analysis response
MedXplain-api/DTOs/AnalyzeReportResponse.cs
LLM analysis
- Groq client
MedXplain-api/Services/GroqService.cs - Prompt templates
MedXplain-api/Services/PromptTemplateService.cs
Report delivery
- Email delivery panel
medxplain-ui/src/components/ReportDeliveryPanel.tsx - Email service
medxplain-api/Services/EmailService.cs - Email report HTML
medxplain-api/Helpers/ReportHtmlBuilder.cs
Session and location
- Session storage
medxplain-ui/src/utils/reportStorage.ts
Other components
- Report user
- Groq API
- SMTP server
- Browser local storage
Connections 28
- Report user → App workflow: uses
README.md - App workflow → Upload form: renders
medxplain-ui/src/App.tsx - App workflow → Report API client: calls
medxplain-ui/src/App.tsx - Report API client → Report controller: HTTP requests
README.md - Report controller → PDF validation: validates upload
MedXplain-api/Controllers/ReportController.cs - Report controller → Language handling: normalizes language
MedXplain-api/Controllers/ReportController.cs - Report controller → PDF extraction: extracts text
MedXplain-api/Controllers/ReportController.cs - Report controller → Text cleaning: cleans text
MedXplain-api/Controllers/ReportController.cs - Report controller → Groq client: requests analysis
MedXplain-api/Controllers/ReportController.cs - Groq client → Prompt templates: gets template
MedXplain-api/Services/GroqService.cs - Groq client → Language handling: builds instructions
MedXplain-api/Services/GroqService.cs - Groq client → Groq API: sends prompt
MedXplain-api/Services/GroqService.cs - Report controller → Response parsing: parses response
MedXplain-api/Controllers/ReportController.cs - Response parsing → Analysis response: populates
MedXplain-api/Helpers/MedicalAnalysisResponseParser.cs - Report controller → Email service: sends report
MedXplain-api/Controllers/ReportController.cs - Email service → Email report HTML: builds attachment
medxplain-api/Services/EmailService.cs - Email service → SMTP server: sends email
medxplain-api/Services/EmailService.cs - App workflow → Results view: renders report
medxplain-ui/src/App.tsx - Results view → Executive summary: renders
medxplain-ui/src/components/ReportResults.tsx - Results view → Findings and advice: renders
medxplain-ui/src/components/ReportResults.tsx - Results view → Charts: renders
medxplain-ui/src/components/ReportResults.tsx - Results view → Nearby clinicians: renders
medxplain-ui/src/components/ReportResults.tsx - Results view → Email delivery panel: renders
medxplain-ui/src/components/ReportResults.tsx - App workflow → Session storage: saves and restores
medxplain-ui/src/App.tsx - Session storage → Browser local storage: reads and writes
medxplain-ui/src/utils/reportStorage.ts - Nearby clinicians → Geolocation: uses location
- Nearby clinicians → Map links: creates map links
- Email delivery panel → Report API client: requests email