# 项目算法方案层

`solutions/` 用于组织面向具体业务场景的项目算法。它不重复实现模型，也不替代
`capabilities/` 中的原子能力，而是定义多个能力如何按固定输入、输出和规则组合。

## 与能力库的关系

```text
capabilities/  -> 可独立验证的原子能力
solutions/     -> 组合能力形成的项目算法方案
apps/          -> 本地实验控制台或后续产品接入界面
```

项目算法通常属于 C 类产品能力：它会消费 A 类直接能力（检测、分割、分类、变化
检测）和 B 类组合能力（测量、三维、异常检测）的结果，再经空间规则生成事件建议。
不得将整个项目算法表述为 `geoai-py` 的单一内置接口。

## 目录约定

```text
solutions/
`-- <业务域>/
    |-- README.md             # 场景、需求映射和成熟度
    `-- <编号>-<项目算法>/
        |-- README.md         # 方案说明、数据前提和验收标准
        `-- solution.json     # 能力依赖、步骤、输入、输出和边界
```

`solution.json` 是编排声明，不代表该算法已可运行。只有引用的能力已通过样本验证，
并且输入数据、空间规则和输出协议齐备后，才可以为方案增加实际运行脚本或控制台入口。

## 统一结果协议

所有项目算法组合应遵循 `shared/configs/solution-result.schema.json` 的顶层字段：

- `run_metadata`：方案、版本、模型、设备、输入和运行限制。
- `observations`：模型或空间分析发现的原始对象/图斑。
- `events`：依据业务规则生成的告警候选，不等同于最终人工确认结论。
- `artifacts`：标注图、GeoJSON、掩膜、报告等可查看产物。

## 当前方案

| 业务域 | 方案 | 状态 |
| --- | --- | --- |
| 矿山巡检 | 人员安全识别 | 试点骨架，等待安全帽样本、危险区域和告警规则。 |
| 矿山巡检 | 排洪沟堵塞识别 | 试点骨架，等待沟道边界、堵塞样本和严重度口径。 |

索道安全、爆破警戒热成像、边坡、尾矿库渗漏、竖井和另一类排洪沟需求仍保留在
矿山巡检方案索引中，待基础能力和现场数据满足条件后再创建专项目录。