配置契约、埋点与日志
本页合并旧配置数值和埋点日志标准的有效定义方式。规则来自草案,尚未统一为所有现有协议/配置的事实;各功能文档已给出的字段与事件名称优先按实际消费者核对,不以通用模板改名覆盖。
配置字段与数值
配置定义需让消费方理解字段名、类型、单位、默认、最小/最大、可空语义;有条件适用的字段说明生效条件。业务公式和最终倍率显式表达,共享字段说明哪些功能消费,避免依赖未命名常量或把百分比/倍数混用。
修改ID、版本或字段语义时检查真实消费者和数据,声明影响范围。当前任务采用clean break时,同步生成产物/调用方并删除旧字段路径,不默认添加fallback、双读或版本兼容。只有存在明确且获授权保留的消费者才讨论例外,不能由“字段新增”自动推定必须兼容旧客户端。
生成代码从真实单一源生成,记录来源与生成器身份;不能分别手改两端产物。参数不明确就记录具体未知与影响,不擅自猜成正式数值,也不把所有未填默认值一概升为人工审批门。
旧稿要求每个关键字段提供公式、测试用例和边界结果;本页保留公式/边界信息,测试仍受项目明确授权约束,不自动生成或运行。
埋点语义与字段
事件名稳定表达业务行为,避免同名异义;原稿建议“模块_行为_结果”,而现有好友/聊天文档已有 friend_page_open 等明确名称,不能为统一词形擅改这些事件。每个事件说明触发时点、入口/场景、参数类型、结果语义及成功/失败的判据。
旧稿通用字段 event_id/event_time/feature_id/actor/result 是候选事件包络,不是本次已确认全部功能都包含的强制schema。具体字段以现有源契约为准;如果实现没有对应字段,应标缺口而非在文档中补成实现事实。
高频事件说明采样率/策略;同帧重复点击、刷新重入等不能被错误统计成多个独立业务结果。幂等/去重范围按事件意义处理,不一律吞掉真实多次意图。业务结果使用稳定枚举,错误原因不任意拼自由文本。
日志与隐私
账号/设备身份等按实际诊断所需最小范围脱敏,禁止输出密码、token、私钥和完整连接串。用户输入不能无结构直接拼入日志;聊天正文及搜索关键词按对应功能设计不上传为普通埋点。日志记录能够说明失败与恢复路径的上下文,不复制状态权威到另一套可编辑台账。
监控图表和告警只有在实际消费者需要时设置;旧“所有关键流程必须dashboard/阈值”没有具体运营需求,不作为当前交付前提。埋点定义存在不等于已采集,字段定义正确也不等于线上数据完整。
来源与边界
来自旧 config-data-standard.md 和 telemetry-logging-standard.md;配置兼容模板、默认新增测试、通用blocker和固定审批已移除。业务事件详细字段保留在各功能页,不在这里复制第二套。未修改配置/埋点源码,未新增或扩写测试。本地验证:根据项目策略禁止执行。