Files
shop_helm/docs/adoption-checklist.md

42 lines
1.9 KiB
Markdown

# 空项目初始化与 Harness 接入清单
> ShopHelm 当前从空目录起步。本文只记录从“文档基线”进入“可运行代码基线”的一次性准备状态。
## 文档基线
- [x] 建立 `AGENTS.md` 和 AI 开工入口。
- [x] 固定产品愿景、需求范围和首发验收。
- [x] 固定 Go + Gio、SQLite、外部 Chrome 技术路线。
- [x] 定义模块边界、数据模型、页面和本地服务合约。
- [x] 建立单 agent 任务看板、执行流水和当前状态。
- [x] 建立验证、收尾、评审和质量跟踪文档。
## 代码基线
- [x] 初始化 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`](06-tasks.md) 到 T-005 逐项完成,不在文档初始化任务中顺带生成未经验证的业务代码。
## 首轮决策闸门
完成工程基线后,必须在扩展业务页面前验证:
| 闸门 | 任务 | 通过标准 |
| --- | --- | --- |
| Gio 管理台可用性 | T-101 | 真实字段表格、筛选和表单在 Windows 上可用 |
| Chrome/profile 安全启动 | T-102 | 参数、占用、退出和代理行为可复现 |
| 图片预览/导出一致性 | T-103 | 共享几何算法和像素测试通过 |
任一闸门失败时,先在 T-104 记录证据和替代方案,由用户决定是否调整技术路线,不继续堆业务代码。
## 完成判据
当 T-005 完成后,本接入清单视为完成。后续状态只在 `current-state.md`、`06-tasks.md` 和 `progress.md` 维护,不继续修改本文的历史勾选。