docs(游戏分发): 给 lineage JSON 字段留 rename-refactor TODO

- shared-contracts 的 GameDistributionGameSummary.lineage 与 TS 契约同名字段各留 TODO(rename-refactor)。
- 待网页读面 .lineage 用法与测试夹具同批切换后,把该 JSON 字段改名 network(公开契约破坏性改名)。
- 实施计划同步标注该待办。
This commit is contained in:
2026-10-07 23:36:06 +08:00
parent fc71275ce2
commit 515b681d24
3 changed files with 4 additions and 1 deletions
@@ -116,7 +116,7 @@ cargo test -p spacetime-client --manifest-path server-rs/Cargo.toml
- 前缀冲突:`GameDistributionLineageNode` ⊂ `GameDistributionLineageNodeSnapshot`、
`GameDistributionForkSource` ⊂ `GameDistributionForkSourceInput/Result`;改名只动手写源文件,
`spacetime-client/src/module_bindings/` 由绑定生成,绝不手改或全局替换。
- `GameDistributionLineage` 只改类型名,JSON 字段名保持 `lineage` 不变,避免读面破坏性改名。
- `GameDistributionLineage` 只改类型名,JSON 字段名保持 `lineage` 不变(Rust DTO 与 TS 契约已留 `TODO(rename-refactor)`),待读面(`.lineage?.generation` 用法与测试夹具)同批切换后再改 `network`。
- 模块不在线、无历史数据:hard cut,不写迁移、不留兼容路由或旧 DTO 别名。
## 9. 证据(回填)
@@ -377,6 +377,7 @@ export type GameDistributionGame = {
* 不新增索引,api-server 只发键不遍历。
*/
coCreationCount?: number;
// TODO(rename-refactor): 字段名 lineage 与类型 GameDistributionNetwork 不一致,待读面切换后改名 network。
/** 血缘摘要;根作品或旧数据为 null/缺省。 */
lineage?: GameDistributionNetwork | null;
/**
@@ -243,6 +243,8 @@ pub struct GameDistributionGameSummary {
/// 读取方按 `0` 兜底。
#[serde(default)]
pub co_creation_count: u64,
// TODO(rename-refactor): 字段名 `lineage` 与类型 `GameDistributionNetwork` 不一致;待网页读面
// (`.lineage?.generation` 用法与测试夹具)同批切换后改名为 `network`——公开契约破坏性改名。
/// 该作品的改编来源;母版为空。
#[serde(default, skip_serializing_if = "Option::is_none")]
pub lineage: Option<GameDistributionNetwork>,