shop_helm/docs/adoption-checklist.md

空项目初始化与 Harness 接入清单

ShopHelm 当前从空目录起步。本文只记录从“文档基线”进入“可运行代码基线”的一次性准备状态。

文档基线

• 建立 AGENTS.md 和 AI 开工入口。
• 固定产品愿景、需求范围和首发验收。
• 固定 Go + Gio、SQLite、外部 Chrome 技术路线。
• 定义模块边界、数据模型、页面和本地服务合约。
• 建立单 agent 任务看板、执行流水和当前状态。
• 建立验证、收尾、评审和质量跟踪文档。

代码基线

• 初始化 Git 仓库并配置远程。
• 初始化 Go module shophelm。
• 在目标 Windows 上运行最小 Gio 窗口。
• 锁定 Go/Gio 版本并更新技术文档。
• 建立 cmd/、internal/、migrations/ 和测试结构。
• 让 ./init.ps1 完成依赖同步、测试并打印启动命令。
• 运行 go test ./...、go vet ./... 和 Windows build。
• 把真实结果追加到 progress.md 并更新 current-state.md。

代码基线由 T-001 到 T-005 逐项完成，不在文档初始化任务中顺带生成未经验证的业务代码。

首轮决策闸门

完成工程基线后，必须在扩展业务页面前验证：

闸门	任务	通过标准
Gio 管理台可用性	T-101	真实字段表格、筛选和表单在 Windows 上可用
Chrome/profile 安全启动	T-102	参数、占用、退出和代理行为可复现
图片预览/导出一致性	T-103	共享几何算法和像素测试通过

任一闸门失败时，先在 T-104 记录证据和替代方案，由用户决定是否调整技术路线，不继续堆业务代码。

完成判据

当 T-005 完成后，本接入清单视为完成。后续状态只在 current-state.md、06-tasks.md 和 progress.md 维护，不继续修改本文的历史勾选。