一、功能介绍
认筹积分报表当前是只读分页列表，不是实时积分流水。后台每日 02:00 把前一日积分流水按账单 ID 写入聚合表；表为空时先回填最近 30 天。页面可按关键词和积分来源查询，并展示组织、门店、导购与会员归属。接口返回的积分来源、积分值和状态已在表格中展示；部分组织列也没有可靠数据源。
二、功能亮点
- 关键词实际可匹配会员名称、会员手机号、门店名称和导购名称。
- 合同单积分来源由 referral_subscribe 流水映射为值 2。
- 门店归属取导购的主职组织，缺少主职时按有效关联顺序取第一条。
- 后台按 bill_id 幂等更新，不会因同一流水重复跑批产生多行。
- 默认每页 50 条，可切换为 10、20、50 或 100 条。
- 列表为只读页面，不提供积分调整或单条操作。
三、使用场景
适用于会员运营按会员、门店或导购定位认筹积分聚合记录，核查记录的组织和渠道归属。当前页面尚不能独立完成积分金额、状态、发生时间或余额对账，财务核对仍需结合积分流水或原业务单据。
四、使用权限
- 进入页面需要「认筹积分报表」菜单权限。
- 列表包含会员与导购手机号、门店和经销商归属，应按最小必要原则限制给会员运营和主管角色。
- MemberPointsReportController 没有专区、报表查看或个人信息查看的服务端权限守卫，直接调用接口不会由该控制器校验菜单权限。
- MemberPointsReportEntity 没有 authCorpId、tenantId 或 ownerId，查询 Specification 也没有企业条件；当前报表数据实际跨企业共享，不能用于多租户正式环境。
- 页面源码没有声明细分按钮权限键，也没有单条编辑操作。
- 当前“导出EXCEL”只显示开发中提示，不会生成文件，不能把页面出现导出按钮视为已具备导出能力。
五、前置条件
- 明确本次查询是定位会员归属记录，而不是核对积分余额、不可变历史或完整积分流水。
- 确认当前环境已修复或以其他方式隔离跨企业报表数据；未修复前不得向普通租户开放。
- 准备会员名称、会员手机号、门店名称或导购名称中的至少一个关键词；后端四类字段均可匹配。
- 如按来源查询，确认值 2 只对应 referral_subscribe 合同/收订积分流水；值 1 虽显示为首次预发积分审核，但当前聚合代码没有该来源。
- 确认应用服务器时区与业务时区一致；日报调度没有指定 zone，02:00 和 T-1 依赖服务器默认时区。
- 注意数据至少延迟到次日 02:00 跑批后；首次建表只自动回填最近 30 天。
- 保留发生时会员、导购和门店归属快照作对照；当前重跑会按最新关系覆盖历史归属。
- 处理个人信息前确认当前角色有权查看会员和导购手机号。
- 需要财务对账时另行准备积分流水、奖励单或合同单作为金额与状态依据。
六、操作步骤
- 进入「会员管理 → 数据分析 → 认筹积分」。页面默认加载第 1 页，每页 50 条。确认当前环境已经隔离企业数据；报表当前没有租户字段和查询条件，未隔离时停止查看。
- 先核对数据日期和服务器时区。跑批每日服务器时间 02:00 处理服务器日期的 T-1；今天发生的积分不会立即出现，表首次为空时只回填前 30 天。
- 不要只凭任务日志中的 affected=0 判断当天无流水。流水查询失败会被转换为空汇总，调度仍可能记录任务完成，无法区分失败和确实无流水。
- 在关键词框输入会员名称、会员手机号、门店名称或导购名称。虽然占位提示只写会员名称/手机号，后端也会匹配门店和导购名称。
- 按需选择积分来源。值 2 是 referral_subscribe 合同/收订积分；值 1 当前没有聚合写入来源。其他流水类型会按原始 type 字符串落库，因此选择两个预设来源不能覆盖全部数据。
- 状态下拉当前只有“全部”，不能形成有效状态筛选。后端聚合状态实际为 NORMAL 或 EXPIRED，但页面没有提供这两个选项。
- 点击「搜索」，页面会把关键词、积分来源、状态和分页参数发送给列表接口。服务端没有显式排序，同一条件跨页浏览时顺序不具备稳定保证。
- 不要依赖日期和组织筛选结果：这两个控件虽然可填写，但当前值尚未传给列表接口，选择后不会缩小查询范围。
- 在结果中核对分公司、门店、导购、会员等级和会员身份。门店来自跑批时导购的当前主职组织；没有主职时取当前有效关联第一条，并非流水发生时快照。
- 历史重跑后重新核对归属。upsert 会用当前会员、导购和门店关系覆盖旧字段，历史归属可能发生变化。
- 代表处、一级和二级经销商编码及名称、渠道名称在当前聚合服务中固定写为 null，列为空不代表业务上没有归属。
- 使用底部分页切换页码或每页条数，并记录结果总数。切换每页条数后页面回到第 1 页；遇到新增跑批或跨页重复、遗漏时重新从第 1 页核对。
- 需要重查时点击「重置」；关键词、组织、状态和积分来源会清空，日期恢复默认范围（2026-09-12 实测恢复为最近 7 天，而非原记录的 30 天），但日期仍不会参与当前接口查询。
- 当前表格已显示接口返回的积分来源、积分值和状态；涉及金额、正负、状态或时间的判断仍然要回到相应流水或业务记录核对。
- 源流水 amount 和 number 都缺失或无法解析时，缺失积分金额会按 0 写入；必须回查原流水区分真实零积分与数据缺失。
- 若记录缺少会员、导购或门店，检查积分流水 uid、会员 spread_uid、启用导购和有效组织关系。没有 bill id 的流水会被跳过。
- “导出EXCEL”当前只提示“导出功能开发中”，不会生成文件。需要留档时只能在合规范围内记录筛选口径和结果总数，不能宣称已完成导出。
七、字段与规则说明
- 列表接口支持的有效筛选参数为 keyword、pointsSource、status、page 和 size；当前页面实际可用的是关键词、日期、组织、状态和积分来源。
- 关键词会模糊匹配会员名称、会员手机号、门店名称和导购名称。
- 合同/收订积分流水 referral_subscribe 映射为来源值 2；来源值 1 当前没有写入来源，其他 type 原样保存。
- 状态由流水 expired 映射为 NORMAL 或 EXPIRED，页面也提供对应选项。
- 日期和组织筛选值会传给报表接口并参与查询。
- 当前表格已展示积分来源、积分值和状态字段，也没有积分发放、扣减或余额汇总。
- 代表处、两级经销商和渠道字段在当前聚合代码中固定为空。
- 每日 02:00 处理前一日；日报调度没有指定 zone，时间和 T-1 依赖服务器默认时区。
- 流水查询失败会被转换为空汇总，无法区分失败和确实无流水。
- 空表首次自动回填最近 30 天，但被内部转换为空汇总的失败日不会可靠计入失败天数。
- 历史归属使用跑批时的当前会员、导购和门店关系，重跑会覆盖旧归属。
- 缺失积分金额会按 0 写入，没有数据质量状态。
- 按 bill_id 幂等 upsert；没有有效 bill id 的流水直接跳过。
- 查询没有显式排序，分页结果在数据变化时可能漂移。
- 报表实体和查询没有企业隔离字段或条件。
- 分页从接口的第 0 页开始换算，页面展示从第 1 页开始；默认每页 50 条。
- 本页面只有查询能力，不提供查看详情、修改积分或审批操作。
八、风险与限制
报表当前跨企业共享且接口无细分权限守卫，可能泄露会员、导购手机号和组织归属。日期和组织筛选表面可选但实际不生效；来源、状态、组织字段与数据时效又不完整。若直接用于积分金额、余额或财务结论，会产生严重口径偏差。
注意
当前多租户隔离缺口未修复前不得向普通租户开放。不要把本页面当作完整积分流水或财务对账报表：部分组织列固定为空，导出功能仍在开发中。
九、常见问题
- 为什么今天的积分看不到？日报按服务器时区每天 02:00 处理前一日流水，不是实时查询。
- 任务显示完成 0 条就代表没有流水吗？不代表，流水查询异常也会被转换为空汇总。
- 为什么历史数据只有近 30 天？表为空时首次自动回填窗口只有最近 30 天。
- 为什么重跑后历史门店变了？归属按跑批当下关系补全，upsert 会覆盖旧归属。
- 为什么积分值为 0？可能是真实零值，也可能是源金额缺失后被默认写成 0，需查原流水。
- 为什么选择日期后结果没有变化？日期筛选值尚未传给报表接口，当前不参与查询。
- 为什么选择组织后仍看到其他组织？组织筛选值尚未传给报表接口，且报表当前没有企业隔离条件。
- 状态可以筛选吗？当前状态下拉只有“全部”，不能按 NORMAL 或 EXPIRED 筛选。
- 为什么选择首次预发积分没有数据？来源值 1 当前没有聚合写入来源。
- 为什么代表处、经销商和渠道为空？当前聚合代码没有可靠来源，固定写入空值。
- 关键词还能搜索什么？除会员名称和手机号外，后端也会匹配门店名称和导购名称。
- 积分来源、积分值和状态在哪里看？它们已在表格中展示；需要对账时仍应回到积分流水或原业务记录。
- 为什么没有发放、扣减和余额汇总？当前页面只实现组织与会员归属列表，没有这些汇总指标。
十、相关指南
配合《配置会员基础信息与等级》《查看会员操作日志》和《审核会员奖励》使用；积分金额与状态以原业务记录为准。 补充验收口径（2026-09-12 源码核验）：当前表格没有展示。
说明
页面入口：/member/analytics/points-report