Files
performance-evaluation-system/.kiro/specs/employee-performance-system/requirements.md
2026-04-11 11:51:54 +08:00

189 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 需求文档 - 员工月度绩效考核系统
## 简介
优一科技员工月度绩效考核系统是一个用于规范化、自动化管理员工月度绩效考核的系统。系统覆盖员工、管理层、总经理三类角色,以月度为周期进行绩效考核,集成 AI 自动评分功能,实现绩效填报、审核、统计分析的全流程管理。
## 术语表
- **System**: 员工月度绩效考核系统
- **Employee**: 员工角色,负责填报个人绩效
- **Manager**: 管理层角色,负责审核下属员工绩效
- **General_Manager**: 总经理角色,负责全公司绩效查看和统计分析
- **Performance_Record**: 绩效记录,包含员工某月的完整绩效数据
- **AI_Evaluator**: AI 评分模块,基于 FastGPT 实现自动打分和建议生成
- **Business_Quality**: 业务素质考评,占总分 70%
- **Comprehensive_Quality**: 综合素质考评,占总分 30%
- **Performance_Cycle**: 绩效考核周期,为自然月
- **Submission_Period**: 提交期,每月 1-5 日
- **Review_Period**: 审核期,每月 6-10 日
## 需求
### 需求 1: 用户认证与权限管理
**用户故事:** 作为系统用户,我希望能够安全登录系统并根据我的角色访问相应的功能,以便保护数据安全和隐私。
#### 验收标准
1. WHEN 用户提供有效的用户名、密码和角色信息 THEN THE System SHALL 验证凭据并返回有效的访问令牌
2. WHEN 用户提供无效的登录凭据 THEN THE System SHALL 拒绝访问并返回明确的错误信息
3. WHEN 用户访问需要权限的资源 THEN THE System SHALL 验证用户角色并仅允许授权访问
4. WHEN 访问令牌过期24小时后THEN THE System SHALL 要求用户重新登录
5. THE System SHALL 确保员工仅能访问个人数据,管理层仅能访问下属数据,总经理可访问全量数据
### 需求 2: 员工绩效填报
**用户故事:** 作为员工,我希望能够在每月 1-5 日填写上月绩效内容,以便完成月度绩效考核。
#### 验收标准
1. WHEN 员工在提交期(每月 1-5 日)访问填报页面 THEN THE System SHALL 显示当前考核月份和员工基础信息
2. WHEN 员工填写绩效内容 THEN THE System SHALL 要求填写 17 项考核指标(业务素质 9 项 + 综合素质 8 项)的完成情况描述和自评分数
3. WHEN 员工填写考勤数据 THEN THE System SHALL 记录事假、病假、迟到、旷工、缺卡的具体次数及说明
4. WHEN 员工上传佐证材料 THEN THE System SHALL 支持上传文件(截图、文档、代码片段等)作为可选附件
5. WHEN 员工选择暂存 THEN THE System SHALL 保存草稿并允许后续继续编辑
6. WHEN 员工选择提交 THEN THE System SHALL 锁定表单并触发 AI 评分流程
7. WHEN 员工提交后需要修改 THEN THE System SHALL 要求员工向管理层申请退回修改
### 需求 3: AI 自动评分与反馈
**用户故事:** 作为系统,我需要在员工提交绩效后自动调用 AI 进行评分和反馈生成,以便提供客观的初步评估。
#### 验收标准
1. WHEN 员工提交绩效记录 THEN THE System SHALL 自动调用 FastGPT API 进行 AI 评分
2. WHEN AI 评分完成 THEN THE System SHALL 存储每个考核项的 AI 评分、评分说明、总分(业务素质 70% + 综合素质 30%
3. WHEN AI 分析完成 THEN THE System SHALL 生成 3-5 条核心问题总结
4. WHEN AI 分析完成 THEN THE System SHALL 生成 3-5 条具体可落地的改进建议
5. WHEN AI 调用失败或超时(>10秒THEN THE System SHALL 记录错误并通知管理员
6. THE System SHALL 确保 AI 返回的数据格式为标准 JSON 并可被系统正确解析
### 需求 4: 管理层绩效审核
**用户故事:** 作为管理层,我希望能够在每月 6-10 日审核下属员工的绩效,以便完成最终评分和反馈。
#### 验收标准
1. WHEN 管理层在审核期(每月 6-10 日)访问审核页面 THEN THE System SHALL 显示所有下属员工的绩效提交列表
2. WHEN 管理层查看员工绩效 THEN THE System SHALL 显示员工填报内容、自评分数、AI 评分及 AI 反馈
3. WHEN 管理层调整评分 THEN THE System SHALL 允许修改每个考核项的分数并要求填写调整原因
4. WHEN 管理层填写审核意见 THEN THE System SHALL 记录详细的审核意见说明
5. WHEN 管理层审核通过 THEN THE System SHALL 计算最终总分、确定绩效等级和奖惩说明,并归档绩效记录
6. WHEN 管理层驳回绩效 THEN THE System SHALL 要求填写驳回原因并通知员工修改
7. WHEN 管理层审核完成 THEN THE System SHALL 锁定绩效记录不可随意修改
### 需求 5: 绩效等级与奖惩计算
**用户故事:** 作为系统,我需要根据最终总分自动计算绩效等级和奖惩金额,以便明确员工的考核结果。
#### 验收标准
1. WHEN 最终总分 >= 90 分 THEN THE System SHALL 标记为"优秀"等级并说明按公司规定给予奖励
2. WHEN 最终总分在 80-89 分 THEN THE System SHALL 标记为"合格"等级并说明扣除当月绩效工资 100 元
3. WHEN 最终总分在 70-79 分 THEN THE System SHALL 标记为"合格"等级并说明扣除当月绩效工资 200 元
4. WHEN 最终总分在 60-69 分 THEN THE System SHALL 标记为"需激励"等级并说明扣除当月绩效工资 300 元
5. WHEN 最终总分 < 60 THEN THE System SHALL 标记为"不合格"等级并说明扣除当月绩效工资 600
6. WHEN 员工连续 2 个月考核分数低于 60 THEN THE System SHALL 标记需要书面警告
7. WHEN 员工连续 3 个月考核分数低于 60 THEN THE System SHALL 标记需要劝退处理
### 需求 6: 个人绩效查看
**用户故事:** 作为员工我希望能够查看我的历史绩效记录和 AI 反馈以便了解自己的工作表现和改进方向
#### 验收标准
1. WHEN 员工访问个人绩效页面 THEN THE System SHALL 显示所有历史月份的绩效记录列表
2. WHEN 员工查看某月绩效详情 THEN THE System SHALL 显示填报内容自评分数AI 评分管理层评分最终总分和等级
3. WHEN 员工查看 AI 反馈 THEN THE System SHALL 显示 AI 总结的问题和改进建议
4. WHEN 员工查看奖惩说明 THEN THE System SHALL 显示当月绩效对应的奖惩情况
5. THE System SHALL 支持按月份筛选和分页查看历史绩效
### 需求 7: 管理层数据查看与导出
**用户故事:** 作为管理层我希望能够查看和导出下属员工的绩效数据以便进行团队管理和统计分析
#### 验收标准
1. WHEN 管理层访问团队绩效页面 THEN THE System SHALL 显示下属员工的绩效列表
2. WHEN 管理层筛选数据 THEN THE System SHALL 支持按考核月份部门员工姓名绩效状态进行筛选
3. WHEN 管理层导出数据 THEN THE System SHALL 生成 Excel 格式的绩效表
4. WHEN 管理层查看团队统计 THEN THE System SHALL 显示团队绩效平均分
5. WHEN 管理层查看团队统计 THEN THE System SHALL 显示优秀合格需激励员工的人数及占比
6. THE System SHALL 支持导出单个员工的历史绩效或所有下属的当月/指定时间段绩效
### 需求 8: 总经理全局管理
**用户故事:** 作为总经理我希望能够查看全公司的绩效数据并进行多维度统计分析以便掌握公司整体绩效水平
#### 验收标准
1. WHEN 总经理访问全局绩效页面 THEN THE System SHALL 显示各部门各岗位的月度绩效整体情况
2. WHEN 总经理进行统计分析 THEN THE System SHALL 支持按考核月份部门岗位绩效等级等维度进行统计
3. WHEN 总经理查看统计报表 THEN THE System SHALL 生成可视化图表柱状图饼图等
4. WHEN 总经理导出数据 THEN THE System SHALL 支持导出全公司所有员工的所有月份绩效数据
5. WHEN 总经理配置考核规则 THEN THE System SHALL 允许修改考核指标权重评分标准奖惩金额
6. WHEN 考核规则修改后 THEN THE System SHALL 自动应用于后续考核周期
### 需求 9: 数据持久化与历史追溯
**用户故事:** 作为系统管理员我需要确保所有绩效数据被安全存储并可追溯以便满足审计和合规要求
#### 验收标准
1. WHEN 绩效数据生成或修改 THEN THE System SHALL 将数据持久化存储到 MySQL 数据库
2. WHEN 用户查询历史数据 THEN THE System SHALL 能够检索任意历史月份的绩效记录
3. WHEN 绩效数据被修改 THEN THE System SHALL 记录修改人修改时间修改内容
4. WHEN 管理层审核完成 THEN THE System SHALL 将绩效数据归档并标记为不可随意修改
5. THE System SHALL 对员工个人信息绩效奖惩等敏感数据进行加密存储
6. THE System SHALL 支持数据备份与恢复功能
### 需求 10: 系统性能与稳定性
**用户故事:** 作为系统用户我希望系统运行稳定响应迅速以便高效完成绩效考核工作
#### 验收标准
1. WHEN 用户访问页面 THEN THE System SHALL 2 秒内完成页面加载
2. WHEN 员工提交绩效 THEN THE System SHALL 确保提交成功率 >= 99%
3. WHEN AI 评分被触发 THEN THE System SHALL 在 10 秒内返回评分结果
4. WHEN 管理层审核绩效 THEN THE System SHALL 确保审核操作成功率 >= 99%
5. THE System SHALL 支持主流 PC 浏览器Chrome、Edge、Firefox
6. WHEN 系统出现异常 THEN THE System SHALL 记录错误日志并提供友好的错误提示
### 需求 11: 考勤数据处理
**用户故事:** 作为系统,我需要根据员工填写的考勤数据自动计算考勤分数,以便准确评估综合素质。
#### 验收标准
1. WHEN 员工全勤无事假、迟到、缺卡、旷工THEN THE System SHALL 给予考勤满分 10 分
2. WHEN 员工有事假记录 THEN THE System SHALL 每天扣除 5 分
3. WHEN 员工有迟到或缺卡记录 THEN THE System SHALL 每次扣除 2 分
4. WHEN 员工有旷工记录 THEN THE System SHALL 按公司制度另行处理
5. THE System SHALL 确保考勤分数不低于 0 分
### 需求 12: 绩效修改申请流程
**用户故事:** 作为员工,当我提交绩效后发现需要修改时,我希望能够向管理层申请退回修改,以便更正错误信息。
#### 验收标准
1. WHEN 员工提交绩效后需要修改 THEN THE System SHALL 提供"申请修改"功能
2. WHEN 员工发起修改申请 THEN THE System SHALL 通知所属管理层
3. WHEN 管理层同意修改申请 THEN THE System SHALL 解锁绩效表单并允许员工重新编辑
4. WHEN 管理层拒绝修改申请 THEN THE System SHALL 通知员工并说明拒绝原因
5. WHEN 员工修改完成后 THEN THE System SHALL 要求重新提交并触发新的 AI 评分
### 需求 13: FastGPT 集成
**用户故事:** 作为系统开发者,我需要正确集成 FastGPT API以便实现 AI 自动评分功能。
#### 验收标准
1. WHEN 系统调用 FastGPT API THEN THE System SHALL 使用正确的 API-Key 和模型配置
2. WHEN 构建 AI 请求 THEN THE System SHALL 包含员工岗位、考核月份、填报内容、考核规则等完整参数
3. WHEN 接收 AI 响应 THEN THE System SHALL 验证返回的 JSON 格式是否符合预期结构
4. WHEN AI 返回无效数据 THEN THE System SHALL 记录错误并提供降级处理方案
5. THE System SHALL 确保 AI 调用的安全性,防止敏感信息泄露