Trent/vigilcare-clinical
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feature: Self-Service Clinical Testing Sessions
CI / backend (push) Successful in 8m52s
Details
CI / frontend (push) Failing after 1m39s
Details

Browse Source
This commit is contained in:
voltsrage
2026-08-06 04:03:04 +08:00
parent 1d28880920
commit 80b009fd23
41 changed files with 4922 additions and 123 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/simulator-guide.md
+16
View File
@@ -4,6 +4,8 @@ Welcome! The VigilCare Simulator lets you replay realistic hospital patient scen
Think of it as a flight simulator, but for clinical decision support.
> **Clinicians evaluating the dashboard:** you do not need this CLI. Use **Simulation** in the web app (session presets, individual scenarios, and ward reset). See [clinical-testing-guide.md](clinical-testing-guide.md). This guide is for developers, CI, and anyone running `validate`, `dry-run`, `replay-all`, `mimic-generate`, or the `scripts/run-phase*-verification.sh` suites.
---
## Table of Contents
@@ -19,6 +21,7 @@ Think of it as a flight simulator, but for clinical decision support.
9. [Troubleshooting](#9-troubleshooting)
10. [Ward Outage Scenario (Climate Resilience)](#10-ward-outage-scenario-climate-resilience)
11. [MIMIC-IV Real Patient Data](#11-mimic-iv-real-patient-data)
12. [CLI vs in-app simulation](#12-cli-vs-in-app-simulation)
---
@@ -618,3 +621,16 @@ dotnet run --project VigilCare.Simulator -- mimic-list docs/MIMIC-IV/ --stay-id
```
The table shows care unit, length of stay, and whether the patient expired -- useful for finding clinically interesting trajectories to replay.
---
## 12. CLI vs in-app simulation
| Audience | Tool |
|---|---|
| Clinicians / clinical testers | Dashboard **Simulation** page — session presets, scenario catalogue, speed control, ward reset. See [clinical-testing-guide.md](clinical-testing-guide.md). |
| Developers / CI | This CLI — `validate`, `dry-run`, `replay`, `replay-all`, `mimic-list`, `mimic-generate`, and the `scripts/run-phase*-verification.sh` suites. |
The CLI is **not deprecated**. In-app simulation (Phases 36–38) reuses the same scenario JSON files under `VigilCare.Simulator/Scenarios/` and the same `ReplayEngine`. Prefer the dashboard when a clinician should run Sessions A–D without a terminal; prefer the CLI when scripting, validating scenario files, generating MIMIC scenarios, or driving verification scripts.
In-app simulation is gated by `Simulation:Enabled` (default **false**). Never enable it against a database that holds real patient data.