邮件标题：20260908-技术评审-活动计费管理-计费积分功能调整技术方案

邮件正文：

孔玮：
已完成针对【计费积分功能调整技术方案】的技术评审，现将评审结论、风险判断及后续执行安排同步如下，便于各方对齐认知并落实执行。

项目名称： 活动计费管理
评审时间： 2026/09/08
参与评审人： 王军、王建朝、李强、贾继伟、蒋宜宏、孔玮、马奇等
评审结果： 通过

一、技术方案背景

• 业务场景：积分体系新增门店维度，底层物理模型与明细流水统一继承门店字段，支撑基于销售底座的门店级数据权限控制，并配套调整积分乐园/智慧门店跳转方式、券核销一致性校验与券列表展示规则。

二、技术方案要点

• 整体流程：积分池、积分批次、积分变动记录等物理模型新增门店维度 → 积分账户变动明细表与积分兑换单据表继承积分池门店维度（供结案报表与前端明细展示）→ 对外接口同步调整 → 券中心核销回调新增一致性校验、券列表发放维度调整 → 智慧门店集成跳转方案调整。
• 物理模型调整：积分体系 7 张表中 6 张有调整，其中 5 张在原有维度上新增门店维度——积分池、积分批次、积分变动记录、积分变动明细、积分兑换记录；积分兑换单据表从积分池继承门店维度，用于数据权限处理。
• 数据权限实现：业务单据统一新增销售五段，基于底座配置的数据权限对业务单据的销售五段做筛选过滤实现数据隔离；积分变动记录继承积分池的销售五段。
• 记账流水字段：同步积分记账流水接口新增经销商编码与名称（供结案报表使用），并新增"记账描述（客态文案）"字段，用于积分账户明细流水的标题展示。
• 接口调整：积分账户汇总余额接口新增门店编码（非必填），支持按人或按门店查询、返回结果不变；积分明细流水列表接口新增门店维度（非必填），供钱包 H5 与积分商城调用；积分兑换一阶段冻结积分接口门店编码为必填，用于从指定积分池扣减并冻结积分。
• 性能说明：积分池账户中最多存在 90 天的积分批次，扣减操作最多并行处理 90 条，性能有保障。
• 券核销与展示：接收券中心核销回调时新增数据校验，要求核销门店与发放门店一致、核销人员与发放人员一致；券发放维度由"仅人"改为"门店+人"，门店员工在券列表可见"发给门店的券"与"发给本人在该门店的券"两类，员工关联多个门店时仅在指定门店可见对应券。

三、决议事项

• 各相关端对本次接口变更方案逐项确认，重点包括：账户汇总余额与积分明细流水接口新增门店维度（非必填）、一阶段冻结积分接口门店编码由可选改为必填、多门店员工场景下的券可见规则与底座数据权限配置是否一致，确保跨端协同无误。

四、风险提示

• 券核销门店/人员一致性校验与券列表"门店+人"调整为强约束，若门店归属主数据不准确，将直接影响核销与券展示结果。

五、方案地址

接口文档：https://drive.weixin.qq.com/s?k=AK0AZgcfAA0lePfLULAZ4ABQayAIQ