# opendicom/sirius-ris architecture

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

- Interactive diagram: https://gitdiagram.com/opendicom/sirius-ris
- Repository: https://github.com/opendicom/sirius-ris

## Overview

Sirius RIS is a radiology information system: staff use its Angular web application to manage appointments and related clinical workflows through a Node.js REST backend, with MongoDB-backed domain modules. The backend also provides reporting and statistics, access control, and interfaces for MWL/DICOM services. The graph groups related domain modules rather than enumerating every CRUD endpoint. Relationships are limited to those shown in excerpts or the source index; the index does not establish frontend-to-backend request wiring, so that link is marked unverified.

Main entry points: [`backend/src/main.middlewares.js`](https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.middlewares.js) (Authorization middleware), [`backend/src/modules/appointments/routes.js`](https://github.com/opendicom/sirius-ris/blob/master/backend/src/modules/appointments/routes.js) (Appointments), [`backend/src/modules/modules.services.js`](https://github.com/opendicom/sirius-ris/blob/master/backend/src/modules/modules.services.js) (Domain services), [`backend/src/stats/routes.js`](https://github.com/opendicom/sirius-ris/blob/master/backend/src/stats/routes.js) (Statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["RIS web app"]
  node_appointments_ui["Appointment workflows"]
  node_reports_ui["Report workflows"]
end

subgraph group_domain["RIS domain"]
  node_schemas["Domain schemas"]
  node_appointments["Appointments<br/>[routes.js]"]
  node_appointment_drafts["Requests and drafts"]
  node_scheduling["Slots and calendar"]
  node_organizations["People and organizations"]
  node_performing["Exam performing"]
  node_reports["Reports and signatures"]
  node_statistics["Statistics<br/>[routes.js]"]
  node_export["Report export<br/>[routes.js]"]
end

subgraph group_platform["Backend platform"]
  node_api["REST API<br/>[index.js]"]
  node_auth["Authentication"]
  node_middleware["Authorization middleware"]
  node_services["Shared services<br/>[main.services.js]"]
  node_languages["Language loader<br/>[main.languages.js]"]
  node_domain_services["Domain services"]
end

subgraph group_integrations["External services"]
  node_database[("MongoDB")]
  node_mwl["MWL interface<br/>[routes.js]"]
  node_wezen["Wezen bridge<br/>[routes.js]"]
  node_wezen_service["Wezen"]
  node_pacs[("DICOM PACS")]
  node_mail["Mail delivery<br/>[routes.js]"]
end

node_staff(("Clinical staff"))

node_staff -->|"uses"| node_webapp
node_webapp -.->|"uses API"| node_api
node_api -.->|"routes auth"| node_auth
node_appointments_ui -.->|"calls API"| node_appointments
node_reports_ui -.->|"calls API"| node_reports
node_appointments -->|"checks access"| node_middleware
node_appointments -->|"delegates to"| node_domain_services
node_appointments -.->|"reads and writes"| node_database
node_auth -->|"checks tokens"| node_middleware
node_middleware -->|"uses helpers"| node_services
node_middleware -->|"checks permissions"| node_domain_services
node_services -->|"loads language"| node_languages
node_domain_services -->|"uses schemas"| node_schemas
node_statistics -->|"checks access"| node_middleware
node_statistics -->|"dispatches to"| node_performing
node_mwl -->|"checks access"| node_middleware
node_mwl -->|"exchanges MWL"| node_wezen_service
node_wezen -->|"integrates with"| node_wezen_service
node_wezen_service -->|"serves DICOM"| node_pacs
node_appointments -.->|"coordinates slots"| node_scheduling
node_reports -.->|"exports reports"| node_export

click node_webapp "https://github.com/opendicom/sirius-ris/tree/master/frontend/src/app"
click node_appointments_ui "https://github.com/opendicom/sirius-ris/tree/master/frontend/src/app/modules/appointments"
click node_reports_ui "https://github.com/opendicom/sirius-ris/tree/master/frontend/src/app/modules/reports"
click node_api "https://github.com/opendicom/sirius-ris/blob/master/backend/src/index.js"
click node_auth "https://github.com/opendicom/sirius-ris/tree/master/backend/src/auth"
click node_middleware "https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.middlewares.js"
click node_services "https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.services.js"
click node_languages "https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.languages.js"
click node_domain_services "https://github.com/opendicom/sirius-ris/blob/master/backend/src/modules/modules.services.js"
click node_schemas "https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules"
click node_appointments "https://github.com/opendicom/sirius-ris/blob/master/backend/src/modules/appointments/routes.js"
click node_appointment_drafts "https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/appointment_requests"
click node_scheduling "https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/slots"
click node_organizations "https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/organizations"
click node_performing "https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/performing"
click node_reports "https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/reports"
click node_statistics "https://github.com/opendicom/sirius-ris/blob/master/backend/src/stats/routes.js"
click node_export "https://github.com/opendicom/sirius-ris/blob/master/backend/src/exporter/routes.js"
click node_mwl "https://github.com/opendicom/sirius-ris/blob/master/backend/src/mwl/routes.js"
click node_wezen "https://github.com/opendicom/sirius-ris/blob/master/backend/src/wezen/routes.js"
click node_mail "https://github.com/opendicom/sirius-ris/blob/master/backend/src/mail/routes.js"

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_webapp,node_appointments_ui,node_reports_ui toneBlue
class node_schemas,node_appointments,node_appointment_drafts,node_scheduling,node_organizations,node_performing,node_reports,node_statistics,node_export toneAmber
class node_api,node_auth,node_middleware,node_services,node_languages,node_domain_services toneMint
class node_database,node_mwl,node_wezen,node_wezen_service,node_pacs,node_mail toneRose
class node_staff toneIndigo
```

## Components

### Web application

- [RIS web app](https://github.com/opendicom/sirius-ris/tree/master/frontend/src/app): `frontend/src/app`
- [Appointment workflows](https://github.com/opendicom/sirius-ris/tree/master/frontend/src/app/modules/appointments): `frontend/src/app/modules/appointments`
- [Report workflows](https://github.com/opendicom/sirius-ris/tree/master/frontend/src/app/modules/reports): `frontend/src/app/modules/reports`

### RIS domain

- [Domain schemas](https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules): `backend/src/modules`
- [Appointments](https://github.com/opendicom/sirius-ris/blob/master/backend/src/modules/appointments/routes.js): `backend/src/modules/appointments/routes.js`
- [Requests and drafts](https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/appointment_requests): `backend/src/modules/appointment_requests`
- [Slots and calendar](https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/slots): `backend/src/modules/slots`
- [People and organizations](https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/organizations): `backend/src/modules/organizations`
- [Exam performing](https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/performing): `backend/src/modules/performing`
- [Reports and signatures](https://github.com/opendicom/sirius-ris/tree/master/backend/src/modules/reports): `backend/src/modules/reports`
- [Statistics](https://github.com/opendicom/sirius-ris/blob/master/backend/src/stats/routes.js): `backend/src/stats/routes.js`
- [Report export](https://github.com/opendicom/sirius-ris/blob/master/backend/src/exporter/routes.js): `backend/src/exporter/routes.js`

### Backend platform

- [REST API](https://github.com/opendicom/sirius-ris/blob/master/backend/src/index.js): `backend/src/index.js`
- [Authentication](https://github.com/opendicom/sirius-ris/tree/master/backend/src/auth): `backend/src/auth`
- [Authorization middleware](https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.middlewares.js): `backend/src/main.middlewares.js`
- [Shared services](https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.services.js): `backend/src/main.services.js`
- [Language loader](https://github.com/opendicom/sirius-ris/blob/master/backend/src/main.languages.js): `backend/src/main.languages.js`
- [Domain services](https://github.com/opendicom/sirius-ris/blob/master/backend/src/modules/modules.services.js): `backend/src/modules/modules.services.js`

### External services

- **MongoDB**
- [MWL interface](https://github.com/opendicom/sirius-ris/blob/master/backend/src/mwl/routes.js): `backend/src/mwl/routes.js`
- [Wezen bridge](https://github.com/opendicom/sirius-ris/blob/master/backend/src/wezen/routes.js): `backend/src/wezen/routes.js`
- **Wezen**
- **DICOM PACS**
- [Mail delivery](https://github.com/opendicom/sirius-ris/blob/master/backend/src/mail/routes.js): `backend/src/mail/routes.js`

### Other components

- **Clinical staff**

## Connections

- Clinical staff → RIS web app: uses (evidence: `README.md`)
- RIS web app → REST API: uses API
- REST API → Authentication: routes auth
- Appointment workflows → Appointments: calls API
- Report workflows → Reports and signatures: calls API
- Appointments → Authorization middleware: checks access (evidence: `backend/src/modules/appointments/routes.js`)
- Appointments → Domain services: delegates to (evidence: `backend/src/modules/appointments/routes.js`)
- Appointments → MongoDB: reads and writes
- Authentication → Authorization middleware: checks tokens (evidence: `backend/src/auth/routes.js`)
- Authorization middleware → Shared services: uses helpers (evidence: `backend/src/main.middlewares.js`)
- Authorization middleware → Domain services: checks permissions (evidence: `backend/src/main.middlewares.js`)
- Shared services → Language loader: loads language (evidence: `backend/src/main.services.js`)
- Domain services → Domain schemas: uses schemas (evidence: `backend/src/modules/modules.services.js`)
- Statistics → Authorization middleware: checks access (evidence: `backend/src/stats/routes.js`)
- Statistics → Exam performing: dispatches to (evidence: `backend/src/stats/routes.js`)
- MWL interface → Authorization middleware: checks access (evidence: `backend/src/mwl/routes.js`)
- MWL interface → Wezen: exchanges MWL (evidence: `README.md`)
- Wezen bridge → Wezen: integrates with (evidence: `README.md`)
- Wezen → DICOM PACS: serves DICOM (evidence: `README.md`)
- Appointments → Slots and calendar: coordinates slots
- Reports and signatures → Report export: exports reports
