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:
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`)在实现计划中选定,本文不绑定。
|
||||
Reference in new issue
Block a user