eb5dbcb1af
- 新增 docs/mvp/MVP进度总账.md:把「计划↔完成↔待办↔执行记录」对账在一处 (M0-M5 里程碑账 / 13 模块建设矩阵 / 5 条闭环链路 / 8 类契约 / backlog / 波次史) - 诚实口径:结构骨架~70%(9/13模块脊柱+M1单体真启动),真实可验收P0仍早期(M2-M5为桩) - 刷新两个 .agent:Wave2/3 已建已提交、M1 达成、contractGaps 已补;均指向总账为准 - 修复"跑了波次却无活账"的项目管理缺口 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
45 lines
3.6 KiB
Plaintext
45 lines
3.6 KiB
Plaintext
# game-studio（产品端前端 · 创作者 + 玩家）
|
||
|
||
> **状态：脊柱已建成并本地验收通过（2026-06-08）。** 单 SPA 双区，全 mock 可试用。
|
||
> 上游契约：仓根 `contracts/`（5 API YAML + sdk-interface.d.ts#3 + game-package.schema.json#4，单一事实源）。
|
||
> 建设过程与验收详见 `docs/agent-specs/2026-06-08-前端game-studio建设-{review,execution}.md`。
|
||
|
||
## 目标功能
|
||
造梦AI 产品端：创作者（创建→生成→预览→发布）+ 玩家（游戏流→试玩→互动→分享）两端合一的移动竖屏 SPA。
|
||
技术栈：Vue3 + Vant + Vite 8 + Pinia + vue-router + axios；自研 Canvas Runtime(<15KB, Tier1) + WanxiangGameSDK（注入游戏 iframe）。
|
||
|
||
> **命名（2026-06-08 全栈统一 wanxiang，见记忆 [[brand-rename-huijing-to-zaomeng]]）**：品牌「造梦AI」；技术命名空间已全部 `wanxiang`——Java 包 `cn.wanxiang.game`、SDK `WanxiangGameSDK`、postMessage channel `wanxiang-game-sdk`，与契约 `contracts/` 一致。原 `huijing` 已彻底淘汰（除 git 历史）。仅 yudao 框架 `cn.iocoder.yudao` + Maven groupId `cn.iocoder.cloud` 保留不动。
|
||
|
||
## 目录（已建，互斥工位产出）
|
||
```
|
||
game-studio/
|
||
├── src/
|
||
│ ├── router/ store/ api/ mock/ styles/ components/ telemetry/ ← A1 地基（App Shell）
|
||
│ ├── host/ ← A2 宿主引擎
|
||
│ │ ├── GamePlayer.vue + bridge.ts + contract.ts （iframe 沙箱 + postMessage 桥 + origin/schema 双校验）
|
||
│ │ ├── sdk/ WanxiangGameSDK 实现契约#3（注入 iframe）
|
||
│ │ └── runtime/ Canvas Runtime <15KB(实测 3.5KB) + demo clicker
|
||
│ └── views/ feed·play·share（B1）/ create（B2）/ project（B3） ← 业务页面
|
||
└── vite.config.ts（含自写 mock 中间件插件：dev+preview 双 hook）
|
||
```
|
||
|
||
## 边界 / 不做（本次脊柱）
|
||
- 不做 `game-admin` 运营后台（不同栈 Element Plus，后端 admin-api 已就绪，后置）。
|
||
- 不做真实后端联调（留 staging，切 axios baseURL 即可）、真实广告/支付（仅桩）、Tier2/3、完整玩法引擎、钱包/提现、ui-ux-pro-max 精修。
|
||
|
||
## 当前状态 / TODO（2026-06-09）
|
||
|
||
> **进度对账以 `docs/mvp/MVP进度总账.md`（单一事实源）为准**，本节只记本仓要点。
|
||
- [x] Phase 0 脚手架（Vite8+Vue3.5）+ 依赖装齐 + 空壳 build。
|
||
- [x] 三相 Workflow 并行建成（A1 地基 + A2 宿主引擎 ∥ → B1/B2/B3 业务页 ∥），60 文件。
|
||
- [x] 主 agent Phase C 验证门：`npm run build`+`vue-tsc -b` 绿（修复 A2 两处假绿类型 bug）；`/browse` 实证玩家+创作双闭环、三方链路、ad 桩、遥测上报。
|
||
- [x] **4 个 contractGaps 已由契约 owner 在 Wave3 补齐**：publish 门禁明细(GAP-1 ProjectPublishRespVO) / GamePackage 取包端点(GAP-2 runtime manifestUrl) / ShareMeta versionId(GAP-3) / 遥测 snake→camel(GAP-4)。
|
||
- [x] **已 git 提交**（前端脊柱 `67ad750`）。
|
||
- [ ] **真实联调（staging：切 `VITE_API_BASE_URL` 接 mini-desktop 后端，5 条链路端到端走查）** ← 当前最高价值待办，见总账 §5「联调」。
|
||
- [ ] 安全测试补：postMessage 双校验"拒非法 origin/schema"独立验证。
|
||
- [ ] 可选：卡片点击热区扩大到整卡；mock 假数据品牌文案；srcdoc 生产收紧 origin。
|
||
|
||
## 验证门铁律（本仓特有，勿踩）
|
||
- **`vue-tsc --noEmit` 在本仓恒退 0 = 假门禁**（根 tsconfig files:[]）。类型检查权威 = `npm run build`（含 `vue-tsc -b`）。
|
||
- mock 数据严格贴契约 YAML，发现缺口上报 contractGaps、**不私造契约**。
|