docs(游戏分发): 给 lineage JSON 字段留 rename-refactor TODO
- shared-contracts 的 GameDistributionGameSummary.lineage 与 TS 契约同名字段各留 TODO(rename-refactor)。 - 待网页读面 .lineage 用法与测试夹具同批切换后,把该 JSON 字段改名 network(公开契约破坏性改名)。 - 实施计划同步标注该待办。
This commit is contained in:
@@ -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>,
|
||||
|
||||
Reference in New Issue
Block a user