2.6 KiB
2.6 KiB
EveryPublish Web-only V1 交付计划
当前唯一有效排期。macOS/Windows 客户端线暂停；不以客户端安装、配对或 Agent WSS 作为 V1 门槛。
1. 交付目标
在本机启动 Go server 和 React Web，用户通过浏览器完成登录、账号登录/扫码、素材上传、发布任务、审核、挑战、日志和结果查看。真实平台按 adapter 逐个验收，mock executor 先保证业务全链路可重复测试。
2. 排期
| 阶段 | 内容 | 验收证据 |
|---|---|---|
| W1 | 清理客户端/Agent 网页依赖、确认 Web-only 路由/数据模型、参考仓库分析 | 客户端/设备页面不在菜单；Agent 路由返回 404；逻辑图与 README 一致 |
| W2 | 认证、工作区、成员、权限、审计加固 | Go API 集成测试 + 浏览器登录回归 |
| W3 | 素材库流式上传、去重、预览、删除、直链 | 真实 multipart + 重复 SHA 测试 |
| W4 | 账号台账、Cookie 导入、网页扫码挑战、账号健康状态 | mock QR/挑战状态机、Cookie 导入契约、挂起/重发/空确认值和 B站轮询 stub 已测试；真实扫码由用户验收 |
| W5 | 新建发布、任务状态机、审核、排期、取消/重试、数据库事件 | mock/web smoke、真实 adapter 逐账号执行、context cancel、成功/驳回/重提/取消时间线已测试 |
| W6 | 挑战中心、通知、实时 Browser WS、断线 REST 兜底 | WebSocket 注入断开 + 页面状态恢复 |
| W7 | 平台 adapter：当前先完成 B站，再逐个平台接入 | B站 HTTP stub、错误分类、凭据隔离和上传链路通过；真实扫码/投稿必须人工验收，未接入平台不冒充真实成功 |
| W8 | 全页面视觉整理、部署脚本、文档审校和发布验收 | API/TypeScript/build/smoke 已通过；浏览器控制服务恢复后逐页验收，用户随后手动验收真实发布 |
3. 每阶段停止条件
- 任一阶段接口测试不通过，不进入下阶段。
- 真实扫码无法执行时，只能标记“QR 已生成、等待用户扫码”，不能标记账号 active 或发布成功。
- mock executor 只能证明任务状态机，不证明目标平台发布。
- 失败重试必须有错误分类和日志，不允许吞掉异常。
4. V1 交付物
apps/web：React + TDesign 网页控制台。server：认证、业务 API、Browser WS、WebExecutor/PlatformAdapter、MySQL/Redis。docs/web-only-v1-plan.md、docs/web-only-logic-diagrams.md、docs/reference-repositories-analysis.md。references/：三个 MIT 参考仓库的只读副本和许可证。- 自动化测试与浏览器验收报告。