Minos Health

Minos

Minos 是一个面向波兰医院医疗服务的可解释结算智能平台。它将带版本管理的医学术语（波兰 ICD-10 和 ICD-9 PL）与 NFZ JGP 医院分组系统相结合：包括决定波兰医院如何获得支付的组定义、点数目录和分组算法。

在但丁的《神曲·地狱篇》中，Minos 会听取每个案件的全部陈述，并将其分配到相应的圈层。DRG 分组器也是如此，而这个分组器还会展示推理过程。

代码库和命令使用简称 minos。Minos 是暂定的公开品牌，等待商标法律顾问审核；已于 2026-08-06 进行了注册预筛查（参见 决策记录）。

产品层

1. 术语：icd10-pl 和 icd9-pl，提供确定性、快速搜索和完整的来源溯源信息。
2. JGP 知识库：组、分组条件、方向性 ICD 列表、年龄和住院时长规则、点数值，以及版本间差异；内容从 NFZ 规范性法案中导入。
3. 分组引擎：对已审核支持的规则进行确定性评估，并提供点数、带来源链接的轨迹和有限范围内的近似匹配。对于不支持的规则，结果保持未确定，不会猜测答案。

交付状态（2026-10-19）

公开验证站点提供术语/JGP 搜索、带日期的组和代码页面、分步式就诊构建器（位于 minoshealth.pl/gruper），以及面向 Agent 的公开 MCP 服务，地址为 https://minoshealth.pl/mcp （文档）；该服务已列入官方 MCP 注册表，标识为 pl.minoshealth/mcp。 最新记录的已验证验证部署为 b0dee0d（于 2026-10-19T11:42:10Z 激活，5cea0d5d bundle 未变），使用已修补的 NGINX 1.31.7 边缘基础镜像（#197）。当天早些时候，2b6e26b 激活了蓝绿 API 颜色（#192）：Uptime Kuma 未记录停机心跳，边缘层窗口约 24 秒，已获接受。两者在一次启动退出并回滚后，均需重试一次（#198）。fda0788（#191）通过了全部 102 项站点审计检查。f9a0a72 新增 MODTAR 第 103 代，即 2026-10-13 知识截止时间（#184），并加快了 API 启动速度（#189）；736ba9f 增加了来源筛选、分享和有界启动就绪机制，#171/#172（088f190）则加入了初始来源 HTML 和持久化的 RSK/BAW 引用。schema-10 bundle 和固定发布版本的概念 JSON 仍可用。经审核的 MODTAR 绑定、主管法案中的结算产品排除项、固定版本的 JGP 比较，以及 NFZ 发布元数据也已上线。 部署证据 记录了恢复、API、浏览器、隐私和精确摘要检查，包括恢复防护机制之后经所有者批准的一次性启动等待。这是带日期的验收记录，不代表进行了新的生产环境检查。

启动预热可靠性（#157）、恢复防护诊断（#162）、NFZ 发布元数据（#92）和概念 JSON（#23）均已交付并关闭。 PR #171 中不依赖 JS 的来源目录和持久化 RSK/BAW 引用功能，已通过生产恢复和公开/浏览器验收；之后在 736ba9f（#185）中加入了来源筛选、排序和可分享视图，而更广泛的 #80 仍未关闭。有界启动就绪机制（#181）已通过首次生产激活。#174 中记录了 Actions 用量；自 #272 起，每次推送到 main 都会再次运行完整 CI。

初始黄金测试套件包含 9 个合成案例和 5 个基于固定来源生成的案例。临床人员构建器验收（#158）、真实病房一致性（#38）以及完整的签名发布/容量验收仍未完成；未完成工作记录在 GitHub issues 中。

路线图

阶段	发布内容
0 监视器	每日源数据监视器、范围明确的原始快照存档、经审核的数据更新 PR。此阶段先于产品代码，因为上游文件集和复用的 URL 可能在没有有效验证器的情况下发生变化，且先前公开的数据可能变得无法查找。
v0.0.1 基础功能	双时态存储、术语和 JGP 知识库、搜索、CLI、只读 HTTP API，以及可查看版本差异的匿名 Web 浏览器。
v0.0.2 分组器	按点数进行就诊分组、完整规则追踪和近似未命中报告。
v0.0.3 优化器	将假设分析定位为编码完整性检查和预防拒付。

药品产品、替代方案、以 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 中的采集器会生成变更记录。经审核的更新使用受保护的验证部署工具。无人值守的选择、激活和详细事件通知已于 2026-10-20 在 #141 中恢复，目前尚未启用；#21 已关闭，原因是被取代，而非已交付。监视器故障推送会注明固定的故障类别，例如 source_drift。 主机处理器每六小时会根据在线数据包评估每个新的 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 主机、网络或电源完全中断的情况。目前接受这一限制。

初始服务仍保持匿名。已接受的后续客户端方向是提供一个可安装的响应式 PWA，可同步经验证的不可变 SQLite 参考快照，以供离线使用。未来的个人计算将在线授权并计量；高级离线计算则单独许可给组织或医院。账户、付款、使用情况存储和确切的商业条款均不属于 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 和 Web 边缘服务，并同时运行监控器和 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

使用 minos watcher status [SOURCE_ID] --json 检查一个已配置的来源。状态路径以只读模式打开控制 SQLite。这些主机本地的状态和日志命令无法从故障域之外检测 Mikr.us 主机、网络或电源完全中断的情况。

Uptime Kuma 的设置和两阶段公共路由引导流程见 Ansible 运行手册。运维人员已创建管理员账户并启用 2FA，配置私有状态页和暂停的监控器推送监控项，通过 Kuma 测试 Telegram 警报，并于 2026-09-23 将已停止且通过完整性检查的异地备份存入 1Password。该备份已在隔离的 Docker 环境中使用相同的固定版本映像完成恢复测试，期间未使用网络或主机端口。目前还有两个运维关卡尚未完成：完整的空主机恢复演练（#49）和发布容量负载验收（#42）。负载目标和目前的测量结果见 API 负载记录。

网站仅通过 Cloudflare Tunnel 访问主机。唯一的管理通道 SSH 自 2026-10-23 起通过 Tailscale tailnet 运行，且不开放公共监听器（#227）；切换过程见 Ansible 运行手册。

对象存储使用一个位于欧盟司法管辖区的 Cloudflare R2 存储桶，其锁定规则会拒绝覆盖和删除操作；AWS 堆栈及其验收测试框架已在 #200 中退役。Mikr.us 激活和恢复演练仍须明确获得运维人员批准。

数据

所有来源均为公开来源。详情、端点和轮询流程见 data sources；法律分析见 data and licensing。

数据集	来源
JGP 分组目录、特征、系数	Zarządzenia Prezesa NFZ（住院治疗），来自 https://baw.nfz.gov.pl
JGP 分组算法和手术等级	NFZ komunikaty 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 Releases；精确摘要验证部署 与完整签名产品发布门槛分别跟踪，详见 #41/#27。未发布的变更请参阅 CHANGELOG.md， 实现基线请参阅 SPEC.md，待处理工作请参阅 GitHub issues。

贡献

提交问题或拉取请求前，请先阅读 CONTRIBUTING.md。