# 代码库质量文档

> 跟踪 ShopHelm 产品领域和架构层的长期健康度。单次任务输出使用 [`evaluator-rubric.md`](evaluator-rubric.md)。

## 评级

- **A**：完整验证通过，边界清楚，测试稳定，新 agent 可直接接手。
- **B**：主要验证通过，有少量明确缺口但不影响核心使用。
- **C**：部分可用，存在可靠性、测试或可读性缺口。
- **D**：不可用，或存在数据/安全/结构性问题。
- **N/A**：尚未实现，不参与质量趋势判断。

## 产品领域

| 领域 | 评级 | 验证状态 | Agent 可读性 | 测试稳定性 | 关键缺口 | 上次更新 |
| --- | --- | --- | --- | --- | --- | --- |
| 多店铺运营台 | N/A | 未实现 | 文档已定义 | 无测试 | T-201 至 T-209 | 2026-07-11 |
| 商品运营助手 | N/A | 未实现 | 文档已定义 | 无测试 | T-301 至 T-308 | 2026-07-11 |
| 图片预览与导出 | N/A | 未实现 | 合约已定义 | 无测试 | T-103、T-305 至 T-307 | 2026-07-11 |
| 客服助手 | N/A | 未实现 | 文档已定义 | 无测试 | T-401 至 T-405 | 2026-07-11 |
| 数据备份恢复 | N/A | 未实现 | 流程已定义 | 无测试 | T-208 | 2026-07-11 |

## 架构层

| 层级 | 评级 | 边界执行 | Agent 可读性 | 关键缺口 | 上次更新 |
| --- | --- | --- | --- | --- | --- |
| Harness / 项目文档 | A | 入口和权威来源已建立 | 高 | 随实现持续校准 | 2026-07-11 |
| Gio UI | N/A | 未实现 | 目标边界已定义 | T-001、T-101 | 2026-07-11 |
| Application / Domain | N/A | 未实现 | 合约已定义 | T-004 起实现 | 2026-07-11 |
| SQLite persistence | N/A | 未实现 | schema 草案已定义 | T-003、T-201 起实现 | 2026-07-11 |
| Chrome platform adapter | N/A | 未实现 | 副作用边界已定义 | T-102 | 2026-07-11 |
| Image pipeline | N/A | 未实现 | 几何与导出边界已定义 | T-103 | 2026-07-11 |

## 更新规则

- 每个阶段验收任务完成后更新对应产品领域。
- 架构或高风险模块发生实质变化后更新对应架构层。
- 评级下降必须写明触发变更和恢复任务。
- 没跑验证不能给 A；仅“代码已完成”最高不得超过 C。
- 尚未实现用 N/A，不用 D 惩罚计划中的空白。

## 变更历史

### 2026-07-11

- 变更：按 Harness Coding 模板建立 ShopHelm 产品、技术、架构、任务和质量文档。
- 提升：聊天中的产品结论转为仓库内可执行事实。
- 下降：无。
- 新缺口：生产代码、自动测试和真实 Windows smoke 尚未开始。
- 下一检查点：T-104 三个高风险技术闸门完成后。