历史 · oceanway-drama 实施计划
重构前档案，仅供追溯，不作为新版本执行指令
历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。
仓库：Oceanway-AI/oceanway-drama。来源仓库已从 manju-workbench 重命名并保留历史；正式产品 Host 尚待确认。
目标结果与当前基线
Drama 是独立建设的漫剧工作台。仓库保留需求历史，当前主要产物为需求文档，不能据此标记已有完整应用或正式运行服务。仓库 v2/README.md 自述 V2 为当前完整需求基线，需在本轮由项目负责人确认其与平台架构的对应关系。
原平台架构使用 Episode、Scene、Shot、Review、Composition；V2 使用分集剧本、生产剧本基线、资产/变体/出现位置、文字分镜、视频段、生成工作区与正式结果选择。D-DRAMA-V2 是首轮必须确认的需求和术语映射决策：V2 明确终点为正式视频段下载、外部剪辑，不能直接把旧架构中的 Composition/Episode Master 合并进首期。下列里程碑编号保留为既有规划索引，涉及旧术语与合成的范围在决策前不作为开发授权。
Drama 私有生产聚合由本仓维护；共享 Asset、Run、Agent、MCP、Model Offering 与 Billing 由对应平台 Owner 提供，不能复制第二事实源。Studio 的 /drama 明确保留和维护，不搬代码、路由或用户数据到独立 Drama；若长期架构材料仍要求迁走旧路由，以本轮差异记录为依据先澄清。
依赖与输出
| 类型 | 内容 |
|---|---|
| 上游 | Customer/Tenant、Project、Asset/Canvas、Run/Agent、Model Offering、Billing Contract |
| 写回 | Core/Studio 只返回候选 Asset/Version；设为角色基准图、写回分镜等由 Drama 命令校验 |
| 输出 | Drama 聚合事件、稳定共享资源引用、浏览器生产链与费用证据 |
| 部署 | 目标为独立 Web/BFF 制品与待确认 Host；不接管 Studio /drama |
既有仓库里程碑（范围需经 D-DRAMA-V2 对齐）
- DRAMA-1 领域盘点：先确认 V2 与原 Project/Episode/Scene/Shot/Review/Composition 术语和范围的映射，再冻结项目资产与生产聚合 Owner。
- DRAMA-2 独立 Surface：完成 Customer Session、Tenant 上下文、CI、部署和 Host 决策。
- DRAMA-3 Asset 接入：现有角色/场景/道具和来源素材映射到稳定 Asset Version/Reference。
- DRAMA-4 统一执行：剧本、分镜、镜头生成按 Run/Step/Attempt 执行，费用进入统一 Billing。
- DRAMA-5 Agent 与 Handoff：接入项目 Agent、在 Studio/Canvas 打开、候选写回和审批。
- DRAMA-6 生产验收：按确认后的终点完成单集链路、刷新、失败、重试、撤权和费用演练；旧“到合成”范围与 V2 外部剪辑存在冲突，决策前不进入首期开发。
真实运行门禁与验收
- 正式生成等待 B3 的共享文本链和 B5 的 Media Gateway；此前可以整理领域和 UI，但不能创建第二套生产 Run/账本。
- 项目资产归项目/Organization，不因当前 Episode 筛选而改变所有权。
- 所有写回动作显式、幂等且经过 Drama 领域校验；共享系统不能静默覆盖剧本或镜头。
- 删除、重试与恢复使用稳定 ID，不按标题、Prompt 或媒体 URL 匹配。
- 回滚时已受理生成继续由原 Run/Attempt 完成，Drama 只切换后续命令路由。
本轮需求基线确认
按统一实施流程与本地协调工作。项目负责人一人承担产品、设计、后台和验收责任，文档中的编剧、资产制作、视频制作等是产品用户分工，不是开发团队分工。
| 用户与目标 | 已有来源 | 首轮要作出的决定 |
|---|---|---|
| 个人创作者/工作室制作成员 | V2 产品总纲：从已有剧本推进到各视频段正式结果 | 确认 V2 为本轮执行基线及明确排除项，不叠加 V1 与旧架构流程 |
| 项目管理员 | V2 锁稿、范围确认、正式选择和影响记录 | 角色到具体操作的权限映射、冲突处理、生产分工与权限的区别 |
| 只读成员/交付人员 | V2 授权查看、正式视频下载 | 下载内容和顺序、交付元信息；最终剪辑继续外部完成是否作为正式范围决定 |
需求审阅从 v2/需求文档/00-产品总纲与范围.md 到 11-验收矩阵与V1迁移.md，复用 MANJU-V2-* 编号。输出逐项“采用、调整、待确认、后续”与平台能力映射；不是重写第三套需求。Host、首期移动端范围、业务权限与平台 Identity 的结合、费用口径仍需单独确定，不把 V2 文档自述的固定项自动视为本轮新增批准。
待确认的首期主旅程与信息架构
V2 候选主旅程：上传剧本 → 解析并确认分集 → 逐集编辑与全剧锁稿 → 共享资产结构/扫描建议 → 滚动制作资产图 → 本集范围确认 → 文字分镜 → 视频段整理 → 普通工作台/画布生成 → 选择正式视频 → 按段下载。需求确认先验证这条链，再做视觉细化。
| 页面/区域 | 原型交付 | 关键状态与分支 |
|---|---|---|
| 项目、分集与剧本 | 上传、解析建议、编辑、锁稿和来源对照 | 无项目、解析失败、歧义、未锁稿、修订影响、并发保存冲突 |
| 项目共享资产 | 资产/变体/出现位置、建议纳入、图片生产单位与正式图 | 建议非事实、缺项、无图、部分结果、改选正式图、历史引用 |
| 本集生产准备 | 按场核对与范围确认，区分结构就绪和图片就绪 | 范围未确认、结构歧义、图片可后补、变更影响只阻断相关对象 |
| 文字分镜与视频段 | 剧本对照、草稿修订、组合/拆分/排序、进入段工作区 | AI 建议待采用、来源更新、未整理、局部就绪、已有结果保留 |
| 统一生成工作区 | 普通工作台与无限画布呈现同一段的任务、结果和正式选择 | 缺硬依赖、能力不支持、运行中、部分成功、失败/未知、刷新恢复 |
| 单集交付 | 当前正式结果与下载顺序 | 无正式选择、仍有失败/影响、可下载；任务成功不等于全剧完成 |
先交付桌面完整生产原型，移动端是浏览、审核、下载还是完整编辑由需求确认；适用的窄屏页面再纳入 390/430px 验收。复用统一品牌、表格、状态、媒体和画布基础，不从 Studio 整包导入业务页面。画布和普通视图不能各自维护任务/结果事实。
API 能力与领域责任草案
| 能力 | 产品/平台 Owner | 契约设计重点 |
|---|---|---|
| 项目、分集、锁稿与影响记录 | Drama 私有生产服务（待实现） | Revision/期望值、幂等锁稿、影响范围、历史不覆盖 |
| 资产结构、纳入建议、本集范围 | Drama 私有绑定；实际文件由共享 Asset Owner 管理 | 项目共享引用、范围修订、纳入与忽略、权限和血缘 |
| 分镜、视频段、工作区与正式选择 | Drama 领域服务（待实现） | 业务单位映射确认后冻结；正式选择与任务成功分离 |
| 文本/图片/视频任务与用量 | 目标 Core Run/Execution/Model Control/Billing | 固定输入快照、段级预检、结果登记、恢复和可重试语义 |
| 身份、项目授权与审计 | 平台 Identity/Policy/Audit；Drama 校验业务动作 | 共用身份，不新建 Drama IdP 或绕过项目权限 |
| 下载与跨产品候选写回 | Asset 权限服务 + Drama 绑定命令 | 保留来源、版本与原业务位置，不能覆盖正式选择 |
需求与原型阶段同步起草 API 能力文档，并关联 MANJU-V2-*、页面动作和数据 Owner。正文先描述输入/输出意义、状态、权限、并发、异步恢复、成本与错误；未发布服务不编造 HTTP 路由。确定接口后补 OpenAPI/Schema、分页、幂等、版本和合成示例，重点说明“分镜/视频段”“生成任务/结果/正式选择”“范围确认/图片就绪”的区别。
分阶段交付与依赖
- 需求对齐：完成 D-DRAMA-V2、范围和术语映射、V2 需求覆盖表；输出一条明确生产终点与首期不做清单。这一步不等待 B1/B3/B5。
- 设计与原型：先评审剧本到本集范围，再评审分镜到正式视频段；补双视图、回流和错误状态，形成数据/动作/API 草案。共享服务未完成时只用原型演示数据。
- 契约与领域实现：先实现已确认的产品数据与人工编辑保存，再接一个视频段的真实共享 Asset/Run 链；正式模型执行等待对应平台运行门禁。
- 生产链验收：按确认终点走通单集、刷新/断网/重启恢复、局部失败、改选/撤权、费用和下载；全剧完成依据业务数据，不依据百分比或单任务成功。