How ritheesh-chittimalla/mediqon works
Mediqon is a healthcare portal for patient and clinician workflows, with multi-disease risk assessments as a documented end-to-end path: patients submit assessment data, the NestJS API delegates predictions to a Python ML service, and prediction history is persisted. The portal also supports accounts, doctor discovery, appointment management, records, vitals, wellness, and assistant experiences. The README documents Gemini explanations and Vapi voice booking; their detailed wiring is not fully visible in the sampled source, so those links are shown only at the documented integration boundary.
Main entry points: api.js API client · database.config.ts PostgreSQL · ml.service.ts Prediction orchestration · main.py FastAPI prediction API
Components 23
Patient portal
- React app and routes
Mediqon-frontend/src/App.jsx - Disease assessments
Mediqon-frontend/src/pages/predictions/HeartAssessment.jsx - Health portal
Mediqon-frontend/src/pages/Dashboard.jsx - Doctor booking
Mediqon-frontend/src/pages/Bookings.jsx - Assistant experiences
Mediqon-frontend/src/pages/Assistant.jsx - Login and registration
Mediqon-frontend/src/pages/Login.jsx - API client
Mediqon-frontend/src/lib/api.js
NestJS backend
- Auth endpoints
mediqon-backend/src/modules/auth/auth.controller.ts - Auth service
mediqon-backend/src/modules/auth/auth.service.ts - Doctor discovery
mediqon-backend/src/modules/doctor/doctor.controller.ts - Appointment endpoints
mediqon-backend/src/modules/appointment/appointment.controller.ts - Appointment service
mediqon-backend/src/modules/appointment/appointment.service.ts - Voice booking endpoints
mediqon-backend/src/modules/vapi/vapi.controller.ts - Prediction endpoints
mediqon-backend/src/modules/ml/ml.controller.ts - Prediction orchestration
mediqon-backend/src/modules/ml/ml.service.ts - PostgreSQL
mediqon-backend/src/config/database.config.ts
Prediction service
- FastAPI prediction API
ml-service/app/main.py - Heart risk model
ml-service/app/services/heart.py - Diabetes risk model
ml-service/app/services/diabetes.py - Kidney risk model
ml-service/app/services/kidney.py
External services
- Google Gemini
- Vapi voice service
Other components
- Patient
Connections 29
- Patient → React app and routes: uses
- React app and routes → Login and registration: routes to
- Login and registration → API client: requests
- API client → Auth endpoints: calls
- Auth endpoints → Auth service: delegates
- Auth service → PostgreSQL: reads/writes users
- Patient → Disease assessments: enters measures
- Disease assessments → API client: submits inputs
- API client → Prediction endpoints: calls
- Prediction endpoints → Prediction orchestration: delegates
- Prediction orchestration → FastAPI prediction API: forwards prediction
- FastAPI prediction API → Heart risk model: runs heart model
- FastAPI prediction API → Diabetes risk model: runs diabetes model
- FastAPI prediction API → Kidney risk model: runs kidney model
- Prediction orchestration → PostgreSQL: persists history
- Prediction orchestration → Google Gemini: requests explanation
- Patient → Doctor booking: seeks appointment
- Doctor booking → API client: requests
- API client → Doctor discovery: calls
- API client → Appointment endpoints: calls
- Doctor discovery → PostgreSQL: reads doctors and slots
- Appointment endpoints → Appointment service: delegates
- Appointment service → PostgreSQL: reads/writes bookings
- Patient → Assistant experiences: uses
- Assistant experiences → API client: requests
- Vapi voice service → Voice booking endpoints: calls booking tools
- Voice booking endpoints → Appointment service: books appointments
- Voice booking endpoints → PostgreSQL: queries records
- Patient → Health portal: views health data