From b0a4b94d7d645ad230af7c1e6e0dfdd1d4f24421 Mon Sep 17 00:00:00 2001 From: zlwu <704541015@qq.com> Date: Sat, 10 Oct 2026 21:43:16 +0800 Subject: [PATCH] docs: add market miniapp role feature design for specialist and region manager Capture confirmed data scopes, shared module matrix, freight redaction, and non-goals for the on-site mini program. Co-authored-by: Cursor --- ...-10-market-miniapp-role-features-design.md | 186 ++++++++++++++++++ 1 file changed, 186 insertions(+) create mode 100644 docs/superpowers/specs/2026-10-10-market-miniapp-role-features-design.md diff --git a/docs/superpowers/specs/2026-10-10-market-miniapp-role-features-design.md b/docs/superpowers/specs/2026-10-10-market-miniapp-role-features-design.md new file mode 100644 index 00000000..9fdb1000 --- /dev/null +++ b/docs/superpowers/specs/2026-10-10-market-miniapp-role-features-design.md @@ -0,0 +1,186 @@ +# 小程序:市场专员 / 地区经理功能划分 + +**日期:** 2026-10-10 +**状态:** 待审阅 +**范围:** 市场现场侧小程序(存储业务子集);角色能力与数据范围,不含 UI 线框与实现排期 + +## 1. 背景与目标 + +### 1.1 背景 + +Web 管理端「市场 → 存储服务」已形成面向市场部客服的后台能力:预签约订单、采集协议单(细胞存储 / 科研捐赠)、缴费信息、催缴信息、样本信息、运费信息等。 + +医院现场的**市场专员**与**地区经理**平时不在电脑前,需要通过小程序操作系统。二者操作能力对齐,差异仅在**数据可见/可改范围**;运费批次对市场专员另有跨专员脱敏。 + +相关 Web 用语与主数据(已落地): + +| 模块用语(`biz_collection_region_staff`) | 业务用语 | +|------------------------------------------|----------| +| 工作人员 | 市场专员 | +| 负责人(`is_leader=1`) | 地区经理 | + +协议 / 预签单据字段:`sales_user_id`(市场专员)、`region_manager_user_id`(地区经理)、采集地区。 + +### 1.2 目标 + +1. 明确小程序要上线的业务模块清单(对齐 Web 存储服务子集)。 +2. 明确市场专员、地区经理的数据范围与操作能力。 +3. 明确运费批次对市场专员的脱敏规则。 +4. 明确非目标(继续留在 Web 或非本角色)。 +5. 为后续实现计划预留「市场现场数据范围」过滤层要求(Web 现有部门/创建人 `apply_data_scope` 不覆盖本规则)。 + +### 1.3 已确认决策 + +| 项 | 选择 | +|----|------| +| 产品形态 | 同一小程序、同一套业务菜单;角色只影响数据范围与运费脱敏 | +| 市场专员数据范围 | 单据 `sales_user_id` = 当前用户(不以 `create_by`) | +| 地区经理数据范围 | **C**:主数据负责地区(`is_leader=1`) **∪** 单据 `region_manager_user_id` = 当前用户 | +| 市场专员操作能力 | 与地区经理同权:范围内预签/协议/催缴/缴费/样本/运费均可建改查(运费另有脱敏) | +| 地区经理操作能力 | 分管范围内可读可建可改 | +| 一人兼两职 | 数据范围取**并集**(自己名下 ∪ 分管地区) | +| 本期 Demo | 不做 HTML Demo | + +## 2. 角色与数据范围 + +### 2.1 市场专员 + +- **范围键:** 协议 / 预签等主单据的 `sales_user_id` = 当前登录用户。 +- **下游模块(催缴、缴费、样本):** 经所属协议关联过滤,同样落在「自己是市场专员」的协议下。 +- **运费:** 见第 4 节脱敏规则。 + +### 2.2 地区经理 + +满足以下任一即可纳入范围: + +1. **主数据:** 当前用户在 `biz_collection_region_staff`(`del_flag=0`)中为某采集地区的负责人(`is_leader=1`),且该地区 `del_flag=0`;协议(或预签)的采集地区属于这些地区之一。 +2. **单据字段:** 协议 / 预签上的 `region_manager_user_id` = 当前用户。 + +下游模块经协议关联过滤,规则同上。 + +### 2.3 兼岗并集 + +同一用户既是若干单据的市场专员,又是若干地区的负责人(或单据地区经理)时: + +``` +可见可改集合 = 专员范围 ∪ 经理范围 +``` + +列表与详情、写操作均按并集校验;写操作目标单据必须落在并集内。 + +### 2.4 与现有 Web 数据权限的关系 + +| 层级 | 机制 | 是否满足本设计 | +|------|------|----------------| +| 租户 | `tenant_no` | 必须继续生效 | +| 角色数据权限 | `apply_data_scope`(部门 / 创建人等) | **不替代**本设计的专员/地区范围 | +| 本设计 | 市场现场 scope(`sales_user_id` / 负责地区 ∪ `region_manager_user_id`) | 小程序 API **必须**实现 | + +实现阶段应在小程序(或专用)API 上增加「市场现场数据范围」过滤,可与租户隔离叠加;是否回写到 Web 端同一套 scope **不在本文范围**,另行决策。 + +## 3. 功能矩阵 + +两端菜单一致,模块对齐 Web「存储服务」子集。 + +| 模块 | 市场专员 | 地区经理 | Web 对照 | +|------|----------|----------|----------| +| 预签约订单 | 建 / 改 / 查;预签转正式协议 | 同权,范围=分管(含并集) | `/market/cell-storage/presign-order` | +| 协议单(细胞存储) | 建 / 改 / 查 | 同权,范围=分管 | 采集协议单 · 细胞存储 | +| 协议单(科研捐赠) | 建 / 改 / 查 | 同权,范围=分管 | 采集协议单 · 科研捐赠 | +| 催缴信息 | 查 / 改(范围内) | 同权,范围=分管 | `/market/cell-storage/payment-chase` | +| 缴费信息 | 查 / 改(含登记转账等) | 同权,范围=分管 | `/market/cell-storage/payment-info` | +| 样本信息 | 查 / 改(轻量能力按 Web 统一样本信息子集) | 同权,范围=分管 | `/market/cell-storage/sample-info` | +| 运费信息 | 见第 4 节 | 分管范围内完整可见可改 | `/market/cell-storage/sample-freight` | + +### 3.1 模块口径说明 + +- **催缴信息:** 口径对齐 Web——未来 30 天内应缴未清 ∪ 已逾期未清;行与筛选可移动端瘦身,业务集合不变。 +- **缴费信息:** 支持查看与登记转账等市场侧改写;**不含**财务确认收款、开票。 +- **样本信息:** 对齐统一样本信息的进度查看与 Web 已提供的轻量办理能力子集;实验室/生产操作不在此列。 +- **预签转正式:** 人员映射继续遵循现有后端约定(正式单市场专员以采集专员为准等),小程序不另造规则。 + +```mermaid +flowchart TB + subgraph roles [角色] + Spec[市场专员] + Mgr[地区经理] + end + subgraph modules [小程序模块] + Presign[预签约订单] + Protocol[协议单] + Chase[催缴信息] + Pay[缴费信息] + Sample[样本信息] + Freight[运费信息] + end + Spec --> Presign + Spec --> Protocol + Spec --> Chase + Spec --> Pay + Spec --> Sample + Spec --> Freight + Mgr --> Presign + Mgr --> Protocol + Mgr --> Chase + Mgr --> Pay + Mgr --> Sample + Mgr --> Freight +``` + +## 4. 运费批次脱敏(仅市场专员) + +适用:当前请求仅以**市场专员**身份命中某运费批次,或以并集进入但明细行归属其他专员时。 + +| 场景 | 市场专员 | 地区经理(分管内) | +|------|----------|-------------------| +| 批次含自己为市场专员的样本/协议 | 可见批次;可查看并操作**自己相关**明细 | 完整可见可改 | +| 同批次含其他市场专员的协议/样本 | **可看**运单号等批次级信息;**不可看**他专员协议/样本详情 | 完整可见可改 | +| 批次仅含其他专员且自己无明细、也不在经理范围 | 不可见该批次 | 若地区不在分管则不可见 | + +实现要点(后续计划展开): + +- 批次列表:专员侧「批次可见」当且仅当批次内至少一条明细关联到自己 `sales_user_id` 的协议/样本,**或**兼岗并集下经理范围命中。 +- 批次详情:明细行按专员过滤;**他专员明细行不返回**(专员仅见批次头字段 + 自己的明细行;不提供「有 N 条他人明细」之类的可推断详情)。 +- 写操作:专员仅能改自己明细;经理可改分管范围内全部明细。 + +## 5. 非目标 + +以下**不在**本小程序角色首期范围: + +- 缴费财务确认及开票、退费财务确认 +- 采集地区及医院主数据配置、细胞样本类型等基础资料维护 +- 市场物料库全量管理(「我的领用」若需要,单独立项) +- 质检 / 生产 / 入库放行等非市场现场链路 +- HTML Demo、完整小程序视觉稿(另文) +- 将本 scope 强制推广到 Web 全部菜单(另决策) + +## 6. 数据范围实现要点(供后续实现计划) + +1. **专员:** 协议及下游均经 `sales_user_id` 过滤;预签同字段语义。 +2. **经理:** 采集地区 ∈ 负责地区列表,**或** `region_manager_user_id` = 本人;下游经协议关联。 +3. **兼岗:** 查询 OR 合并;写前校验目标落在并集。 +4. **运费:** 批次可见性 + 明细级专员脱敏,独立查询策略。 +5. **租户:** 所有查询/写操作继续 `tenant_no` 隔离。 + +## 7. 与 Web 菜单对照(摘要) + +| 小程序模块 | Web Hash(参考) | +|------------|------------------| +| 预签约订单 | `/#/market/cell-storage/presign-order` | +| 协议单 | `/#/market/cell-storage/protocol-audit` | +| 催缴信息 | `/#/market/cell-storage/payment-chase` | +| 缴费信息 | `/#/market/cell-storage/payment-info` | +| 样本信息 | `/#/market/cell-storage/sample-info` | +| 运费信息 | `/#/market/cell-storage/sample-freight` | + +## 8. 验收标准(产品级) + +1. 市场专员登录后,仅能看到/操作 `sales_user_id` 为自己的预签、协议及下游;运费批次对他人明细脱敏符合第 4 节。 +2. 地区经理登录后,能看到/操作:负责地区内全部相关单据 **加上** 单据上挂自己为地区经理的单据。 +3. 兼岗用户看到并集,且可对并集内单据执行与矩阵一致的建改查。 +4. 财务确认开票、主数据配置等不出现在该小程序菜单中。 + +## 9. 后续 + +- 本文审阅通过后,再编写实现计划(`docs/superpowers/plans/`),拆分:鉴权与 scope 中间层、各模块 API/页面瘦身、运费脱敏、测试用例。 +- 小程序工程载体(新建 uni-app 工程 vs 扩展现有 `mobile-h5`)在实现计划中选定,本文不绑定。