feat(admin): initialize procurement service skeleton

This commit is contained in:
QiuSW
2026-08-03 18:13:30 +08:00
parent b7559a9451
commit c72371ce90
11 changed files with 288 additions and 37 deletions
+30 -23
View File
@@ -12,30 +12,29 @@
## 当前快照
- 日期:2026-08-03
- 阶段:**Phase 0 · 地基(先确认原型,尚未开始生产编码)**
- 阶段:**Phase 0 · 地基(采购服务骨架完成,采购工具骨架进行中)**
- MVP 形态:手工填链接建单 → 批量开始试选 → 定时轮询 → **第一趟试选** → 人工确认 → **第二趟下单** → 待付款
- 技术栈:已定。采购服务(`admin/`)使用 Go 1.23+ / gin / SQLite;采购工具(`client/`)
使用 Python 3.11+ / uiautomator2 / PySide6。
详见 [`03-tech-stack.md`](03-tech-stack.md)
- 生产代码:**无**。仓库目前只有文档
- 测试:**无**
- 生产代码:`admin/` 已有最小 Go 服务、`GET /healthz` 与 SQLite 驱动封装;尚无采购业务代码
- 测试:采购服务 2 项离线单元测试
- 数据:**无**
- 标准启动路径:`./init.ps1`(Windows)/ `./init.sh`。已存在,以 `admin/go.mod` 和
`client/requirements.txt` 判断两端是否初始化;当前会以退出码 3 结束并列出 T-001 / T-002
——这是预期行为
- 标准验证路径:目前只有 `python scripts/validate_agent_context.py` 可跑通
- 当前 blocker:无外部 blocker。T-001 / T-002 尚未落成任务文件和初始化代码;两者是
下一波可并行任务。T-002 完成后立即进入 T-101,不等待整个 Phase 0 收尾。
- 标准启动路径:`./init.ps1`(Windows)/ `./init.sh`。当前会验证采购服务,再因
`client/requirements.txt` 尚不存在以退出码 3 提示 T-002——这是预期行为
- 标准验证路径:`admin/` 下运行 `go test ./...`、`go vet ./...`、`go build ./...`;仓库根运行
`python scripts/validate_agent_context.py`
- 当前 blocker:无外部 blocker。T-002 正在实现;T-004 已因 T-001 完成而可领取。
## 当前目录要点
| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `docs/` | 已有 | 项目规范化文档,本次已完整生成 |
| `docs/tasks/` | 已有(T-005~T-009) | T-005~T-008 已完成;T-009 记录关键路径与并行波次 |
| `docs/tasks/` | 已有(T-001、T-002、T-005~T-009) | T-001 已完成;T-002 正在进行;其余既有任务已完成 |
| `docs/design/` | 已有(6 个原型) | web 登录 / 建单 / 工作台 / 详情,desk 采购执行 / 配置;均已人工确认 |
| `scripts/` | 已有 | 上下文门禁、Vikunja 单向导出与 MCP 启动包装 |
| `admin/` | **待建** | “采购服务”Go 后端与管理页面(T-001) |
| `admin/` | 已初始化 | Go 1.23+ / gin / SQLite 骨架与健康检查;无采购业务路由 |
| `client/` | **待建** | “采购工具”Python 桌面端(T-002) |
| `init.ps1` / `init.sh` | 已有(骨架) | 统一入口。两端目录建好后由 T-003 补全并验证 |
@@ -44,29 +43,37 @@
任务状态以 `docs/tasks/` 各任务文件 frontmatter 的 `status` 为准。本节只写项目级摘要:
- 已完成:T-005(采购服务交互原型)、T-006(采购工具交互原型)、T-007(产品名称与
源码目录契约)、T-008(Vikunja 任务权威与单向导出)、T-009(MVP 关键路径与并行波次)。
- **下一步:并行落成并启动 T-001 与 T-002。** T-001 完成后可推进 T-004;T-002 完成后
立即推进 T-101 → T-102 → T-103;两端骨架都完成后可并行补 T-003。
源码目录契约)、T-008(Vikunja 任务权威与单向导出)、T-009(MVP 关键路径与并行波次),
以及 T-001(采购服务 Go 骨架)。
- 正在进行:T-002(采购工具 Python 骨架)。采购服务方向可并行落成 T-004;T-002 完成后
立即推进 T-101 → T-102 → T-103,并可补 T-003 统一入口。
- T-103 是当前最高优先级和 MVP 生死线。通过前不开发依赖真机可读字段的 Phase 2 生产页面。
- 已确认原型继续只作信息架构依据;原型假数据不调用真实接口、不驱动真机。真机结论改变
可读字段时必须先回修原型与交互清单。
## 当前可运行内容
**目前没有可运行的代码。** 唯一可运行的检查:
采购服务当前可运行:
```bash
# 校验 agent 上下文清单
cd admin
go mod download
go run ./cmd/server
```
采购服务验证与仓库级上下文门禁:
```bash
cd admin
go test ./...
go vet ./...
go build ./...
cd ..
python scripts/validate_agent_context.py
```
T-001 / T-002 完成后,本节替换为真实命令:
```bash
# 采购服务 admin/(T-001 后填写)
# 采购工具 client/(T-002 后填写)
# 统一入口(T-003 后填写)
```
采购工具与统一入口的真实命令分别等待 T-002、T-003 完成后补齐。
## 关键背景