How bahmni/bahmni-apps-frontend works
Bahmni Apps Frontend is a React/TypeScript healthcare monorepo: a browser-hosted suite of clinical, patient, scheduling, administrative, reporting, and document workflows backed by shared services and widgets. Users enter through the distro shell or an app, then use domain screens to search or manage patient and encounter data. The graph highlights registration and encounter-session behavior where source was sampled, while retaining major app areas visible in the tree. Unsampled app internals and shell-to-app wiring are not asserted; dashed edges indicate unverified integration.
Main entry points: app.tsx Browser shell · api.ts Service API client · useRelationshipManager.ts Relationship manager · ConsultationPage.tsx Clinical consultation
Components 20
Application shell
- Browser shell
distro/src/app/app.tsx - Administration
apps/admin/src/pages/AuditLog.tsx - Appointments
apps/appointments/src/routes/index.tsx - Reports
apps/reports/src/routes/index.tsx - Home dashboard
apps/home/src/components/HomePage/HomePage.tsx
Patient workflows
- Patient registration
apps/registration/src/pages/PatientRegister/PatientRegister.tsx - Relationship manager
apps/registration/src/components/forms/patientRelationships/useRelationshipManager.ts - Patient search
apps/registration/src/hooks/usePatientSearch.ts - Relationship validation
apps/registration/src/hooks/useRelationshipValidation.ts - Patient documents
apps/patient-documents/src/pages/Index.tsx
Clinical workflows
- Clinical consultation
apps/clinical/src/pages/ConsultationPage.tsx - Clinical forms
apps/clinical/src/components/forms/renderer.tsx - Encounter sessions
packages/bahmni-services/src/encounterSessionService/encounterSessionService.ts
Shared platform
- Service API client
packages/bahmni-services/src/api/api.ts - Session authentication
packages/bahmni-services/src/authService/authService.ts - Reusable widgets
packages/bahmni-widgets/src/commandPalette/useCommandPaletteSearch.ts - Design system
packages/bahmni-design-system/src/atoms/button/index.tsx - Command palette
apps/command-palette/src/components/CommandPaletteProvider/CommandPaletteProvider.tsx
Other components
- Healthcare user
- OpenMRS FHIR service
Connections 21
- Healthcare user → Browser shell: opens app
- Browser shell → Administration: hosts app
- Browser shell → Appointments: hosts app
- Browser shell → Clinical consultation: hosts app
- Browser shell → Patient registration: hosts app
- Browser shell → Patient documents: hosts app
- Browser shell → Reports: hosts app
- Browser shell → Home dashboard: hosts app
- Patient registration → Relationship manager: uses relationships
- Relationship manager → Patient search: searches patients
apps/registration/src/components/forms/patientRelationships/useRelationshipManager.ts - Relationship manager → Relationship validation: validates rows
apps/registration/src/components/forms/patientRelationships/useRelationshipManager.ts - Patient search → Service API client: searches records
- Clinical consultation → Clinical forms: renders forms
- Clinical consultation → Encounter sessions: checks session
- Encounter sessions → Service API client: requests data
packages/bahmni-services/src/encounterSessionService/encounterSessionService.ts - Encounter sessions → OpenMRS FHIR service: queries encounters
- Session authentication → Service API client: checks session
packages/bahmni-services/src/authService/authService.ts - Service API client → OpenMRS FHIR service: transfers FHIR data
- Command palette → Reusable widgets: uses search
- Reusable widgets → Service API client: searches patients
- Browser shell → Design system: applies theme