fix(埋点合同): 服务端同步 AGC 新增的 creation_source=platform_game

- 依据客户端提交 `5d01e43b6`:AGC 的 `CreationSource` 新增 `PlatformGame`,按 serde snake_case 落到线上取值 **`platform_game`**(同提交的 `creation_source_gains_platform_game_without_breaking_existing_values` 用例显式给出该字面量),上报字段仍是 `project_create_success` 的属性 `creation_source`。服务端枚举此前没有它,整条事件会被判 `invalid_properties` 直接丢弃
- `shared-contracts/src/agc_analytics.rs`:`values!(CreationSource { .. })` 追加 `PlatformGame`(注释与客户端一致);解析走 serde 派生,无需新增匹配分支
- `module-runtime/src/agc_analytics.rs`:新增 `agc_accepts_every_creation_source_and_rejects_unknown`——五个受支持取值(home_game / home_design / template / selected_directory / **platform_game**)逐个通过整批校验(事件形如 `project_create_success` 且带 `project_id`),未知取值(`remix` / `platform` / `PLATFORM_GAME` / 空串)仍然失败关闭为 `invalid_properties`
- 文档:`docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md` §6.6 的 `creation_source` 取值列表补 `platform_game`(保持 `/` 分隔与 snake_case 风格)
- 全仓核对:该枚举只有两处定义(AGC `analytics/contract.rs` 与 `shared-contracts`),**无第二处服务端镜像**、无 TS 联合类型、无 schema/OpenAPI 取值表;生成绑定不含该类型(埋点批量跨模块边界走 `payload_json: String`),因此无需重跑 spacetime generate
This commit is contained in:
2026-10-05 04:16:06 +08:00
parent e3bae05351
commit 4626aeefd4
3 changed files with 43 additions and 2 deletions
@@ -210,7 +210,7 @@ Direct 的自动登录刷新重试仍属同一个 run。原生单次调用结束
- 触发:新项目初始化完成,manifest 已持久化且稳定 project_id 已确认;覆盖自动创建与用户选目录创建。
- 公共字段:status=success;project_id 必填;source=editor;任务/run/turn ID 均 null。
- properties:creation_source=home_game / home_design / template / selected_directory;project_template_id 可选,仅填真实模板稳定 ID。
- properties:creation_source=home_game / home_design / template / selected_directory / platform_game;project_template_id 可选,仅填真实模板稳定 ID。
- 打开已有项目、幂等初始化不记创建;文件夹刚建立但后续失败不记成功。
- 去重事实键:project_id + 本次创建操作 ID + event_name,沿用业务操作身份,不读取路径当项目 ID。
- 只有成功事件,不能计算创建成功率;创建尝试数不在本版范围。
@@ -386,6 +386,45 @@ mod tests {
raw["file_path"] = json!("secret");
assert!(serde_json::from_value::<Event>(raw).is_err());
}
/// `creation_source` 的取值集合必须与客户端埋点合同一一对应:客户端新增「从平台作品开始创作」
/// (`platform_game`)后,服务端不认得就会把整条事件判成 `invalid_properties` 丢掉。这里把
/// 全部受支持取值逐个跑通,并钉住未知取值仍然失败关闭(不得静默接受或静默丢弃)。
#[test]
fn agc_accepts_every_creation_source_and_rejects_unknown() {
for creation_source in [
"home_game",
"home_design",
"template",
"selected_directory",
"platform_game",
] {
let mut e = event(
"project_create_success",
json!({ "creation_source": creation_source }),
);
// `project_create_success` 要求 source=editor 且 project_id 非空(见 `EventRules::validate`)。
e.project_id = Some("project-a".into());
assert_eq!(
validate_agc_analytics_batch(&batch(e)),
Ok(()),
"{creation_source}"
);
}
for unknown in ["remix", "platform", "PLATFORM_GAME", ""] {
let mut e = event(
"project_create_success",
json!({ "creation_source": unknown }),
);
e.project_id = Some("project-a".into());
assert_eq!(
validate_agc_analytics_batch(&batch(e)),
Err("invalid_properties"),
"{unknown}"
);
}
}
#[test]
fn agc_requires_explicit_nullable_fields_and_no_optional_nulls() {
let mut raw =
@@ -55,7 +55,9 @@ values!(CreationSource {
HomeGame,
HomeDesign,
Template,
SelectedDirectory
SelectedDirectory,
// 从平台作品开始创作(改编 Fork):取件自平台已授权公开作品的发行成品包。
PlatformGame
});
values!(OpenSource {
Create,