一、功能介绍
「拉新明细」计划展示被邀请会员、邀请人、渠道、归属、激活时间与奖励；「成长值明细」计划展示会员、归属、商城、操作、成长值变化与有效期。但后端当前只返回空列表，注释明确说明会员主档、邀请关系和成长值流水尚未同步到 SCRM。2026-08-09 实测两个接口均成功返回 0 条；成长值页还曾显示静态默认的「共 10 条」，不能将页面选项或总数视为真实数据。
二、功能亮点
- 拉新页会把邀请人、被邀请人、双方渠道、激活日期和商城条件组装进请求，便于数据源接通后核对查询契约。
- 成长值页当前只按会员渠道 Tab 和分页请求，其他筛选控件不生效。
- 拉新表设计覆盖邀请双方、渠道等级、归属、创建/激活时间、积分、成长值和商城。
- 成长值表设计覆盖会员、归属、商城、操作、变化值、有效期、流水类型、节点和发放方式。
- 明确区分接口 total、表格空态与前端静态渠道数量，避免把演示数字当成报表。
三、使用场景
适用于数据同步完成后，由获授权的会员运营人员追溯邀请关系和成长值变化。当前只适合验证页面和空数据契约，不适合生产拉新分析、奖励对账、导出或依据页面结果调整会员权益。
四、使用权限
- 两个页面都没有查看明细、查看手机号或导出的按钮权限判断；只要路由可访问，页面就会发起列表请求。
- MemberAcquisitionController 没有功能权限、会员专区、角色或企业范围的服务端守卫，也没有调用带 authCorpId 的业务服务。
- 表格设计包含会员和邀请人手机号、地址、归属导购、门店、经销商和运营主体，数据接入后必须另行落实最小权限、企业隔离和字段脱敏。
- 成长值页使用 formatPhoneNumber 对 11 位手机号做中间四位掩码，但这是前端展示处理；响应、浏览器调试信息和拉新页手机号仍可能是明文。
- 当前空列表不能证明权限安全。正式接入前必须用不同企业、组织与角色账号验证正向访问、越权拒绝和数据范围。
五、前置条件
- 先确认当前版本是否已经把会员主档、邀请关系和成长值流水从现役站点域同步到 SCRM；按当前源码，两个端点预期固定返回 0 条。
- 明确企业、站点、积分商城、会员渠道和业务时区口径；当前接口自身不提供企业或站点隔离证据。
- 准备一条经过脱敏的已知邀请关系和一条成长值流水，记录双方会员 ID、渠道、商城、发生时间、变化值与原始流水凭证，用于接入后的完整性核对。
- 确认操作账号只拥有完成本次核验所需的最小权限，并准备第二企业或第二组织账号做越权拒绝测试。
- 将查询时间、完整条件、浏览器显示总数和接口 total 分开记录；渠道 Tab 上的数字不进入验收基线。
- 不要在当前页面测试真实奖励发放、扣减、调整或结算；两页都是查询骨架，没有写入能力。
六、操作步骤
- 进入「会员管理 → 数据分析 → 拉新明细」。页面脚本立即查询第 1 页，默认每页 50 条；先记录请求时间、返回 total 和页面空态。
- 输入被邀请会员姓名或手机号、邀请会员姓名或手机号，分别选择被邀请会员渠道与邀请会员渠道。两个渠道下拉来自页面静态常量，不是后端实时字典。
- 选择会员激活时间。页面把两个毫秒时间戳转为 UTC ISO 字符串后截取 YYYY-MM-DD；处在 UTC+8 凌晨的本地时间可能落到前一日期，跨日核验要同时记录原选择值和请求日期。
- 展开筛选区并选择积分商城。当前只有固定的 NexusClaw 积分商城选项；选择后点击「搜索」，核对请求是否包含 invitedKeyword、invitedChannel、inviterKeyword、inviterChannel、startDate、endDate、mallId、pageNo 和 pageSize。
- 表格接入真实数据后，逐列核对被邀请会员姓名/手机号和渠道等级、邀请人姓名/手机号和渠道等级、归属导购/门店/经销商、创建/激活时间、拉新积分/成长值及积分商城。数值为 null 时页面显示“-”。
- 点击「重置」会清空六项筛选并重新查询，但不会显式把页码恢复为 1。拉新表把分页对象交给表格，却没有绑定翻页或每页条数变化后的重新请求处理；数据接入后必须验证翻页是否真的加载下一页，不能只看页码控件变化。
- 点击拉新页「导出 EXCEL」。导出按当前页列表生成 CSV 文件（按钮文案为 EXCEL），不请求服务端导出端点；后端当前固定返回空数据，实际无可导内容。
- 进入「成长值明细」。页面初始 activeTab 为空并查询第 1 页、每页 50 条；接口返回后用 total 覆盖初始静态 10。
- 切换渠道 Tab。成长值请求只携带渠道和分页；切换 Tab 会重新查询，但不会显式把当前页重置为 1，处于后续页时要警惕得到空页。
- 输入会员/导购姓名或手机号，选择积分商城、时间、成长值类型、增加/减少，再展开会员归属和导购。归属树是页面内固定演示选项，导购下拉为空；这些控件连同关键词都不会进入请求。
- 点击「搜索」只会按当前 channel、pageNo 和 pageSize 重新查询；不要把界面中已填写的其他条件写进报表标题或筛选口径。点击「重置」会清空控件、清空渠道并重新查询，但同样不会显式把页码恢复为 1。
- 接入真实数据后，逐列核对会员姓名、脱敏手机号、拼接地址、渠道等级、导购/门店/经销商/上级组织/运营主体、商城与 ID、操作人/时间、备注、成长值变化、有效期、类型、当前成长值、节点和发放方式。
- 成长值变化大于 0 显示绿色、小于 0 显示红色、等于 0 使用默认颜色；空有效期显示“永久有效”，空备注和节点显示“-”。这些仅为展示规则，不能替代原始流水。
- 分页可选 20、50 或 100 条，成长值页的翻页和每页条数变化会重新请求。以接口 total 为准；渠道 Tab 数量来自前端静态常量，不得作为报表数量。
- 点击成长值页「导出 EXCEL」。成长值导出按钮没有点击处理，不会请求端点、生成文件或显示成功结果。
- 当前后端会把 pageNo 最小值调整为 1、pageSize 限制在 1–200，但无论筛选如何都返回空 dataList 和 total=0。将 0 条记录为“当前查询骨架无数据”，不得解释成实际没有邀请或成长值变动。
七、字段与规则说明
- 拉新和成长值端点当前都只构造空 dataList、total=0 和规范化分页，不读取会员主档、邀请关系或成长值流水。
- 两个端点页码从 1 开始，默认每页 50 条；pageNo 小于 1 时回为 1，pageSize 小于 1 时回为 1，大于 200 时截为 200。
- 拉新页把六类筛选与分页组装进请求，但后端没有读取这些参数执行过滤；搜索条件改变也不会显式重置页码。
- 拉新表格声明 1400px 横向滚动，成长值表格声明 2200px 横向滚动；截图和人工验收必须覆盖右侧列，不能只验首屏。
- 成长值请求只传 channel、pageNo 和 pageSize，关键词、商城、时间、成长值类型、增减、会员归属和导购当前无效。
- 渠道、商城、成长值类型、成长值增减、归属树和渠道 Tab 数量来自前端静态常量，不是后端实时字典或统计。
- 成长值页对表格手机号按 3+4+4 规则隐藏中间四位；非匹配格式可能保持原样。拉新页直接渲染响应中的双方手机号。
- 成长值地址按省、市、区和详细地址直接拼接，不添加分隔符；全部为空时显示“-”。
- 拉新页导出按当前页生成 CSV（无服务端导出）；成长值导出按钮没有点击处理。
- 当前接口没有企业、站点、商城、组织数据范围或功能权限守卫。
- 空列表、静态选项和前端脱敏都不能作为数据同步、权限隔离或隐私合规已完成的证明。
八、风险与限制
空数据端点、静态渠道数量和看似完整的筛选控件会让操作人误以为会员数据已经接入。成长值多数筛选未传参、切换条件不总是重置页码、拉新分页缺少远程重载处理，均可能形成错误报表。数据一旦接入，缺少服务端细分权限、企业/站点范围与拉新页手机号脱敏还会造成跨企业查看和个人信息泄露；用页面展示的当前成长值代替原始流水也会破坏奖励对账。
注意
数据同步、企业与站点隔离、服务端最小权限、双方手机号脱敏、分页远程加载、全部筛选传参及导出审计完成前，不得将这两页用于生产分析、奖励结算、权益调整或审计。
九、常见问题
- 为什么搜索总是 0 条？后端当前固定返回空列表，真实会员、邀请关系与成长值流水尚未同步。
- 页签上的渠道和数量是实时的吗？不是，渠道 Tab 数量来自前端静态常量。
- 为什么成长值页填了关键词仍没有变化？成长值请求只携带渠道和分页，关键词不会传给后端。
- 积分商城、时间、类型、增减、归属和导购筛选有效吗？成长值页中目前都无效。
- 为什么会员归属看起来有组织但选导购为空？归属树是页面内固定演示选项，导购下拉为空，两者都不来自接口。
- 为什么曾显示共 10 条却没有行？成长值页初始 total 为静态 10，接口返回后应改为 0；只能以当次接口 total 为准。
- 切换渠道后为什么仍在后续页？渠道切换不会显式把 page 重置为 1，需手动回到第一页复核。
- 拉新页翻页后为什么数据可能不变？分页对象没有绑定远程重新加载处理，数据接入后需要专项验证并整改。
- 能导出吗？拉新页可按当前页生成 CSV（后端当前返回空数据，实际无内容）；成长值导出按钮仍没有点击处理。
- 拉新页手机号已脱敏吗？没有，页面直接显示响应字段；成长值页的掩码也只是前端展示。
- 成长值为空有效期代表什么？页面显示“永久有效”，正式使用前必须与原始流水的有效期字段核对。
- 返回 0 条是没有拉新或成长值变化吗？不能这样判断，当前是固定空数据骨架。
- 页面有数据后就能正式使用吗？不能，还需验证数据同步完整性、企业/站点隔离、服务端权限、手机号脱敏、筛选、分页和导出审计。
十、相关指南
会员主档与当前指标阅读《查看会员列表与详情》；奖励状态阅读《审核会员奖励》；积分变化可对照《查看认筹积分报表》。实际对账必须回到原始邀请关系、积分和成长值流水。
说明
页面入口：/member/analytics/acquisition-detail、/member/analytics/growth-detail