- 注册表:docs/architecture/README.md §2,37 份 canonical(frontmatter topic+canonical:true)与表双向机器对账
- 门:.agents/tools/docs-gate.py 六检(品牌根/canonical唯一/死链/入口卫生/留痕隔离/设计档申报),挂 .githooks/pre-commit(本仓已激活)+ .gitea/workflows/docs-gate.yml(待runner)+ wave-close 第8步;旧 check-deadlinks.sh 退役并入 G3
- 清缩:删 54 项历史档(plans 16/agent-specs 设计与spike 20/brainstorms 5/memorys 3/goals+作战清单完成史归档/王蓝莓design/SAA现状html/add-game-template);channel-spike 564K 代码资产迁仓级 spikes/;六件删前蒸馏已迁(代码评审16条open项→进度总账§5、prefix-cache字段表→cheap-model skill、意图基线29条→需求清单附录、九门降级rationale→验收门、A11 TODO→tech-decisions、3layer边界→littlejs-game-dev 指针)
- 修口径约90处:六处SAA『现行主线』旧标、Nacos/RocketMQ『未部署』旧述(07-01反转)、gameDefinition残留、全部死链改 git show 定位;AGENTS.md 249→136行(决策史归tech-decisions);_index 改纯在飞板;对外演示版 md→html
- 依据:docs/agent-specs/2026-07-02-文档治理-{全量普查与裁决-report,SoT注册表与治理门-设计}.md(四路普查191份md+Codex/Opus双评审必修项已折入);恢复基线 8ea97234(单档 git checkout 8ea97234 -- <路径>)
21 KiB
date, topic, status
| date | topic | status |
|---|---|---|
| 2026-06-07 | MVP执行spec | 视图(项目上线主计划之下) |
MVP 总执行 Spec — 10人×3周(验收 55 项 P0 产品功能 · 工作量≈137 技术项)
文档定位(2026-07-02):本 spec 是
可行性方案16周-波次映射.md(项目上线主计划 SoT)之下的一个视图 —— 提供上线的产品验收来源(55 项 P0 产品功能、工作量 ≈137 技术项)与一段 3 周冲刺执行视图(contract-first + 五工位并行的打法)。它不是平行的执行基线;日常排期以 16 周主计划为准,引用本 spec 时只取其 55 P0 验收定义。
⚠️ 状态横幅(2026-06-12,仅作历史):本 spec 为 v1.0 原始执行规划(2026-06-07),其中 WS2 的「Dify / OpenGame / ComfyUI 文生代码」部署与编排步骤(§工位编制、M1 里程碑 Dify/OpenGame Docker 部署、§6 Dify workflow 6 节点、§风险"切纯 Dify+模板填充")均已作废——现行裁决:Dify/OpenGame 降级远期、从未部署(C2 2026-06-09 / HJ-GEN-001);生成主线=new-api 网关 + agent 写码于插件库;agentic 编排基建=AgentScope 2.x(HJ-AGI-001);RocketMQ/Nacos=future-state 未部署;Tier1 引擎=LittleJS 增强发行版(2026-06-12 终裁);「玩法模板层」已废除(模板=LittleJS 插件)。现行口径以
.agents/knowledge/tech-decisions.md§1/§1.1、docs/mvp/MVP进度总账.md为准。以下正文保留原貌,仅作历史规划留痕,勿照其 Dify/OpenGame/模板步骤执行。文档编号:HJ-MVP-SPEC-001 版本:v1.0 受众:全体开发团队 + 产品运营 生成时间:2026-06-07 前置:系统概要设计-技术决策版、产品需求清单(Doc A)/技术架构与模块(Doc B)/需求模块映射(Doc C) 约束:10 人团队、3 周(15 个工作日);MVP 验收 = Doc A 的 55 项 P0 产品功能,工作量≈137 技术项,核心闭环不砍
1. 目标
1.1 交付目标
3 周后(2026-06-27)交付一个种子用户可试用的 MVP,覆盖完整链路:
创作者登录 → 资产管理 → Prompt生成/资产组装 → 预览试玩 → 发布
→ 审核通过 → 游戏流推荐 → 玩家试玩 → 互动 → 分享
→ 广告展示 → 收益归集 → 创作者钱包可见
→ 遥测采集 → 质量评分 → 推荐优化
1.2 量化验收标准
| 指标 | 标准 |
|---|---|
| P0 产品功能覆盖 | 55/55 项 Doc A 的 P0 产品功能全部可用(可验证) |
| 端到端链路 | 创作→生成→预览→发布→审核→游戏流→试玩→互动→广告→收益 全走通 |
| 生成成功率 | ≥ 80%(基于 3-5 个模板) |
| 游戏流首屏 | P75 < 3s |
| 冒烟测试 | 核心 5 条链路自动化通过 |
| P0 Bug | 0 个(P1 可遗留不超过 10 个) |
2. 团队编制
| 工位 | 代号 | 人数 | 角色 | 职责边界 |
|---|---|---|---|---|
| 平台基座 | WS1 | 2 | 后端 Senior × 2 | Huijing fork / Gateway / DB / CI-CD / project / compliance |
| AI 生成 | WS2 | 2 | AI 工程师 + 后端 | Dify / OpenGame / ComfyUI / aigc 模块 / 质量门禁 |
| 运行时与分发 | WS3 | 2 | 后端 + 前端(SDK) | runtime / SDK / LayaAir导出 / feed 推荐 / 互动 / 分享 |
| 产品前端 | WS4 | 2 | 前端 × 2 | game-studio 全页面 / game-admin 审核+模板+看板 |
| 数据与变现 | WS5 | 2 | 后端 + 产品运营 | telemetry / ad / trade / pay / community / biz / seed / 验收 |
3. 契约先行(Day 0,6月9日上午)
全员用半天对齐并锁定以下契约文件,写入 contracts/ 目录提交 git:
| 契约文件 | 内容 | 负责人 |
|---|---|---|
api-schemas/*.yaml |
所有模块 API 的 OpenAPI 3.0 定义(Request/Response) | WS1 lead 主笔,全员 review |
db-schemas/V1__*.sql |
核心表结构(Flyway 迁移脚本) | WS1 |
sdk-interface.d.ts |
WanxiangGameSDK 全部 public API 类型定义 + postMessage 协议 | WS3 SDK 负责人 |
game-package.schema.json |
GamePackage manifest 格式 + 目录结构 | WS3 + WS2 |
events.schema.json |
telemetry 事件名 + 字段(v1) | WS5 |
dify-workflow-io.json |
Dify workflow 的输入/输出契约 | WS2 |
ad-slot.schema.json |
广告位配置格式 | WS5 |
以上 7 个
contracts/文件为 Day-0 契约;Prompt Registry(独立prompt/目录)为第 8 类契约,与全局 8 契约口径一致。
契约锁定后:各工位 mock 对方接口独立开发,联调在 Day 11 开始。
4. 三周逐日计划
Week 1(6/9 ~ 6/13):基座 + 各工位独立开发
WS1 平台基座
| Day | 任务 | 交付物 |
|---|---|---|
| 1 | Fork huijing-cloud + 本地跑通 + docker-compose.middleware.yml | 全栈中间件可启动 |
| 1 | CI/CD pipeline 搭建(GitHub Actions / GitLab CI) | push→lint→test→build 流水线 |
| 2 | 创建 13 个 game-module Maven 骨架(含 studio)+ game-server 单体入口 | 编译通过 |
| 2 | DB 迁移 V1(project + compliance + telemetry + feed 核心表) | Flyway migrate 成功 |
| 3 | project 模块:CRUD + 状态机 + 版本管理 | Swagger 可调 |
| 3 | Gateway 路由配置 + CORS + 匿名Token | 前端可调通 API |
| 4 | project 模块:草稿 + 发布前检查 + 发布审核(BPM) | 审核流程可走通 |
| 5 | compliance:Prompt 文本安全 + 图片安全(对接 safe-content-ai) | 安全检测 API 可调 |
M1 验证(Day 3 下午):docker compose up → 全栈绿灯 → Swagger 可调 project CRUD。
WS2 AI 生成
已作废(现行注):本段原为 Dify / OpenGame / ComfyUI 的 Docker 部署与 6 节点 workflow 编排步骤。Dify / OpenGame 已降级远期、从未部署,ComfyUI 亦未部署;生成主线现已收敛到 AgentScope 三档(Tier0/1/2 按 AI 参与深度分,引擎随复杂度在 LittleJS / Phaser 间选,A-model 直接写真
src/)。现行口径见运行时 SoTdocs/architecture/架构/生成引擎/agentic运行时架构图说.md;原步骤见 git(基线 8ea97234)。
WS3 运行时与分发
| Day | 任务 | 交付物 |
|---|---|---|
| 1 | SDK Core 开发:lifecycle + event-bus + telemetry | npm 包 v0.1 发布(内部) |
| 2 | SDK Core 开发:error-track + postMessage 协议完整 | SDK < 8KB 验证通过 |
| 2 | runtime 编译服务:GamePackage→Web 包 + manifest + OSS 上传 | API 可调 |
| 3 | SDK Plugin.Ad 桩 + Plugin.Pay 桩(接口齐全,实现为 mock) | npm 包 v0.2 |
| 3 | runtime 预览交付端点(按版本返回 manifest + 资源 URL) | GET /app/runtime/preview/:versionId |
| 4 | feed 推荐引擎 MVP(Redis Sorted Set + 规则排序) | GET /app/feed/list 可调 |
| 5 | feed 互动 API(点赞/收藏/分享/举报)+ 候选集刷新 | POST /app/feed/interaction 可调 |
WS4 产品前端
| Day | 任务 | 交付物 |
|---|---|---|
| 1 | game-studio 项目初始化(Vue3 + Vant + Vite + Router + Pinia) | 项目可运行 |
| 1 | game-admin fork(huijing-ui-admin-vue3)+ 菜单配置 | admin 可登录 |
| 2 | studio:登录/注册页 + Token 管理 + 路由守卫 | 可登录 |
| 2 | admin:game/review 审核队列页骨架 | 页面可访问 |
| 3 | studio:创作工作台骨架(项目列表 + 创建项目) | mock API 驱动 |
| 4 | studio:资产管理页(列表/上传/AI生成入口) | UI 可操作 |
| 5 | studio:游戏流页骨架 + 滑动切换 + 封面卡片 | mock 数据可滑动 |
| 5 | admin:模板管理页 + 精选池管理页 | 页面可操作 |
WS5 数据与变现
| Day | 任务 | 交付物 |
|---|---|---|
| 1 | telemetry:事件摄取 API(/events/batch)+ MQ 异步入库 | API 可调 |
| 2 | telemetry:事件 Schema 校验 + 限流 + 去重 | 异常事件被拦截 |
| 2 | seed 数据脚本:用户/模板/标签/配置 | 一键导入 |
| 3 | telemetry:质量评分聚合(GameDailyStats 定时任务) | 质量分可查 |
| 3 | ad:广告位定义 API + 穿山甲 SDK 集成准备 | 广告位 CRUD 可调 |
| 4 | ad:广告展示上报 API + eCPM 基础统计 | 上报可入库 |
| 4 | pay:积分充值订单 API + 微信支付对接骨架 | 订单可创建 |
| 5 | trade:创作者钱包 API(余额/收益明细/分成规则) | 钱包数据可查 |
| 5 | 制作 3 款 demo 游戏(用 AI 生成 + 手工调整) | demo 内容就绪 |
Week 2(6/16 ~ 6/20):链路串通 + 功能完善
WS1 平台基座
| Day | 任务 |
|---|---|
| 6 | compliance:音频安全 + AI 输出风控规则 + 违禁词库管理 |
| 6 | project:审核拒绝反馈 + 重新提交 + 精选池管理 |
| 7 | project:创作者主页 API + 下架/封禁 |
| 7 | compliance:举报处理 + 阈值降权 + 用户封禁 |
| 8 | compliance:操作审计日志 + RBAC 精细权限 + 匿名用户约束 |
| 8 | 发布前检查清单完善(7 道门禁联动 compliance) |
| 9 | compliance:隐私政策/适龄提示/防沉迷桩接口 + CSP/CORS 加固 |
| 10 | 联调准备:修复 WS4 对接时发现的契约偏差 |
WS2 AI 生成
| Day | 任务 |
|---|---|
| 6 | 模板库完善:3-5 个玩法模板(躲避/跑酷/点击收集/解谜/射击) |
| 6 | 每个模板:Schema + 默认参数 + 示例 Prompt(3-5个) |
| 7 | aigc:生成任务状态机完整(queued/running/succeeded/failed/timeout/canceled) |
| 7 | aigc:LLM 熔断降级 + 确定性 Fallback 生成器 |
| 8 | aigc:生成失败原因分类 + 用户可读提示 |
| 8 | 质量门禁:GameConfig Schema 校验 + 资源有效性 + 可玩性基础验证 |
| 9 | aigc:生成进度 SSE 推送 + 超时后台通知 |
| 9 | ComfyUI:封面/宣传图自动生成 workflow |
| 10 | 端到端验证:5 个模板 × 3 个 Prompt = 15 次生成全部成功率 ≥ 80% |
WS3 运行时与分发
| Day | 任务 |
|---|---|
| 6 | SDK Plugin.Ad 真实实现(宿主侧穿山甲 SDK 加载 + postMessage) |
| 6 | runtime:GameConfig 静态校验 + Manifest 完整性校验 |
| 7 | feed:新人保底曝光 + 低质降权 + 冷启动策略 |
| 7 | runtime:资源大小限制 + hash 命名长期缓存 + CDN 刷新 |
| 8 | feed:分享链接 + Open Graph 元数据 + 分享落地页 |
| 8 | SDK:调试面板(开发模式)+ trace_id 贯穿 |
| 9 | LayaAir CLI 集成:微信小游戏导出 + 自动图标封面 |
| 9 | runtime:Web 沙箱 iframe 隔离 + CSP + postMessage 来源校验 |
| 10 | runtime:三容器预加载策略 + 加载超时跳过 + 错误上报 |
WS4 产品前端
| Day | 任务 |
|---|---|
| 6 | studio:Prompt 输入 + 风格/模板选择 → 调真实 aigc API |
| 6 | studio:生成状态展示(进度/成功/失败/重试) |
| 7 | studio:资产空间完善(分类/搜索/AI生成单项资产) |
| 7 | studio:游戏组装页(模板选择 + 资产拖入 + 配置机制) |
| 8 | studio:预览试玩页(iframe + SDK 集成 + 调试面板) |
| 8 | studio:发布流程(检查清单 + 提交审核) |
| 9 | studio:游戏流 → 对接真实 feed API + 三容器预加载 |
| 9 | studio:互动浮层(点赞/收藏/分享/举报)+ 分享页 |
| 10 | admin:审核队列完善(试玩预览 + 通过/拒绝/下架 + 拒绝理由) |
| 10 | admin:数据看板(核心 5 指标:生成率/发布率/留存/互动/收益) |
WS5 数据与变现
| Day | 任务 |
|---|---|
| 6 | telemetry:创作漏斗 + 游戏流消费漏斗 |
| 6 | telemetry:运营看板 API(审核积压/生成成功率/举报率) |
| 7 | ad:激励视频 + 插屏广告触发逻辑 + 合规植入规则 |
| 7 | trade:广告分成结算逻辑(T+1)+ 多渠道收入归集 |
| 8 | trade:创作者收益明细 + 提现申请 API(MVP 展示余额,真实打款 P1) |
| 8 | pay:积分充值流程完善 + 订单状态管理 |
| 9 | community:站内信系统 + 生成完成/审核结果/收益变动通知 |
| 9 | biz:B 端需求表单 + 模板选择 + 进度看板(简化版) |
| 10 | 制作 5 款追加 demo 游戏 + 审核通过 + 游戏流内容补充 |
M2 验证(Day 10 / 6/20):创作→生成→预览→发布→审核→游戏流→试玩→互动→广告→收益 全链路端到端走通(可能有 bug,但链路通了)。
Week 3(6/23 ~ 6/27):联调 + 修 bug + 加固 + 上线
全工位进入联调模式,每天站会同步阻塞点。
| Day | 全体任务 |
|---|---|
| 11 | 全链路联调:创作→生成→预览(WS1+WS2+WS3+WS4 对接) |
| 12 | 全链路联调:发布→审核→游戏流→试玩→互动→分享(WS1+WS3+WS4) |
| 12 | 全链路联调:广告→收益→钱包(WS3+WS5+WS4) |
| 13 | Bug 修复(P0 优先)+ 性能优化(CDN/缓存/预加载调优) |
| 13 | 安全加固:WAF 配置 + 渗透测试基础项 + 密钥轮换 |
| 14 | 冒烟测试脚本编写并通过(5 条核心链路) |
| 14 | seed 数据最终版 + demo 内容充实(≥10 款游戏) |
| 15 | 灰度发布 staging → 种子用户 10 人内测 → 收集反馈 |
| 15 | 紧急 bug 修复 + MVP 交付确认 |
M3 验证(Day 15 / 6/27):种子用户完成全链路操作 + 冒烟测试全绿 + P0 bug = 0。
5. 里程碑与验证节点
| 里程碑 | 日期 | 验证标准 | 验证人 |
|---|---|---|---|
| M0 契约锁定 | 6/9 上午 | contracts/ 目录 7 个文件提交 git | 全员签字 |
| M1 全栈可启动 | 6/11 (Day 3) | docker compose up → 全服务绿灯 + API 可调 | WS1 lead |
| M2 创作链路跑通 | 6/18 (Day 8) | Prompt→AI 生成→预览试玩 端到端(真 LLM,非 mock) | WS2 lead |
| M3 分发链路跑通 | 6/20 (Day 10) | 发布→审核→游戏流→试玩→互动→分享 | WS3 lead |
| M4 变现链路跑通 | 6/23 (Day 11) | 广告展示→收益→钱包可见 | WS5 lead |
| M5 MVP 交付 | 6/27 (Day 15) | 种子用户全链路 + 冒烟绿 + P0=0 | 产品负责人 |
6. 并行解耦规则
6.1 Mock 策略
| 工位 | 依赖谁 | Mock 方式 | 真实对接时间 |
|---|---|---|---|
| WS4(前端) | WS1/WS2/WS3/WS5 的 API | vite-plugin-mock 基于契约 yaml 自动生成 |
Day 6 起逐步替换 |
| WS3(SDK) | WS4(宿主) | 独立测试页模拟 postMessage | Day 6 集成 |
| WS2(aigc) | WS1(project) | 内存态写入 + MQ mock | Day 5 真实对接 |
| WS5(telemetry) | WS3(SDK 上报) | curl 模拟 /events/batch | Day 6 真实对接 |
6.2 每日站会(15 分钟)
- 时间:每天 10:00
- 格式:每人 2 分钟(昨天完成 / 今天计划 / 阻塞点)
- 阻塞点处理:会后 10 分钟两人对齐,不拖会
6.3 联调窗口
- Day 11-12:预留 2 天专门联调,不安排新功能开发
- 联调期间:前端主导提 bug,后端 30 分钟内响应
- P0 bug:当天必须修复;P1 bug:联调期内修复
7. P0 工作量到工位的映射(≈137 技术项 · 验收口径见 §1.2 = 55 项 P0 产品功能)
生成域拆为 aigc(无状态生成原子)+ studio(创作编排域);首屏骨架能力归位为:专区 Zone 实体 / 发布去向 launchZone / 统一发布编排 → project,锁风门 Gate 二态 → compliance,渠道发布状态机 → runtime,按 Zone 分区推荐 → feed。下列为工作量分解(技术项粒度,各模块标题计数与逐条列举一致;最终以 Doc B 的 T-id 与契约为准);逐条产品功能↔技术功能映射见 Doc C,验收以 55 项 P0 产品功能为准。
WS1 负责(43 项)
project 模块(14 项 P0):
- 项目 CRUD
- 游戏状态机
- 版本管理
- 草稿保存与恢复
- 标题/简介/封面/标签编辑
- 发布前检查清单
- 发布审核(BPM)
- 审核决策与操作
- 审核拒绝反馈
- 创作者主页
- 精选池管理 + 下架/封禁
- 专区 Zone 实体与游戏归属(双轨) ←G1
- 发布去向 launchZone 选择 ←G1
- 统一发布编排(compliance→runtime→feed,失败回滚) ←G6
compliance 模块(29 项 P0): 文本安全 / 图片安全 / AI 输出风控 / 违禁词库 / 举报处理 / 举报阈值降权 / 人工审核队列 / 审核状态机 / 风险分层 / 操作审计 / 审计长期保存 / 安全日志告警 / RBAC / 游戏沙箱CSP / 文件安全校验 / Prompt 注入防护 / OWASP 防护 / Secrets 管理 / 敏感数据加密 / 数据传输加密 / 日志脱敏 / 登录安全限频 / 匿名用户约束 / CORS+CSP / 隐私政策 / 数据最小化 / 适龄提示 / 用户封禁 / 锁风门 Gate 二态(pass/block) ←G2
WS2 负责(16 项:studio 6 + aigc 10)
studio 模块(6 项 P0,创作编排,自 aigc 迁出 + demo 缺口): 创作会话与草稿装配 / 六类资产模块化生成调度 / 附件驱动创作上下文 / agentic 任务链编排 / 生成进度流(SSE) / 重生成迭代编排
aigc 模块(10 项 P0,无状态生成原子): Prompt 解析 / 模板匹配 / GameConfig 生成 / 参数校验兜底 / LLM 熔断 / Prompt 安全检测 / 确定性 Fallback / 失败原因分类 / 模板注册管理 / 示例 Prompt 库
WS3 负责(38 项 + SDK)
runtime 模块(20 项 P0): Web 包编译 / Manifest 生成 / 资源打包上传 / Web 沙箱隔离 / SDK 事件桥接 / Canvas 渲染容器 / GameConfig 注入 / 实时预览 / 资源大小限制 / hash 缓存 / 版本化路径 / 预加载策略 / 超时跳过 / 错误捕获上报 / 多端适配 / 竖屏适配 / postMessage 校验 / Manifest 校验 / GameConfig 静态校验 / 渠道发布状态机(待开通/申请中/已上线) ←G6
feed 模块(18 项 P0): Feed 推荐列表 / cursor 分页 / 候选集缓存 / 新人保底 / 低质降权 / 冷启动策略 / 上下滑切换 / 点赞 / 收藏 / 分享 / 举报 / 分享链接 / OG 元数据 / 分享落地页 / 行为信号推荐 / 首屏封面展示 / 精选池接口 / 按 Zone 分区推荐/浏览 ←G1
SDK:Core(lifecycle/telemetry/error-track) + Plugin.Ad + Plugin.Pay 桩
WS4 负责(前端页面承载所有 P0 的 UI 表现)
game-studio:登录 / 创作工作台(项目列表/资产管理/Prompt/生成状态/组装/预览/发布/专区选择) / 游戏流(滑动/卡片/互动/分享/双专区) / 创作者中心(主页/数据/收益)
game-admin:审核队列 / 模板管理 / 精选池 / 数据看板 / 内容安全
WS5 负责(45 项)
telemetry(17 项 P0):事件批量摄取 / Schema 治理 / 前端批量上报 / 质量评分 / 事件聚合 / 创作漏斗 / 消费漏斗 / 运营看板 / 玩家留存 / 创作者复创率 / Product Metrics / 加载时间埋点 / 服务健康监控 / 生成任务健康 / Runtime 健康 / 异常告警 / 失败根因
ad(5 项 P0):广告联盟对接(穿山甲) / 广告联盟对接(优量汇) / 激励视频 / 插屏广告 / 展示上报
trade(8 项 P0):广告分成结算 / 多渠道收入归集 / T+1 对账 / 创作者钱包余额 / 提现 / 收益明细 / 平台营收报表 / 渠道收入归集
pay(3 项 P0):积分充值 / 支付网关抽象 / 订单管理
community(6 项 P0):站内信 / 短信通知 / 生成完成通知 / 审核结果通知 / 收益变动通知 / 新人任务奖励(T-CMU-11 等级引擎)
biz(5 项 P0):B 端需求表单 / 模板选择预览 / 进度看板 / 交付验收 / 品牌营销模板
ip(1 项 P0):素材安全扫描(T-IP-01 版权基础原子;ip 域无 P0 产品功能出口,仅此基础原子计入工作量)
8. 技术约束与规范
8.1 开发规范(全工位遵守)
- 分支:
feature/{ws}-{module}-{brief}→ PR → develop - Commit:Conventional Commits(
feat(aigc): xxx) - PR:< 500 行 + 至少 1 人 review + CI 通过
- 测试:Service 层单元测试覆盖核心逻辑;集成测试覆盖 API 端点
- 文档:新 API 必须有 Swagger 注解;变更必须更新契约文件
8.2 幂等性(全工位遵守)
- 所有写操作 API:前端防抖 + 后端 idempotency_key
- MQ 消费:message_id 去重(Redis SET + 5min TTL)
- 支付回调:订单状态机 + 乐观锁
8.3 联调规则
- 前端 mock → 真实 API 切换:改
.env中VITE_API_BASE_URL即可 - 后端新增/变更 API:必须同步更新
contracts/api-schemas/并通知前端 - 阻塞超过 30 分钟:立即升级到站会解决
9. 风险与应对
| 风险 | 概率 | 应对 |
|---|---|---|
| Dify/OpenGame 集成比预期复杂 | 中 | WS2 前 3 天全力攻坚;失败则 Day 3 切换为纯 Dify + 模板填充 |
| 联调期 bug 过多 | 高 | Week 3 前 2 天只联调不加功能;P0 优先 |
| 广告联盟审核未通过 | 中 | 先用 mock 广告;真实对接可延到 MVP 后 1 周 |
| 某工位进度落后 | 中 | Day 5/Day 10 两次检查点;落后则其他工位支援 |
| 3 周内 10 人无法完成 | 低 | 工作量≈137 技术项,每项约 1 人天;10人×15天=150 人天 > 137,留约 13 人天缓冲 |
10. 交付物清单
MVP 结束时 git 仓库应包含:
game-cloud/ 后端全部模块可编译运行
game-admin/ 管理后台可登录可操作
game-studio/ 产品端全链路可用
contracts/ 契约文件(API/DB/SDK/事件)
deploy/
├── docker-compose.yml # 全栈启动
├── docker-compose.middleware.yml
├── docker-compose.ai.yml
├── sql/seed-*.sql # 初始化数据
└── smoke-test.sh # 冒烟测试脚本
docs/
├── architecture/ # 已有架构文档
└── mvp/
├── this-spec.md # 本文档
└── changelog.md # 每日进展记录