# 设计决策、假设与待确认事项

## 1. 用户已确认

| 编号 | 决策 | 来源与影响 |
| --- | --- | --- |
| C-01 | 短剧／故事生产线为核心 | 问答确认；不是四个孤立工具 |
| C-02 | 面向公众 SaaS | 需要身份、隔离、运营、支付、安全与风控 |
| C-03 | 积分／余额按次消费 | 首版不以订阅为主，账本与资金闭环是 P0 |
| C-04 | 优先 TypeScript | Web、API、Worker 与共享契约优先 TS |
| C-05 | 深色专业创作工具 | 界面以视频生产而非普通聊天为中心 |
| C-06 | 兼容 New API 等网关 | 精确协议仍需选择和验证，不能泛称全部兼容 |
| C-07 | 参考 cc-switch 的渠道管理 | 管理员增改、数据库管理、版本与切换体验 |
| C-08 | 初始数据库无任何 API Key/Base URL | 无预置连接、默认域名或自动导入配置 |
| C-09 | 图片必须实际生图，不要 ASCII art | 生成 PNG、保留提示词与收据，不假装应用截图 |
| C-10 | 使用本机提供的中转连接生成文档图片 | 凭据不复制进文档，也不写为未来产品默认配置 |
| C-11 | 默认生图 524 后改用 gpt-image-2 | 用户明确批准先试一张，成功后继续其余图片；请求 quality=high |
| C-12 | 项目名称确认为 `kumo-drama` | 用户明确要求更名；文档与文档站统一使用新名称，原始概念图与生图提示词保留为历史记录 |
| C-13 | 文件存储使用七牛云 Kodo | 用户已准备 AK/SK、Bucket、访问域名、Region 和 Key 前缀六项环境配置；本轮只更新设计，未读取实际值或验证连接 |
| C-14 | 后端使用 MVC，优先复用成熟能力，字段按需无冗余 | 用户要求先做基础架子；采用 Nest Controller、Service／Prisma Model 和 JSON DTO，不提前建立全量业务表 |
| C-15 | 使用 PM2 管理后端进程 | API 初始采用单进程 fork，使用现成自动重启与退出管理，不修改其他应用或系统启动服务 |

## 2. 本文提出、尚待正式评审的主方案

| 编号 | 建议 | 原因与替代 |
| --- | --- | --- |
| D-02 | Next.js + NestJS + TS Worker | 遵循 TS，模块化单体起步；API 使用 NestJS 默认 HTTP 适配器 |
| D-03 | PostgreSQL / Prisma / Redis / BullMQ | 持久资金事实与至少一次调度分开；对象存储已按 C-13 确认为七牛云 Kodo |
| D-04 | 个人工作区为 P0，团队协作 P1 | 保留隔离模型，降低首版复杂度 |
| D-05 | FFmpeg 为首版导出引擎 | 粗剪足够，不先绑定付费渲染框架；后续可评估 Remotion |
| D-06 | 1 积分 = 1,000,000 microcredits | 资金精度统一，实际售价与兑换比另定 |
| D-07 | 文本也使用可证明上限的预留 | 公众 SaaS 先控制超额消耗，不直接套后付制 |
| D-08 | 媒体 P0 不自动换渠道重发 | 模糊受理会重复收费；先保证可核对 |
| D-09 | 取消只对 queued 开放 | 不能把本地断开当成上游停止或退款 |
| D-10 | 独立实现，不拼装受限源码 | 商业许可、复杂度和公众隔离要求 |
| D-11 | 无交付的媒体生成 P0 默认不向用户收取该生成费 | 平台承担其交付和上游失败损失，需运营确认条款 |
| D-12 | 首版不开放真人音色克隆与任意脚本插件 | 权利和安全边界尚未具备 |

“建议”不是替用户确认的商业合同。正式开发前应将接受／修改／拒绝的结果写入评审记录。

## 3. 需要确认的上线阻塞项

| 编号 | 问题 | 为什么阻塞 | 建议决定时点 |
| --- | --- | --- | --- |
| Q-01 | 首发国家／地区与数据驻留？ | 影响支付、内容要求、隐私与标识 | A0 |
| Q-02 | 首个正式支付商与充值币种？ | 订单、退款、资质、验签不能凭空设计成已对接 | A0 |
| Q-03 | 具体聚合站／New API 版本与公开协议？ | 四模态、视频任务和用量需要真实契约 | A0/A1 |
| Q-04 | 正式售价、兑换比、渠道成本与预算？ | 无定价不能发布；图上价格不能作为正式数据 | A1 |
| Q-05 | 交付核对期限、失败收费和退款条款？ | 决定预留释放、迟到结果与客服承诺 | 商业灰度前 |
| Q-06 | 素材、私有故事、录音、日志和财务保留期？ | 影响成本、隐私、删除与备份 | A2 前 |
| Q-07 | 内容标识、审核、申诉与权利联系人？ | 公众产品必须有处置流程 | 灰度前 |
| Q-08 | 谁负责资金、安全和事故响应？ | 不是添加几个后台页面就具备运营能力 | A0，持续维护 |

这些项暂不继续打断当前文档任务；文档明确边界，未来实施前集中确认。

## 4. 可以后置的产品选择

品牌商标与域名核验；默认横屏／竖屏优先级；首发短剧时长档位；是否做公开样片库；是否开放团队席位；音乐／音效生成优先级；外部 API；移动端编辑范围；订阅；更复杂时间线；渠道级自动等价切换。这些不会被偷偷当成 P0 已确认功能。

## 5. 本轮没有执行的事情

没有生成业务工程、没有启动数据库或 Docker、没有安装产品依赖、没有导入用户中转凭据到平台、没有支付／充值、没有调用视频／语音生成 API、没有运行参考项目完整测试、没有确认任何法律合规认证。

## 6. 评审建议顺序

先评产品目标与一集生产旅程，再评渠道／计费／任务不变量，再看页面和模型清单，最后评工期与基础设施。否则容易把“看起来像完整平台”的界面当成具备可靠交易能力的产品。