goauto/docs/00-project-profile.md

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Project-Profile wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Project-Profile.- wiki_revision: 03ea269058b50fea2be7842b9c284018987c82d9 synchronized_at: 2026-09-21T08:14:21Z

项目档案

基本信息

项目	内容
项目名称	GoAuto 移动采集与采购管理平台
一句话目标	管理 Android 手机，采集 PDD 商品资料，并在独立高风险阶段支持创建待付款采购订单
主要使用者	管理员、采购人员、开发维护者
Gitea 仓库	OPC/goauto
默认分支	main
当前已实施范围	PDD 商品与采集闭环、虾皮/SYB 商品档案与导入、采购任务服务、Admin 采购管理与人工处理、Android 采购演练，以及 #36 已实现但尚未真机授权验证的正式地址/待付款订单能力
后续设计范围	从 SYB 创建采购任务、创建待付款订单、物流采集与自动回填
预计规模	20 台 Android；每天约 100 个采集任务、200 个采购任务

项目治理模式

GoAuto 默认采用轻量治理：文案、注释、格式、局部样式或布局、预期行为明确的小 Bug，以及不改变接口、数据结构、权限和安全边界的单模块低风险调整可以直接实施，无需为了留痕补建工单。完整独立需求、新页面、跨模块功能，以及涉及 API、数据结构、权限、安全、迁移或范围不明确的变化必须建立单元工单。采购、创建订单、真实个人或生产数据、权限、安全、并发、迁移、删除、发布和不可逆操作始终升级为高风险，必须具备对象和范围明确的人工授权；已有有效授权时不机械重复确认，范围或环境发生实质变化时重新确认。永久禁止付款以及设备、隐私、AI 和真机安全红线不可裁剪。

建设基线

基线	来源与版本	许可证 / 使用方式	GoAuto 适配
DevHarness	D:\OPC\dev_harness，目标提交 ecab899	开发流程与文档模板	2026-09-05 升级（#221）：在既有单人工单事实源基础上，选择性加入轻量治理、明确授权边界、中文默认沟通、Windows PowerShell 安全规则，以及按 revision 增量同步与显式深度检查；继续保留 GoAuto 专用高风险与安全门禁
服务端	go-admin v2.3.0	上游开源管理端基线；升级时复核许可证和安全公告	保留认证、菜单、配置和管理端基础能力，新增 GoAuto 业务模块
管理端	go-admin-ui v3.0.0，web/package.json 标注 MIT	Vue 管理界面基线	保留应用外壳与通用组件，新增 GoAuto 页面
Android	原生 Kotlin Agent	自研业务客户端	通过管理员明确配置的 HTTP 或 HTTPS Origin 直连服务端，不保留 Windows 桌面 Client/ADB 作为生产拓扑

升级必须比较当前记录的目标提交与新的明确提交，不能笼统复制“最新版”。本次上一基线为 4bbacf4d7fb265984396bb5589c544105043fa0b，目标为 ecab899，选择性适配其后的 7 个提交；更早基线适配见 #47 与 #114。模板内容一律按 GoAuto 事实改写：不复制 DevHarness 的项目事实、任务记录、占位部署参数或历史归档；harness.py 继续校验 GoAuto 实际核心页面与产品 README，GoAuto 更严格的付款、订单、设备、数据和真机门禁继续优先。

交付单元

目录	职责	技术栈	独立验证
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/	用户或项目规则明确要求时导出的版本化 HTML 原型快照；既有快照保留	HTML/CSS/JavaScript	入口、交互、相对资源和敏感信息检查
docs/	核心 Wiki 的本地只读镜像、版本绑定分析和规则文件	Markdown、JSON	Wiki 镜像一致性、链接、结构和差异检查

跨端共享契约以 Android Agent API 契约 为唯一事实来源。各交付单元可以独立构建和验证，但共享字段、状态或能力变化必须在同一工单中验证所有受影响端。

文档事实来源

• Gitea 工单是单次任务需求、变化、实现、测试、提交和验收的唯一事实来源。
• Gitea Wiki 只保存长期产品需求、架构、业务规则、开发规范、共享契约、安全边界和操作说明。
• Git docs/ 保存核心 Wiki 的只读镜像，以及与代码版本绑定且未映射到 Wiki 的分析和规则文件。
• QuantUX 保存可编辑交互原型；工单必须记录可访问链接、App ID、版本或确认日期和审核状态。本地 HTML 只在用户或项目规则明确要求时按版本导出。
• Gitea Wiki 已于 2026-08-17 完成核心页面迁移、显式映射和单向同步验证，长期文档采用 Wiki-first。
• 只有长期事实变化时才按修改 Wiki、读取 revision、导出本地镜像、检查一致性并提交的顺序更新；无长期影响的任务不运行 Wiki 同步。不得直接编辑镜像后反向覆盖 Wiki。
• 既有 Wiki 任务归档和 docs/task/ 只作历史兼容；标准任务不创建，只有用户明确要求专项快照时才使用 archive / export。

环境与凭据

• 服务端正式环境默认必须使用 HTTPS。仅当管理员接受 Device Token、任务内容和执行结果明文传输风险，并显式设置 GOAUTO_ALLOW_INSECURE_AGENT_HTTP=true 时，Agent /api/agent/v1/** 可通过 HTTP；管理端和第三方服务不因此放宽。
• #237 客户端密钥例外（用户 2026-09-07 明确接受风险）：提交 71f7751 起，管理员密钥管理及 /api/client/v1 默认兼容 HTTP/HTTPS，无开关；HTTP 明文传输密钥及业务数据，建议优先 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 构建已通过，但未安装到真机、未修改真实地址、未点击真实创建订单，等待用户独立授权验证。