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 <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-10-10 21:43:16 +08:00
1 parent db31990ebe
commit b0a4b94d7d
1 file changed
+186
@@ -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`)在实现计划中选定,本文不绑定。