Files
EveryPublish/docs/delivery-plan.md
T

36 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 参考仓库的只读副本和许可证。
- 自动化测试与浏览器验收报告。