feat(oa): add owner person/dept fields with initiator defaults

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-07-30 17:54:48 +08:00
1 parent 3b46b10604
commit 4ebc2dbe82
18 files changed
+791 -15

No files matched your search

@@ -0,0 +1,112 @@
# OA 表单设计 · 归属人 / 归属部门 设计文档
**日期**: 2026-07-30
**状态**: 已实现(计划见 `docs/superpowers/plans/2026-07-30-oa-owner-fields.md`)
**范围**: `web-admin` 审批设计器「2 表单设计」组件 Tab;发起页默认值;`backend` 发布白名单与提交时只读强制回填
**界面模式**: 对齐现有「人员」「部门」控件;视觉 Fresh Mint
---
## 1. 背景与目标
表单设计「组件」Tab 已有 **人员**、**部门**。业务需要两个带默认值的同类控件:
- **归属人**:默认当前登录人
- **归属部门**:默认当前登录人主部门
### 1.1 目标
- 左侧「组件」新增「归属人」「归属部门」,与人员/部门并列。
- 发起时自动填入当前登录人 / 主部门。
- 设计器属性「允许修改」:默认 **关**(只读);开则可改选。
- 值结构与人员/部门一致,便于打印、详情、条件(归属人)复用。
### 1.2 非目标
- 不改现有「人员」「部门」行为。
- 不放入「套件」Tab。
- 不支持多选。
---
## 2. 产品决策(已确认)
| 项 | 决策 |
|----|------|
| 控件类型 | `ownerPerson` / `ownerDept` |
| 默认值时机 | 发起审批表单加载时写入;设计器画布不依赖设计者登录身份作为业务默认 |
| 默认来源 | 归属人 = 当前用户 id + 姓名;归属部门 = 主部门 id + 名称(全路径优先) |
| 允许修改 | 属性开关 `allowModify`,**默认 false** |
| 选型 | 固定单选 |
| 值格式 | `{ id, name }`(与 person / dept 一致) |
| 只读防篡改 | `allowModify === false` 时,后端发起提交强制回填为当前用户 / 主部门 |
---
## 3. Schema
```json
{
"type": "ownerPerson",
"field": "Fxxxx",
"title": "归属人",
"props": {
"allowModify": false
}
}
```
```json
{
"type": "ownerDept",
"field": "Fyyyy",
"title": "归属部门",
"props": {
"allowModify": false
}
}
```
---
## 4. 运行时
### 4.1 前端(发起页)
- 加载 schema 后:对空字段写入默认值。
- `allowModify === false`:控件 `disabled`(只读展示)。
- `allowModify === true`:复用人员/部门选择器,可改选。
- 详情页:展示已存 `formData`,不再按当前查看者覆盖。
### 4.2 后端(发起)
- 发布白名单纳入 `ownerPerson` / `ownerDept`。
- 校验值格式同单选 person / dept。
- `allowModify` 为假时:提交前强制写入发起人 id/姓名、主部门 id/名称。
- 条件分支:`ownerPerson` 与 `person` 同属人员类(`contains`);`ownerDept` 暂不进条件候选(与现有 `dept` 一致)。
### 4.3 打印 / 关联展示
- 打印与关联审批摘要:按 person / dept 同路径格式化展示。
---
## 5. 登录用户字段约定
web-admin `userInfo`(见 `backend/app/api/public.py` `_build_user_info_payload`):
| 用途 | 字段 |
|------|------|
| 用户 id | `id`(兼容 `userId`) |
| 姓名 | `realName`(兼容 username) |
| 部门 id | `regionId`(即 `sys_user.dept_id`) |
| 部门名称 | 登录态常无 `regionName`;前端用部门树解析全路径,后端用库表 `dept_name` |
---
## 6. 自检
- [x] 无未决占位符
- [x] 与「人员/部门」值格式一致
- [x] 默认不允许修改 + 后端强制回填
- [x] 范围不含套件、不多选