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>
50 lines
5.7 KiB
Plaintext
50 lines
5.7 KiB
Plaintext
# game-cloud（后端 · monorepo 子目录）
|
||
|
||
> **本目录状态：脚手架占位（Day-0）。** 业务代码待 yudao-cloud fork 到位后填充。
|
||
> 决策：MVP 先在当前仓 monorepo 承载，later 再拆为独立 game-cloud 仓（见 memory monorepo-first-split-later）。
|
||
|
||
## 目标功能
|
||
绘境AI 后端：Yudao Cloud fork + 13 个 game-module 业务模块（project/aigc/runtime/feed/telemetry/pay/trade/community/ip/compliance/biz/ad/studio）。技术栈 Java 17 + Spring Cloud Alibaba + MySQL + RocketMQ + Redis + Nacos + Dify + OpenGame。
|
||
|
||
## 目录规划（待落地）
|
||
```
|
||
game-cloud/
|
||
├── (yudao-cloud fork 框架：game-framework / game-gateway / game-server ...) ← 前置：需 fork yudao-cloud
|
||
├── game-module-project/ ← 黄金模板模块（先做到完美，其余 12 个克隆）
|
||
│ ├── game-module-project-api/ # 枚举/错误码段 1-100/跨模块 DTO·Feign
|
||
│ └── game-module-project-server/ # controller(admin/app)/service/dal/convert（结构对齐 yudao fork）
|
||
└── game-module-*/ ← 其余 12 模块克隆黄金模板
|
||
```
|
||
|
||
## 边界 / 不做
|
||
- 契约不放这里：`contracts/`（仓根）是跨端单一事实源，本模块引用它。
|
||
- 管理后台前端 = `game-admin/`；产品端前端 = `game-studio/`（各自子目录）。
|
||
|
||
## 当前状态 / TODO（更新 2026-06-09）
|
||
|
||
> **进度对账以 `docs/mvp/MVP进度总账.md`（单一事实源）为准**，本节只记本模块要点。
|
||
- [x] 契约先行：8 类契约锁定（`contracts/`，M0），含 project 的 DB+API。
|
||
- [x] **fork yudao-cloud 完成**：GitHub `master-jdk17`（Java17, rev 2026.05-SNAPSHOT），已裁剪至 system/infra/pay/bpm + framework/gateway/server/dependencies（删 11 个 demo 模块，74M→44M）。
|
||
- [x] 业务决策 HJ-DEC-001 敲定：D1 主 DeepSeek+备 Qwen / D2 放置·经营·合成·点击 4 模板 / D3 MVP 统一 80%(全配置化) / D4 ui-ux-pro-max+demo（详见 `docs/agent-specs/2026-06-08-mvp业务决策.md`）。
|
||
- [x] 结构决定：游戏模块跟 fork 用 **`-api`/`-server`**（已同步规范 §9/§1）。
|
||
- [x] **工具链就绪**：JDK 17.0.19 + Maven 3.8.7。
|
||
- [x] **黄金模块 `game-module-project` 建成并编译通过**（`mvn install` BUILD SUCCESS，18 源文件，照抄 fork notice/infra 范式）：
|
||
-api(ErrorCodeConstants 段1-100/ProjectStatusEnum/ReviewDecisionEnum) + -server(ProjectDO·ReviewRecordDO 继承 TenantBaseDO / 2 Mapper / ProjectService+Impl 状态机·归属·门禁·审核事务 / ProjectConvert / 7 VO / App+Admin 双控制器)。
|
||
- [x] **B 路线接线 yudao-server**：pom 依赖 game-module-project-server；`YudaoServerApplication` 加 `cn.wanxiang.game.module` 组件扫描 + `@MapperScan`；`application.yaml` type-aliases 纳入 game DO。
|
||
- [x] **关键核实**：`WebProperties` 端前缀按 `**.controller.app/admin.**` 通配 → cn.wanxiang 包自动获 `/app-api`·`/admin-api`，无需改框架。
|
||
- [x] **集成编译通过**：`mvn -pl yudao-server -am compile` BUILD SUCCESS（接线后整体编译，含 Flyway 依赖）。
|
||
- [x] **Flyway 启用（创始人定 A）**：yudao-server 加 `flyway-core`+`flyway-mysql`（版本由 spring-boot 管理）；`application.yaml` 加 `spring.flyway`（enabled+`baseline-on-migrate`+`baseline-version=0`，关键防 V1.0.0 被当≤baseline 跳过）；迁移脚本复制到 `yudao-server/.../db/migration/`（执行副本，源在 `contracts/db-schemas/`，diff 一致；Flyway 校验和敏感故保持同步）。
|
||
- [x] **端前缀（创始人定 B）**：保留 yudao 默认 `/app-api`·`/admin-api`，已把 `project.yaml`/`README`/`规范§4`/`events.schema` 的 `/app`·`/admin` 改为 `/app-api`·`/admin-api`（控制器代码零改，前缀框架按包名自动加）。
|
||
- [x] **Service 单测通过**：`ProjectServiceImplTest` 9 用例全绿（Mockito，覆盖默认值/归属/状态机/发布门禁/审核流转）。
|
||
- [x] **M1 全栈真启动达成（2026-06-09，mini-desktop 隔离 staging）**：单体 `Started YudaoServerApplication`、Flyway V1-V9 全 success、24 张 game_* 表、admin-api/app-api 均 200。启动装配缺陷已修（撤 openfeign 排除+4 CommonApi 补 primary=false `d7fac90`；去 system/infra-server repackage `8565fa2`）。详见记忆 `m1-runtime-bringup-state`。
|
||
- [x] **Wave1 闭环脊柱 4 模块（aigc/runtime/feed/telemetry）已并行建成并验证**（Workflow 三相编排：契约→建设→集成；4 模块 46 单测绿 + 全量集成编译绿 41 模块 reactor；详见 `docs/agent-specs/2026-06-08-后端模块并行建设-execution.md`）。13 张表全落 `contracts/db-schemas/V1-V5`，错误码段 100-104 独占。
|
||
- [x] **Wave2 变现域**：ad/trade 后端建成验证（`43fce85`）。pay 为 yudao 原生，当前未接单体。
|
||
- [x] **Wave3 治理/创作**：compliance（锁风门 Gate 二态，已注入 project.publish）+ studio（创作任务链）建成（`b70e90b`/`6c8844f`）。
|
||
- [x] **已建 9/13 game 模块**（project/aigc/runtime/feed/telemetry/ad/trade/compliance/studio），全部接入单体、有单测、有契约 yaml、有 Flyway V1-V9。
|
||
- [ ] **Wave4 待建 3 模块**：community(5 P0) + biz(6 P0) + ip(D5 seam 寄宿，不独立建)。须先备 review+execution 双 spec。
|
||
- [ ] **桩真实化（决定 M2-M5）**：Dify 真实生成 / runtime 真实编译 / OSS 存取 / telemetry MQ 聚合 / 真实广告+pay。见总账 §5。
|
||
- [x] **已全量 git 提交并推送** origin/dev/2.0.0（最新 `8565fa2`）。
|
||
|
||
## 规范锚点
|
||
包名 `cn.wanxiang.game.module.{模块}.{层}`；错误码段见 `.agents/rules/engineering-conventions.md §1.3`；API `/app-api`·`/admin-api` 双端（前缀框架按包名自动加）；DO/VO/DTO 分层；Flyway 迁移（执行位 `yudao-server/.../db/migration/`）；测试金字塔（单测>80%/集成 Testcontainers）。
|