games-development-ai/docs/plans/2026-06-22-架构图集-目录与图清单-plan.md
zizi b52afc5ea2 docs(arch-atlas): 按领域拆成 00-07 编号文档(全放顶层)——创始人反馈全量主档太大
结构经三次反馈收敛终态:导览式多文件(跨子目录不渲染)→ 合并一篇(太大 1721 行)→
拆 8 篇编号文档都放 docs/architecture 顶层:
- 00-系统总览图说.md = 总图(7 系统级图)+ 目录(链 01-07)+ 通用图例 + 按角色路径
- 01-产品…07-运维图说.md = 每域一篇,各含该域全部图 + 讲解(散文逐字保留)
顶层文档引子目录 assets(运维/assets/xx.svg)单向下引、全图真渲染;SVG/各域README不动。
复验:8 篇共 35 图嵌入零缺失、36 Mermaid 配平、00 链 7 域有效。
配方/记忆/计划/README索引同步终态(铁律:图集文档放顶层引子目录assets,别让子目录文档跨引另一子目录图)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 15:33:46 +00:00

25 KiB
Raw Blame History

date, topic, status
date topic status
2026-06-22 架构图集——全域目录 + 图清单 + 每图讲什么(确认稿 v2,已纳 Codex+Opus 双评审整改) 第一期已收口 = 架构图集按领域拆成 8 篇编号文档,全放 docs/architecture 顶层(00-系统总览=总图+目录 / 01-产品…07-运维各域)。结构经创始人三次反馈收敛:导览式多文件跨子目录不渲染 → 合并一篇嫌太大 → 终态拆多篇都放顶层编号(顶层文档引子目录 assets 单向下引故真渲染);§4 图清单仍是有效图账 · 第二期生成引擎子树归在飞 session 只链不双写

架构图集 · 全域目录与图清单(确认稿 v2)

0. 双评审整改说明(v1 → v2)

v1 经 Codex(xhigh)+ Opus 对抗式文档评审 双路把关,两路均判"需修订后启动"——在画 100+ 张图之前就揪出清单层面的硬伤。v2 已纳入整改,关键修订:

  1. 补全运维域图说(v1 漏整域,声称 140 实际只列 132)。
  2. 生成引擎子树拆【现行簇】/【远期 tier2 簇】两簇,并重定金样板性质——agentic运行时架构图说 画的是 tier2 远期自治轨(待 0 号 spike、未落代码),不是现行主线;现行主线是 SAA 固定 16 节点线。子树第一张图就画"现行 SAA 廉价线 ‖ 远期 tier2 自治轨"硬边界。
  3. 逐图加「状态」列(现行/待接/待建/缓做/future/废弃/决策史),从源头杜绝把演进中/已废方案画成现行。
  4. 修源档映射 + 补孤儿档:演进路线 改指真源;控制面治理中枢 agentic集成架构.md、tier2 两份工程档补图覆盖;全部映射改完整相对路径。
  5. 契约图 / 验收门图改画现实而非理想:契约总览自陈"DB 镜像已漂移、防漂移 CI 门缺位、Dify #6 废、第9契约五套编号相撞"——契约图画"声明 vs 现实";验收门拆"九门 harness(机制地板)"与"W-G1 开闸 6 门(发布门)"两层。
  6. 删「每域齐五种图」隐形配额:家族由内容定、不为凑数硬画类图;已有 README Mermaid 一律单源引用、不复制进图说(复制 = 自造漂移面,违背"图不漂移"目标)。总量由"~140 全新作"修正为 ~110 需新作 + ~30 引用现有 = ~140 图位
  7. 补 3 张最该据图 review 的跨域图:失败/降级/补偿路径全景、端到端鉴权信任边界、契约镜像+防漂移现状。
  8. 校准承诺口径:总图说达成的是"全局轮廓 + 下钻导航",不是"读一份文档了解整个系统";第一期含生成引擎"现行主线轮廓"、但深度留第二期。
  9. 加机器可检防漂移门:图说 frontmatter 记「源档 + 源档 commit hash」,收口脚本比对,不一致即标"图说待复核"。

跨 session 协调前置(记忆补充,评审看不到):生成引擎子树正被另一条 session 在飞建设(金样板 assets 2026-06-22 09:35 仍在更新)。故第二期(生成引擎子树)在启动前必须先与在飞 session 对齐边界、避免双写;§4.9 的子树清单是提案,待对齐。第一期(六域)归本线、无冲突。


1. 目标与背景

docs/architecture/架构/生成引擎/agentic运行时架构图说.md 已为生成引擎的 tier2 自治轨运行时这一个切片出了金样板(89 张:手绘 SVG 大图 + Mermaid 混合)。它证明了:一套图 + 配套讲解,能让人看图入门、照图实现、据图评审子系统设计是否合理

现在把这套做法铺到 docs/architecture 每一个领域,交付两层:

  • 每个领域一套图说(该域真正需要的架构图 / 讲解图 / 时序图 / 类图 / 流程图,家族由内容定);
  • 一份系统级总图说(总图叙)——导览式:内联系统级跨域大图 + 讲解,自顶向下建立全局轮廓,再导航下钻各域图说。

成败标尺三条:① 新人按"总图说轮廓 → 下钻 23 份域图说"能建立认知;② 评审者据图能发现设计缝(现行 vs 远期、模块边界、孤儿设计、跨域裂缝、失败路径);③ 图与设计档不漂移(同步纪律 + 机器可检门)。

本稿是确认稿:定"放哪些图说、每份里有哪些图、每张讲什么、什么状态",经创始人确认后按域启动 workflow。本稿只定清单,不画图。

2. 产物形态与统一风格(house style)

全沿用金样板已立的约定:

  • 混合形式:复杂 / 跨域图用手绘 SVG 大图(高保真、矢量可编辑、GitHub 直接渲染);简单 / 线性图用 Mermaid。每张 SVG 另在 mini-desktop 转 PNG 入仓(6c6g 禁 chrome)。
  • 单源原则(v2 新增):同一张图只存一处。各域 README 已内嵌的 Mermaid 不复制进图说,图说在叙述里引用它(链接到 README §X);图说只新作 README 没有的图。杜绝"同图两份、改一处漏一处"。
  • SVG 视觉规格(实测自 assets/01-系统全景.svg):viewBox 约 1480×宽幅;浅底 #f8fafc;slate 调色板(#0f172a/#475569/#334155);圆角矩形 rx 712;CJK 字体栈;标题 + 副标 + 脚注三段式。
  • 两套贯穿标注:① 生产维度徽章(安全/可观测/可靠/成本/数据/伸缩/质量);② 复用/边界三线(实线=现成直接用,虚线=自建/解耦,双线=跨域共享公共件)。
  • 可评审导向:每张图显式标 状态(见 §4 状态码)、跨域接缝、待裁项,让图本身承载"哪里可能有问题"。
  • 同步纪律 + 机器可检门:设计档一变,图说与 SVG 同步更新;图说 frontmatter 记「映射源档 + 源档 commit hash」,收口脚本比对,不一致即标"待复核"。入 wave 收口清单。

3. 目录与命名约定

在现有六域结构上增量铺开,不动既有 README(README 仍是 L2 主文档;图说是它的"看图入口"伴档)。

docs/architecture/
├── 系统全景图说.md            ← 【新·总图叙】导览式:内联系统级图 + 导航各域
├── assets/                    ← 【新】系统级 SVG
├── 产品/    产品图说.md  + assets/
├── 架构/    架构图说.md  + 产物执行沙箱图说.md  + assets/
│   └── 生成引擎/   (旗舰子树·提案待与在飞 session 对齐·拆现行/远期两簇,见 §4.9
├── 后端/    后端图说.md  + assets/
├── 前端/    前端图说.md  + assets/
├── 运营/    运营图说.md  + assets/
└── 运维/    运维图说.md  + assets/
  • 每域一份 <域>图说.md,结构沿用金样板:0 阅读约定与同步纪律 → 1 通用图例 → 2 图集(每图 = 嵌图/引用 + 一段讲解散文)→ 3 图清单与状态表。
  • 生成引擎子树:内容最厚、且在飞,按子主题拆多份并分现行/远期两簇。
  • SVG 命名 NN-名称.svg(域内编号)。

状态码:现=现行已建 · 接=现行待接线 · 建=待建 · 缓=缓做 · F=future-state · 废=废弃(决策史对照) · 史=决策史。 形式码:SVG新 · SVG升(以现有 Mermaid 升保真) · Mer新 · 引(引用现有 README Mermaid,单源不复制)。家族:架/讲/时/状/类/ER/流。


4. 图清单(每图讲什么 + 状态)

总量 ≈ 140 图位 = ~110 需新作(~65 SVG + ~45 Mermaid)+ ~30 引用现有 README Mermaid(单源)。与"100+ 图"预期一致,且把"图不漂移"真正落住。

4.1 系统全景图说(总图叙 · 15 张 · 含 3 张高价值跨域图)

映射:架构/README.md · 产品/README.md · 运营/README.md · 运维/README.md · 后端/数据模型.md · 架构/契约总览.md

# 图名 家族 形式 状态 一句话讲什么
1 六域生命周期全景 SVG升 产品→架构→后端/前端→运营→运维 六域串成产品全生命周期
2 六层技术分层总图 SVG升 接入→网关→业务→基座→AI→中间件 + 旁路可观测
3 产品端到端闭环 SVG升 create→generate→preview→publish→feed→play→互动→广告→收益→数据回流
4 13 模块聚类 + 依赖总图 SVG升 四簇 13 模块 + 单向依赖,未来微服务切割线
5 生成主线端到端轮廓(现行 SAA 线) SVG升 一句话→aigc→SAA 16 节点→new-api→九门→落库(第一期承载护城河轮廓)
6 现行 SAA 廉价线 ‖ 远期 tier2 自治轨 SVG新 现+F 两条生成轨的硬边界:现行已建 vs 待 0 号 spike;只经公共件交汇
7 全平台数据模型 ER 总图(canonical) ER SVG升 用户→项目→版本→包/任务/审核,钱包/交易,广告位/曝光(全仓唯一 ER 权威,余处引用)
8 跨域数据流(越用越聪明) SVG新 埋点→telemetry 聚合→质量分→候选集→feed 重排→行为回流 飞轮回路
9 ★失败/降级/补偿路径全景 SVG新 横切外部模型/异步/支付:超时→失败→重试→幂等→补偿→兜底(评审最易发现缝处)
10 ★端到端鉴权信任边界总图 SVG新 前端→网关→业务 各层挡什么、anon_id 衔接、网关+业务双重校验职责切分
11 ★契约镜像 + 防漂移现状(声明 vs 现实) SVG新 8+2 类契约落点、Java 镜像、DB 镜像已漂移 / CI 防漂移门缺位 / Dify#6 废 / 编号五套相撞 诚实画出
12 部署拓扑总图(四机) 引用运维 README §1.1 四机分工
13 四层护城河 引用运营 README:数据/网络效应/资产/合规
14 三线变现排序 引用运营 README:B 端现金线→数据线→渠道规模线
15 角色 × 端全景 Mer新 创作者/玩家/经营/运营/B 端/通用 各在哪个端做什么

4.2 产品图说(9 张)

映射:产品/README.md · 产品/需求清单.md · 产品/需求模块映射.md · 产品/商业定位.md · 产品/护城河话术.md

# 图名 家族 形式 状态 一句话讲什么
1 产品闭环全景 引用 README §1
2 19 产品域 × 五大块 SVG新 创作/玩家/变现/成长/平台 五大块归拢 19 域
3 155→55 P0 收敛 引用 README §4
4 需求编号体系 Mer新 P-{域}-{序号} + 端/优先级/来源 四属性怎么读
5 需求→模块 M:N 映射(RTM) ER SVG新 产品需求 ↔ 技术模块 的多对多映射矩阵(关系图,非类图)
6 五大块产品域关系 Mer新 创作产出→玩家消费→变现回流 的块间流转
7 创作者旅程 Mer新 挑素材→一句话生成→预览迭代→发布→看收益
8 玩家旅程 Mer新 刷 feed→即点即玩→点赞分享→发起同款
9 商业定位与护城河一图 SVG新 平台定位、差异化闭环、资本效率对比

4.3 架构图说(12 张)

映射:架构/README.md · 架构/13模块.md · 架构/契约总览.md

# 图名 家族 形式 状态 一句话讲什么
1 六层技术分层 引用 README §1
2 关键选型决策树 SVG新 现+史 框架/生成/引擎/素材 每项击败了谁;并列已废候选(Dify/OpenGame/自研壳)作决策史
3 生成主线 现行 vs 决策史 现+废 引用 README §2.2(现行 SAA vs 蓝图原案 Dify/OpenGame)
4 13 模块聚类 引用 README §3
5 13 模块单向依赖 引用 README §4
6 一条生成请求时序 引用 README §5
7 生成任务状态机 引用 README §5
8 游戏安全运行时序 引用 README §6
9 推荐打分公式 SVG新 Score 正负信号加权 + Redis 候选集 + error_rate 硬降权
10 8+2 类契约族总览 SVG新 契约族导航(与总图说图 11 同源,域内细化:含 agent-loop/templates README 漏登项)
11 工程治理(幂等/SLO/可观测) SVG新 幂等矩阵、三服务 SLO + Error Budget、四路可观测
12 专区 Zone + 锁风门 Gate Mer新 两个跨模块概念的 owner 与聚合关系(概念图)

4.4 产物执行沙箱图说(7 张)

映射:架构/产物执行沙箱.md

# 图名 家族 形式 状态 一句话讲什么
1 不可信代码隔离全景 SVG新 生成出的不可信游戏代码怎么在浏览器里被隔离着安全跑
2 取包→校验→隔离→注入 时序 SVG升 sha256 校验→iframe+CSP→注入 GameConfig+SDK→执行
3 postMessage 双向桥双校验 Mer新 宿主↔沙箱 消息的来源 + schema 双校验
4 受控面(SDK bridge)能力面 SVG新 平台注入唯一通道:Core 层 + Plugin 层各暴露什么
5 两条正交边界 SVG新 沙箱边界 vs 插件↔引擎受控面,别混
6 CSP/同源红线/产物消毒 Mer新 allow-same-origin 红线、connect-src none、产物白名单消毒
7 三容器加载/失败/销毁态机 Mer新 当前播放/前一个销毁/后一个预加载 + 加载失败降级

4.5 后端图说(8 张)

映射:后端/README.md · 后端/数据模型.md · 后端/鉴权与权限.md · 架构/13模块.md

# 图名 家族 形式 状态 一句话讲什么
1 后端分层与依赖(实现视角) 引用 README §1
2 两段式模块 -api/-server SVG新 每模块拆 -api(契约面)/-server(实现),跨模块只依赖 -api
3 包名→端前缀自动生效 Mer新 **.controller.app/admin.** 如何自动套 /app-api、/admin-api
4 错误码分段分配 Mer新 1-{模块段}-*** 各模块独占段
5 数据模型跨域 ER(域内细化) ER 引用总图说图 7 canonical ER + 软关联/语义坑标注
6 五条业务链路 SVG新 创作/发布/试玩/广告收益/数据回路 五链路跨模块调用
7 鉴权 OAuth2/RBAC 双模型 SVG新 B 端 RBAC 与 C 端归属隔离两套并存(配合总图说图 10 边界)
8 匿名/登录准入矩阵 Mer新 哪些端点匿名可达、哪些必须登录

4.6 前端图说(9 张)

映射:前端/README.md(交叉:架构/产物执行沙箱.md · 架构/生成引擎/引擎与运行时.md)

# 图名 家族 形式 状态 一句话讲什么
1 两个前端定位 引用 README §1
2 token 两层 + 组件库四层(核心) SVG升 primitive→semantic→component + L0/L1/L2/L3
3 三条数据流 token/theme/i18n SVG新 token 自底向上、theme 换肤、i18n 文案 三条流
4 demo 取舍 引用 README §3(留设计语言/弃布局)
5 三大契约 token/组件/i18n SVG新 additive 契约面:命名空间、向后兼容别名
6 主题切换 [data-theme]+防 FOUC Mer新 localStorage→首屏内联脚本→语义层覆盖→组件自动反应
7 studio 视图地图 SVG新 19 视图按业务域布局与导航
8 真实试玩宿主 Mer新 iframe+SDK/Runtime 注入+postMessage 桥(交叉引沙箱)
9 tier2 富游戏前端承载 Mer新 feed 双轨装载 + 第二轨创作入口(归属已定·待建)

4.7 运营图说(11 张)

映射:运营/README.md · 运营/变现与单位经济.md · 运营/变现端到端.md · 运营/渠道发行.md · 运营/合规闸门.md · 运营/审核台运营.md

# 图名 家族 形式 状态 一句话讲什么
1 运营三件事咬合 引用 README §1
2 12+1 合规闸门依赖 SVG升 ICP 临界路径、律所分叉、经营主体已具备
3 合规死锁三环 + 双层定性破解 SVG新 IAA 豁免/无版号/二清 三环锁,如何用双层定性解开
4 分账公式钱流 引用 README §2.2(平台恒留 0.2N)
5 两平面两钱包三硬边界 SVG新 生成计费≠收益、收益钱包≠消费钱包、元≠分
6 三线变现排序 引用 README §3
7 四层护城河 引用 README §3
8 发行双路线 H5/渠道 引用 README §2.3
9 一壳多游 L1 精选整包 SVG新 一 appid 装固定模板 + 远程 GameConfig,备案锁约束
10 变现端到端钱流地图 SVG新 钱从广告/订阅/定制 经表/job/回调 落到钱包/营收
11 审核台双层审核 SVG新 自部署快检 + 阿里云兜底 + 人审 BPM + 锁风门三档 + 处置联动 feed

4.8 运维图说(8 张)v2 补全〕

映射:运维/README.md · 运维/观测体系.md · 运维/k8s迁移.md

# 图名 家族 形式 状态 一句话讲什么
1 四机分工拓扑 引用 README §1.1(lili-mac/mini-desktop/mini-infra/6c6g + Gitea 中转)
2 部署链 push→pull→重建→验门 SVG新 Gitea 中转 + 串行 push + 字节码实证 + 隔离验证安全变体
3 隔离验证安全变体 Mer新 新 JAR 在 :48090 验全再切,live :48080 全程不动
4 冒烟门 12+1 项 SVG新 五链路就绪检查 + --deep 写路径
5 可用性 SLO / Error Budget Mer新 ≥99.5% + 成本盒子 <¥5000/月 的约束来源
6 观测体系 OTel→Grafana/夜莺 SVG新 采集→看板→告警 + admin 观测入口(设计已出·待接线)
7 admin 观测入口 Mer新 控制台一键进监控大盘
8 k3s 单节点迁移(收窄+缓做) SVG新 单节点 k3s + staging + 观测栈、库不进集群、推迟高可用;标"缓做"

4.9 生成引擎子树(旗舰 · 提案待与在飞 session 对齐 · 拆两簇)

⚠️ 本节是提案,不直接启动:生成引擎子树正被另一条 session 在飞建设。启动前须先对齐边界(哪些已被对方在做、哪些归本线)。下表按"现行 SAA 廉价线"与"远期 tier2 自治轨"两簇组织;子树第一张图必须是两簇硬边界图(= 总图说图 6,子树内细化)。

A. 现行 SAA 廉价线簇(已实测合入主干 · 状态多为「现」)——映射 固定游戏架构.md · SAA编排.md · 开闸接线.md · 引擎与运行时.md · prompt治理.md · 数据飞轮.md · 验收门-W-G1.md · WG1基准.md · OpenGame对照.md · 设计合理性裁决.md · 演进路线(真源 = 生成引擎 README §4§7 + OpenGame对照.md + 设计合理性裁决.md;agent-specs 留痕档仅作外部 trace 源)

子图说 张数 关键图(状态)
固定生成线图说 11 现行固定线全景(现)/16 节点+7 条件边拓扑(现)/一句话→首局可玩时序(现)/救场阶梯(现)/dispatcher 契约(现)/双 sourceMode 同源 assemble(现)/源项目持久层 V18+V20(现)/生命周期六操作(现/建)/gameDefinition→src 终态兑现门缺口(建,诚实画"承重 behavior.code 未进契约"债)
SAA 编排图说 8 StateGraph 原语装配(现)/加节点法(现)/checkpoint 框架+saved_at 坑(现)/节点观测→trace(现)/六不变量(现)/双脑防线(现)/子图与 subAgents(现)/最小依赖+Boot 版本坑(现)
引擎与运行时图说 8 LittleJS 增强发行版分层(现)/Runner v2 两层装载契约(现)/game-host.d.ts 类图(现)/三容器加载(现)/冷启动对比(现)/SDK Core/Plugin 注入(现)/bootGameHost 泛化(现)/引擎↔插件受控面边界(现)
prompt 治理图说 5 第 8 契约 Registry(现)/load-inject 链(现)/eval 门(现)/HITL(现)/prompt 同源解 split-brain(建)
数据飞轮图说 6 三飞轮全景(建)/溯源链+同款 P-FED-12(建)/资产库→市场(建)/收益回流语料(建)/分期依赖(建)/跨模块接缝(建)
演进路线图说 9 现状三类债(现)/线 A 加固(引 README §6)/线 B 补能力(引)/两交汇点(引)/cutover 门(引)/迁移序列(引)/OpenGame 命令式 vs 我方声明式(现)/三缺口(引)/Tier0 可靠产线天花板·非通用范式(史/裁决)
验收门与基准图说 7 九门 harness 总览(现)/九门逐门流程(现) + W-G1 开闸 6 门(现,与九门分层)/双层验收门=确定性硬门+M3 视觉软检(现)/开闸门配置 2 焊死+3 观测+1 地板(现)/20 款经典靶集(现)/缺口诊断矩阵(现)

B. 远期 tier2 自治轨簇(待 0 号 spike · 未落代码 · 状态多为「F」)——映射 自治富游戏引擎.md · tier2四层工程架构.md · tier2实现详设.md · agentic集成架构.md · 金样板 agentic运行时架构图说.md

子图说 张数 关键图(状态)
tier2 运行时图说〔金样板·已出·另 session WIP ~89 系统全景/调用时序/运行时内部/ReAct 循环/编排配置/reuse 边界/产物契约/类图(均标 F·远期轨)
自治富游戏引擎图说 6 引擎内核 O2 约束自治(F)/Phaser·Pixi 选型为何排 Cocos(F/史)/确定性地板+人工终审(F)/无头自治筛子(F)/与现行线解耦边界(现+F)/0 号 spike go-no-go(F)
tier2 工程落点图说 5 四层工程切分 environment/harness/context/prompt(F)/硬代码 vs 可配置(F)/源项目契约(F)/统一 trace 接点(F)/0 号 spike runbook+退路树(F)
agentic 集成架构图说v2 补孤儿〕 4 控制面/管理面四组件 ×两条生成线(现+接)/配置注册表(接)/观测审计仓(接)/D12 运行治理门 现覆盖 SAA·tier2 待接(现+F)

子树第一张 = 两簇硬边界图(现行‖远期);末张 = 子树图清单与状态表。A 簇约 54 张、B 簇约 23 张(含金样板已出 89);以与在飞 session 对齐后的最终清单为准。


5. 编排方案(确认后执行)

  1. 分两期(降风险 + 避跨 session 冲突):
    • 第一期 = 总图说(15)+ 六域图说(产品 9 / 架构 12 / 沙箱 7 / 后端 8 / 前端 9 / 运营 11 / 运维 8)≈ 79 张。第一期已含生成引擎现行主线轮廓(总图说图 5/6 + 架构图说图 3/6/7),故第一期可支撑"全局轮廓 + 关键路径轮廓"的 review;深度留第二期。
    • 第二期 = 生成引擎子树(A 簇 ~54 + B 簇 ~23),前置 = 先与在飞 session 对齐边界
  2. 按域启动 workflow,每域一个,负责该域图说内所有图:读源设计档 → 逐图产出(SVG XML / Mer / 引用现有)→ 自检(viewBox 不溢出、徽章/三线/状态/映射脚注齐)→ 汇编进图说 md。子代理模型分档:画图=有裁量→opus;纯汇编=机械→haiku。
  3. PNG 转换:SVG 入仓后在 mini-desktop 批量转 PNG;验收标准 = 文字不溢出 / viewBox 完整 / 字体正常 / PNG 可读;SVG↔PNG 同步检查。
  4. 单源优先: 类不复制 README Mermaid,只在图说叙述里链接;SVG升 以现有 Mermaid 为底稿提保真。
  5. 防漂移门:图说 frontmatter 记「源档 + commit hash」,收口脚本比对;同步纪律入 wave 收口清单。

6. 关键决策(创始人 2026-06-22 已拍板)+ v2 待点头 2 项

已拍板:① 形式 = 混合(复杂 SVG + 简单 Mermaid);② 总图叙 = 导览式(内联系统级图 + 导航);③ 分两期(先六域、后生成引擎子树);④ 域级命名 <域>图说.md

v2 据评审调整,需创始人点头:

  • (a) 总量口径:由"~140 全新作"修正为 ~140 图位 = ~110 需新作 + ~30 单源引用(删凑数配额 + 已有 Mermaid 不复制)。是否认可这个"更少但不漂移"的口径?
  • (b) 第一期 review 范围:第一期承载全局轮廓 + 生成引擎现行主线轮廓,但生成引擎深度(债/OpenGame/tier2)留第二期。认可"第一期=轮廓级 review、深度待第二期"这个诚实口径吗?

执行前置门:决策已拍 → 已过计划双评审(Codex+Opus,v2 已整改)→ 创始人确认 v2 + 上述 2 项 → 启动第一期六域 workflow;第二期另需先与在飞 session 对齐。


7. 设计档覆盖矩阵(防遗漏 / 防孤儿)

策展层现行设计档 → 对应图说;_archive/ _recall/ 仅作历史证据,不进现行图集。

源设计档 覆盖图说
产品/README · 需求清单 · 需求模块映射 · 商业定位 · 护城河话术 产品图说 + 总图说
架构/README · 13模块 架构图说 + 总图说
架构/契约总览 架构图说图 10 + 总图说图 11
架构/产物执行沙箱 产物执行沙箱图说(+ 前端图说图 8 交叉)
后端/README · 数据模型 · 鉴权与权限 后端图说 + 总图说图 7/10
前端/README 前端图说
运营/README · 变现与单位经济 · 变现端到端 · 渠道发行 · 合规闸门 · 审核台运营 运营图说 + 总图说图 13/14
运维/README · 观测体系 · k8s迁移 运维图说 + 总图说图 12
生成引擎/固定游戏架构 · SAA编排 · SAA能力API-dossier · 开闸接线 · 引擎与运行时 · prompt治理 · 数据飞轮 · 验收门-W-G1 · WG1基准 · OpenGame对照 · 设计合理性裁决 生成引擎子树 A 簇(第二期)
生成引擎/自治富游戏引擎 · tier2四层工程架构 · tier2实现详设 · agentic集成架构 · agentic运行时架构图说(金样板) 生成引擎子树 B 簇(第二期)
生成引擎/README 生成引擎子树总览(两簇边界图)

排除项:_archive/*_recall/*(历史/回收,只读证据);docs/agent-specs/*(留痕层,仅作演进路线图说的"外部 trace 源"引用,不在 architecture 图集内单独成图)。