How 333ian/hospital-managemnet-api works
This is a Django REST API for hospital operations. Users and staff authenticate and access role-based endpoints for patient records, appointments, consultations, laboratory work, pharmacy, and billing. Clinical encounters and lab requests/results are distinct domain stages; dispensing and lab completion can also create billing entries through Django signals. Billing supports payments and downloadable PDF invoices. The graph reflects documented capabilities and sampled model/API behavior; unsampled route wiring and some subsystem details are left unlinked where evidence is unavailable.
Main entry points: billing/models.py Invoices & payments · urls.py API routing · clinical/models.py Appointments & encounters · lab/models.py Lab tests & results
Components 21
Identity & Access
- Accounts & profiles
hms_backend/users/models.py - User endpoints
hms_backend/users/viewsets.py - User serialization
hms_backend/users/serializers.py
Clinical Care
- Appointments & encounters
hms_backend/clinical/models.py - Clinical endpoints
hms_backend/clinical/viewsets.py - Clinical serialization
hms_backend/clinical/serializers.py - Clinical permissions
hms_backend/clinical/permissions.py - Clinical billing signals
hms_backend/clinical/signals.py
Laboratory
- Lab tests & results
hms_backend/lab/models.py - Lab endpoints
hms_backend/lab/viewsets.py - Lab serialization
hms_backend/lab/serializers.py - Lab billing signals
hms_backend/lab/signals.py
Pharmacy
- Medication & stock
hms_backend/pharmacy/models.py - Pharmacy endpoints
hms_backend/pharmacy/viewsets.py - Dispensing & stock alerts
hms_backend/pharmacy/signals.py
Billing
- Invoices & payments
hms_backend/billing/models.py - Billing & PDF endpoints
hms_backend/billing/viewsets.py - Billing serialization
hms_backend/billing/serializers.py
Other components
- API clients
- API routing
hms_backend/hms_backend/urls.py - PostgreSQL
Connections 34
- API clients → API routing: sends API requests
README.md - API routing → User endpoints: routes requests
- API routing → Clinical endpoints: routes requests
- API routing → Lab endpoints: routes requests
- API routing → Pharmacy endpoints: routes requests
- API routing → Billing & PDF endpoints: routes requests
- User endpoints → User serialization: serializes users
hms_backend/users/viewsets.py - User serialization → Accounts & profiles: reads profiles
hms_backend/users/serializers.py - Clinical endpoints → Clinical permissions: checks access
hms_backend/clinical/viewsets.py - Clinical endpoints → Clinical serialization: serializes encounters
hms_backend/clinical/viewsets.py - Clinical endpoints → Appointments & encounters: queries encounters
hms_backend/clinical/viewsets.py - Clinical serialization → Appointments & encounters: serializes models
hms_backend/clinical/serializers.py - Appointments & encounters → Accounts & profiles: references care roles
hms_backend/clinical/models.py - Clinical billing signals → Appointments & encounters: observes records
hms_backend/clinical/signals.py - Clinical billing signals → Invoices & payments: creates billing records
hms_backend/clinical/signals.py - Lab endpoints → Lab serialization: serializes lab data
hms_backend/lab/viewsets.py - Lab endpoints → Lab tests & results: queries lab records
hms_backend/lab/viewsets.py - Lab serialization → Lab tests & results: serializes models
hms_backend/lab/serializers.py - Lab tests & results → Accounts & profiles: references care roles
hms_backend/lab/models.py - Lab billing signals → Lab tests & results: observes lab records
hms_backend/lab/signals.py - Lab billing signals → Invoices & payments: creates billing records
hms_backend/lab/signals.py - Pharmacy endpoints → Medication & stock: manages inventory
- Dispensing & stock alerts → Medication & stock: handles dispensing
hms_backend/pharmacy/signals.py - Dispensing & stock alerts → Invoices & payments: creates invoice items
hms_backend/pharmacy/signals.py - Billing & PDF endpoints → Billing serialization: serializes billing
hms_backend/billing/viewsets.py - Billing & PDF endpoints → Invoices & payments: records payments
hms_backend/billing/viewsets.py - Billing serialization → Invoices & payments: serializes models
hms_backend/billing/serializers.py - Invoices & payments → Accounts & profiles: references patients
hms_backend/billing/models.py - Invoices & payments → Appointments & encounters: references appointments
hms_backend/billing/models.py - Accounts & profiles → PostgreSQL: persists records
README.md - Appointments & encounters → PostgreSQL: persists encounters
README.md - Lab tests & results → PostgreSQL: persists results
README.md - Medication & stock → PostgreSQL: persists stock
README.md - Invoices & payments → PostgreSQL: persists billing
README.md