# x0r909/simrs architecture

> Architecture diagram of the GitHub repository x0r909/simrs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/x0r909/simrs
- Repository: https://github.com/x0r909/simrs

## Overview

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: [`apps/frontend/src/lib/api.ts`](https://github.com/x0r909/simrs/blob/main/apps/frontend/src/lib/api.ts) (Frontend API client), [`apps/backend/src/shared/prisma/prisma.service.ts`](https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/prisma/prisma.service.ts) (PostgreSQL data), [`apps/backend/src/modules/auth/auth.service.ts`](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/auth/auth.service.ts) (Authentication), [`apps/backend/src/modules/appointments/appointments.controller.ts`](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/appointments/appointments.controller.ts) (Appointments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portals"]
  node_portal["Role dashboards<br/>[page.tsx]"]
  node_signup["Patient signup<br/>[page.tsx]"]
  node_webapi["Frontend API client<br/>[api.ts]"]
  node_authui["Login pages<br/>[page.tsx]"]
end

subgraph group_security["Identity and access"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_access["Access policies<br/>[policy.engine.ts]"]
  node_sessions["Redis sessions<br/>[session.service.ts]"]
end

subgraph group_clinical["Clinical operations"]
  node_patients["Patient records"]
  node_appointments["Appointments"]
  node_visits["Visits and records"]
  node_laboratory["Laboratory"]
  node_radiology["Radiology"]
  node_clinicalother["Other clinical modules"]
  node_files["File handling"]
end

subgraph group_admin["Administration and operations"]
  node_audit["Audit logs"]
  node_settings["System settings"]
  node_backup["Database backup<br/>[backup.service.ts]"]
  node_reporting["Reports and health<br/>[reports.service.ts]"]
end

subgraph group_platform["Shared platform services"]
  node_db[("PostgreSQL data<br/>[prisma.service.ts]")]
  node_context["Hospital context"]
  node_objectstore[("MinIO storage<br/>[minio.service.ts]")]
end

node_user(("Staff and patients"))

node_user -->|"signs in"| node_authui
node_user -->|"registers"| node_signup
node_user -->|"uses role portal"| node_portal
node_authui -.->|"submits credentials"| node_webapi
node_signup -.->|"submits registration"| node_webapi
node_portal -.->|"requests operations"| node_webapi
node_webapi -->|"calls API"| node_auth
node_webapi -.->|"calls API"| node_patients
node_webapi -.->|"calls API"| node_appointments
node_webapi -.->|"calls API"| node_visits
node_webapi -.->|"calls API"| node_laboratory
node_webapi -.->|"calls API"| node_radiology
node_auth -->|"manages sessions"| node_sessions
node_auth -->|"records security events"| node_audit
node_auth -->|"checks maintenance mode"| node_settings
node_access -->|"protects records"| node_visits
node_appointments -->|"reads and writes"| node_db
node_appointments -->|"uses hospital scope"| node_context
node_appointments -->|"records actions"| node_audit
node_laboratory -.->|"reads and writes"| node_db
node_patients -.->|"reads and writes"| node_db
node_visits -.->|"reads and writes"| node_db
node_files -->|"uploads and downloads"| node_objectstore
node_backup -->|"backs up and restores"| node_db
node_reporting -.->|"queries operational data"| node_db
node_clinicalother -->|"persists clinical data"| node_db
node_settings -.->|"stores settings"| node_db

click node_portal "https://github.com/x0r909/simrs/blob/main/apps/frontend/src/app/(dashboard)/doctor/page.tsx"
click node_signup "https://github.com/x0r909/simrs/blob/main/apps/frontend/src/app/signup/page.tsx"
click node_webapi "https://github.com/x0r909/simrs/blob/main/apps/frontend/src/lib/api.ts"
click node_authui "https://github.com/x0r909/simrs/blob/main/apps/frontend/src/app/login/page.tsx"
click node_auth "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/auth/auth.service.ts"
click node_access "https://github.com/x0r909/simrs/blob/main/apps/backend/src/common/auth/policy.engine.ts"
click node_sessions "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/auth/session.service.ts"
click node_patients "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/patients/patients.controller.ts"
click node_appointments "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/appointments/appointments.controller.ts"
click node_visits "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/medical-records/medical-records.controller.ts"
click node_laboratory "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/laboratory/laboratory.controller.ts"
click node_radiology "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/radiology/radiology.controller.ts"
click node_clinicalother "https://github.com/x0r909/simrs/tree/main/apps/backend/src/modules"
click node_files "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/files/files.controller.ts"
click node_audit "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/audit-logs/audit-logs.service.ts"
click node_settings "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/system-settings/system-settings.service.ts"
click node_backup "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/backup/backup.service.ts"
click node_reporting "https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/reports/reports.service.ts"
click node_db "https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/prisma/prisma.service.ts"
click node_context "https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/context/hospital-context.service.ts"
click node_objectstore "https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/storage/minio.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_portal,node_signup,node_webapi,node_authui toneBlue
class node_auth,node_access,node_sessions toneAmber
class node_patients,node_appointments,node_visits,node_laboratory,node_radiology,node_clinicalother,node_files toneMint
class node_audit,node_settings,node_backup,node_reporting toneRose
class node_db,node_context,node_objectstore,node_user toneIndigo
```

## Components

### Web portals

- [Role dashboards](https://github.com/x0r909/simrs/blob/main/apps/frontend/src/app/(dashboard)/doctor/page.tsx): `apps/frontend/src/app/(dashboard)/doctor/page.tsx`
- [Patient signup](https://github.com/x0r909/simrs/blob/main/apps/frontend/src/app/signup/page.tsx): `apps/frontend/src/app/signup/page.tsx`
- [Frontend API client](https://github.com/x0r909/simrs/blob/main/apps/frontend/src/lib/api.ts): `apps/frontend/src/lib/api.ts`
- [Login pages](https://github.com/x0r909/simrs/blob/main/apps/frontend/src/app/login/page.tsx): `apps/frontend/src/app/login/page.tsx`

### Identity and access

- [Authentication](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/auth/auth.service.ts): `apps/backend/src/modules/auth/auth.service.ts`
- [Access policies](https://github.com/x0r909/simrs/blob/main/apps/backend/src/common/auth/policy.engine.ts): `apps/backend/src/common/auth/policy.engine.ts`
- [Redis sessions](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/auth/session.service.ts): `apps/backend/src/modules/auth/session.service.ts`

### Clinical operations

- [Patient records](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/patients/patients.controller.ts): `apps/backend/src/modules/patients/patients.controller.ts`
- [Appointments](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/appointments/appointments.controller.ts): `apps/backend/src/modules/appointments/appointments.controller.ts`
- [Visits and records](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/medical-records/medical-records.controller.ts): `apps/backend/src/modules/medical-records/medical-records.controller.ts`
- [Laboratory](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/laboratory/laboratory.controller.ts): `apps/backend/src/modules/laboratory/laboratory.controller.ts`
- [Radiology](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/radiology/radiology.controller.ts): `apps/backend/src/modules/radiology/radiology.controller.ts`
- [Other clinical modules](https://github.com/x0r909/simrs/tree/main/apps/backend/src/modules): `apps/backend/src/modules`
- [File handling](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/files/files.controller.ts): `apps/backend/src/modules/files/files.controller.ts`

### Administration and operations

- [Audit logs](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/audit-logs/audit-logs.service.ts): `apps/backend/src/modules/audit-logs/audit-logs.service.ts`
- [System settings](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/system-settings/system-settings.service.ts): `apps/backend/src/modules/system-settings/system-settings.service.ts`
- [Database backup](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/backup/backup.service.ts): `apps/backend/src/modules/backup/backup.service.ts`
- [Reports and health](https://github.com/x0r909/simrs/blob/main/apps/backend/src/modules/reports/reports.service.ts): `apps/backend/src/modules/reports/reports.service.ts`

### Shared platform services

- [PostgreSQL data](https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/prisma/prisma.service.ts): `apps/backend/src/shared/prisma/prisma.service.ts`
- [Hospital context](https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/context/hospital-context.service.ts): `apps/backend/src/shared/context/hospital-context.service.ts`
- [MinIO storage](https://github.com/x0r909/simrs/blob/main/apps/backend/src/shared/storage/minio.service.ts): `apps/backend/src/shared/storage/minio.service.ts`

### Other components

- **Staff and patients**

## Connections

- Staff and patients → Login pages: signs in (evidence: `README.md`)
- Staff and patients → Patient signup: registers (evidence: `README.md`)
- Staff and patients → Role dashboards: uses role portal (evidence: `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 (evidence: `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 (evidence: `apps/backend/src/modules/auth/auth.service.ts`)
- Authentication → Audit logs: records security events (evidence: `apps/backend/src/modules/auth/auth.service.ts`)
- Authentication → System settings: checks maintenance mode (evidence: `apps/backend/src/modules/auth/auth.service.ts`)
- Access policies → Visits and records: protects records (evidence: `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 (evidence: `apps/backend/src/modules/files/files.controller.ts`)
- Database backup → PostgreSQL data: backs up and restores (evidence: `README.md`)
- Reports and health → PostgreSQL data: queries operational data
- Other clinical modules → PostgreSQL data: persists clinical data (evidence: `README.md`)
- System settings → PostgreSQL data: stores settings
