--- date: 2026-06-07 topic: MVP执行spec status: 视图(项目上线主计划之下) --- # MVP 总执行 Spec — 10人×3周(验收 55 项 P0 产品功能 · 工作量≈137 技术项) > **文档定位(2026-07-02)**:本 spec 是 [`可行性方案16周-波次映射.md`](../../mvp/可行性方案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/`)。现行口径见运行时 SoT `docs/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)**: 1. 项目 CRUD 2. 游戏状态机 3. 版本管理 4. 草稿保存与恢复 5. 标题/简介/封面/标签编辑 6. 发布前检查清单 7. 发布审核(BPM) 8. 审核决策与操作 9. 审核拒绝反馈 10. 创作者主页 11. 精选池管理 + 下架/封禁 12. **专区 Zone 实体与游戏归属(双轨)** ←G1 13. **发布去向 launchZone 选择** ←G1 14. **统一发布编排(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 # 每日进展记录 ```