How mahim2077/healthlink works
HealthLink is a healthcare platform with Citizen, Professional, and Admin portals. Its principal workflow runs from portal sign-in and role/ownership checks through care discovery, appointments, consultations, and access to clinical records; diagnostic sessions and finalized reports form a distinct lab workflow. The README also documents administration, scoped access and auditing, reminders, emergency profiles, and consent-based AI. Edges use README statements or shown source references; unsampled feature internals are represented at their existing directory paths.
Main entry points: main.py FastAPI API · session_service.py Diagnostic sessions · dashboard/page.tsx Citizen portal · dashboard/page.tsx Professional portal
Components 27
Portals and API
- Citizen portal
frontend/src/app/citizen/dashboard/page.tsx - Professional portal
frontend/src/app/professional/dashboard/page.tsx - Admin portal
frontend/src/app/admin/dashboard/page.tsx - FastAPI API
backend/app/main.py
Identity and Administration
- Authentication
backend/app/auth/service.py - Auth context
backend/app/auth/dependencies.py - Citizen identity
backend/app/citizens/service.py - Professional roles
backend/app/professionals/service.py - Admin services
backend/app/admins/service.py - Facility management
backend/app/facilities/service.py
Care Delivery
- Doctor discovery
backend/app/doctors/service.py - Appointments
backend/app/appointments/service.py - Consultation visits
backend/app/visits/service.py - Prescriptions
backend/app/prescriptions/service.py
Records and Diagnostics
- Medical history
backend/app/medical_records/service.py - Diagnostic sessions
backend/app/diagnostics/session_service.py - Diagnostic reports
backend/app/diagnostics/report_service.py - Emergency profiles
backend/app/emergency/service.py
Access and Assistance
- Clinical read policy
backend/app/access/policy.py - Access audit
backend/app/clinical_audit/service.py - Reminders and inbox
backend/app/reminders/service.py - AI assistance
backend/app/ai/assistant_service.py - PostgreSQL
Other components
- Citizen
- Professional
- Administrator
- Groq AI
Connections 29
- Citizen → Citizen portal: uses
README.md - Professional → Professional portal: uses
README.md - Administrator → Admin portal: uses
README.md - Citizen portal → FastAPI API: calls API
README.md - Professional portal → FastAPI API: calls API
README.md - Admin portal → FastAPI API: calls API
README.md - FastAPI API → Authentication: authenticates
- Auth context → Authentication: validates session
backend/app/auth/dependencies.py - FastAPI API → Citizen identity: serves identity
- FastAPI API → Professional roles: serves roles
- FastAPI API → Admin services: serves admin
- FastAPI API → Facility management: manages facilities
- FastAPI API → Doctor discovery: serves discovery
- FastAPI API → Appointments: serves booking
- FastAPI API → Consultation visits: serves visits
- FastAPI API → Prescriptions: serves prescriptions
- FastAPI API → Medical history: serves history
- FastAPI API → Diagnostic sessions: serves sessions
backend/app/diagnostics/session_service.py - FastAPI API → Diagnostic reports: serves reports
- FastAPI API → Emergency profiles: serves profiles
- FastAPI API → Reminders and inbox: serves reminders
- FastAPI API → AI assistance: serves assistant
- FastAPI API → Clinical read policy: checks access
- FastAPI API → Access audit: records access
- Appointments → PostgreSQL: persists data
- Diagnostic sessions → Access audit: records actions
backend/app/diagnostics/session_service.py - Diagnostic sessions → Reminders and inbox: creates notices
backend/app/diagnostics/session_service.py - FastAPI API → PostgreSQL: opens sessions
- AI assistance → Groq AI: generates explanations
README.md