Minos Health

Minos

Minos は、ポーランドの病院医療向けの、説明可能な診療報酬判定インテリジェンスプラットフォームです。バージョン管理された医療用語（ポーランド版 ICD-10 および ICD-9 PL）と、NFZ JGP 病院分類システムを統合しています。これには、ポーランドの病院への支払額を決定するグループ定義、点数カタログ、分類アルゴリズムが含まれます。

ダンテの『神曲』地獄篇では、ミノスはすべての事情を聞いたうえで、各人をその罪に応じた圏へ振り分けます。DRG 分類器が行うのも同じことで、この分類器はその判断根拠を示します。

リポジトリとコマンドでは、短縮名 minos を使用しています。Minos は、商標弁護士による審査を待つ暫定的な公開ブランドです。2026-08-06 に商標登録の事前調査を実施しました（決定事項を参照）。

プロダクトの各レイヤー

1. 用語：icd10-pl と icd9-pl による、決定論的で高速な検索と、完全な出典情報。
2. JGP ナレッジベース：グループ、分類条件、方向別 ICD リスト、年齢および在院日数のルール、点数、NFZ の規範的な法令から取り込んだバージョン間の差分。
3. 分類エンジン：レビュー済みの対応ルールを決定論的に評価し、点数、出典にリンクされたトレース、範囲を限定したニアミスを提示します。未対応のルールは、答えを推測するのではなく、未確定のままとなります。

提供状況（2026-10-19）

公開検証サイトでは、用語／JGP 検索、日付付きのグループおよびコードのページ、段階式の診療エンカウンタービルダー（minoshealth.pl/gruper）、エージェント向けの公開 MCP サーバー（https://minoshealth.pl/mcp、ドキュメント）を提供しており、公式 MCP Registry に pl.minoshealth/mcp として登録されています。 記録上、最新の検証済みデプロイは b0dee0d です（2026-10-19T11:42:10Z に有効化、バンドル 5cea0d5d は変更なし）。パッチ適用済みの NGINX 1.31.7 エッジベース（#197）を使用しています。同日、それ以前に 2b6e26b がブルー／グリーン方式の API 切り替え（#192）を有効化しました。Uptime Kuma のダウン判定はなく、約 24 秒のエッジウィンドウが許容されました。どちらも、ロールバックされた起動終了（#198）の後に 1 回の再試行が必要でした。fda0788（#191）では、サイト監査の 102 項目すべてに合格しました。f9a0a72 では、MODTAR 第 103 版、2026-10-13 のナレッジの基準日（#184）、および高速化された API 起動（#189）が追加されました。736ba9f では、出典フィルター、共有、範囲を限定した起動時レディネスが追加され、#171／#172（088f190）では、初期の出典 HTML と永続的な RSK／BAW 引用が追加されました。スキーマ 10 のバンドルとリリースに固定された概念 JSON は引き続き利用できます。レビュー済みの MODTAR 連携、適用される法令に基づく診療報酬プロダクトの除外、固定された JGP 比較、NFZ の公開メタデータも稼働中です。 デプロイの証跡には、復旧、API、ブラウザー、プライバシー、正確なダイジェストの各チェックが記録されています。これには、保護付き復旧後に一度だけ起動待機を行うことをオーナーが承認した記録も含まれます。これは日付付きの受け入れ記録であり、新たな本番環境の検査ではありません。

起動時ウォームアップの信頼性（#157）、保護付き復旧診断（#162）、NFZ 公開メタデータ（#92）、概念 JSON（#23）は提供済みで、完了しています。 PR #171 による、JavaScript なしで利用できる出典カタログと永続的な RSK／BAW 引用の一部は、本番復旧および公開／ブラウザー受け入れに合格しました。その後、736ba9f（#185）で出典フィルター、並べ替え、共有可能なビューが追加されました。より広範な #80 は引き続きオープンです。範囲を限定した起動時レディネス（#181）は、初回の本番有効化に合格しました。Actions の使用状況は #174 で計測されており、#272 以降、main へのプッシュごとに完全な CI が再び実行されています。

初期のゴールデンスイートには、合成ケース 9 件と、固定された出典から導出されたケース 5 件があります。医療従事者向けビルダーの受け入れ（#158）、実際の病棟での一致確認（#38）、署名済みリリースおよび容量の完全な受け入れは未完了です。未完了の作業はGitHub のイシューで追跡されています。

ロードマップ

フェーズ	提供内容
0 ウォッチャー	ソースの毎日の監視、対象を絞った未加工スナップショットのアーカイブ、レビュー済みのデータ更新 PR。上流のファイル構成や再利用される URL は、有用なバリデーターがないまま変更され、以前に公開されたデータも見つからなくなる可能性があるため、プロダクトコードより先に実施します。
v0.0.1 基盤	バイテンポラルストア、用語および JGP ナレッジベース、検索、CLI、読み取り専用 HTTP API、バージョン差分を表示する匿名ウェブブラウザー。
v0.0.2 グルーパー	点数、完全なルール追跡、ニアミスのレポートを備えた受診グルーピング。
v0.0.3 オプティマイザー	コーディングの完全性向上と請求却下の防止を目的とした what-if シミュレーション。

医薬品、代替品、PLN 建ての償還契約、臨床上の推奨、国際的な ICD バリアントは、これらのリリースの対象外です。 ソースとライセンスの検証後、個別の名前空間を持つモジュールとして追加される可能性があります。データモデルは、追加の市場（WHO 分類、その他の DRG システム）がスキーマ変更ではなく、新たな名前空間付き用語体系、グルーピング方式、料金表として加わるように設計されています。

アーキテクチャ

Minos は、内部のパッケージ境界が厳格に定められた単一の Python 3.14 ディストリビューションです。

• minos.domain：同期的なドメイン型、正規化、ランキング、エラー；
• minos.store：SQLite/FTS5 による読み取り専用の永続化とインデックス検索；
• minos.ingest：堅牢化されたソース解析と再現可能なアーティファクトのビルド；
• minos.cli：データのビルド／差分、オフライン検索、グループ化のコマンド；
• minos.http：上限を設けた FastAPI エンドポイントと、プライバシーに配慮したテレメトリー；
• minos.grouper：バージョン管理されたグループ化エンジン。ルールをデータとして扱い、 該当事実を評価します。

検証環境では、不変の linux/amd64 API、エッジ、ウォッチャーのイメージを使用します。Docker Compose により、ローカルと専用の Mikr.us 3.0 ホストでスタック全体を実行します。唯一のパブリックな入口は Cloudflare Tunnel です。検証環境では、 個別にチェックサムを検証した読み取り専用の SQLite バンドルを API にマウントします。エッジ イメージには静的な Web アーティファクトが含まれます。署名付きの製品リリースに関する完全な契約は 引き続き #41/#27 です。オフライン CLI ディストリビューションには Python ランタイムが同梱され、 同じ生成済みデータベースを使用します。

ウォッチャーコンテナは APScheduler と、別個の変更可能な制御用 SQLite データベースを実行します。正確な生バイトデータと、バージョン管理された制御データベースの復旧 イメージを、プライベートな Cloudflare R2 バケットに保存します（#200）。GitHub ホスト型 Actions はイメージをビルドしてテストしますが、 本番のスケジュールは実行しません。課題 #6～#8 のコレクターが変更レコードを 出力します。レビュー済みの更新には、ガード付き検証デプロイツールを使用します。無人での 選択、有効化、詳細なインシデント通知は #141 で 2026-10-20 に再開されましたが、まだ有効化されていません。#21 は完了ではなく、置き換えによりクローズされています。 ウォッチャーの障害通知には、source_drift など、固定の障害カテゴリが記載されます。 ホストプロセッサーは 6 時間ごとに、新しい RSK ICD-10 または CZS ICD-9 ファイルを稼働中の バンドルと照合して判定し、別個の Kuma モニターに判定結果を報告します。現時点では、 何も有効化しません。

オフラインの minos data diff は、検証済みバンドルディレクトリ内の、明示的にピン留めされた用語集、カタログ、病態のリリースを比較し、 サイズを制限した Markdown/JSON レポートを生成します。CLI の契約と 検証の証跡を参照してください。

同じ Mikr.us ホストでは、セルフホストの Uptime Kuma 2.5.5 も status.minoshealth.pl で稼働しています。公開ページに表示されるのは大まかなサービス状態のみです。詳細なウォッチャーの状態は、 minos watcher status を通じて引き続き非公開で確認します。課題 #54 は、将来の非公開の詳細管理ポータル用に確保されています。これは有料の外部監視 SaaS に代わるものであり、監視の必要性そのものに代わるものではありません。Kuma は同じ ホスト上で稼働するため、Mikr.us ホスト、ネットワーク、電源の完全な停止を検出したり通知したりすることはできません。 この制約は現時点では許容されています。

初期サービスは引き続き匿名で利用できます。後続のクライアントについて合意されている方針は、検証済みの不変な SQLite リファレンススナップショットを同期してオフラインで利用できる、インストール可能なレスポンシブ PWA を 1 つ提供することです。 将来の個人向け計算はオンラインで認可され、利用量が計測されます。プレミアムなオフライン計算は、 組織または病院向けに別途ライセンスされます。アカウント、支払い、利用量の保存、 厳密な商用条件は v0.0.1 の対象外です。

合意済みの決定事項と実装計画については、v0.0.1 のドキュメントを参照してください。

開発

クリーンなチェックアウトから、固定された Python ランタイムとすべての開発ツールをインストールします。

uv sync --all-groups
uv run minos --version

Ruff、BasedPyright、mypy、pytest は uv.lock で固定されています。ターミナルと Neovim の統合については、CONTRIBUTING.md に記載されています。セキュリティ、正確性、測定済みのパフォーマンスは、同等のリリース要件です。エビデンスに基づくトレードオフと、代表的なベンチマークが求められます。開発者の利便性は、これらの要件に従います。クリティカルパスには、対象を絞ったミューテーションテストと統合テストを実施します。

オフライン参照コマンドと、その制約付き JSON／終了コードの仕様については、offline-search.md をご覧ください。ローカルでのフルソースおよび単独でのエビデンスについては、検索の検証をご覧ください。ウェブサイトでは公開検証の例外に基づき、参照検索とグループ化を公開しています。ソースの再配布と署名付き製品のプロモーションには、それぞれ別個の審査ゲートが適用されます。

デプロイ済みの検証用 Compose スタックは、Cloudflare Tunnel 経由で API とウェブエッジを提供し、ウォッチャーと Uptime Kuma も稼働させます。ウォッチャーの基盤には、実行可能な UTC スケジューラー、フェンシングされた SQLite 制御トランザクション、ローカルおよび R2 アーカイブ、リビジョン管理されたリカバリーイメージ、署名済みの信頼できるリカバリーインベントリー、読み取り専用のウォッチャーステータスコマンド、事前チェックコマンド、強化されたウォッチャーイメージ、容量に上限のあるローカル Docker ログ、ローカル Compose が含まれます。RSK コレクターはランタイムに登録されていますが、ウォッチャーの起動前に、新しい制御ボリュームを明示的に初期化する必要があります。

ローカルのランタイムコマンドは次のとおりです。

docker compose build watcher
docker compose --profile bootstrap run --rm --no-deps watcher-bootstrap-rsk
docker compose --profile preflight run --rm --no-deps watcher-preflight
docker compose up --detach watcher
docker compose exec --no-TTY watcher /app/.venv/bin/minos watcher status --json
docker compose logs --since 24h --tail 500 --timestamps watcher

設定済みのソースを 1 つ確認するには、minos watcher status [SOURCE_ID] --json を使用してください。ステータスの確認には、制御用 SQLite を読み取り専用で開きます。これらのホスト上で実行するローカルのステータスおよびログコマンドでは、Mikr.us のホスト、ネットワーク、または電源が障害ドメイン全体で完全に停止したことを検知できません。

Uptime Kuma のセットアップと、2 段階のパブリックルートのブートストラップについては、Ansible の運用手順書に記載されています。オペレーターは、2026-09-23 に管理者アカウントと 2FA を作成し、非公開のステータスページと一時停止中のウォッチャープッシュモニターを設定しました。また、Kuma から Telegram アラートをテストし、停止状態で整合性を確認済みのオフサイトバックアップを 1Password に保存しました。このバックアップを使った Docker の分離復元テストは、ネットワーク接続もホストポートも使用せず、同じ固定イメージに対して成功しました。未完了の運用ゲートが 2 つ残っています。完全に空のホストでのリカバリー演習（#49）と、ローンチ時のキャパシティ負荷受け入れテスト（#42）です。負荷目標とこれまでの測定結果については、API 負荷記録をご覧ください。

サイトからホストへの接続には、Cloudflare Tunnel のみを使用します。唯一の管理経路である SSH は、2026-10-23 以降、パブリックリスナーを設けず、Tailscale テールネット経由で稼働しています（#227）。切り替えについては、Ansible の運用手順書をご覧ください。

オブジェクトストレージには、上書きと削除を拒否するロックルールを設定した、EU 管轄の Cloudflare R2 バケットを 1 つ使用します。AWS スタックとその受け入れテスト用ハーネスは #200 で廃止されました。Mikr.us の有効化と復元演習には、引き続きオペレーターによる明示的な承認が必要です。

データ

すべてのソースは公開されています。詳細、エンドポイント、ポーリング手順は data sources に、法的分析は data and licensing に記載されています。

データセット	ソース
JGP グループカタログ、特性、係数	Zarządzenia Prezesa NFZ（入院治療）、https://baw.nfz.gov.pl 経由
JGP グルーパーアルゴリズムおよび処置ランク	NFZ の JGP 通知
ICD-9 PL	NFZ の辞書ダウンロードおよび https://slowniki.nfz.gov.pl
ICD-10 PL	RSK リソース HCD 00CD10、https://rsk3.ezdrowie.gov.pl
ICD-11 PL（先行公開版）および WHO ICD-10/ICD-11 テーブル	RSK リソース HCD 99ICD1、CC BY-ND 4.0
JGP 利用統計	https://api.nfz.gov.pl（オープンデータ、出典表示が必要）

ソースのスナップショットと生成されたデータベースは成果物であり、リポジトリの構成物ではないため、Git にコミットしてはなりません。そのため、リポジトリにはデータセットもデプロイ用認証情報も含まれていません。テストスイートは合成フィクスチャ上で実行され（uv run pytest）、サイトをローカルで実行するには（scripts/run_local_site.py）、公開ソースからオフラインコマンドを使って構築した参照バンドルが必要です。生成される各データセットには、ソースの識別情報、タイムスタンプ、チェックサム、変換バージョン、出典表示、および必要な告知が含まれます。

安全性、コンプライアンス、プライバシー

Minos は参照・請求分析ツールであり、医療上の助言、診断、治療を提供するものでも、専門家の判断に代わるものでもありません。

コンプライアンス上の境界は明確です。Minos が支援するのは、実際に実施され、記録された内容を完全かつ正確にコーディングすることと、回避可能な請求却下の防止です。記録を超えたコーディングを推奨してはなりません。グルーピング結果は点数と製品コードで表されます。契約上の PLN 金額は支払者との契約に依存するため、対象外です。

公開サービスは匿名で利用できます。ログには、生の医療検索クエリ、診療ペイロード、患者データ、処方箋、認証情報、その他の個人データを含めてはなりません。グルーピング（v0.0.2 から）はステートレスです。診療入力は評価後に破棄され、保存されることはありません。

ライセンス

リポジトリのソフトウェア、インフラストラクチャ、テスト、ドキュメントは、Apache-2.0 または MIT のいずれかを選択してライセンスできます。データセットの成果物には、それぞれのソースの利用条件が適用されます。NFZ の規範的行為およびその付属書は、ポーランド著作権法第 4 条に基づき著作権の適用除外となる公的資料として扱われています（正式な法的見解は確認中です）。RSK のポーランド語版 ICD-10 リソースには CC BY-NC-SA 3.0 IGO と明記されています。NOTICE.md および data and licensing をご覧ください。

ステータス

Minos は現在、一般公開の検証を積極的に進めています。バージョンタグや GitHub リリースはまだ公開されていません。完全な署名付き製品リリースのゲートとは別に、正確なダイジェストによる検証デプロイが #41/#27 で追跡されています。未リリースの変更については CHANGELOG.md、実装の基準については SPEC.md、未対応の作業については GitHub issues をご覧ください。

コントリビューション

イシューまたはプルリクエストを作成する前に、CONTRIBUTING.md をご覧ください。