《互联网产品的客户端架构·交易、增长与平台化》12.1 埋点模型与事件契约
交易埋点最容易在「同名事件两个口径」上失真。本节把曝光、点击、加购、下单、支付、退款六类事件写成带 schema 版本的契约,用必填字段、命名规范与 orderId/traceId 串联把端上采集约束住,并给出可运行的校验、链路串联与 schema 差异检测模块。
category
交易埋点最容易在「同名事件两个口径」上失真。本节把曝光、点击、加购、下单、支付、退款六类事件写成带 schema 版本的契约,用必填字段、命名规范与 orderId/traceId 串联把端上采集约束住,并给出可运行的校验、链路串联与 schema 差异检测模块。
方舟立项会上有人问「消消首包 120MB,方舟为什么不能也压到 120MB」。本节把内存、帧预算、包体、机型、联网与稳定性写成统一整数单位的可计算清单,给出双案例差异,说明电量与发热为什么只能用代理建模、不能在本机冒充设备测量,并把清单挂到四个固定检查点上。
客服工单最容易被低估的是「用户关掉 App 之后」。消息发没发出去、重连后会不会重复、会话关闭后历史还在不在,决定了用户是否信任这个入口。本节用注入存储与假时钟实现本地缓存、离线队列、按序号补拉与去重,并复盘一次重连后消息翻倍的完整排查过程。
从「回声」模型试图自带 tenantId 查询别家订单、以及直接提议退款两个场景出发,拆开工具调用中“谁提议、谁授权、谁执行”三段职责,给出工具白名单、角色、租户注入、参数校验、副作用分级与单轮次数上限的可测试实现,并说明确认为什么必须绑定到具体调用 id。
渠道登录把 open_id、union_id、游客设备和平台账号四类标识同时带进服务端,绑定表稍有不慎就会产生影子账号、重复账号和无法解绑的死号。本文讨论 provider、租户与外部主体组成的唯一键,绑定、解绑、换绑与影子账号收编的语义边界,并用 internal/identitylink 的 Go 实现和五组表驱动测试说明幂等与冲突处理。
售后申请最常见的两个问题,是证据不齐导致来回补材料,和重复提交产生多张售后单。本节把申请、审核、通过或驳回、完成写成带角色约束的状态机,按原因定义必要与可选证据,用草稿标识与订单行双重判重,并复盘一次重复申请引发退款叠加的完整修复过程与回归结果。
拾光工作室把《潮汐消消》的客户端架构直接套到《潮汐方舟》,首帧、帧预算与联网假设同时失效。本节用六个运行驱动和一张共享/隔离表说明:品类只决定玩法内容,客户端架构必须按约束重新推导,并把判断写成可运行的层模型与测试,避免下一版被另一张架构图覆盖。
《裂隙战场》《群岛纪元》《泡泡工坊》共用账号底座后,客服工单暴露出账号、角色、设备与租户四层被混为一谈。本文拆开四层模型的责任边界,给出主键与软删除口径、同租户合并与跨租户迁移的分界、注销宽限期与墓碑保留策略,并用 internal/account 的 Go 实现和五组表驱动测试说明每次状态跃迁的代价。
《后端架构设计·演进与治理》的阅读入口:13 章分四段的结构、章节依赖图、三条阅读路径、症状到章节的对照表、arch-lab 在卷四新增的拆分、契约、发现、网关、配置、可观测性、SLO、混沌、发布、多租户、平台与成本组件,以及实测值、目标值与示例值的口径和读完本卷的五项标准。
用户在订单页点客服,却还要第三次报订单号;问题不在客服系统,而在入口没有携带最小上下文。本节把订单号、支付单、页面来源与最近错误码写成可校验的上下文对象,用入口白名单控制字段,用脱敏函数挡住手机号与邮箱,并复盘一次多标签页上下文串单的典型问题。
从「回声」客服辅助返回的工单建议 JSON 出发,说明为什么只取 JSON Schema 的一个可审查子集,如何把必填、枚举、范围与多余字段变成可定位的问题码,并给出一个零依赖校验器与一次真实的失败分类,让解析失败从“模型不稳定”变成可测量、可回归的工程输入。
卷一的学习路径与 45 篇索引:从双案例与移动端约束出发,依次经过分层、引擎与壳、生命周期、配置、资源内存、UI、设备、帧率功耗、存档、区域化与可观测性,最后收口到双案例客户端基线;每章三节构成一条判断链,附录给出术语、案例事实表与评审清单。
《游戏服务端架构》卷二《核心系统与契约》全 45 篇的阅读入口:说明本卷要解决的四个问题、十三章结构、三款产品的系统差异、序/前言/附录与三条阅读路径,并给出可运行性口径、各章核心内容速查和 39 篇正文的完整目录,便于按角色跳读,并标注三条路径的预计用时。
卷一的使用说明:双案例的口径与各章分工、mga-lab 的目录结构与测试命令、每节固定的六段结构、代码块三行头与 L1/L2 可运行层级的区别,以及顺序读、带问题查、只读产物三类阅读路径和四条读完一卷的自检标准,附与站内其它书稿的分工边界。
本卷的用法说明:13 章四段结构、arch-lab 在前三卷之上的治理组件、L1–L4 可运行性分级、代码块标记与抽取方式、贯穿全卷的 G1 拆分、G2 带门禁发布、G3 成本归因三个固定场景,以及实测值、目标值、示例值的数字口径和本机测试环境。
移动游戏客户端的问题很少出在「不会用引擎」,而是出在引擎之上没人拍板:分层、恢复、内存、帧预算、存档与可观测性。本序用一个 IP 两款产品的真实分歧说明这本书为什么存在、它明确拒绝写什么,以及四卷如何从客户端运行时一直排到商业化发行与平台化长线治理。
本篇交代卷二的技术基线、案例构造、13 章对应的 Go 验证包、L1 到 L4 的可运行性口径与数字证据规则,并给出按角色阅读、各章验证包与本地复现命令,说明怎样把系统契约写成能跑、能查、能被评审的产物,便于逐章复现与评审,并标注每条结论的证据等级。
卷一《客户端与移动运行时》45 篇索引:13 章覆盖双案例与移动约束、四层分层、引擎与壳、生命周期、配置、资源内存、UI、设备、帧率功耗、存档、区域化、可观测性与收口基线,附可运行的 mga-lab 实验工程与三篇附录,每章三节构成一条可复盘的判断链。
为什么卷三之后还要单独写演进与治理:拆分后发布互相拖累、SLO 全绿但用户投诉、平台建好却没人用三个场景,说明机制正确不等于组织可持续。这篇序交代卷三留下的未证明项、本书的四个立场、Go 主线与 Java 21 对照的口径,以及不伪造云上实测的边界。
卷一定下了拓扑,卷二才进入真正的工期:账号归谁、结算怎么不重不漏、平台和游戏各自负责什么。这篇序说明卷二与卷一、与《MMO 服务器开发》的分工,给出贯穿三款产品的系统差异、本卷的六组系统与四个写作立场,并把每节契约落成可运行的 Go 夹具。