workos-office / docs /11_Workspace_Service /requirements.json
dellweb3's picture
Work OS validated demo local-v0.8
99caad5 verified
Raw History Blame Contribute Delete
9.69 kB
{
"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
}