{ "source": "docs/11_Workspace_Service/README.md", "requirements": [ { "phase": "P0", "id": "WS01-01", "requirement": "首次登录为每位用户创建唯一个人空间;重复登录复用", "dependencies": "Identity Principal、PostgreSQL", "acceptance": "A 连续登录 3 次仅 1 个 home;B 是另一个;DB 有唯一约束" }, { "phase": "P0", "id": "WS01-02", "requirement": "个人空间下创建、列出、进入事项;有标题、归属、状态、版本", "dependencies": "WS01-01、Gateway API-05–07", "acceptance": "A/B 各建 2 件,各列表只见自己的 2 件;重启后仍存在" }, { "phase": "P0", "id": "WS01-03", "requirement": "事项重命名按 expected_version 比对", "dependencies": "WS01-02、API-08", "acceptance": "旧版 PATCH 409;成功后版本+1,标题不丢" }, { "phase": "P0", "id": "WS01-04", "requirement": "所有子资源统一租户+用户+事项授权", "dependencies": "Identity、WS01-02", "acceptance": "B 对 A 的事项、消息、附件、草稿、Skill URL 读写均 404;拒绝有审计" }, { "phase": "P0", "id": "WS01-05", "requirement": "事项列表稳定分页,切换事项不串消息或附件", "dependencies": "WS01-02", "acceptance": "20+ 事项翻页不漏/不重;A1 切 A2 内容独立" }, { "phase": "P0", "id": "WS01-06", "requirement": "事项 Skill 选择保留 ID、版本、顺序,更新按绑定版本 CAS", "dependencies": "Agent Skill Catalog、API-22", "acceptance": "重开事项仍保留;不可用 Skill 422;并发旧版 409;运行读同一快照" }, { "phase": "P0", "id": "WS01-07", "requirement": "创建事项按幂等键和请求哈希去重", "dependencies": "WS01-02", "acceptance": "同键同体返回同一事项;同键异体 409,无第 2 件" }, { "phase": "P0", "id": "WS01-08", "requirement": "事项状态投影消费 Runtime 事件并对账", "dependencies": "Runtime run 事件", "acceptance": "乱序/重复不倒退状态;完成后列表与 run 一致" }, { "phase": "P2", "id": "WS01-09", "requirement": "共享事项和管理员授权另立角色模型", "dependencies": "客户角色矩阵", "acceptance": "未审批前接口不开放;审批后另立验收" }, { "phase": "P0", "id": "WS02-01", "requirement": "用户消息写入当前事项,带主体、顺序、时间和内容", "dependencies": "WS01-04、API-10", "acceptance": "A1 写 3 条,刷新/重启仍为 3 条;A2/B 看不到" }, { "phase": "P0", "id": "WS02-02", "requirement": "Agent 助手消息仅在授权事项及真实 run 上追加", "dependencies": "Runtime、WS01-04", "acceptance": "错事项/run 委托写入拒绝;合法结果只在该事项可见" }, { "phase": "P0", "id": "WS02-03", "requirement": "消息按服务端序号稳定分页", "dependencies": "WS02-01、API-09", "acceptance": "100 条分页读完 ID 与 DB 一致,无重复/遗漏" }, { "phase": "P0", "id": "WS02-04", "requirement": "消息写入幂等;键同而正文变化 409", "dependencies": "WS02-01", "acceptance": "重试不多一条;异文重用键 409" }, { "phase": "P1", "id": "WS02-05", "requirement": "审计、内容长度和保留策略可配置", "dependencies": "客户留存要求", "acceptance": "超限 422,审计无正文,客户确认策略后迁移验证" }, { "phase": "P0", "id": "WS03-01", "requirement": "上传 DOCX/PDF/TXT/MD,单件≤10 MiB、事项最多 5 件", "dependencies": "WS01-04、StoragePort、API-12", "acceptance": "四类样本可传;第 6 件/超限/非法文件给 409/413/422,不落半文件" }, { "phase": "P0", "id": "WS03-02", "requirement": "持久化原件及元数据:随机逻辑键、大小、MIME、SHA-256", "dependencies": "WS03-01、PostgreSQL", "acceptance": "重启后列表仍在;实际 hash 与记录一致;DB 无 Windows 绝对路径" }, { "phase": "P0", "id": "WS03-03", "requirement": "下载时重验 owner,阻断路径穿越/软链接逃逸", "dependencies": "WS01-04、API-13", "acceptance": "B 下载 A 的文件 404;伪造键/../ 无法越根;本人下载 hash 不变" }, { "phase": "P0", "id": "WS03-04", "requirement": "上传后发解析请求,展示 uploaded/parsing/ready/failed", "dependencies": "Knowledge 回执、outbox", "acceptance": "成功为 ready、失败为 failed+安全错误码;重复回执无重复效果" }, { "phase": "P0", "id": "WS03-05", "requirement": "DB/文件部分失败可清理或 reconcile", "dependencies": "WS03-01/02", "acceptance": "注入 DB 提交失败后无可见附件;扫描能报告并清理孤儿" }, { "phase": "P1", "id": "WS03-06", "requirement": "云对象存储 adapter 和 manifest 迁移", "dependencies": "腾讯云存储/权限", "acceptance": "导入后逐件 hash 相同,授权下载一致" }, { "phase": "P2", "id": "WS03-07", "requirement": "OCR、病毒扫描、敏感信息策略另行选型", "dependencies": "安全/OCR 产品", "acceptance": "新用例另立;PC 文本资料不依赖" }, { "phase": "P0", "id": "WS04-01", "requirement": "Agent 在当前事项创建带引用的草稿 v1", "dependencies": "WS01-04、Runtime、Knowledge 引用", "acceptance": "生成后正文、版本、hash、引用可查;重启仍可取" }, { "phase": "P0", "id": "WS04-02", "requirement": "每次编辑新增不可变版本,保留历史正文/hash", "dependencies": "WS04-01、API-29", "acceptance": "连改两次得 v1/v2/v3,v1 正文和 hash 不变" }, { "phase": "P0", "id": "WS04-03", "requirement": "expected_version 乐观锁防覆盖", "dependencies": "WS04-02", "acceptance": "两客户端同时以 v1 保存,仅一成功,另一 409;无丢失" }, { "phase": "P0", "id": "WS04-04", "requirement": "人工确认绑定 artifact_id+version+content_hash", "dependencies": "Runtime API-27、WS04-02", "acceptance": "v1 确认后编辑 v2,旧确认不能导出 v2;错 hash/owner 拒绝" }, { "phase": "P0", "id": "WS04-05", "requirement": "Tool 只读已确认精确版本;回执与版本关联", "dependencies": "Tool Gateway、WS04-04", "acceptance": "v2/hash2 返回 v2;v1/hash2 拒绝;下载对应版本" }, { "phase": "P0", "id": "WS04-06", "requirement": "草稿及版本文件下载始终校验 owner", "dependencies": "WS01-04、API-28/30", "acceptance": "B 对 A 草稿和各版本内容均 404" }, { "phase": "P1", "id": "WS04-07", "requirement": "历史比较与恢复产生新版本", "dependencies": "WS04-02、Portal", "acceptance": "恢复 v1 时创建 vN+1,旧版本仍可审计" }, { "phase": "P2", "id": "WS04-08", "requirement": "正式 OA 发文回写、电子签章另用 Adapter", "dependencies": "OA 系统/客户授权", "acceptance": "未联通前 capability=false;另立端到端验收" }, { "phase": "P0", "id": "WS-X01", "requirement": "Repository 真连 PostgreSQL,迁移脚本可重复部署", "dependencies": "DB、Alembic", "acceptance": "空库迁移→接口写入→重启→数据仍在;fixture 不计通过" }, { "phase": "P0", "id": "WS-X02", "requirement": "事务内写 outbox、可重试和去重发布", "dependencies": "WS-X01、消费者", "acceptance": "注入发布失败再恢复,事件最终有一次业务效果,无已提交事项缺事件" }, { "phase": "P0", "id": "WS-X03", "requirement": "Gateway/Workspace 错误和 trace 可追踪", "dependencies": "Gateway、日志", "acceptance": "一次失败按 trace 找到调用;日志无 token、正文、物理路径" }, { "phase": "P0", "id": "WS-X04", "requirement": "完整双用户 E2E、并发与故障回归", "dependencies": "WS01–04", "acceptance": "自动化脚本/日志留存;PC 从空状态走完办文,不借 WS 桩" }, { "phase": "P1", "id": "WS-X05", "requirement": "腾讯云单机迁移、备份恢复、manifest 对账", "dependencies": "云主机/存储", "acceptance": "恢复后 A/B 事项、附件、版本和 hash 与迁移前一致" }, { "phase": "P2", "id": "WS-X06", "requirement": "麒麟 V10 SP3 + 海光目标机实测", "dependencies": "目标硬件/OS/依赖包", "acceptance": "同一合同及隔离脚本通过,记录 CPU/OS/包版本及失败项" } ], "version": "1.0", "count": 35 }