docs: establish project harness baseline

2026-07-25 16:59:06 +08:00
commit 50a6d8ee5b
30 changed files with 2742 additions and 0 deletions
@@ -0,0 +1,57 @@
+# 采购自动化验证系统
+
+本项目面向采购管理人员和采购执行人员，目标是将后台采集的商品标题、描述、图片、
+数量和预算转成 Android 端可执行的采购任务，并验证 AI 辅助拼多多检索和候选商品
+判断是否可靠。
+
+第一版只验证：
+
+```text
+后台创建任务
+  -> Android App 手动领取
+  -> VLM 解析图片与文字
+  -> 拼多多搜索和候选比较
+  -> 停在人工确认位置
+  -> 回传结果、截图和失败原因
+```
+
+MVP 不自动提交订单、不支付、不绕过验证码或平台风控。
+
+## 目标结构
+
+```text
+cmroubao/
+├── android-buyer/       # 基于 Roubao 二次开发的采购 App，待接入
+├── backend-api/         # Go-Gin API、管理页面和任务数据，待创建
+├── docs/                # Harness Coding 项目事实和执行约束
+├── AGENTS.md            # AI coding agent 权威入口
+├── init.ps1             # Windows 标准验证入口，待 T-001 配置
+└── init.sh              # Unix/WSL 等价入口，待 T-001 配置
+```
+
+管理人员使用 Web 管理端，采购人员使用 Android App；二者共享同一后端、任务数据
+和权限体系。验证版先使用单管理账号和设备身份，完整 RBAC 放到验证通过后。
+
+后端已确定采用 Go 1.23.0 + Gin 1.11.0，并用 Go Blueprint v0.10.11 生成最小
+Gin + SQLite 骨架后按领域边界二次开发。
+
+Android 端已核实的 Roubao 上游环境为 Kotlin 1.9.20、JDK 17、Gradle 8.2、
+AGP 8.2.0、Android SDK 34，以及 Jetpack Compose Compiler 1.5.5。最低支持
+Android 8.0（API 26），目标为 Android 14（API 34）。具体版本和本机环境状态见
+[`docs/03-tech-stack.md`](docs/03-tech-stack.md) 与
+[`docs/current-state.md`](docs/current-state.md)。
+
+## 文档入口
+
+- [AI 开发入口](docs/00-ai-start-here.md)
+- [项目愿景](docs/01-vision.md)
+- [需求与 MVP 验收](docs/02-requirements.md)
+- [技术栈](docs/03-tech-stack.md)
+- [架构设计](docs/04-architecture.md)
+- [API 合约](docs/api.md)
+- [任务路线图](docs/06-tasks.md)
+- [当前实现状态](docs/current-state.md)
+- [完整文档导航](docs/README.md)
+
+当前仓库只有文档，还没有接入 Roubao、后端代码或可构建 APK。真实状态以
+[`docs/current-state.md`](docs/current-state.md) 为准。