feat(cell-storage): 储存证质检字段级质检/生产权限
按方案 A 增加租户级 ACL(字段+人员),详情返回可编辑字段,保存改为服务端 merge;弹窗 footer 提供权限配置入口。关联 #93。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
9dc6812393
commit
529f36eac6
16 files changed
+1210
-32
No files matched your search
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-11-11
|
||||
@@ -0,0 +1,47 @@
|
||||
## Context
|
||||
|
||||
储存证质检信息由 `biz_sample_storage_cert_qc.payload` JSON 保存,Web 共用 `storage-cert-qc-dialog`,API 以菜单码控制读写且保存为整单覆盖。业务现要求按「质检 / 生产」拆分字段编辑权,并可由管理员配置人员。
|
||||
|
||||
已确认:方案 A(租户级配置 + 按人授权);配置入口独立菜单码;未配置前兼容旧写权限;同人字段并集;修改端为 web-admin + backend。
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
|
||||
- 租户可配置质检、生产两套「字段 + 人员」ACL
|
||||
- 前端按字段只读/可写;后端 merge 强制执行
|
||||
- 三处入口行为一致;配置 UI 符合 Fresh Mint 弹窗规范
|
||||
|
||||
**Non-Goals:**
|
||||
|
||||
- 不按样本、不按工单单独配置 ACL
|
||||
- 不引入角色绑定作为本期主路径(人员勾选)
|
||||
- 不改造 mobile-h5 / mobile-oa-h5
|
||||
- 不改变 payload 字段语义与预填逻辑(仅限制谁能改)
|
||||
|
||||
## Decisions
|
||||
|
||||
1. **存储**:主表 `biz_storage_cert_qc_acl`(`tenant_no`+`scope` 唯一,`field_keys` JSON,`configured_flag`)+ 子表 `biz_storage_cert_qc_acl_user`(`acl_id`+`user_id`,软删同步)。相对单 JSON 大包,子表便于人员校验与审计扩展。
|
||||
2. **权限解析**:用户可编辑字段 = 其所属各已配置 scope 的 field_keys 并集;严格模式在「任一 scope 的 configured_flag=1」时启用;否则有原 WRITE_MENUS 即可编辑全部合法字段。
|
||||
3. **写路径**:**BREAKING 行为**:`PUT` 从整单覆盖改为服务端 merge——仅更新 `editableFieldKeys` 内键;无任何可写字段拒绝保存;提交中含无权键且值相对库内有变化则 403。
|
||||
4. **配置权限**:独立菜单码(建议 `cell-storage:sample-info:storage-cert-qc-acl`);与业务填写菜单分离。按钮仅在 `canConfigureAcl=true` 时展示。
|
||||
5. **字段候选**:前后端共用类型字段清单(与 `STORAGE_CERT_QC_GROUPS` / 后端 type keys 对齐);配置 UI 展示两样本类型字段并集,非法 key 拒绝保存。
|
||||
6. **UI**:主弹窗 footer 左侧配置按钮、右侧取消/确定;配置子弹两个 Tab(字段勾选 / 人员多选)。先 Figma 确认再编码。
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [未配置→已配置切换瞬间全员变严] → 上线说明;兼容期默认未配置仍可写;配置保存前可预览影响(可选,本期不做强制)。
|
||||
- [人员名单维护成本] → 接受方案 A;后续可加角色扩展,不阻塞本期。
|
||||
- [整单覆盖客户端旧代码] → 后端 merge 兼容旧客户端:无权字段被忽略或在变更时 403;推荐 403 以便发现错误集成。
|
||||
- [超级管理员] → 不默认绕过 ACL;仅配置菜单控制谁能改 ACL。若需超管旁路,另开需求。
|
||||
|
||||
## Migration Plan
|
||||
|
||||
1. 执行 SQL 建表;部署后端(读接口先返回兼容态 editableFieldKeys=全部或空+aclStrict=false)。
|
||||
2. 部署前端(无配置权限时 UI 与现网接近)。
|
||||
3. 管理员配置质检/生产后该租户进入严格模式。
|
||||
4. 回滚:保留表数据;回退代码后配置表闲置;严格模式逻辑随代码回退消失。
|
||||
|
||||
## Open Questions
|
||||
|
||||
- 无(关键项已在对话确认:租户级、独立配置菜单、兼容期、字段并集、先 Figma)。
|
||||
@@ -0,0 +1,28 @@
|
||||
## Why
|
||||
|
||||
「填写储存证质检信息」弹窗目前只要具备菜单写权限即可改全部字段,无法按质检 / 生产职责拆分。业务需要:质检与生产各自配置可编辑字段与人员,范围外用户仅可查看,且服务端必须强制校验。
|
||||
|
||||
## What Changes
|
||||
|
||||
- 新增租户级储存证质检字段 ACL:两个 scope(`qc` / `production`),各自保存可编辑字段列表与可编辑人员。
|
||||
- 详情接口返回当前用户 `editableFieldKeys` 等权限上下文;保存改为服务端按权限 merge,拒绝无权字段篡改。
|
||||
- 主弹窗 footer 左侧增加「质检权限」「生产权限」入口(仅配置权限可见);配置子弹含「勾选字段」「配置人员」两个 Tab。
|
||||
- 未对任一 scope 保存过配置时,兼容现有菜单写权限(可改全部);任一 scope 首次配置后该租户进入严格 ACL。
|
||||
- **不改**小程序 / mobile-oa-h5;三处 Web 入口(客户服务、质检工单、生产工单)共用同一弹窗组件一并生效。
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
- `storage-cert-qc-field-acl`: 储存证质检信息字段级编辑权限(配置、解析、读写强制)
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
- (无;`openspec/specs/` 尚未建立长期基线中的对应能力)
|
||||
|
||||
## Impact
|
||||
|
||||
- **backend**:新表与 CRUD/API;`sample_storage_cert_qc` 读/写路径;菜单码与鉴权
|
||||
- **web-admin**:`storage-cert-qc-dialog`、ACL 配置子弹、API 客户端
|
||||
- **docs/sql**:结构迁移脚本
|
||||
- **权限**:租户隔离;配置入口独立菜单码;写入不信任客户端字段权限声明
|
||||
@@ -0,0 +1,76 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 租户级质检与生产字段 ACL 配置
|
||||
|
||||
系统 SHALL 按租户维护储存证质检信息的两套编辑权限配置,scope 分别为 `qc`(质检)与 `production`(生产)。每套配置 SHALL 包含可编辑字段 key 列表与可编辑用户列表。字段 key MUST 属于该业务已定义的合法 payload 键集合。
|
||||
|
||||
#### Scenario: 管理员保存质检权限
|
||||
|
||||
- **WHEN** 具备 ACL 配置菜单权限的用户保存 scope=`qc` 的字段列表与人员列表
|
||||
- **THEN** 系统持久化该租户的质检 ACL,并将该 scope 标记为已配置
|
||||
|
||||
#### Scenario: 非法字段被拒绝
|
||||
|
||||
- **WHEN** 配置请求包含不在合法 payload 键集合中的 field key
|
||||
- **THEN** 系统拒绝保存并返回错误,不部分写入
|
||||
|
||||
### Requirement: 按当前用户解析可编辑字段
|
||||
|
||||
系统在返回储存证质检详情时 SHALL 附带当前用户可编辑字段集合。可编辑字段 MUST 为用户所属各 scope 字段列表的并集。未出现在任一 ACL 人员名单中的用户,在严格模式下 MUST 得到空的可编辑字段集合(仍可只读查看详情)。
|
||||
|
||||
#### Scenario: 同属两 scope 取并集
|
||||
|
||||
- **WHEN** 用户同时在质检与生产人员名单中,且两 scope 勾选了不同字段
|
||||
- **THEN** 详情中的可编辑字段为两 scope 字段的并集
|
||||
|
||||
#### Scenario: 未授权用户只读
|
||||
|
||||
- **WHEN** 租户已进入严格 ACL,且当前用户不在任一 scope 人员名单中
|
||||
- **THEN** 可编辑字段为空,用户可查看已有数据但不能修改
|
||||
|
||||
### Requirement: 未配置前兼容菜单写权限
|
||||
|
||||
当租户的质检与生产 scope 均未被标记为已配置时,系统 SHALL 保持兼容行为:只要用户具备既有储存证质检写菜单权限,即可编辑全部合法字段。当任一 scope 被标记为已配置后,该租户 MUST 进入严格 ACL,不再仅凭菜单写权限获得全字段编辑权。
|
||||
|
||||
#### Scenario: 全新租户未配置
|
||||
|
||||
- **WHEN** 租户两 scope 均未配置,且用户具备既有写菜单权限
|
||||
- **THEN** 详情返回全部合法字段为可编辑,保存可更新这些字段
|
||||
|
||||
#### Scenario: 首次配置后收紧
|
||||
|
||||
- **WHEN** 管理员首次成功保存任一 scope 的 ACL
|
||||
- **THEN** 之后该租户按严格 ACL 解析可编辑字段与保存权限
|
||||
|
||||
### Requirement: 保存时服务端强制 merge
|
||||
|
||||
储存证质检保存接口 MUST 仅更新当前用户有权编辑的字段;无权字段 MUST 保留库中原值。若请求试图修改无权字段的值,系统 MUST 拒绝该请求。当用户没有任何可编辑字段时,系统 MUST 拒绝保存。
|
||||
|
||||
#### Scenario: 部分字段可写
|
||||
|
||||
- **WHEN** 用户仅对字段集合 A 有编辑权并提交包含 A 与其他字段的 payload
|
||||
- **THEN** 仅 A 中相对原值有权限的变更被写入,其他键保持原值;若其他键相对原值发生变化则整单拒绝
|
||||
|
||||
#### Scenario: 无可写字段
|
||||
|
||||
- **WHEN** 当前用户可编辑字段为空并调用保存接口
|
||||
- **THEN** 系统拒绝保存
|
||||
|
||||
### Requirement: 配置入口与主弹窗交互
|
||||
|
||||
Web 管理端储存证质检弹窗在用户具备 ACL 配置权限时,SHALL 在 footer 左侧提供「质检权限」「生产权限」入口。配置界面 SHALL 提供两个 Tab:勾选可编辑字段、配置可编辑人员。不具备配置权限的用户 MUST 看不到上述入口。不具备字段编辑权的用户打开业务弹窗时 MUST 以只读方式展示字段,且不得出现可提交业务保存的主按钮(或等价禁用)。
|
||||
|
||||
#### Scenario: 管理员可见配置按钮
|
||||
|
||||
- **WHEN** 具备 ACL 配置菜单权限的用户打开填写弹窗
|
||||
- **THEN** footer 左侧显示质检权限与生产权限按钮
|
||||
|
||||
#### Scenario: 普通填写人不可见配置
|
||||
|
||||
- **WHEN** 不具备 ACL 配置菜单权限的用户打开填写弹窗
|
||||
- **THEN** 不显示质检权限与生产权限按钮
|
||||
|
||||
#### Scenario: 三处入口一致
|
||||
|
||||
- **WHEN** 用户从客户服务、质检工单或生产工单打开同一储存证质检弹窗
|
||||
- **THEN** 字段可编辑性与配置入口可见性均按同一 ACL 与菜单规则生效
|
||||
@@ -0,0 +1,26 @@
|
||||
## 1. 数据与后端 ACL
|
||||
|
||||
- [x] 1.1 新增 `docs/sql/` 迁移:`biz_storage_cert_qc_acl`、`biz_storage_cert_qc_acl_user`(租户、软删、标准审计字段)
|
||||
- [x] 1.2 新增 ORM / CRUD:按 tenant+scope 读写字段列表与人员;保存时校验合法 field key、同步子行
|
||||
- [x] 1.3 实现当前用户可编辑字段解析(兼容模式 vs 严格模式、两 scope 并集)
|
||||
- [x] 1.4 扩展 GET 详情:返回 `editableFieldKeys`、`canConfigureAcl`、`aclStrict`
|
||||
- [x] 1.5 改造 PUT 保存为服务端 merge,无权字段变更拒绝,无可写字段拒绝
|
||||
- [x] 1.6 新增 ACL GET/PUT API,鉴权独立配置菜单码
|
||||
- [x] 1.7 补充/调整 `backend/tests/test_sample_storage_cert_qc.py`(及 ACL 用例)覆盖兼容、严格、并集、拒绝篡改
|
||||
|
||||
## 2. Web 主弹窗与配置弹窗
|
||||
|
||||
- [x] 2.1 按已确认 Figma 原型调整 `storage-cert-qc-dialog` footer(左侧配置按钮、右侧取消/确定)与字段只读态
|
||||
- [x] 2.2 新增 ACL 配置弹窗(质检/生产):Tab1 分组勾选字段,Tab2 选人,保存调 ACL API
|
||||
- [x] 2.3 接入 API 客户端与菜单码;无配置权限不展示入口;无可写字段隐藏业务确定
|
||||
- [x] 2.4 核对客户服务 / 质检工单 / 生产工单三处入口共用行为
|
||||
|
||||
## 3. 权限种子与文档回写
|
||||
|
||||
- [x] 3.1 增加配置菜单码种子/SQL(命名与路由约定一致),说明仅管理员授予
|
||||
- [ ] 3.2 工单回写:OpenSpec 路径、Figma 链接、验收要点;原型确认结论
|
||||
|
||||
## 4. 验证
|
||||
|
||||
- [x] 4.1 在任务 worktree 运行受影响后端单元测试并记录结果
|
||||
- [x] 4.2 源码级对照已确认原型(footer 布局、双 Tab、按钮主次、只读态)
|
||||
Reference in new issue
Block a user