標準仕様書の条項を、87ユースケースと111エンティティへ。
仕様書と別紙から単一の真実源(SSoT)receipt-computer.dslmodel.json を作り、そこからアクティビティ図26・ユースケース仕様87・クラス図(11パッケージ)・状態機械23・シーケンス図162を生成しました。すべての要素が仕様書の参照箇所と引用文(_source)を持ち、画面上の「UC-xxx」「BR-xxx」はそのままモデルと標準仕様の条項を指します。モデル検証は 27/27 PASS(警告0・スコア100)です。
111エンティティを11パッケージに分割したクラス図です。クリックすると原寸で開きます(数字はエンティティ数)。
本ページは、標準仕様書からのモデル駆動開発の概要と、生成したアプリケーションの操作マニュアルをまとめたものです。画面・ボタン名は実装に準拠しています。
- 対象アプリ: 中小病院向け電子カルテ及びレセプトコンピュータ(参照実装)
- 構成: フロントエンド(React + TypeScript)+ バックエンド(Express REST API + Prisma)
- 設計トレース: 標準仕様書(基本要件)第1.0版 → 業務シナリオ → アクティビティ図 / ユースケース図 / クラス図 / 状態機械図 → 実装
01仕様書からの生成
入力は公開された標準仕様書と3つの別紙だけです。人手で書いたのはSSoT の JSON と生成スクリプトだけで、設計文書・実装・テストはすべてそこから再生成できます。
| 成果物 | 数量 |
|---|---|
| ユースケース(業務ロジック実装済み) | 87 / 87 |
| ドメインエンティティ / 状態機械 | 111 / 23 |
| 業務ルール(標準仕様の規定) | 99 |
| 専用業務API / 画面 | 157 / 23 |
| テスト(単体22・統合131・E2E4) | 153 |
| End-to-End 完全追跡 | 87 / 87(100%) |
1.1 入力と単一の真実源(SSoT)
| 入力 | 使ったところ |
|---|---|
| 中小病院向け電子カルテ及びレセプトコンピュータ標準仕様書(基本要件 第1.0版) | 業務ルール99件、遵守・推奨・不可・参考の4類型、経過措置 |
| 第1章別紙様式1 電子カルテ提示対象機能一覧 | 機能要件の粒度と項番(出典の引用元) |
| 第1章別紙3 IPA「非機能要求グレード」に基づく要開示項目一覧 | 稼働率・RTO/RLO・レスポンス目標などの開示項目 |
SSoT は5つの関心事で構成されます。strategy(ビジョン1・ゴール8・ケイパビリティ21・ロール14)、domain(エンティティ111・列挙型63)、process(業務プロセス26・アクション242・分岐50)、state(状態機械23・状態110・遷移115)、cross-cutting(業務ルール99)。例えば三点認証のルール BR-014 は「別紙様式1 項番70-76」と引用文を保持し、実装コードとテストの両方からそのIDを参照します。
1.2 工程(uml-workflow-v3 の10ステップ)
spec-to-scenario で仕様書を SSoT と業務シナリオに変え、uml-workflow-v3 の10ステップで設計・実装・テスト・追跡までを生成しました。
| Step | スキル | 成果物 |
|---|---|---|
| 1 | scenario-to-activity | アクティビティ図26(レーン・分岐50・ループ15) |
| 2 | activity-to-usecase | ユースケース仕様87・拡張75・ユースケース図52 |
| 3 | usecase-to-class | ドメインモデル(111エンティティ・236関連・11パッケージ)とアーキテクチャ文書 |
| 4 | class-to-statemachine | 状態機械23(ガード21)と検証用TS |
| 5 | usecase-to-sequence | シーケンス図162(主87・拡張75) |
| 6 | model-validator | 検証 27/27 PASS(警告0・スコア100) |
| 7 | security-design | ロール19・遷移ポリシー115・機密項目403 |
| 8 | usecase-to-code | Prismaスキーマ111モデル、バックエンドAPI157、画面23 |
| 9 | usecase-to-test | 単体22・統合131・E2E4のテスト |
| 10 | traceability-matrix | トレーサビリティ行列(JSON / Markdown) |
02はじめに
本アプリは、中小病院の外来・入院・在宅の診療業務と、レセプト請求・運用・調達までを一体で扱うシステムです。
| 区分 | 機能 |
|---|---|
| 外来 | 外来予約、資格確認、受付(窓口・自動再来受付機・アプリ)、救急受付とトリアージ、仮登録の同定・本登録、診察終了とレセコン連携 |
| 診療記録 | SOAP 記載と確定・承認、病名登録、問診回答の確認、紹介状の作成・送付 |
| オーダ | 処方(禁忌薬・重複・極量チェック、電子処方箋)、注射(注射箋・ラベル・三点認証)、検査、化学療法、手術・輸血、食事・栄養、リハビリ |
| 入院・病棟 | 入院予約・確定、入院診療計画書、持参薬、経過表・看護記録・看護計画・褥瘡評価、転棟・転床、看護管理日誌、退院オーダ・退院サマリ・退院確定、病床マップ |
| 在宅・健診 | 訪問診療/訪問看護/訪問リハビリの指示書・計画・記録、健診の予約・受付、保健指導、主治医意見書と請求書の電送 |
| 医事 | 診療報酬の算定、患者負担金の会計、電子レセプトの作成、請求 |
| 外部連携 | 医療DXサービス群への接続、電子カルテ情報共有サービスへの登録、FHIR API(認証・レート制限・監査ログ)、マスタ同期 |
| 運用 | マスタ保守、利用者登録と最小権限、アカウント棚卸し、オプション機能の有効化、アクセスログ |
| ベンダー運用 | 脆弱性診断、リリース、セキュリティパッチ、障害復旧・DR、稼働率評価、情報開示、改定対応と準拠の標榜 |
| 導入 | 公開価格の比較・情報開示の要請・製品選定、共通レイアウトでのデータ移行 |
代表的なアクター:受付・医事担当者 / 医師 / 看護師 / 看護管理者 / 臨床検査技師 / コメディカル(理学療法士・管理栄養士)/ 健診担当 / 選定・調達担当 / 情報システム / ベンダーの運用保守担当 / 患者 / 外部サービス。
03起動とログイン
3.1 起動手順
Node.js 18 以降が必要です。ターミナルを2つ使います。
# ① バックエンド(REST API / ポート 3001)
cd app/backend
npm install # 初回のみ
npx prisma generate && npx prisma db push # 初回のみ(SQLite: dev.db を作成)
npx ts-node src/seed.ts # デモデータ投入(既存データは削除)
npm run dev
# ② フロントエンド(画面 / ポート 5173)
cd app/frontend
npm install # 初回のみ
npm run dev
ブラウザで http://localhost:5173/ を開きます。フロントエンドは /api と /fhir へのアクセスをバックエンド(3001番)へ転送します。
3.2 医療機関の利用者でログイン
開発用の二要素認証コードは 000000 です。5回失敗するとアカウントがロックされます(BR-040)。選んだ利用者の医療機関と権限で、以降の画面の見え方と操作可否が変わります。
| ログインID | 氏名 | 職種・ロール | よく使う画面 |
|---|---|---|---|
| S-reception | 高橋 恵 | 医事 / reception_clerk | 受付 |
| S-doctor | 佐藤 一郎 | 医師 / physician | 患者カルテ・処方・オーダ・検査・在宅 |
| S-nurse | 鈴木 花子 | 看護師 / nurse | 病棟看護・注射実施 |
| S-nursemgr | 山本 師長 | 看護師 / nurse_manager | 病床マップ・入退院・看護管理日誌の承認 |
| S-lab | 渡辺 検 | 臨床検査技師 / examination_staff | 検査 |
| S-pt / S-rd | 山下 理学 / 松本 栄養 | コメディカル / comedical_staff | リハビリ・栄養管理計画書 |
| S-checkup | 福田 健診 | 事務(健診)/ checkup_staff | 健診 |
| S-billing | 田中 修 | 医事 / billing_clerk | 会計・レセプト |
| S-procure | 大村 調達 | 事務(選定・調達)/ procurement | 選定・調達 |
| S-admin | 伊藤 管理 | 情報システム / hospital_admin | 運用管理・アクセスログ |
上記はさくら中央病院(医療機関番号 1312345670)の利用者です。みどり総合病院(1398765430)の利用者は M- で始まり、M-doctor でログインするとさくら中央病院の患者は一件も見えません。
3.3 ベンダー運用でログイン
「ベンダー運用」タブでは、ベンダーの運用保守アカウントでログインします。運用保守担当は医療機関に属さないため患者データには到達できません(BR-041)。管理者権限は申請に応じた一時付与です(BR-043)。
| 運用保守アカウント | 職務 | 管理者権限 |
|---|---|---|
| OPS-product | 製品管理(リリース・開示) | なし |
| OPS-runtime | サービス運用(パッチ・障害・DR) | 一時付与あり(2027-03-31 まで) |
| OPS-audit | 監査ログ管理 | なし |
04画面構成
画面左のサイドバーから各機能へ移動します。上から下へ、おおむね業務の流れの順に並んでいます。
| グループ | メニュー | 内容 |
|---|---|---|
| 全体 | ダッシュボード | 当日の受付・在床・未会計などのサマリ |
| 外来 | 受付 / 患者 | 予約・資格確認・受付、患者検索とカルテ |
| オーダ | 処方 / 注射実施 / オーダ / 検査 | 各オーダの発行・実施・結果 |
| 入院 | 病棟看護 / 病床マップ / 入退院 | 病棟業務と入退院 |
| 在宅 | 在宅・健診 | 訪問診療・訪問看護・訪問リハビリ・健診・保健指導 |
| 医事 | 会計・レセプト | 算定・会計・レセプト・請求 |
| 連携 | 外部連携 | 医療DXサービス・FHIR API・マスタ同期 |
| 運用 | 運用管理 / アクセスログ | マスタ・利用者・オプション機能、操作ログ |
| ベンダー | ベンダー運用 / データ移行 | 製品運用・移行作業 |
| 導入 | 選定・調達 / 標準仕様準拠 | 価格比較・情報開示・製品選定、準拠状況 |
| 参照 | データ参照 / モデル | 全エンティティの参照、ユースケース・ルール一覧 |
各画面はカード単位で構成され、カードの見出しに対応するユースケース番号(UC-xxx)が書かれています。画面上部にはその画面が実装しているユースケースと、根拠になる業務ルール・標準仕様の条項が表示されます。
4.1 ダッシュボード
ログイン直後に表示されます。当日の受付件数、患者数、在床/病床、未確定の外部文書、未会計の算定、未請求のレセプト、アクセスログ件数、稼働率が並びます。「試せる業務」のリンクから代表的な業務フローへ入れます。
05受付
外来の入り口です(UC-001〜UC-005、UC-008、UC-017)。受付・医事担当者(S-reception)で操作します。
| カード | 操作 |
|---|---|
| 本日の受付患者一覧 | 受付時刻・患者・診療科・経路(窓口/自動再来受付機/アプリ/救急)・状態。「診察」で診察開始、「診察終了」で初診料・再診料などの診療行為情報をレセコンへ連携(UC-017) |
| 外来受付を登録(UC-004 / UC-002) | 患者・診療科・経路を選び、「資格確認」でオンライン資格確認等システムに照会、「受付登録」で一覧に追加 |
| 新規患者を登録(UC-003) | 氏名・カナ氏名・生年月日・性別を入れて「患者登録」。診察券番号が採番される |
| 外来予約(UC-001) | 患者・予約日時・診療科で「予約登録」。来院して受付すると「予約済」→「受付済」 |
| 仮登録患者の同定・本登録(UC-008) | 業務効率化サービス経由で診察券番号なしに受け付けた来院・問診を、既存患者と同定(BR-082) |
| 救急受付とトリアージ(UC-005) | トリアージ区分(I 蘇生〜V 非緊急)・来院手段・救急情報メモで「救急受付」。予約なしで直接「受付済」 |
06患者・カルテ
6.1 患者一覧
診察券番号・氏名・カナで検索します(BR-081)。表示されるのは所属医療機関の患者だけです(BR-041)。「カルテを開く」で患者カルテへ移動します。
6.2 患者カルテ(UC-012 / UC-013 / UC-016)
医師(S-doctor)で開きます。
- 患者プロファイル・禁忌 — 血液型・感染症などのプロファイルと、禁忌(アレルギー)が赤で表示されます。ここに登録された禁忌が処方の安全性チェック(BR-013)で使われます。
- 病名 — 病名と ICD10 を入れて「病名を登録」。「疑い病名」のチェックで区別します。
- 診療録を記載(SOAP) — S / O / A / P を入力し、記載種別を選んで「記載する」。状態は
Draft→「確定」でConfirmed。確定前は削除できます。 - 問診回答(UC-011)— Web問診が届いている場合に表示されます。
- 紹介状(UC-015)— 「紹介状を作成」で作成し、一覧の「印刷・送付」で送付します。
07処方と注射
7.1 処方(UC-022 / UC-023 / UC-024)
医師で操作します。患者と薬品を選び、1回量・1日回数を入れて「安全性チェック」を押します。
| チェック(BR-013) | 内容 | 結果 |
|---|---|---|
| 禁忌薬チェック | 薬剤の成分が患者プロファイルの禁忌に該当しないか | 該当すると発行不可 |
| 重複チェック | 同一オーダ内に同じ薬剤がないか | 重複すると要確認 |
| 極量チェック | 1日量が医薬品マスタの極量を超えないか | 超えると発行不可 |
上の画面は、禁忌「ペニシリン」を持つ患者にアモキシシリン(成分:ペニシリン)を処方しようとした例です。「禁忌薬チェック → 発行不可」となり、「電子処方箋で発行」ボタンが押せなくなります。問題がなければ「電子処方箋で発行」で電子処方箋管理サービスへ登録(UC-023)、または「処方箋を印刷」で院内・入院処方として薬剤部門へ連携します(UC-024)。
7.2 注射オーダの発行(UC-025)
医師で操作します。患者・注射種別・期間・1日回数・実施時刻と薬剤を入れ、「オーダを発行して印刷」を押すと、注射箋と注射ラベル(バーコード付き)が表示され、薬剤部門へ連携されます。
7.3 三点認証して実施登録(UC-026 / BR-014)
看護師(S-nurse)で操作します。注射オーダを選び、患者バーコード(診察券番号)・薬剤バーコード・実施者バーコードを読み取って「認証して実施登録」を押します。
Executed になり、診療行為情報が算定へ連携されます。1つでも不一致だとエラーになり、どれが不一致かが表示されます(実施は登録されません)。08オーダ・検査
8.1 オーダ(化学療法・手術・食事・リハビリ)
医師で操作します。画面上部で患者を選ぶと、4つのカードがその患者のオーダを表示します。
| オーダ | 操作 |
|---|---|
| 化学療法(UC-027 / UC-028) | レジメン名・クール番号・化学療法ベッドの予約日時で「レジメンを計画」。看護師が「認証して実施」で三点認証(患者・レジメン・実施者)すると、経過表に記録され次クールが自動で計画される |
| 手術・輸血(UC-031 / UC-032) | 術式・予定日時と輸血の要否で「オーダを発行して同意書を印刷」。実施後は「レポート」から手術レポートを作成 |
| 食事・栄養管理(UC-037) | 食種を選んで「食事オーダ」。管理栄養士(S-rd)が「栄養管理計画書を作成」 |
| リハビリ(UC-029 / UC-030) | 予定日時・担当療法士・目標で「オーダ・予約・計画書」。療法士(S-pt)が「受付・実施記録」で単位数を算定へ連携 |
8.2 検査(UC-018〜UC-021)
臨床検査技師(S-lab)と医師で分担します。医師が検査項目をチェックして「オーダを発行して印刷」すると、基準値とパニック値がマスタから表示され、必要に応じて同意書・検体ラベルが発行されます。
| 状態 | 表示 | 操作 |
|---|---|---|
| 発行済 | 受付待ち | 「受付」 |
| 受付済 | 実施待ち | 「実施」 |
| 実施済 | 結果入力待ち(n / m) | 「結果入力」「承認」 |
| 結果承認済 | — | 「再検」 |
「結果入力」で値を入れると、基準値と照合して基準内 / 高値 / 低値 / パニック値が自動判定されます。医師の検査結果確認(UC-021)では、パニック値の行が赤く表示されます。
09病棟看護・病床マップ・入退院
9.1 病棟看護(UC-038〜UC-043)
- 入院患者から対象を選びます(病床番号/診察券番号/氏名)。
- オーダ・予定に当日のオーダが並びます。処置は「処置を実施」で登録できます。注射・化学療法は三点認証が必要なため、注射実施画面で登録します(BR-014)。
- 経過表への記録で体温・脈拍・血圧・SpO2・呼吸数を入れて「経過表に記録」。
- 看護記録の記載で「看護上の問題がある」にチェックすると看護計画の立案へ進みます。
- 褥瘡評価は「褥瘡あり」のとき部位・深達度などの記載が必須です。
- 転棟・転床は空床のみが移動先に出ます(BR-016)。
- 看護管理日誌は病棟・日付で一意、承認は看護管理者だけが行えます(BR-017)。
9.2 病床マップ
入院確定・退院確定の都度、病床マップへ反映されます(BR-016)。空床と在床が一目で分かり、在床の病床からは「退院確定」を実行できます。
9.3 入退院(UC-033〜UC-036 / UC-044〜UC-046)
- 入院予約(医師): 患者・入院予定日・診療科で「入院予約を登録」。
- 入院確定: 空床があるときだけ実行でき、病床マップへ反映されます。
- 入院診療計画書(UC-035): 病名等・治療計画・推定入院期間・クリティカルパス名を登録。
- 持参薬(UC-036): 薬剤名・数量・継続の有無を登録。
- 退院オーダ(UC-044)→ 退院サマリ(UC-045)→ 退院確定(UC-046)の順に進め、退院確定で病床が空床に戻ります。
10在宅・健診
UC-047 訪問診療 / UC-048 訪問看護 / UC-049 訪問リハビリ / UC-050〜052 健診・保健指導 / UC-058 主治医意見書と請求書の電送。
- 訪問診療計画(UC-047)— 「計画書を作成して同意書を印刷」。訪問のたびに SOAP で記録します。
- 訪問看護指示書と記録(UC-048)— 訪問看護記録は有効な指示書がなければ登録できません。
- 訪問リハビリ(UC-049)— 指示書の発行後に実施計画を登録します。
- 健診・保健指導(UC-050〜052)— 保健指導は健診を受診した方だけが対象です。
- 主治医意見書(UC-058)— 意見書の電送後に、医事会計担当者が請求書を電送します。
11会計・レセプト
UC-053 算定と会計 / UC-054 電子レセプト作成 / UC-055 請求。医事担当者(S-billing)で操作します。
- 算定する: 患者を選んで「算定を依頼」。実施済みの診療行為が算定対象になり、点数はマスタから引きます(BR-007 / BR-008)。
- 算定内訳: 診療行為コードごとに名称・マスタ種別・点数・数量・小計が並びます。上の画面は点滴注射(G004)102点 → 患者負担 310円(3割)の例です。
- 会計: 算定一覧の「会計」で患者負担金を収納し、状態が
Settledになります。 - レセプト作成・請求: 請求年月(例
202609)を入れて「レセプト作成」、続けて「請求」。
[BR-007] 算定対象の診療行為がありません と表示されます。先に検査・注射などの実施登録を行ってください。12外部連携
医療DXサービス群との接続と、標準 API(FHIR R4)の状況を確認・操作します。
| カード | 内容 |
|---|---|
| 医療DXサービス接続 | オンライン資格確認等システム・電子処方箋管理サービス・電子カルテ情報共有サービス・共通算定モジュール・介護情報基盤ごとに、仕様書版・類型・経過措置の適用状況 |
| CapabilityStatement | GET /fhir/v1/metadata の応答(UC-072 / BR-074) |
| 電子カルテ情報共有サービスへの登録(UC-056 / UC-057) | 傷病名・アレルギー・処方・退院時サマリー・患者サマリーなどを記録条件仕様に沿って作成し、バリデーションチェックルールで検証してから送信(BR-011) |
| API 認証(UC-061 / UC-062) | OAuth 2.1 client_credentials + private_key_jwt(RS256)。サーバは登録済み JWKS で検証し、jti の再利用を拒否(BR-067 / BR-068) |
| API 監査ログ(UC-063 / UC-064) | 全リクエストを記録。レート制限超過は 429 と Retry-After |
| 外部サービスの文書(UC-059 / UC-060) | AI要約・音声認識の文書は未確定で取り込み、医師が確認して確定すると診療録に入る |
| マスタ同期(UC-066) | Organization / Practitioner / PractitionerRole を診療時間外に取得。件数上限で切り詰めた場合は relation=next(BR-079) |
13運用管理
医療機関の管理者(S-admin)で操作します。UC-065 マスタ保守 / UC-067 利用者登録と最小権限 / UC-070 アカウント棚卸し / UC-087 オプション機能の有効化。
- 利用者を登録(UC-067)— ロールは職種・所属・役職に基づく最小権限として付与します(BR-042)。
- アカウント棚卸し(UC-070)— 90日以上未使用のアカウントは黄色で強調されます。「棚卸しを記録」「削除」で整理します。
- マスタを登録(UC-065)— 医事・検査・医薬品・特定器材のコード・点数・極量・成分名を登録。「点数改定」で改定できます。
- オプション機能(UC-087 / BR-055)— 個別カスタマイズは行わず、全医療機関共通のオプション機能の有効化と設定変更で環境に適応させます。
14ベンダー運用・データ移行・選定調達
14.1 ベンダー運用(UC-071〜UC-079 / UC-085 / UC-086)
| カード | 内容 |
|---|---|
| 製品と稼働実績 | 稼働環境・方式・DR の RTO と年度ごとの稼働率。「稼働率を算出」 |
| 脆弱性診断(UC-071) | Webアプリ診断・プラットフォーム診断・ペネトレーションテストと検知した脆弱性、対策の記録 |
| リリース(UC-073) | 「一括配布」で全医療機関へ同時適用、「ノート公開」でリリースノートを公開 |
| セキュリティパッチ(UC-074) | 対象構成要素と区分(定期/緊急)、端末互換性の検証 |
| 障害・DR(UC-075 / UC-076) | 障害の起票・原因分析、バックアップ取得履歴(隔離クラウド/外部メディア) |
| 情報開示(UC-079) | 提示対象機能一覧・非機能要件の要開示項目への回答(BR-058〜BR-065) |
| 改定と準拠(UC-085 / UC-086) | 遵守類型のすべてに適合しなければ準拠を標榜できない(BR-001)。電子処方箋・情報共有の遵守項目は公表から6か月間は推奨扱い(BR-010) |
14.2 データ移行(UC-081〜UC-084)
OPS-product で支援対象の医療機関を選んでログインします。その操作は当該医療機関のアクセスログに「運用保守担当」として記録されます(BR-033 / BR-034)。
共通データ移行レイアウトに沿って CSV を実ファイルで出力し、形式を検証します。
Data/PatientBasic_20260924161952_001.csv.gz ← 基本名称_タイムスタンプ_連番.csv(圧縮)
Data/Disease_… SpecimenTest_… PrescriptionOrder_… InjectionOrder_… ClinicalRecord_…
Attachments/S-schema-001.png ← バイナリは外部参照方式(CSV に相対パス)
UTF-8(BOMなし)・LF・カンマ区切り・常時ダブルクォート・日付は YYYY-MM-DD hh:mm:ss(BR-092)。形式検証は文字コード・改行・引用・ヘッダ・日付・件数を確認し、不適合なら取り込まずに修正と再検証を促します。計画の承認と結果確認は医療機関側の分担です(BR-097)。
14.3 選定・調達(UC-078 / UC-080)
公開価格の比較(BR-057)、情報開示の要請(BR-058・BR-059)、方式・標準仕様準拠・稼働率・DR・価格公開を並べた製品比較を経て「デモ依頼」「トライアル依頼」→「選定」へ進みます。遵守類型に未適合の製品は選定できません(BR-001)。
15参照系の画面
15.1 標準仕様準拠
遵守・推奨・参考の類型ごとに、準拠項目と経過措置の状況・適合可否を一覧します(BR-001 / BR-010)。
15.2 アクセスログ
参照を含む医療情報へのアクセス・操作を記録し、5年以上保管します(BR-034 / BR-071)。拒否した試行も記録されます。
15.3 データ参照
ドメインモデルの111エンティティを、11パッケージごとにそのまま参照できます。表示されるのは所属医療機関のデータだけです。
15.4 モデル
この画面と API の出所です。87のユースケースと99のビジネスルール(標準仕様の出典条項つき)を検索できます。画面で見えた挙動が、どの条項に由来するかをここで辿れます。
16業務ルールと状態遷移
16.1 オーダの状態遷移(ClinicalOrder)
入力 発行 部門で受付 実施を登録 検査結果を承認
下書き ──▶ 発行済 ──────▶ 受付済 ─────────▶ 実施済 ─────────▶ 結果承認済
│ │
│ 中止 │ 受付後に中止
▼ ▼
中止(中止日時・中止者・理由を記録)
「実施を登録」は、注射・化学療法では三点認証が一致したときだけ通ります(BR-014)。実施登録の際に算定用の診療行為情報が生成されます。
16.2 入院の状態遷移(Admission)
入院予約 入院確定(空床がある) 退院オーダ 退院確定
(なし)──▶ 予約済 ─────────────────▶ 入院中 ─────────▶ 退院オーダ済 ──────▶ 退院済
│ │ ▲ │
│ 予約を削除 │ └── 退院オーダを削除 ┘
▼ │
取消 転棟・転床(入院中のまま移動情報を登録)
16.3 医事の状態遷移(算定 → 会計 → レセプト → 請求)
算定を依頼 算定結果を受領 患者負担金を会計
(なし)──▶ 依頼中 ──────────────▶ 算定済 ──────────────▶ 会計済
請求月の締め 作成完了 請求処理
(なし)──▶ 作成中 ────────▶ 作成済 ────────▶ 請求済
16.4 主な業務ルール
標準仕様の規定を「拒否できる形」で実装し、その拒否をテストで確認しています。
| ID | 内容 | アプリでの挙動 |
|---|---|---|
| BR-001 | 遵守類型のすべてに適合しなければ準拠を標榜できない | 未適合項目を列挙し、未適合製品は選定不可 |
| BR-010 | 電子処方箋・情報共有の遵守項目は公表から6か月間は推奨扱い | 判定日から経過措置の満了を自動判定 |
| BR-011 | 記録条件仕様に沿って作成し、検証してから送信 | 不足があると登録せずエラー |
| BR-013 | 禁忌薬・重複投薬・極量をチェック | 医薬品マスタの成分名で禁忌を検知、極量超過は発行不可 |
| BR-014 | 三点認証が一致しない場合は実施登録しない | 患者・薬剤(レジメン)・実施者の不一致を拒否 |
| BR-016 | 入院確定・退院確定の都度、病床マップへ反映 | 在床の病床へは移動不可 |
| BR-020 | 同一データの同時更新を排他制御 | ETag と If-Match。欠落は 428、不一致は 412 |
| BR-024 | 真正性の確保 | 23状態機械の遷移表以外の状態変更を拒否 |
| BR-034 | 参照を含むアクセス・操作を記録 | アクセスログ画面。拒否した試行も記録 |
| BR-040 | 二要素認証、既定回数の失敗でロック | 5回失敗でロック |
| BR-041 | 医療機関ごとにデータを分離 | TenantAccessGuard を経由し、他院のIDを直接指定しても 404 |
| BR-042 | 職種・所属・役職に基づく最小権限 | 看護師の診療録記載、医師の経過表記録などを拒否 |
| BR-055 | 個別カスタマイズせずオプション機能で適応 | 運用管理のオプション機能の有効化 |
| BR-067 | private_key_jwt による API 認証 | JWKS 検証、jti 再利用を拒否 |
| BR-092〜097 | 共通データ移行レイアウト | 実ファイルで出力し形式検証 |
(全99ルール。上表は画面操作に関係する主なものを抜粋しています。)
17品質とトレーサビリティ
17.1 テスト
| 種別 | 件数 | 検証していること |
|---|---|---|
| 単体 | 22 | 状態機械の遷移表、業務ルール登録簿、エンティティ登録簿とコードの整合 |
| 統合 | 131 | ユースケース別の API(主成功シナリオと拡張、ルール違反の拒否) |
| E2E | 4 | 画面からの重要フロー(Playwright) |
単体テストはモデルとコードの乖離を検出します。「全ユースケースが実装コードから参照されている」「テナント所属エンティティは必ず tenantId を持つ」などを機械的に確かめ、実際に3件の不整合を検出しました。
cd app/backend
npm test # 単体+統合(153テスト)
npm run test:coverage # カバレッジ付き
npx playwright install chromium && npm run test:e2e
17.2 トレーサビリティ行列
シナリオ → アクティビティ → ユースケース → エンティティ/状態機械/シーケンス → セキュリティ → コード → テストの対応と、逆方向(コード → ユースケース → 業務プロセス)を出力します。
| 追跡レベル | カバレッジ |
|---|---|
| シナリオ → アクティビティ(26プロセス) | 100% |
| アクティビティ → ユースケース(242アクション) | 100% |
| ユースケース → エンティティ / シーケンス図 / ロール / 実装 / 画面 / テスト | 各 100% |
| 業務ルール → コードでの強制(99件) | 73.7% |
| 業務ルール → テストでの検証(99件) | 56.6% |
| End-to-End 完全追跡 | 100%(87/87) |
18よくある質問・トラブルシュート
| 症状 | 原因・対処 |
|---|---|
| ログインできない | 認証コードは 000000。5回失敗するとロックされます(BR-040)。削除済みのアカウントはログインできません。 |
| 患者が一覧に出ない | 別の医療機関の患者です。S- と M- の利用者では見える患者が変わります(BR-041)。 |
| 操作すると「404」になる | 権限のない操作は、存在を推測させないため 404 を返します。担当ロールでログインし直してください。 |
| 「電子処方箋で発行」が押せない | 禁忌薬または極量に該当しています(BR-013)。チェック結果の「発行不可」の行を確認してください。 |
| 注射・化学療法の実施が登録できない | 三点認証のいずれかが不一致です(BR-014)。患者バーコードは診察券番号です。 |
| 看護管理日誌が登録できない | その病棟・日付の日誌が既にあります(BR-017)。承認は看護管理者のみです。 |
| 「[BR-007] 算定対象の診療行為がありません」 | 検査・注射などを実施登録してから算定してください。 |
| 在宅・健診の操作ができない | 該当するオプション機能が無効です。運用管理で有効化してください(BR-055)。 |
| コードを再生成したのに挙動が変わらない | バックエンドはファイル監視をしません。再起動してください。 |
| テストが2回目から失敗する | テストはシード直後の状態を消費します。npx ts-node src/seed.ts でシードし直してください。 |
19制約事項
- データベースは既定で SQLiteです。
PRISMA_PROVIDER=postgresqlで PostgreSQL に切り替えられます。 - 画面側の認証は開発用です(二要素認証コードは固定値)。外部 API は OAuth 2.1 を実装済みですが、OIDC と mTLS は未実装です。
- 外部サービスはスタブです。オンライン資格確認等システム・電子処方箋管理サービス・電子カルテ情報共有サービス・共通算定モジュール・介護情報基盤への接続は、インタフェースと状態遷移を実装したうえで応答をアプリ内で模擬し、送信の事実を API 監査ログに残しています。
- 点数・極量はサンプル値です。実運用では国の標準マスタと点数表の改定を反映してください。
- 帳票(処方箋・注射箋・同意書・検体ラベル等)は PDF 出力ではなく、印刷内容の画面表示とブラウザ印刷までです。
app/以下は生成物です。直接編集せず、SSoT または生成スクリプトを修正して再生成します。










