How x0r909/simrs works
SIMRS v2 is a hospital operations platform with staff and patient portals, a NestJS API, and PostgreSQL-backed services. Users enter through role-specific web dashboards or login/registration; the API authenticates and authorizes requests, then handles clinical, administrative, and operational work. The README documents the broader capabilities, while sampled controllers confirm several API-to-service calls. Other domain connections and integrations are shown only where documented; unsampled internals are not inferred as inspected.
Main entry points: api.ts Frontend API client · prisma.service.ts PostgreSQL data · auth.service.ts Authentication · appointments.controller.ts Appointments
Components 22
Web portals
- Role dashboards
apps/frontend/src/app/(dashboard)/doctor/page.tsx - Patient signup
apps/frontend/src/app/signup/page.tsx - Frontend API client
apps/frontend/src/lib/api.ts - Login pages
apps/frontend/src/app/login/page.tsx
Identity and access
- Authentication
apps/backend/src/modules/auth/auth.service.ts - Access policies
apps/backend/src/common/auth/policy.engine.ts - Redis sessions
apps/backend/src/modules/auth/session.service.ts
Clinical operations
- Patient records
apps/backend/src/modules/patients/patients.controller.ts - Appointments
apps/backend/src/modules/appointments/appointments.controller.ts - Visits and records
apps/backend/src/modules/medical-records/medical-records.controller.ts - Laboratory
apps/backend/src/modules/laboratory/laboratory.controller.ts - Radiology
apps/backend/src/modules/radiology/radiology.controller.ts - Other clinical modules
apps/backend/src/modules - File handling
apps/backend/src/modules/files/files.controller.ts
Administration and operations
- Audit logs
apps/backend/src/modules/audit-logs/audit-logs.service.ts - System settings
apps/backend/src/modules/system-settings/system-settings.service.ts - Database backup
apps/backend/src/modules/backup/backup.service.ts - Reports and health
apps/backend/src/modules/reports/reports.service.ts
Shared platform services
- PostgreSQL data
apps/backend/src/shared/prisma/prisma.service.ts - Hospital context
apps/backend/src/shared/context/hospital-context.service.ts - MinIO storage
apps/backend/src/shared/storage/minio.service.ts
Other components
- Staff and patients
Connections 27
- Staff and patients → Login pages: signs in
README.md - Staff and patients → Patient signup: registers
README.md - Staff and patients → Role dashboards: uses role portal
README.md - Login pages → Frontend API client: submits credentials
- Patient signup → Frontend API client: submits registration
- Role dashboards → Frontend API client: requests operations
- Frontend API client → Authentication: calls API
README.md - Frontend API client → Patient records: calls API
- Frontend API client → Appointments: calls API
- Frontend API client → Visits and records: calls API
- Frontend API client → Laboratory: calls API
- Frontend API client → Radiology: calls API
- Authentication → Redis sessions: manages sessions
apps/backend/src/modules/auth/auth.service.ts - Authentication → Audit logs: records security events
apps/backend/src/modules/auth/auth.service.ts - Authentication → System settings: checks maintenance mode
apps/backend/src/modules/auth/auth.service.ts - Access policies → Visits and records: protects records
apps/backend/src/modules/medical-records/medical-records.controller.ts - Appointments → PostgreSQL data: reads and writes
- Appointments → Hospital context: uses hospital scope
- Appointments → Audit logs: records actions
- Laboratory → PostgreSQL data: reads and writes
- Patient records → PostgreSQL data: reads and writes
- Visits and records → PostgreSQL data: reads and writes
- File handling → MinIO storage: uploads and downloads
apps/backend/src/modules/files/files.controller.ts - Database backup → PostgreSQL data: backs up and restores
README.md - Reports and health → PostgreSQL data: queries operational data
- Other clinical modules → PostgreSQL data: persists clinical data
README.md - System settings → PostgreSQL data: stores settings