zizi 096020fa0a feat(wave3-phaseA): project 侧跨主线收口(publish 唯一化+ProjectApi seam+GAP-4+治理+V6V7 G0)
Phase A 串行收口(主 agent 独占改黄金模块,11 单测绿),为 Phase B 并行建模块铺底:
- R1 publish 唯一化:submitPublish void→ProjectPublishRespVO{admitted,gates};门禁收集不抛、
  block→admitted=false 不改状态机;compliance gate 留 Phase C 接入 seam(TODO,不 import)
- R2 ProjectApi seam 单点定稿:+getCurrentVersionId(GAP-3)/+createProject(写类RPC 显式 creatorUserId)
- GAP-4:events.schema.json 信封 envelope/user 由 snake→camelCase(与 telemetry/前端 SDK 对齐,破坏性窗口收敛)
- R4 治理:登记 studio=112/Flyway V8(README §4/§1/§2 + CLAUDE.md;与前端仓 game-studio 区分)
- R6 G0:V6/V7 集中复制到 yudao-server/db/migration(diff-identical)
- project.yaml publish 响应同步结构化;D2 锚点 reviewProject/game_review_record 未动

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 01:37:06 +00:00

69 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 造梦AI 游戏生态平台
> 本文件只讲三件事:**项目定位、项目目标、项目目录**。
> 工作方式、规范、技能、流程一律见 [`AGENTS.md`](AGENTS.md) 与 [`.agents/`](.agents/),本文件不重复。
---
## 一、项目定位
**造梦AI = AI 驱动的全民游戏创作与变现生态平台。**
核心命题:
- **零基础**用户用一句话就能做出**可上线、可变现**的轻量小游戏;
- **玩家**像刷短视频一样在"游戏流"里发现并即点即玩;
- **平台**靠广告分成 / 订阅会员 / B 端定制三条线变现。
差异化壁垒 = **生成 + 流量 + 变现"全闭环"**。竞品多停在"生成工具",造梦把"做得出 → 有人玩 → 赚到钱"接成一条链路;真正护城河不在生成引擎(会被大模型追平),而在数据、网络效应、资产与合规四层壁垒。
---
## 二、项目目标MVP 阶段)
MVP 目标:交付一个**种子用户可试用的全链路闭环**——创作→生成→预览→发布→审核→游戏流→试玩→互动→广告→收益→遥测→推荐优化。
关键量化指标:
| 指标 | 目标值 | 来源 |
|---|---|---|
| AI 生成成功率 | **≥ 80%**(基于 3-5 个模板) | MVP 执行 spec |
| 游戏流首屏加载 | **P75 < 3s** | MVP 执行 spec |
| 服务可用性 | **≥ 99.5%** | 可用性目标 |
| MVP 基础设施成本 | **< 5000 /**投资人版核算约 ¥4,300/年化 ~5 | 投资人版 |
| P0 产品功能覆盖 | **55/55 项 P0 产品功能可验证**Doc A 产品口径| 三文档套件 Doc A/C |
> **两份路线并存,勿混用:**
> - **投资人版HJ-ARCH-002****5 人核心团队 + ¥4,300/月基础设施 + 11 周 MVP**,强调资本效率与窗口期验证。
> - **MVP 执行 specHJ-MVP-SPEC-001****10 人 × 3 周15 工作日)**,强调契约先行 + 五工位并行。验收 = Doc A 的 **55 项 P0 产品功能**;工作量 **≈137 技术项**。
> - 生成成功率:**以执行 spec ≥80% 为准**(投资人版未直接给数值)。引用指标时以对应文档为准。
---
## 三、项目目录
### 3.1 三个独立 Git 仓库(业务代码仓,当前仓库尚不含其代码)
| 仓库 | 定位 | 技术栈 |
|---|---|---|
| **game-cloud** | 后端Yudao Cloud fork + 13 个游戏业务模块 | Java 17 + Spring Cloud Alibaba + MySQL + RocketMQ + Redis + Nacos + Dify + OpenGame |
| **game-admin** | 管理后台前端运营/管理员用 | Vue3 + Element Plusyudao-ui-admin-vue3 fork |
| **game-studio** | 产品端前端创作者 + 玩家用 | Vue3 + Vant + 自研轻量 Canvas Runtime(<15KB, Tier1) + WanxiangGameSDK3D/独立App 为远期分层详见 [.agents tech-decisions §1.1](.agents/knowledge/tech-decisions.md) |
> **注(命名区分)**Wave3 后端 game-cloud 内新增 `studio` 业务模块(创作主链路编排,错误码段 112 / Flyway V8与上表**产品端前端仓 `game-studio`** 是两个东西——前者是后端编排模块,后者是 Vue3 前端仓,勿混淆。
### 3.2 当前仓库(文档仓)目录结构
```
games-development-ai/
├── CLAUDE.md # 本文件:定位/目标/目录
├── AGENTS.md # AI/工程师工作入口指南
├── docs/
│ ├── architecture/ # 6 份架构设计文档(投资人版/技术决策版/开发团队版 + 三文档套件:产品需求清单·技术架构与模块·需求模块映射)
│ ├── agent-specs/ # 执行级 spec如 Prompt 治理执行版)
│ ├── superpowers/specs/ # MVP 执行 spec 等执行级规格
│ └── memorys/ # 任务历史快照(带日期归档,长期留存)
├── docs-design/ # 产品/视觉设计资料
└── .agents/ # Agent 能力中枢knowledge/rules/skills/workflows
```