shop_helm/docs/quality-document.md

代码库质量文档

跟踪 ShopHelm 产品领域和架构层的长期健康度。单次任务输出使用 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 三个高风险技术闸门完成后。