袋鼠金融蓝图

Properties1
tagspocketbuy, sa, sm, rm, 店长, 店员, 佣金, 绩效, 结算

SA 与商户角色佣金需求目录说明

1. 唯一归档位置

本目录是 PocketBuy 以下角色相关佣金、绩效、政策、结算、门店端 H5 与 SA App 内嵌 H5 需求的唯一归档位置：

  • SA（SA）
  • SA 经理（SA_MANAGER / SM）
  • SA 区域经理（REGIONAL_MANAGER / RM）
  • 店长（STORE_MANAGER）
  • 店员（CLERK）

后续新增、修订或评审上述角色相关需求，均在本目录维护；不再向 D:\Africa\分销系统 或其他目录新增同主题需求正文。store-h5 仅保留前端原型代码、Mock、测试与发布脚本。

2. 文档清单与用途

文件用途
10-PocketBuy 佣金系统需求文档.md模块一：佣金系统——规则配置、台账、绩效调整、结算与后台能力
初版佣金政策完整配置示例.json初版店长、店员、SA、SM、RM 政策配置示例
月度完成订单量阶梯佣金配置示例.jsonSA、SM、RM 月度 ACH 阶梯示例
09-PocketBuy 佣金系统外围配合改造功能点.md模块二：佣金系统外围配合改造——订单、组织、风险、付款、对账与联调契约
研发参考/佣金系统开发测试验证SOP.md开发、测试、验收、上线与回滚要求
07-PocketBuy门店端H5需求文档.md模块三：门店端 H5——店长/店员 Earnings、政策、二维码、授权协议和唯一收款户
研发参考/门店端H5前后端接口契约.md门店端 H5 接口、字段、权限和错误约定
研发参考/门店端H5联调与上线SOP.md门店端 H5 联调、弱网、验收与上线检查
08-PocketBuy SA、SM、RM端 H5 需求文档.md模块四：SA、SM、RM 端 H5——内嵌收益、政策、三类角色门店资料录入与 App 集成
01-SA入驻App流程需求.mdSA 入驻与 App 流程需求
02-SA审核管理后台需求.mdSA 审核管理后台需求
06A-SA角色与组织层级管理迭代需求.mdRM → SM → SA 角色、组织关系、人员异动、离职和历史归属规则
06B-门店人员信息审核迭代需求.md店长/店员资料版本、关系审核、生效、转店、停用和后台留痕

3. 文档与设计状态口径

本目录统一把文档生命周期、建设范围和设计完成度拆开描述，禁止继续用 status: mvp 同时表示三种含义：

字段可用值含义
statusdraft / approved / active / deprecated需求文档是否已评审确认；active 仅用于持续维护的目录/说明文档
scopemvp / post_mvp / directory_index能力属于哪一建设批次，不代表设计已完成
design_statusprototype_available / partial / not_applicable / mixed_see_matrix是否有可评审页面原型；纯服务端契约可标记不适用

当前状态：

文档文档状态建设范围设计状态说明
01 SA 入驻 Appdraftmvpprototype_available已有 SA App 在线原型，仍待需求评审确认
02 SA 审核后台draftmvpprototype_available已有后台原型，服务端规则以需求为准
06A SA 角色与组织层级draftmvpprototype_available已有 SA Organization 页面
06B 门店人员信息审核draftmvpprototype_available已有 Store Personnel Review 页面
07 门店端 H5draftmvpprototype_available已有本地/生产预览
08 SA、SM、RM 端 H5draftmvpprototype_available已有本地/生产预览
09 外围配合改造draftmvpnot_applicable服务端/系统间契约，无独立页面设计
10 佣金系统draftmvppartial规则和数据设计已形成；复杂后台交互不属于本期
研发参考/佣金开发测试 SOPdraftmvpnot_applicable过程文档，须在 PRD 评审通过后执行
研发参考/门店端接口契约draftmvpnot_applicable接口契约，无独立页面设计
研发参考/门店端联调上线 SOPdraftmvpnot_applicable联调与发布过程文档

prototype_available 只表示存在可评审交互稿，不等同于需求已批准、研发已完成或生产已上线。

4. 关键边界

  1. 每单基础佣金、绩效系数、结算发放是三层独立能力；前端只展示服务端结果，不自行计算应发金额。
  2. 订单达到佣金资格时，系统固化受益角色、组织关系、适用政策与订单范围快照；人员调岗、离职或店员/店长资料更新不得回写历史佣金和结算。
  3. 政策可见范围遵循层级：RM 可见 RM/SM/SA，SM 可见 SM/SA，SA 仅 SA；店长可见店长/店员，店员仅店员。
  4. 所有新规则须明确生效时间与增量范围；默认仅作用于指定生效时间后的新资格订单或新结算批次。
  5. CPD7 观察窗为 90 天；观察窗内少于 10 单时不发正向绩效加成，>15% 记 -0.2 并在下一发放月扣减。
  6. 常规发放日为每月 25 日：发上月奖励，并扣减上上月已确认的负绩效调整。
  7. SM/RM 可新建门店并直接办单；直办奖励与本人岗位奖励叠加。店长可作为推荐人，但店长奖励不叠加。一个门店仅支持一名有效店长。

5. 六模块职责与冲突处理

模块唯一负责内容不负责内容
门店端 H5店长/店员的页面、交互、展示权限、二维码、授权协议、唯一收款户与只读人员/门店状态人员主数据维护、佣金公式、风险系数或结算计算
SA、SM、RM 端 H5SA App 内嵌页面、收益展示、来源筛选、政策展示，以及三类角色授权范围内的门店/店长/店员资料录入和维护组织归属裁决、佣金/绩效计算、付款执行
SA 角色与组织层级SA/SM/RM 角色、有效期关系、异动、离职及在途业务快照店长/店员审核、佣金金额计算
门店人员信息审核店长/店员资料版本、审核、账号与门店关系生效门店基础资料审批、SA 组织层级、历史佣金重算
佣金系统规则配置、资格、归属快照、台账、绩效调整、每月 25 日结算、跨月扣减、绩效导出、后台与审计H5 视觉交互、上游订单/还款事实生产
佣金系统外围配合改造BNS、组织、风控、付款、商品、BFF 的事实与接口契约在外围系统复制佣金公式或篡改历史快照

出现口径冲突时，按以下顺序处理：

  1. 已确认并发布的政策配置及其 effective_at 决定金额、区间和适用范围。
  2. 《10-PocketBuy 佣金系统需求文档》决定计算、台账和结算语义。
  3. 两份 H5 文档只决定展示和操作，不得推翻佣金系统结果。
  4. 《09-PocketBuy 佣金系统外围配合改造功能点》决定外围系统应提供的事实、快照与接口责任。

6. 原型与页面地址

  • 门店店长、店员 H5 的本地及生产地址，见《07-PocketBuy门店端H5需求文档》“3.1 H5 页面地址（原型 / 联调）”。
  • SA、SM、RM H5 的本地及生产地址，见《08-PocketBuy SA、SM、RM端 H5 需求文档》“3.1 H5 页面地址（原型 / 联调）”。
  • SA 角色与组织层级后台地址，见《06A-SA角色与组织层级管理迭代需求》“2. 设计状态与原型地址”。
  • 门店人员审核后台地址，见《06B-门店人员信息审核迭代需求》“2. 设计状态与原型地址”。
  • 预览参数仅用于原型与联调；生产权限以登录态和服务端返回为准。

关系图谱