6.6 KiB
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Project-Profile wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Project-Profile.- wiki_revision: a1f90d0ff56ce30ace6febbe5de859f3e20ca5fd synchronized_at: 2026-08-24T08:21:02Z
项目档案
基本信息
| 项目 | 内容 |
|---|---|
| 项目名称 | GoAuto 移动采集与采购管理平台 |
| 一句话目标 | 管理 Android 手机，采集 PDD 商品资料，并在独立高风险阶段支持创建待付款采购订单 |
| 主要使用者 | 管理员、采购人员、开发维护者 |
| Gitea 仓库 | OPC/goauto |
| 默认分支 | main |
| 当前已实施范围 | PDD 商品与采集闭环、虾皮/SYB 商品档案与导入、采购任务服务、Admin 采购管理与人工处理、Android 采购演练，以及 #36 已实现但尚未真机授权验证的正式地址/待付款订单能力 |
| 后续设计范围 | 从 SYB 创建采购任务、创建待付款订单、物流采集与自动回填 |
| 预计规模 | 20 台 Android；每天约 100 个采集任务、200 个采购任务 |
建设基线
| 基线 | 来源与版本 | 许可证 / 使用方式 | GoAuto 适配 |
|---|---|---|---|
| DevHarness | D:\OPC\dev_harness，目标提交 bfdf648962d11a8024f62768380d8571e1f45f68 |
开发流程与文档模板 | 2026-08-19 升级（#47）：命令入口合并为 harness.py、项目档案改按需读取、新增 Wiki 初始化门禁与本地 HTML 审核快照、统一 LF 行尾；2026-08-24 再按 #76 精简为单人工单事实源、长期 Wiki 和按需历史快照；保留 GoAuto 专用安全与设计门禁 |
| 服务端 | go-admin v2.3.0 |
上游开源管理端基线；升级时复核许可证和安全公告 | 保留认证、菜单、配置和管理端基础能力，新增 GoAuto 业务模块 |
| 管理端 | go-admin-ui v3.0.0，web/package.json 标注 MIT |
Vue 管理界面基线 | 保留应用外壳与通用组件，新增 GoAuto 页面 |
| Android | 原生 Kotlin Agent | 自研业务客户端 | 通过 HTTPS 直连服务端，不保留 Windows 桌面 Client/ADB 作为生产拓扑 |
升级必须比较当前记录的目标提交与新的明确提交，不能笼统复制“最新版”。上一基线为 b1f500128d6eb100985792d4a715db8b6b5ae203（2026-08-17），本次升级区间共 12 个提交。模板内容一律按 GoAuto 事实改写：harness.py 的核心文档校验清单已改为 GoAuto 实际文档结构，README 校验改为产品 README 结构（新项目 Wiki 初始化门禁改由 AGENTS.md 与开发工作流承载）。
交付单元
| 目录 | 职责 | 技术栈 | 独立验证 |
|---|---|---|---|
server/ |
go-admin API、任务调度、规则、设备连接、结果持久化 | Go 1.26.5、go-admin v2.3.0、MySQL 8.4 | Go 单元与构建验证 |
web/ |
go-admin-ui 管理端 | Vue、go-admin-ui v3.0.0、pnpm | lint、生产构建、浏览器验收 |
android/ |
Portal/Agent、注册保活、任务执行和结果提交 | Kotlin 1.9.22、Android SDK 34 | Android 单元测试、APK 构建与真机验收 |
prototypes/ |
与代码版本绑定的服务端和 Android HTML 原型 | HTML/CSS/JavaScript | 静态检查、浏览器人工验收 |
docs/ |
核心 Wiki 的本地只读镜像、版本绑定分析和规则文件 | Markdown、JSON | Wiki 镜像一致性、链接、结构和差异检查 |
跨端共享契约以 Android Agent API 契约 为唯一事实来源。各交付单元可以独立构建和验证，但共享字段、状态或能力变化必须在同一工单中验证所有受影响端。
文档事实来源
- Gitea 工单是单次任务需求、变化、实现、测试、提交和验收的唯一事实来源。
- Gitea Wiki 只保存长期产品需求、架构、业务规则、开发规范、共享契约、安全边界和操作说明。
- Git
docs/保存核心 Wiki 的只读镜像，以及与代码版本绑定且未映射到 Wiki 的分析和规则文件。 - QuantUX 保存外部交互原型；工单必须记录 App ID、链接和草稿/确认状态。
- Gitea Wiki 已于 2026-08-17 完成核心页面迁移、显式映射和单向同步验证，长期文档采用 Wiki-first。
- 只有长期事实变化时才按修改 Wiki、读取 revision、导出本地镜像、检查一致性并提交的顺序更新；无长期影响的任务不运行 Wiki 同步。不得直接编辑镜像后反向覆盖 Wiki。
- 既有 Wiki 任务归档和
docs/task/只作历史兼容；标准任务不创建，只有用户明确要求专项快照时才使用archive/export。
环境与凭据
- 服务端正式环境必须使用 HTTPS。
- 每台设备使用独立 Device Token；Token 只存安全配置，不进入仓库。
- PDD 账号密码、Cookie、验证码和用户个人数据不得进入日志。
- 根目录
gitea.env是本机工单访问配置，已被 Git 忽略。 - 根目录
config.yaml是本机数据库和端口配置，已被 Git 忽略；示例见config.example.yaml。 demo/是旧 PoC 的本地归档，已被 Git 忽略，不是新产品代码入口。
当前阶段
当前采集 MVP 的 T01～T22 和 T24 已完成实现并由用户验收；T08 只读实时屏幕已延期。T23、T25～T28 的一加真机增强、假售罄恢复、浏览器重开恢复和端口配置已经实现，其中部分工单仍等待用户验收。T24 的规格遍历已在一加和三星真机复核；三星未识别评价数量的问题由用户确认暂不处理。
#31 PDD 商品档案原型、数据库、API、Admin 页面和采集结果写回已于 2026-08-17 通过用户验收；#45 PDD 商品列表批量采集入口已于 2026-08-18 通过用户验收。#32 采购闭环原型及后续采购工单仍按各自门禁推进。采购永不支付，真实地址修改和创建订单属于必须再次人工确认的高风险范围。
#40、#41、#49～#52 已于 2026-08-20 通过用户验收，虾皮/SYB 商品档案、店铺过滤、异步同步记录、列表布局和 MySQL 同步缺陷修复均已完成。
#33、#34、#42 已于 2026-08-20 通过用户验收，采购数据契约、服务端状态机和 Android 安全演练基线已经完成。#35、#55、#56 已于 2026-08-21 通过用户验收，Admin 采购管理、列表与详情查询以及 go-admin 成功响应兼容已经完成。#36 已在 Android Agent 0.2.0 实现正式地址后缀、不可逆门禁、一次性创建待付款订单和只读核单；自动化测试与 APK 构建已通过，但未安装到真机、未修改真实地址、未点击真实创建订单，等待用户独立授权验证。