PRODUCT REQUIREMENTS

埋点系统产品需求文档

V2.15.0 · 10 个子页面逐页说明 · 页面与弹窗原型截图

埋点系统产品需求文档 V2.15.0（功能说明版）#

变更记录#

版本号作者修订内容发布日期
V2.15.0产品依据现行原型重写后台“埋点系统”10个子页面功能说明2026-07-21

1. 背景介绍#

1.1 业务背景#

前端业务页面需要补充用户行为埋点，后台提供经营分析、漏斗、留存、获客、活动、用户调查、风险处置、埋点配置、事件查询和数据质量监控能力。

2. 产品概述#

2.1 产品目标#

2.2 受众#

产品、运营、数据分析、研发、测试、风控和财务人员。

2.3 设计原则#

3. 需求说明#

3.1 前台埋点#

前台具体事件及字段清单沿用上一版事件字典。本版先明确后台10个子页面如何使用前端、后端埋点数据。

3.2 后台需求#

3.2.1 经营总览#

页面原型

经营总览页面

筛选条件

条件用途规则
统计周期控制全部指标和趋势的统计时间默认最近14天；支持今天、昨天、最近7/14/30天
归因类型区分直推、裂变、自然流用户默认全部来源
访问载体区分 H5、PWA、Android、iOS、iOS书签默认全部访问载体
渠道查看指定 app_code 的数据默认全部渠道
查询按当前条件刷新页面更新指标卡、趋势、转化、来源和风险待办
重置恢复默认筛选条件统计周期恢复最近14天，其余恢复全部

功能模块

模块功能说明数据/交互规则
核心指标卡展示活跃会员、首充人数、充值金额、提款金额、平台GGR展示数值及较上一周期变化；点击充值、提款或GGR卡片切换趋势指标
埋点采集状态分开展示前端埋点与后端埋点运行情况展示打点端、事件数和接收成功率
用户主行为链路展示广告入口到业务结果的完整阶段点击“查看五类漏斗”进入转化漏斗页
核心指标趋势按天展示充值、提款或GGR趋势支持今天、最近7天、最近14天切换
今日投放转化展示分流、落地、下载、主站各阶段人数和转化率点击“查看详情”进入转化漏斗页
获客来源展示直推、裂变、自然流占比及人数点击“查看详情”进入获客分析页
风险待办展示待处理、今日新增和自动出款拦截案件点击“进入风险中心/立即处理”进入风险中心

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
O-01页面初始化进入页面后根据当前站点加载默认最近14天数据；站点是数据隔离条件，必须随每个请求传递。首屏可并行请求指标、趋势、投放、来源和风险摘要；任一模块失败不得阻塞其他模块。加载中显示骨架；单模块失败显示“加载失败，重新加载”；全页无权限显示403页。
O-02统计周期生成明确的站点时间起止值，供所有经营指标统一使用，不能由各模块自行计算日期。“今天/昨天”按站点自然日；最近N天包含当天；对比周期取等长上一周期。日期配置不存在时禁止查询并提示“站点时区未配置”。
O-03归因类型控制只统计直推、裂变或自然流用户；用于回答用户从哪类来源进入。直推、裂变可同时命中时同一用户在分来源图中分别计入，但总人数按用户去重，页面需提示可能非简单相加。无归因字段的记录归入“未识别”，不得自动算自然流。
O-04查询与重置查询把页面控件值提交为正式条件；重置只恢复控件默认值，并立即按默认值重新查询。查询期间按钮禁用，避免重复请求；新查询返回前保留旧数据并显示加载态。请求超时保留旧数据并提示失败；不得把失败结果覆盖为0。
O-05核心指标卡每张卡必须返回指标值、单位、对比值、对比方向和口径说明。活跃会员按用户去重；首充取生命周期首次成功充值；资金指标以后端成功结果为准；GGR=有效投注-派彩-Jackpot。分母或上一周期为0时变化率显示“—”；金额统一使用站点币种。
O-06指标卡切换趋势点击充值金额、提款金额或平台GGR卡片时，只切换趋势图指标，不重新请求其他模块。选中卡片增加选中态；趋势接口可复用已缓存数据，缺少时按当前全局条件请求。不支持趋势的卡片不可点击，鼠标样式不得表现为可操作。
O-07趋势周期“今天/最近7天/最近14天”控制图表粒度和点数，与上方统计周期互不改写。今天按小时或单日汇总；7/14天按站点自然日补齐日期，缺失日期补0但需区分无数据与接口失败。图表无数据显示空状态，不显示一条值为0的误导曲线。
O-08今日投放转化展示站内首个分流事件到主站首页的连续阶段，帮助判断投放链路在哪一步流失。每阶段人数按统一身份键去重；阶段率=本阶段人数/上阶段人数；第一阶段固定100%。上阶段为0时转化率显示“—”；点击详情携带当前全局条件进入漏斗页。
O-09获客来源环形图展示来源占比，旁边人数与图例一一对应。占比分母使用当前筛选下全部已识别获客用户；百分比保留1位，小数修正后合计100%。无来源数据时显示空图和0人，不保留上次结果。
O-10风险待办只展示当前用户有权限站点内的待处理风险摘要和最高优先级案件。高风险优先，其次按创建时间升序；“立即处理”携带案件ID打开风险中心。案件已被他人处理时进入风险页后刷新状态并提示，不允许按旧状态操作。

弹窗说明：当前经营总览原型无独立弹窗，卡片和快捷入口均在当前页切换或跳转。

3.2.2 转化漏斗#

页面原型

转化漏斗页面

弹窗原型

转化漏斗步骤详情

筛选条件

条件用途规则
全局筛选按周期、归因、访问载体和渠道筛选漏斗与经营总览筛选规则一致
漏斗类型切换投放下载、注册、登录、充值、提款、代理、活动奖励漏斗切换后刷新步骤、人数、转化率和结论

功能模块

模块功能说明数据/交互规则
漏斗步骤按顺序展示各事件人数和相邻步骤转化率前端步骤统计行为事件；成功步骤仅统计后端 result_status=success
流失人数展示当前步骤相对上一步减少的人数第一步不计算流失
关键结论自动指出当前漏斗主要流失阶段结论随漏斗类型变化
步骤详情抽屉查看事件名、打点端、人数、转化率和流失人数点击任一步骤打开
下钻维度定位具体流失来源支持访问载体、渠道、活动渠道、PID、页面类型、失败原因
导出流失明细导出当前筛选条件下的流失用户使用当前漏斗类型、步骤和全局筛选条件

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
F-01漏斗类型切换每个类型对应固定且有序的事件步骤配置；切换类型实际是切换一套漏斗定义。定义由事件名、成功条件、步骤顺序和显示名组成；前端不得根据中文名称拼事件。某一步未配置时整条漏斗标记“配置不完整”，不得跳过后继续算转化。
F-02步骤人数统计在查询窗口内到达该步骤的唯一用户数，用于衡量到达量。已登录优先用user_id；未登录用fingerprint_id；同一用户重复触发只计1人。身份字段均缺失的事件不计人数，并进入质量异常。
F-03前端步骤页面进入、点击、输入和选择只代表用户行为已发生。以客户端事件接收成功为准，不把按钮点击解释为注册、充值等业务完成。客户端事件延迟到达时按event_time归属原日期。
F-04后端结果步骤注册、登录、充值、提款、领奖等完成步骤必须由服务器结果事件提供。仅result_status=success进入成功步骤；failed进入失败原因下钻，不计成功人数。同一业务单重复结果按business_id+result_status去重。
F-05相邻转化率说明用户从上一步到本步的转化比例。本步人数/上一步人数×100%，保留1位；不计算跨步转化作为页面主值。上一步为0显示“—”；本步大于上步时标记“顺序异常”供数据排查。
F-06流失人数表示到达上一步但未在规定窗口内到达本步的用户。流失=上一步用户集合减本步用户集合；不能只用两个聚合人数相减生成可导出的用户明细。第一步无流失；漏斗窗口未结束时标记“数据持续更新”。
F-07步骤点击点击步骤打开详情抽屉，并把当前漏斗、步骤、时间和全局条件作为上下文。抽屉打开不改变页面筛选；关闭后保留原滚动位置和漏斗类型。详情请求失败只在抽屉内提示，不关闭主页面。
F-08下钻维度对当前步骤到达用户、流失用户或失败事件按指定字段聚合。失败原因只对后端failed事件生效；PID、页面类型缺失统一显示“未上报”。高基数字段默认只返回Top 50，其余合并为“其他”。
F-09关键结论根据最大流失人数、最低转化率和后端失败率生成可解释结论。结论必须带具体步骤和数值；不允许只展示固定文案。样本量低于配置阈值时显示“样本不足”，不输出优化结论。
F-10导出流失明细异步生成当前步骤的流失用户集合，供运营进一步分析。导出任务保存全部筛选快照、漏斗版本和步骤编号；敏感字段按权限脱敏。无导出权限隐藏按钮；超过行数上限时拆分文件并通知用户。

3.2.3 留存分析#

页面原型

留存分析页面上半部分
留存分析页面下半部分

筛选条件

条件用途规则
全局筛选按周期、归因、访问载体和渠道筛选时间按站点国家自然日
商业留存类型切换注册后充值、首充后复充、首投后复投切换起始事件、留存事件、指标卡和同批表

功能模块

模块功能说明数据/交互规则
用户活跃留存总览展示注册用户D1/D3/D7/D30再次进入主站的比例起点为注册成功；活跃为登录状态进入主站；按 user_id 去重
商业质量留存衡量注册、首充或首投用户后续充值/投注质量支持三种商业留存类型切换
留存指标卡展示D1/D3/D7/D30留存及环比未到观察日不参与计算
同批用户表按T0日期展示同批人数和各观察日留存率未到观察日显示“—”，不显示0%
口径说明展示起始事件、留存事件和计算定义充值成功以后端最终入账为准
分组字段用于比较不同用户群留存支持归因类型、访问载体、渠道、活动渠道、VIP等级、用户分组

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
R-01活跃留存起点建立每天注册成功的同批用户集合，后续所有Dn活跃率都使用该集合做分母。起点事件为后端register_result且success；按user_id去重并固定T0站点日期。补到事件更新原T0批次，但需记录最后更新时间。
R-02活跃判定判断T0用户是否在T0+n当天重新进入登录状态主站。使用登录状态下的home_page_view；同一用户当天多次进入只计1次。匿名首页访问不计活跃留存。
R-03商业留存类型切换不同的起始人群和后续商业行为，用于比较用户质量。注册后充值：注册→充值；首充后复充：生命周期首充→后续充值；首投后复投：生命周期首投→后续有效投注。起始事件和留存事件配置必须成对返回，缺一不可。
R-04Dn定义D1/D3/D7/D30是指定自然日留存，不是“截至第n天累计发生”。只判断T0+n当日是否发生留存行为；站点时区变更不回写历史T0日期。观察日尚未结束可显示实时值并标记“更新中”。
R-05指标卡汇总当前筛选范围内各批次的加权留存率及相对上一周期变化。加权率=各批次留存人数合计/各批次起始人数合计；不得对各批次百分比直接平均。无完整观察窗口时对应卡片显示“—”。
R-06同批用户矩阵每行是一个T0批次，每列是固定观察日，便于查看不同日期用户质量。单元格=该批次Dn留存人数/T0人数；颜色深浅按比例映射，数值文本始终显示。未到观察日显示“—”；到期但无人留存显示0.0%。
R-07分组字段把同批用户按T0时刻的属性拆分，避免后续属性变化污染历史分析。渠道、VIP、用户分组等取起始行为发生时快照；一个批次可选一个主分组。分组值缺失显示“未知”，不得丢弃该用户。
R-08全局时间筛选控制T0批次日期范围，不是控制后续留存事件发生范围。查询最近14天时选择最近14个T0批次，同时读取其后续观察日数据。若选择范围不足以形成D30，D30显示可用完整批次结果或“—”。
R-09口径说明把当前起点事件、留存事件、去重字段、时区和计算方式直接展示给使用者。文案随留存类型切换，必须与接口返回的口径版本一致。口径版本变更需在页面显示生效日期。

弹窗说明：当前留存分析原型无独立弹窗，所有定义与明细均在页面内展示。

3.2.4 获客分析#

页面原型

获客分析页面

筛选条件

条件用途规则
全局筛选按周期、归因、访问载体和渠道筛选获客数据默认最近14天、全部来源、全部访问载体、全部渠道

功能模块

模块功能说明数据/交互规则
链路指标卡汇总页面分流、落地页、下载页、主站、注册、支付、首充各阶段人数指标随筛选条件刷新
投放至主站表现表按渠道展示全链路人数和阶段转化率下载按钮与弹窗下载按钮为并列触点，不相加作为唯一用户数
归因类型标记直推、裂变和自然流直推来自广告来源证据；裂变来自邀请码；均无则为自然流
访问载体区分 H5、PWA、Android、iOS、iOS书签使用 channel_type
可下钻字段定位具体投放来源channel_type、app_code、promotion_channel_code、pid、page_type
导出报表导出当前筛选结果导出表格的全部字段和当前条件

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
A-01链路指标卡每张卡对应一个站内获客事件阶段，用于快速比较各阶段到达人数。全部阶段使用相同身份去重规则和查询窗口；后端成功阶段只统计success。指标未接入时显示“未接入”，不能用0代替。
A-02渠道行每行代表一个app_code在一种归因类型和访问载体下的链路结果。同一渠道存在多种channel_type时拆行；后台显示名称与代码同时可追溯。渠道已下架仍保留历史行并标记“已下架”。
A-03阶段人数展示页面分流、落地、下载、主站、注册、支付和首充的去重人数。站外广告点击未接入时，首阶段从站内分流成功开始，不得写成广告点击人数。迟到后端结果允许在24小时内回补原日期。
A-04并列下载触点普通下载按钮和弹窗下载按钮是两个可能重叠的触点。分别统计人数；用户同时点击两类按钮时各自计1，但后续总下载用户集合只计1。页面必须避免把两数直接相加描述为下载总人数。
A-05阶段转化率显示关键阶段之间的业务转化效率。例如落地至下载=进入下载页/进入落地页；全链路首充=首充成功/页面分流成功。分母0显示“—”；分子大于分母标记数据异常。
A-06归因判定把广告证据、邀请关系和无来源用户映射为直推、裂变、自然流。同时具备广告和邀请证据时保留双归因；明细需返回证据字段和归因版本。来源字段缺失但不能确认自然流时归为“未识别”。
A-07横向宽表表格列多于视口时，仅表格容器横向滚动，页面整体不能横向移动。渠道、归因、访问载体列固定在左侧；关键转化率与最终首充列可固定在右侧。移动端可只读查看并保留横向滚动提示。
A-08导出报表导出当前筛选下所有渠道行及全部链路字段，不受页面可视列限制。导出文件包含口径版本、站点时区、筛选条件和生成时间。数据量大时异步生成；重复点击复用未完成任务。

弹窗说明：当前获客分析原型无独立弹窗。

3.2.5 活动分析#

页面原型

活动分析页面

弹窗原型

活动分析用户明细

筛选条件

条件用途规则
全局筛选按周期、归因、访问载体和渠道筛选活动用户与其他分析页一致
活动列表选择充值返利、投注返利、救援金、斗鸡连胜、票券活动、月卡切换后刷新该活动全部指标
票券类型在票券活动内切换每日转盘、砸金蛋、下载宝箱、充值转盘仅选择票券活动时出现

功能模块

模块功能说明数据/交互规则
活动指标卡展示参与人数、达标金额、奖励金额及活动专属指标不同活动展示不同指标，不强制共用无意义字段
用户行为转化展示曝光、进入、参与、达标、领奖、奖励成功的逐步转化投注返利、救援金不展示“参与动作”；月卡拆分每日必得和额外奖励
行为趋势展示近7日参与、达标和奖励成功人数无参与步骤的活动只展示达标和奖励成功
用户行为分层展示曝光未进入、进入未参与、参与未达标、达标未领奖、领奖未成功、奖励成功用户各分层按上一阶段人数计算占比
查看用户打开当前分层用户明细展示UID、渠道和脱敏手机号
导出用户明细导出当前活动的用户行为明细使用当前活动、票券类型和全局筛选条件

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
C-01活动选择左侧活动列表是分析对象选择器，每次只能选一个活动类型。切换后清空上一个活动的票券子类型、步骤选中和用户抽屉状态，再请求新数据。活动无权限时不展示；已结束活动仍可查看历史。
C-02活动专属指标不同活动返回不同经营指标，避免用同一组指标错误解释业务。接口返回指标编码、名称、数值、单位和口径；前端按配置渲染但不执行金额公式。未支持的指标编码显示兼容占位并记录前端告警。
C-03票券子类型票券活动下按每日转盘、砸金蛋、下载宝箱、充值转盘继续细分。子类型是查询条件；切换后同步刷新指标、行为步骤、趋势和分层。非票券活动隐藏该控件，并清除已选票券值。
C-04行为步骤描述用户从活动曝光到奖励成功的业务过程。每步绑定明确事件与成功条件；活动达标、奖励成功必须以后端事实为准。某活动不存在“参与”步骤时从流程定义中移除，不显示0人虚拟步骤。
C-05月卡双奖励路径月卡在达标后分别进入每日必得和每日额外奖励两条领取路径。两条路径各自计算发起领取、成功人数和转化率，不串联为一条漏斗。用户同日重复领取按月卡实例+日期+奖励槽位幂等。
C-06行为趋势展示最近7个站点自然日的参与、达标和奖励成功人数。每个序列使用相同用户去重口径；无参与步骤的活动不返回参与序列。日期无数据补0；接口失败不补0。
C-07用户分层每个分层代表停留在某一阶段的用户集合，供运营定位问题。通过集合差计算，例如达标未领奖=达标集合-领奖集合；奖励成功为最终成功集合。分层集合必须互斥；相加应等于基准阶段人数或给出差异说明。
C-08查看用户打开所选分层的用户明细，不改变主页面活动选择。明细返回UID、渠道、脱敏手机号；支持按稳定排序继续分页或导出。无敏感字段权限时手机号列全部脱敏且不提供查看完整值。
C-09导出用户导出当前分层完整用户集合及判定证据。导出包含活动版本、分层规则、筛选快照和用户最后阶段时间。空分层禁用导出；任务失败可重新生成。

3.2.6 用户360#

页面原型

用户360活动记录
用户360资金记录

筛选条件

条件用途规则
用户查询查询单个会员支持用户名、手机号、会员ID；系统无昵称字段
记录标签切换行为轨迹、资金记录、活动记录、登录设备、风险记录切换后每次先加载10条

功能模块

模块功能说明数据/交互规则
用户头部展示用户名、状态、VIP、会员ID、注册时间和归因来源查询成功后更新
行为轨迹按站点时间倒序串联前端行为和后端业务结果默认10条，上拉或点击继续加载
资金记录展示充值、提款、投注、派彩、奖励、佣金等金额变化展示订单号、结果和失败原因
活动记录展示活动动作、奖励金额、结果和原因失败记录必须保留原因
登录设备展示访问载体、设备/浏览器、IP和设备状态IP默认脱敏
风险记录展示案件编号、风险类型、等级和状态可关联风险中心案件
会员信息展示手机号、注册IP、余额、充提总额、净输赢、稽核和风险标签手机号与IP按权限查看完整值
导出详细数据导出当前标签全部记录和完整字段不仅导出当前已加载10条

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
U-01用户搜索输入用一个输入框接收用户名、手机号或会员ID，提交后由服务端识别查询类型。去除首尾空格；手机号按完整号码查询；会员ID精确匹配；用户名按精确匹配优先。空输入不查询；多用户命中时返回选择列表，禁止默认打开第一人。
U-02用户查询结果查询成功后一次返回用户基础身份，其他标签数据按需加载。新查询用户时清空上一用户的全部记录、加载页码和敏感字段明文状态。未找到显示空状态；用户被删除/合并时展示历史状态和目标用户链接。
U-03用户头部固定展示当前调查对象，避免切换标签后失去上下文。用户名、UID、状态、VIP、注册时间和归因来源来自用户快照；归因显示名称和代码。字段缺失显示“—”，不得保留上一用户数据。
U-04行为轨迹把前端行为和后端结果按站点时间合并成一条可读时间线。默认倒序；相同trace_id事件可连续展示；每次加载10条，使用游标避免重复。迟到事件插入正确时间位置；加载失败保留已加载记录。
U-05资金记录展示影响用户资产或资金订单的记录，便于核对充值、提款、投注、派彩、奖励和佣金。金额带正负方向和币种；成功、失败、处理中分开；订单号可作为后续详情入口。失败必须显示原因；无订单号的人工账变显示账变ID。
U-06活动记录展示用户参与活动、领取奖励及失败原因的历史。每条记录绑定活动ID/版本、动作、奖励金额、结果和业务时间。奖励冲正以负数记录，不覆盖原奖励成功记录。
U-07登录设备展示访问载体、设备、浏览器、IP及当前/历史状态。当前设备依据最近有效会话；同一设备多次登录聚合展示最近时间。IP默认脱敏；设备ID缺失时不能错误合并。
U-08风险记录展示该用户关联的风险案件，作为调查入口。按案件创建时间倒序；点击案件编号进入风险中心并携带案件ID。已关闭案件保留；无权限查看案件时只显示数量。
U-09标签切换切换行为、资金、活动、设备、风险数据域。首次打开才请求；再次切换可使用缓存，但用户或全局站点变化时清空缓存。标签请求失败只影响当前标签。
U-10查看敏感字段“查看”临时显示完整手机号或IP，用于授权人员核查。点击前校验字段权限；成功查看写入敏感字段审计，记录用户、字段、操作者和时间。无权限不显示按钮；会话超时后自动恢复脱敏。
U-11加载更多当前标签每次追加10条，而不是重新替换已有列表。使用服务端游标；返回不足10条表示结束；防止滚动和按钮同时触发重复请求。到底显示“已加载全部”；无数据显示专用空状态。
U-12导出详细数据导出当前用户、当前标签和当前查询范围内的全部记录。不受前端已加载条数限制；附带站点时区、导出人和脱敏规则。资金、设备等敏感域需独立导出权限并写审计。

弹窗说明：当前用户360原型无独立弹窗；手机号和IP通过当前页“查看/隐藏”切换。

3.2.7 风险中心#

页面原型

风险中心页面

弹窗原型

风险案件详情

筛选条件

条件用途规则
风险等级筛选全部、高风险或中风险案件默认全部风险等级

功能模块

模块功能说明数据/交互规则
案件指标卡汇总待处理、处理中、自动出款拦截、今日已关闭数量点击页面刷新后同步最新状态
风险案件表展示案件编号、用户、风险类型、金额、规则数、等级和状态高风险订单必须关闭自动出款并转人工处理
案件详情抽屉展示风险分、订单、命中规则和当前状态点击“查看案件”打开
处理备注记录核查结果和处理原因执行处理前填写；进入审计记录
标记处理中将案件状态更新为处理中保留操作人和时间
审核通过通过当前案件记录处理结果并关闭抽屉
关闭案件关闭无需继续处理的案件记录关闭原因和操作人
导出导出当前筛选案件敏感字段按权限脱敏

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
K-01案件统计卡汇总当前站点各处理状态的案件数量，帮助安排处理优先级。卡片时间口径分别标明存量或今日；自动出款拦截只统计仍在拦截中的案件。卡片与列表查询时间不一致时展示各自更新时间。
K-02风险等级筛选限定列表只返回指定等级案件。等级为规则计算后的案件当前等级，不使用单条规则等级代替。无结果显示空列表，不恢复到全部等级。
K-03案件列表每行代表一个独立风险案件，不是单条规则命中。一个案件可聚合多个规则和业务对象；金额统一按订单币种显示。案件状态更新后只刷新该行和统计卡。
K-04查看案件打开案件详情并获取最新版本，防止基于旧列表状态处理。请求返回case_version；后续状态操作必须携带版本做并发校验。案件已被其他人更新时提示并刷新详情。
K-05风险分与等级风险分用于解释风险程度，等级决定页面颜色和处理优先级。分数及等级由风险服务返回；前端不重新计算。规则重算导致分数变化时展示更新时间。
K-06命中规则展示规则名称、证据和命中时间，帮助人工判断风险原因。规则按风险贡献或时间排序；证据ID可追溯原事件/订单。规则已停用不影响历史命中展示。
K-07处理备注保存人工核查说明，成为案件审计的一部分。审核通过、关闭案件时备注必填；长度和敏感字符按后台统一规则校验。校验失败保留输入内容；不得静默清空。
K-08标记处理中表示当前人员已接手案件，但不代表风险结论。状态从待处理→处理中；记录处理人、时间和版本。已被他人接手时禁止覆盖并提示处理人。
K-09审核通过表示本次业务可继续或风险不成立，具体业务动作由服务端执行。提交备注、案件版本和处理结论；服务端完成业务解锁后才返回成功。业务解锁失败时案件不得先显示已通过。
K-10关闭案件结束无需继续处理的案件，保留历史证据。关闭原因必填；关闭后禁止普通用户继续修改，管理员可重新打开并审计。有未完成拦截动作时服务端拒绝关闭。
K-11导出案件导出当前筛选案件及规则摘要，供审计使用。金额、手机号、支付账户等字段按权限脱敏；导出动作写审计。无权限隐藏入口；数据量大异步生成。

3.2.8 埋点管理#

页面原型

埋点管理页面上半部分
埋点管理页面下半部分

弹窗原型

新增埋点定义

筛选条件

条件用途规则
埋点类型筛选前端埋点或后端埋点默认全部埋点类型
内部事件名称按英文事件名模糊查询支持输入部分名称
事件中文名称按中文名称模糊查询支持输入部分名称
业务模块查询指定业务模块事件默认全部业务模块
状态查询已启用或已停用事件默认全部状态
重置清空全部筛选分页回到第1页

功能模块

模块功能说明数据/交互规则
埋点类型定义说明前端、后端埋点的触发来源、打点端和上报方式前端由客户端SDK上报；后端由业务服务器上报
埋点定义表展示内部名、中文名、类型、打点端、触发来源、业务模块和状态每页10条
状态开关启用或停用某个埋点定义操作需记录审计；停用不删除历史事件
查看详情查看触发条件、上报时机、必填属性、去重规则、指标用途点击后打开详情抽屉
新增埋点新建前端或后端埋点定义类型与打点端联动；填写触发条件、时机、属性、去重和成功判定
保存保存新增定义内部事件名必须小写英文下划线且唯一

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
M-01类型说明区明确前端埋点和后端埋点的边界，防止开发用点击事件代替业务结果。说明内容与事件协议版本一致；前端=客户端行为，后端=业务服务器事实。协议升级时展示当前版本和变更入口。
M-02埋点类型筛选按前端或后端定义过滤列表。选择类型后清零页码并查询；类型同时决定打点端和允许的触发来源枚举。后端返回未知类型时标记“未知”，不能归入前端。
M-03内部事件名搜索用稳定英文事件名定位埋点定义。去空格后转小写做包含匹配；数据库字段应有适合前缀/包含查询的索引策略。输入非法字符可查询但新增时禁止。
M-04中文名称搜索便于产品和测试按业务语义查找事件。包含匹配；中文名不是唯一键，不得用于上报或关联。多条同名事件正常展示并通过内部名区分。
M-05业务模块筛选查看某业务域的全部埋点。模块来自统一枚举或配置，不允许前端硬编码自由文本。已停用模块保留在历史筛选中。
M-06状态筛选区分允许继续上报的定义和已停用定义。状态只影响后续接收/告警策略，不删除定义和历史事件。状态变更与列表筛选冲突时该行可从当前列表移除。
M-07定义列表以事件定义为粒度展示名称、类型、打点端、触发、方式、模块和状态。默认稳定排序；每页10条；接口返回总数、页码和定义版本。空结果显示筛选空状态；接口失败不显示“共0条”。
M-08状态开关快速启停单个事件定义。点击后先二次确认影响；提交定义ID和版本；成功后更新状态并写操作审计。核心P0事件禁止直接停用，需发布流程；并发冲突时刷新。
M-09查看详情展示开发实现所需的完整定义，而非只展示名称。包含触发条件、上报时机、必填属性、类型、格式、枚举、去重规则、指标用途和成功判定。定义版本已更新时提示重新打开最新版本。
M-10新增基础字段创建事件稳定身份和业务归属。内部名满足^[a-z][a-z0-9_]*$且全局唯一；中文名必填；模块必选。重名返回明确冲突事件；保存失败保留表单。
M-11类型与打点端联动防止前端埋点误选服务端、后端埋点误选客户端。选前端时打点端固定浏览器/APP客户端；选后端时固定服务端；切换类型重置不兼容触发来源。用户已填写不兼容内容时切换需确认。
M-12触发与上报定义告诉研发在什么动作、什么时刻上报。前端区分页面进入、点击、输入、选择、停留；后端区分接口完成、状态变化、回调、定时任务。描述为空不得发布，可允许保存草稿。
M-13属性定义规定事件必须携带哪些业务字段以及字段类型。每个属性包含编码、类型、必填、枚举、示例和脱敏级别；公共字段不重复配置。删除已发布必填属性必须新建事件版本。
M-14保存/发布保存仅创建草稿；发布后才成为可接收和监控的正式定义。首版原型只有保存按钮时，服务端至少返回草稿状态；正式上线需后续补发布动作和版本号。Schema校验失败逐字段提示；重复提交使用幂等键。
M-15分页在120条定义中稳定切页。切页保留筛选条件；总页数根据返回总数计算；当前页无数据且非第1页时回退上一页。请求页超过总页数时服务端返回最后有效页或明确错误。

3.2.9 事件查询#

页面原型

事件查询页面

弹窗原型

事件详情

筛选条件

条件用途规则
事件时间限定查询日期范围按站点时间查询
埋点类型筛选前端或后端事件默认全部
内部事件名称按英文事件名模糊查询支持部分匹配
事件中文名称按中文名称模糊查询支持部分匹配
用户名按用户名查询支持包含匹配
UID定位已注册用户必须完整输入，精确匹配
指纹ID定位未注册或跨登录前后的用户必须完整输入，精确匹配
渠道按 app_code 查询默认全部渠道
状态筛选正常或异常事件异常包括字段缺失等质量问题
查询/重置执行查询或恢复默认条件修改条件后需点击查询；重置立即清空

功能模块

模块功能说明数据/交互规则
类型图例解释前端埋点和后端埋点的打点端及用途固定展示在筛选区上方
事件明细倒序展示站点时间、类型、事件名、身份、渠道、来源、状态和延迟最多展示最近20条，不分页
身份复制快速复制用户名、UID或指纹ID空值显示“—”，不提供复制
查看详情打开单条事件详情展示打点信息、基础信息及客户端/业务属性JSON
导出结果导出当前筛选命中的事件导出范围与页面查询条件一致

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
E-01事件时间范围限定按站点时间发生的事件，不按接收时间过滤。开始时间≤结束时间；结束日包含至23:59:59；查询时同时转换UTC边界。超过最大查询跨度时阻止提交并提示上限。
E-02类型筛选区分客户端行为和服务器结果，帮助判断问题发生在哪一端。前端/后端类型取事件定义快照；不能根据event_source临时猜测。历史未知类型显示“未知类型”。
E-03事件名筛选内部名用于研发排查，中文名用于产品定位，两者可同时组合。两个条件为AND；均为包含匹配；查询值做长度限制和安全转义。无匹配显示空结果及当前条件。
E-04用户名筛选通过用户账号查其事件。先由用户服务解析用户ID，再用ID查询事件；避免直接扫描事件明细用户名。用户不存在直接返回空，并提示“未找到用户”。
E-05UID精确查询精确定位已注册用户的事件。完整匹配；与用户名同时输入时必须指向同一用户，否则提示条件冲突。格式非法不发请求。
E-06指纹ID精确查询查询匿名用户或登录前行为，并串联身份合并前后的事件。完整匹配；登录后事件若保留同一指纹也应返回。指纹字段脱敏策略不得破坏精确查询，可使用受控哈希。
E-07查询执行只有点击查询才应用表单条件，避免输入过程中频繁扫描明细库。保存“已应用条件”快照；查询中禁用按钮；结果按站点时间倒序。失败保留上次结果并显示失败提示。
E-08最近20条页面用于快速排查，不承担无限翻页浏览。接口限制20条并返回是否还有更多；如有更多提示使用缩小条件或导出。不提供前端伪分页。
E-09状态与延迟状态说明Schema/必填字段是否正常；延迟说明接收时间与事件时间差。正常=通过当前定义校验；字段缺失显示异常；延迟按毫秒/秒自适应格式。客户端时钟明显漂移时标记“时间异常”，不展示负延迟。
E-10身份复制让研发快速复制UID或指纹继续排查。点击写入剪贴板并显示短暂成功提示；复制完整值需字段权限。浏览器拒绝剪贴板时提示手动复制。
E-11事件详情展示不可变事件信封和属性快照。前端展示客户端属性；后端展示业务属性；JSON保持原始字段顺序或格式化只读显示。超大属性截断展示并提供受权下载原始JSON。
E-12导出结果异步导出满足当前条件的全部事件，而非仅20条。导出包含已应用条件、字段权限、事件定义版本和生成时间；默认脱敏。查询条件过宽时提示收窄；导出任务写审计。

3.2.10 数据质量#

页面原型

数据质量页面

弹窗原型

质量检查详情

筛选条件

条件用途规则
统计时间选择近1小时、近24小时或近7天默认近24小时
埋点类型筛选前端或后端质量默认全部
渠道查看指定渠道质量默认全部渠道
事件名称定位指定内部事件支持输入内部事件名
查询/重置执行检查或恢复默认条件重置后埋点类型恢复全部

功能模块

模块功能说明数据/交互规则
整体质量分展示当前整体数据质量和最后检查时间前端、后端指标加权计算
分类质量分分开展示前端和后端质量分、事件数及监控范围前端关注接收、完整、重复；后端关注接收、对账、幂等、延迟
质量检查项展示检查名称、范围、类型、数值和状态点击检查项打开详情抽屉
版本与服务覆盖前端按APP版本、后端按业务服务展示覆盖率低于门槛时使用警告状态
检查详情抽屉展示检查范围、打点端、异常事件数和主要版本/服务同时给出处理建议
导出异常导出当前检查项异常事件使用当前筛选条件和检查项
上线门槛规定核心事件接收、对账及延迟阈值前端接收率≥99.5%；后端接收/对账≥99.9%；P95延迟≤5秒

开发级功能明细（第一版）

编号功能点开发说明处理规则状态/异常
Q-01统计时间控制质量指标的观测窗口，用于实时排障或趋势检查。近1小时按分钟聚合，近24小时按小时，近7天按天；全部以接收时间判断平台是否收到。数据尚在聚合时显示最后完成时间。
Q-02类型/渠道/事件筛选缩小质量检查范围，定位特定客户端、服务或事件。条件组合为AND；事件名只接受内部事件编码；切换类型后刷新可选检查项。后端事件没有渠道时渠道条件显示“不适用”而非过滤为空。
Q-03整体质量分给出当前范围的综合健康度，同时保留分项以便解释。权重由质量规则配置；前后端分别算分再汇总；前端不得硬编码加权公式。任一核心分项无数据时总分标记“不完整”，不能默认100分。
Q-04前端质量分关注SDK接收成功率、字段完整率、重复率、会话和版本覆盖。按客户端版本和渠道聚合；核心事件权重高于普通事件。新版本样本不足时单独标记观察期。
Q-05后端质量分关注服务器接收、业务对账、幂等、trace完整和处理延迟。资金/订单事实与业务库按业务ID和最终状态对账。对账任务未完成时显示“计算中”，不得沿用昨日结果。
Q-06检查项状态每个检查项展示实际值、阈值、范围和正常/需处理状态。正常或异常由服务端规则判断；页面颜色只映射状态，不自行比较。临界值可显示“预警”；规则停用显示“未监控”。
Q-07检查详情解释为什么异常以及影响哪些版本、服务和事件。返回异常数量、样本、主要版本/服务、阈值、首次/最近发生时间和处理建议。无异常样本时仍显示口径和阈值。
Q-08版本覆盖说明当前活跃客户端版本中有多少正确上报核心事件。分母为统计窗口内活跃客户端版本/设备；按APP版本和渠道拆分。未知版本单独列出，不并入最新版本。
Q-09服务覆盖说明应上报后端事件的业务服务是否完成接入。按服务和事件定义清单比较预期/实际；服务部署版本作为辅助字段。服务无流量时区分“无业务量”和“未上报”。
Q-10上线门槛为发布验收提供明确阻断条件。核心前端接收率、后端接收/对账率、P95延迟任一不达标则发布检查失败。阻断结果必须列出失败项，不只显示总分。
Q-11导出异常输出当前检查项的异常事件样本和定位字段。包含event_id、事件名、版本/服务、异常字段、发生/接收时间；按权限脱敏。样本过大按时间分片；导出任务需审计。

4. 人员#

角色人员
产品待填写
设计待填写
研发待填写
↑ 原型大图