# GoAuto 移动采集管理平台

GoAuto 使用 go-admin、go-admin-ui 和 Android Portal/Agent 跑通 PDD 商品采集闭环：人工添加 PDD 链接、创建采集规则、创建任务、由 Android 执行并在任务详情查看结构化结果。

当前 MVP 只包含 PDD 商品、采集规则、采集任务、Android 执行和任务详情结果。顺云宝、Shopee、采购、批量任务、规则发布流程、全局停机和实时屏幕均不在当前范围。

## 阅读入口

1. [项目档案](docs/00-project-profile.md)
2. [开发工作流](docs/01-workflow.md)
3. [架构与代码地图](docs/02-architecture-and-code-map.md)
4. [业务规则与术语](docs/03-business-rules-and-glossary.md)
5. [本地开发与验证](docs/04-local-development-and-verification.md)
6. [常见修改](docs/05-common-changes.md)
7. [故障排查](docs/06-troubleshooting.md)
8. [MVP 需求](docs/07-mvp-requirements.md)
9. [共享 API 契约](docs/08-agent-api-contract.md)
10. [一期交付工单索引](docs/09-delivery-issues.md)
11. [交互原型](prototypes/README.md)

旧版 ADB/Portal 验证代码、日志和诊断资料已归档到本机 `demo/`，该目录不进入 Git。

## 当前状态

- 需求和技术边界已确认。
- Harness Coding 文档和工单已建立。
- 服务端与 Android 端为可交互 HTML 原型。
- `server/` 已固定导入 go-admin `v2.3.0`。
- `web/` 已固定导入 go-admin-ui `v3.0.0`。
- `android/` 已建立 Kotlin/SDK 34 Agent 骨架。
- 最小闭环 8 张业务表、迁移和唯一约束测试已经落地。
- 设备首次自注册、Token 认证、停用和吊销接口已经落地。
- Token 心跳、在线/离线、空闲/忙碌和离线任务失败已经落地。

## 验证

```powershell
.\scripts\verify.ps1 -Component all
```

也可以把 `all` 改为 `server`、`web` 或 `android` 单独验证。