wkc
47f9491941
- 将员工表org_no字段迁移至dept_id，关联系统部门表 - 更新员工信息相关DTO、VO和Controller，使用deptId替代orgNo - 添加员工信息管理OpenSpec规范文档(proposal/design/spec/tasks) - 更新API文档，反映部门关联变更 - 添加数据库迁移脚本employee_org_no_to_dept_id.sql - 新增员工信息分页接口测试脚本(PowerShell/Python) - 更新CLAUDE.md，添加MCP数据库工具使用说明 Co-Authored-By: Claude (glm-4.7) <noreply@anthropic.com>
476 lines
15 KiB
Markdown
476 lines
15 KiB
Markdown
# Spec: 员工信息管理前端用户界面
|
||
|
||
## ADDED Requirements
|
||
|
||
### Requirement: 前端SHALL提供员工信息列表页面
|
||
|
||
前端MUST提供员工信息列表页面，允许用户查看、搜索和管理员工信息。
|
||
|
||
#### Scenario: 页面加载时显示员工列表
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** 页面应显示员工列表
|
||
**And** 列表应默认显示第1页，每页10条记录
|
||
**And** 页面应显示搜索筛选区和操作按钮
|
||
|
||
#### Scenario: 列表显示正确的员工信息
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**When** 系统返回员工列表数据
|
||
**Then** 列表应显示以下列：姓名、柜员号、身份证号、所属部门、电话、状态、操作
|
||
**And** 状态列应显示"在职"或"离职"的文字描述
|
||
**And** 操作列应显示"详情"、"编辑"、"删除"按钮
|
||
|
||
#### Scenario: 列表支持分页
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**And** 系统中存在25条员工记录
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** 页面应显示分页控件
|
||
**And** 默认显示第1页的10条记录
|
||
**When** 用户点击第2页
|
||
**Then** 页面应显示第11-20条记录
|
||
|
||
#### Scenario: 搜索筛选区默认展开
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** 搜索筛选区应默认显示
|
||
**And** 搜索筛选区应包含：姓名输入框、柜员号输入框、所属部门选择器、身份证号输入框、状态下拉框
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL支持多条件搜索员工
|
||
|
||
前端MUST支持用户通过多种条件组合搜索员工信息。
|
||
|
||
#### Scenario: 按姓名模糊搜索
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**And** 系统中存在姓名为"张三"的员工
|
||
**When** 用户在姓名输入框输入"张"
|
||
**And** 点击"搜索"按钮
|
||
**Then** 列表应仅显示姓名中包含"张"的员工记录
|
||
**And** 分页控件应显示匹配的记录总数
|
||
|
||
#### Scenario: 按柜员号精确搜索
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**And** 系统中存在柜员号为"001"的员工
|
||
**When** 用户在柜员号输入框输入"001"
|
||
**And** 点击"搜索"按钮
|
||
**Then** 列表应仅显示柜员号为"001"的员工记录
|
||
|
||
#### Scenario: 按状态筛选
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**And** 系统中存在在职和离职两种状态的员工
|
||
**When** 用户在状态下拉框选择"在职"
|
||
**And** 点击"搜索"按钮
|
||
**Then** 列表应仅显示状态为"在职"的员工记录
|
||
|
||
#### Scenario: 按所属部门筛选
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**And** 系统中存在多个部门的员工
|
||
**When** 用户在所属部门选择器中选择"研发部门"
|
||
**And** 点击"搜索"按钮
|
||
**Then** 列表应仅显示该部门的员工记录
|
||
|
||
#### Scenario: 组合条件搜索
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:list` 权限
|
||
**When** 用户同时输入姓名"张"、柜员号"001"
|
||
**And** 点击"搜索"按钮
|
||
**Then** 列表应仅显示同时满足所有条件的记录
|
||
|
||
#### Scenario: 重置搜索条件
|
||
|
||
**Given** 用户已输入多个搜索条件并执行了搜索
|
||
**When** 用户点击"重置"按钮
|
||
**Then** 所有搜索条件输入框应清空
|
||
**And** 列表应显示所有员工记录（恢复默认）
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL提供新增员工弹窗
|
||
|
||
前端MUST提供新增员工弹窗，允许用户输入员工基本信息并添加亲属信息。
|
||
|
||
#### Scenario: 点击新增按钮打开弹窗
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:add` 权限
|
||
**When** 用户点击"新增"按钮
|
||
**Then** 应打开新增员工弹窗
|
||
**And** 弹窗标题为"添加员工"
|
||
**And** 所有表单字段应为空
|
||
**And** 亲属列表应为空
|
||
|
||
#### Scenario: 填写员工基本信息
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**When** 用户填写姓名为"张三"
|
||
**And** 填写柜员号为"001"
|
||
**And** 在所属部门选择器中选择"研发部门"
|
||
**And** 填写身份证号为"110101199001011234"
|
||
**And** 填写电话为"13800138000"
|
||
**And** 选择入职时间为"2020-01-01"
|
||
**And** 选择状态为"在职"
|
||
**Then** 表单应正确显示填写的信息
|
||
|
||
#### Scenario: 添加单个亲属
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**And** 用户已填写员工基本信息
|
||
**When** 用户点击"+ 添加亲属"按钮
|
||
**Then** 亲属列表应新增一个空行
|
||
**When** 用户填写亲属姓名为"李四"
|
||
**And** 填写亲属身份证号为"110101199001011235"
|
||
**And** 填写亲属电话为"13800138001"
|
||
**And** 选择关系为"配偶"
|
||
**Then** 亲属列表应显示该亲属信息
|
||
|
||
#### Scenario: 添加多个亲属
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**And** 用户已填写员工基本信息
|
||
**When** 用户点击3次"+ 添加亲属"按钮
|
||
**And** 填写3个亲属的信息
|
||
**Then** 亲属列表应显示3个亲属
|
||
**And** 每个亲属应有独立的删除按钮
|
||
|
||
#### Scenario: 删除亲属
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**And** 亲属列表中存在2个亲属
|
||
**When** 用户点击第一个亲属的"删除"按钮
|
||
**Then** 亲属列表应仅显示1个亲属
|
||
**And** 被删除的亲属应从列表中移除
|
||
|
||
#### Scenario: 提交成功
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**And** 用户已填写所有必填信息
|
||
**When** 用户点击"确定"按钮
|
||
**Then** 系统应发送请求到后端
|
||
**And** 弹窗应关闭
|
||
**And** 应显示"新增成功"的提示消息
|
||
**And** 列表应刷新并显示新增的记录
|
||
|
||
#### Scenario: 表单验证-姓名为空
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**When** 用户不填写姓名
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应显示"姓名不能为空"的错误提示
|
||
**And** 弹窗应保持打开状态
|
||
**And** 不发送请求到后端
|
||
|
||
#### Scenario: 表单验证-身份证号格式错误
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**When** 用户填写身份证号为"123"
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应显示"身份证号格式不正确"的错误提示
|
||
**And** 弹窗应保持打开状态
|
||
|
||
#### Scenario: 亲属姓名为空验证
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**And** 用户已添加一个亲属但未填写亲属姓名
|
||
**When** 用户点击"确定"按钮
|
||
**Then** 系统应显示"亲属姓名不能为空"的错误提示
|
||
|
||
#### Scenario: 取消新增
|
||
|
||
**Given** 新增员工弹窗已打开
|
||
**And** 用户已填写部分信息
|
||
**When** 用户点击"取消"按钮
|
||
**Then** 弹窗应关闭
|
||
**And** 不保存任何数据
|
||
**And** 列表应保持原状态
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL提供编辑员工弹窗
|
||
|
||
前端MUST提供编辑员工弹窗，允许用户修改员工信息和亲属信息。
|
||
|
||
#### Scenario: 点击编辑按钮打开弹窗
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:edit` 权限
|
||
**And** 列表中存在一条员工记录
|
||
**When** 用户点击该记录的"编辑"按钮
|
||
**Then** 应打开编辑员工弹窗
|
||
**And** 弹窗标题为"修改员工"
|
||
**And** 表单应显示该员工的现有信息
|
||
**And** 亲属列表应显示该员工的所有亲属
|
||
|
||
#### Scenario: 修改员工基本信息
|
||
|
||
**Given** 编辑员工弹窗已打开
|
||
**When** 用户修改姓名为"李四"
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应发送更新请求到后端
|
||
**And** 弹窗应关闭
|
||
**And** 应显示"修改成功"的提示消息
|
||
**And** 列表应刷新并显示更新后的姓名
|
||
|
||
#### Scenario: 编辑时新增亲属
|
||
|
||
**Given** 编辑员工弹窗已打开
|
||
**And** 该员工当前有1个亲属
|
||
**When** 用户点击"+ 添加亲属"按钮
|
||
**And** 填写新亲属信息
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应发送更新请求到后端
|
||
**And** 再次打开编辑弹窗时应显示2个亲属
|
||
|
||
#### Scenario: 编辑时删除亲属
|
||
|
||
**Given** 编辑员工弹窗已打开
|
||
**And** 该员工当前有2个亲属
|
||
**When** 用户点击其中一个亲属的"删除"按钮
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应发送更新请求到后端
|
||
**And** 再次打开编辑弹窗时应仅显示1个亲属
|
||
|
||
#### Scenario: 编辑时修改亲属信息
|
||
|
||
**Given** 编辑员工弹窗已打开
|
||
**And** 该员工有亲属"李四"
|
||
**When** 用户修改亲属姓名为"王五"
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应发送更新请求到后端
|
||
**And** 再次打开编辑弹窗时应显示亲属姓名为"王五"
|
||
|
||
#### Scenario: 编辑时清除所有亲属
|
||
|
||
**Given** 编辑员工弹窗已打开
|
||
**And** 该员工有亲属信息
|
||
**When** 用户逐个删除所有亲属
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应发送更新请求到后端
|
||
**And** 再次打开编辑弹窗时亲属列表应为空
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL提供员工详情弹窗
|
||
|
||
前端MUST提供员工详情弹窗，以只读方式展示员工完整信息和亲属列表。
|
||
|
||
#### Scenario: 点击详情按钮打开弹窗
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:query` 权限
|
||
**And** 列表中存在一条员工记录
|
||
**When** 用户点击该记录的"详情"按钮
|
||
**Then** 应打开员工详情弹窗
|
||
**And** 弹窗标题为"员工详情"
|
||
**And** 所有字段应为只读状态
|
||
|
||
#### Scenario: 显示员工基本信息
|
||
|
||
**Given** 员工详情弹窗已打开
|
||
**Then** 应显示以下信息：姓名、柜员号、所属部门、身份证号、电话、入职时间、状态、创建时间
|
||
**And** 状态应显示为"在职"或"离职"的文字描述
|
||
**And** 所有字段应不可编辑
|
||
|
||
#### Scenario: 显示亲属列表
|
||
|
||
**Given** 员工详情弹窗已打开
|
||
**And** 该员工有2个亲属
|
||
**Then** 亲属列表应显示2个亲属
|
||
**And** 每个亲属应显示：亲属姓名、亲属身份证号、亲属电话、与员工关系
|
||
**And** 亲属列表应不可编辑
|
||
|
||
#### Scenario: 无亲属时显示提示
|
||
|
||
**Given** 员工详情弹窗已打开
|
||
**And** 该员工无亲属信息
|
||
**Then** 亲属列表区域应显示"暂无亲属信息"的提示
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL支持删除员工
|
||
|
||
前端MUST支持删除员工操作，包括单个删除和批量删除。
|
||
|
||
#### Scenario: 删除单条记录
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:remove` 权限
|
||
**And** 列表中存在一条员工记录
|
||
**When** 用户点击该记录的"删除"按钮
|
||
**Then** 应弹出确认对话框，提示是否确认删除
|
||
**When** 用户确认删除
|
||
**Then** 系统应发送删除请求到后端
|
||
**And** 应显示"删除成功"的提示消息
|
||
**And** 列表应刷新，该记录应从列表中移除
|
||
|
||
#### Scenario: 取消删除
|
||
|
||
**Given** 用户已点击"删除"按钮
|
||
**And** 确认对话框已显示
|
||
**When** 用户点击"取消"按钮
|
||
**Then** 对话框应关闭
|
||
**And** 不发送删除请求
|
||
**And** 记录应保留在列表中
|
||
|
||
#### Scenario: 批量删除
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:remove` 权限
|
||
**And** 列表中存在多条员工记录
|
||
**When** 用户勾选3条记录
|
||
**And** 点击"删除"按钮
|
||
**And** 确认删除
|
||
**Then** 系统应发送批量删除请求到后端
|
||
**And** 应显示"删除成功"的提示消息
|
||
**And** 列表应刷新，被删除的记录应从列表中移除
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL支持导入员工数据
|
||
|
||
前端MUST支持通过 Excel 文件批量导入员工数据。
|
||
|
||
#### Scenario: 点击导入按钮打开导入弹窗
|
||
|
||
**Given** 用户已登录系统且具有 `dpc:employee:import` 权限
|
||
**When** 用户点击"导入"按钮
|
||
**Then** 应打开导入数据弹窗
|
||
**And** 弹窗标题为"员工数据导入"
|
||
**And** 应显示文件上传区域
|
||
|
||
#### Scenario: 上传Excel文件
|
||
|
||
**Given** 导入弹窗已打开
|
||
**When** 用户选择一个 Excel 文件
|
||
**And** 点击"确定"按钮
|
||
**Then** 系统应上传文件到后端
|
||
**And** 应显示上传进度
|
||
**And** 上传完成后应显示导入结果消息
|
||
|
||
#### Scenario: 导入成功提示
|
||
|
||
**Given** 用户上传了一个包含有效数据的 Excel 文件
|
||
**When** 文件上传完成
|
||
**Then** 应显示导入成功消息，包含成功导入的记录数
|
||
**And** 弹窗应自动关闭
|
||
**And** 列表应刷新，显示新导入的记录
|
||
|
||
#### Scenario: 导入部分失败提示
|
||
|
||
**Given** 用户上传了一个包含10条数据的 Excel 文件
|
||
**And** 其中2条数据格式错误
|
||
**When** 文件上传完成
|
||
**Then** 应显示导入结果消息，说明成功8条，失败2条
|
||
**And** 消息中应包含失败行的错误详情
|
||
|
||
#### Scenario: 更新已存在数据选项
|
||
|
||
**Given** 导入弹窗已打开
|
||
**When** 用户勾选"是否更新已经存在的员工数据"选项
|
||
**And** 上传文件
|
||
**Then** 请求应携带 `updateSupport=true` 参数
|
||
|
||
#### Scenario: 下载导入模板
|
||
|
||
**Given** 导入弹窗已打开
|
||
**When** 用户点击"下载模板"链接
|
||
**Then** 浏览器应下载 Excel 模板文件
|
||
**And** 导入弹窗应保持打开
|
||
|
||
#### Scenario: 支持拖拽上传
|
||
|
||
**Given** 导入弹窗已打开
|
||
**When** 用户将 Excel 文件拖拽到上传区域
|
||
**Then** 文件应自动添加到上传队列
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL根据权限控制按钮显示
|
||
|
||
前端MUST根据用户权限显示或隐藏相应的操作按钮。
|
||
|
||
#### Scenario: 无新增权限时隐藏新增按钮
|
||
|
||
**Given** 用户已登录系统
|
||
**And** 该用户不具有 `dpc:employee:add` 权限
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** "新增"按钮应隐藏或禁用
|
||
|
||
#### Scenario: 无编辑权限时隐藏编辑按钮
|
||
|
||
**Given** 用户已登录系统
|
||
**And** 该用户不具有 `dpc:employee:edit` 权限
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** 列表操作列中的"编辑"按钮应隐藏或禁用
|
||
|
||
#### Scenario: 无删除权限时隐藏删除按钮
|
||
|
||
**Given** 用户已登录系统
|
||
**And** 该用户不具有 `dpc:employee:remove` 权限
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** 列表操作列中的"删除"按钮应隐藏或禁用
|
||
|
||
#### Scenario: 无导入权限时隐藏导入按钮
|
||
|
||
**Given** 用户已登录系统
|
||
**And** 该用户不具有 `dpc:employee:import` 权限
|
||
**When** 用户访问员工信息管理页面
|
||
**Then** "导入"按钮应隐藏或禁用
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL提供友好的用户反馈
|
||
|
||
前端MUST在各种操作中提供适当的用户反馈。
|
||
|
||
#### Scenario: 加载状态显示
|
||
|
||
**Given** 用户执行任何需要请求后端的操作
|
||
**When** 请求正在处理中
|
||
**Then** 列表或弹窗应显示加载状态（如 loading 遮罩）
|
||
|
||
#### Scenario: 操作成功提示
|
||
|
||
**Given** 用户执行新增、修改或删除操作
|
||
**When** 操作成功
|
||
**Then** 应显示成功提示消息
|
||
**And** 提示消息应在几秒后自动消失
|
||
|
||
#### Scenario: 操作失败提示
|
||
|
||
**Given** 用户执行新增、修改或删除操作
|
||
**When** 操作失败
|
||
**Then** 应显示错误提示消息
|
||
**And** 错误消息应说明失败原因
|
||
|
||
#### Scenario: 网络错误处理
|
||
|
||
**Given** 用户执行任何需要请求后端的操作
|
||
**When** 网络请求失败
|
||
**Then** 应显示网络错误提示消息
|
||
**And** 弹窗应保持打开状态（如果是新增/编辑操作）
|
||
|
||
---
|
||
|
||
### Requirement: 前端SHALL支持响应式布局
|
||
|
||
前端MUST确保页面在不同屏幕尺寸下正常显示。
|
||
|
||
#### Scenario: 小屏幕适配
|
||
|
||
**Given** 用户使用小屏幕设备访问页面
|
||
**When** 页面加载完成
|
||
**Then** 搜索筛选区应合理布局
|
||
**And** 表格应支持横向滚动
|
||
**And** 弹窗应适配屏幕尺寸
|
||
|
||
#### Scenario: 大屏幕优化
|
||
|
||
**Given** 用户使用大屏幕设备访问页面
|
||
**When** 页面加载完成
|
||
**Then** 搜索筛选区应在一行内显示
|
||
**And** 表格应充分利用屏幕宽度
|