193 lines
9.5 KiB
Markdown
193 lines
9.5 KiB
Markdown
# 实施计划 - 员工月度绩效考核系统
|
||
|
||
## 概述
|
||
|
||
按照前后端分离架构，分阶段实施：先搭建后端基础设施和核心业务逻辑，再实现前端各角色页面，最后集成 AI 评分和统计分析功能。
|
||
|
||
## 任务
|
||
|
||
- [x] 1. 项目初始化与基础设施搭建
|
||
- 初始化后端 Node.js + TypeScript + Express 项目结构
|
||
- 初始化前端 React + TypeScript + Ant Design 项目结构
|
||
- 配置 MySQL 数据库连接（使用 mysql2 驱动）
|
||
- 创建数据库初始化脚本（6张表的 DDL）
|
||
- 配置环境变量（.env：DB连接、JWT密钥、FastGPT API Key）
|
||
- _Requirements: 9.1, 10.5_
|
||
|
||
- [x] 2. 用户认证模块
|
||
- [x] 2.1 实现用户登录接口 `/api/user/login`
|
||
- 查询用户表验证用户名、密码（bcrypt 比对）和角色
|
||
- 生成 JWT token（有效期 24 小时），返回 userInfo
|
||
- _Requirements: 1.1, 1.2_
|
||
- [x] 2.2 实现 JWT 认证中间件
|
||
- 验证请求头中的 token，解析用户信息注入 req.user
|
||
- token 过期或无效时返回 401
|
||
- _Requirements: 1.4_
|
||
- [x] 2.3 实现角色权限中间件
|
||
- 根据路由配置允许的角色列表，验证当前用户角色
|
||
- 权限不足时返回 403
|
||
- _Requirements: 1.3, 1.5_
|
||
- [x] 2.4 编写认证模块属性测试
|
||
|
||
- **属性 1: 认证正确性** — 对任意凭据，认证结果与凭据有效性一致
|
||
- **属性 2: 权限隔离不变量** — 员工无法访问他人数据
|
||
- **Validates: Requirements 1.1, 1.2, 1.5**
|
||
|
||
- [x] 3. 数据库访问层（DAO）
|
||
- [x] 3.1 实现 UserDAO
|
||
- `findByUsername(username)`: 按用户名查询
|
||
- `findSubordinates(managerId)`: 查询下属列表
|
||
- _Requirements: 1.1, 4.1_
|
||
- [x] 3.2 实现 PerformanceDAO
|
||
- `upsert(data)`: 创建或更新绩效记录（支持暂存/提交）
|
||
- `findByUserAndMonth(userId, month)`: 查询指定月份绩效
|
||
- `findByManagerId(managerId, filters, page)`: 查询下属绩效列表
|
||
- `updateStatus(perfId, status)`: 更新绩效状态
|
||
- `updateReview(perfId, reviewData)`: 更新审核结果
|
||
- _Requirements: 2.5, 2.6, 4.1, 4.5, 9.1_
|
||
- [x] 3.3 实现 AIResultDAO
|
||
- `save(aiResult)`: 保存 AI 评分结果
|
||
- `findByPerfId(perfId)`: 查询绩效对应的 AI 结果
|
||
- _Requirements: 3.2, 3.3_
|
||
|
||
- [x] 4. 考勤分数计算与绩效等级模块
|
||
- [x] 4.1 实现考勤分数计算函数 `calculateAttendanceScore`
|
||
- 基础分 10 分，事假每天扣 5 分，迟到/缺卡每次扣 2 分，下限 0 分
|
||
- _Requirements: 11.1, 11.2, 11.3, 11.5_
|
||
- [x] 4.2 实现绩效等级与奖惩计算函数 `calculateLevelAndReward`
|
||
- 根据总分返回等级（excellent/qualified/need_motivation/unqualified）和奖惩说明
|
||
- _Requirements: 5.1, 5.2, 5.3, 5.4, 5.5_
|
||
- [x] 4.3 实现连续低分预警检测函数 `checkConsecutiveLowScore`
|
||
- 查询员工最近 N 个月记录，检测连续低于 60 分的情况
|
||
- _Requirements: 5.6, 5.7_
|
||
- [x] 4.4 编写计算模块属性测试
|
||
|
||
- **属性 5: 绩效等级与奖惩计算正确性** — 对任意分数，等级和奖惩符合规则
|
||
- **属性 6: 连续低分预警正确性** — 连续低分正确触发预警
|
||
- **属性 8: 考勤分数计算正确性** — 对任意考勤数据，分数计算正确且不低于 0
|
||
- **Validates: Requirements 5.1-5.7, 11.1-11.5**
|
||
|
||
- [x] 5. 检查点 — 确保所有测试通过，如有问题请告知
|
||
|
||
- [x] 6. 员工端绩效填报接口
|
||
- [x] 6.1 实现绩效提交接口 `/api/performance/submit`
|
||
- 支持 draft（暂存）和 submit（提交）两种状态
|
||
- 使用数据库事务同时写入 performance_month、perf_item、attendance 三张表
|
||
- 提交时触发异步 AI 评分（不阻塞响应）
|
||
- _Requirements: 2.1, 2.2, 2.3, 2.5, 2.6_
|
||
- [x] 6.2 实现个人绩效查询接口 `/api/performance/employee/get`
|
||
- 支持按月份筛选和分页
|
||
- 返回绩效记录含 AI 结果、考勤、审核意见
|
||
- _Requirements: 6.1, 6.2, 6.3, 6.4, 6.5_
|
||
- [x] 6.3 实现修改申请接口 `/api/performance/request-modification`
|
||
- 员工发起申请，记录申请原因，通知管理层
|
||
- _Requirements: 12.1, 12.2_
|
||
- [x] 6.4 编写员工端接口属性测试
|
||
|
||
- **属性 3: 草稿暂存往返一致性** — 暂存后读取数据一致
|
||
- **属性 4: 提交幂等性** — 同一用户同月不可重复提交
|
||
- **属性 7: 绩效记录查询完整性** — 提交后查询必能找到
|
||
- **Validates: Requirements 2.5, 2.6, 6.1**
|
||
|
||
- [x] 7. AI 评分模块
|
||
- [x] 7.1 实现 FastGPT 调用服务 `AIEvaluationService`
|
||
- 构建包含岗位、月份、填报内容、考核规则的 Prompt
|
||
- 调用 FastGPT API（超时 10s）
|
||
- _Requirements: 13.1, 13.2_
|
||
- [x] 7.2 实现 AI 响应解析函数 `parseAIResponse`
|
||
- 解析 JSON 格式响应，提取 ai_score_detail、ai_total_score、ai_problems、ai_suggestions
|
||
- 验证格式合法性，异常时记录原始响应并抛出错误
|
||
- _Requirements: 3.2, 3.3, 3.4, 13.3, 13.4_
|
||
- [x] 7.3 实现重试机制（最多 3 次）和错误降级处理
|
||
- _Requirements: 3.5_
|
||
- [x] 7.4 编写 AI 模块属性测试
|
||
|
||
- **属性 9: AI 响应 JSON 解析往返一致性** — 解析后序列化得到等价对象
|
||
- **属性 10: AI 输出格式约束** — problems 和 suggestions 数组长度在 3-5 之间
|
||
- **Validates: Requirements 3.3, 3.4, 3.6**
|
||
|
||
- [x] 8. 管理层审核接口
|
||
- [x] 8.1 实现下属绩效列表接口 `/api/performance/manager/list`
|
||
- 支持按月份、部门、员工姓名、状态筛选和分页
|
||
- _Requirements: 4.1, 7.1, 7.2_
|
||
- [x] 8.2 实现绩效审核接口 `/api/performance/manager/review`
|
||
- 更新各考核项管理层评分和说明
|
||
- 计算最终总分、等级、奖惩，归档绩效记录（状态改为 completed）
|
||
- _Requirements: 4.3, 4.4, 4.5, 4.7_
|
||
- [x] 8.3 实现绩效驳回接口 `/api/performance/manager/reject`
|
||
- 记录驳回原因，状态改为 rejected
|
||
- _Requirements: 4.6_
|
||
- [x] 8.4 实现修改申请审批接口 `/api/performance/manager/approve-modification`
|
||
- 同意时解锁绩效记录，拒绝时通知员工
|
||
- _Requirements: 12.3, 12.4_
|
||
|
||
- [x] 9. 检查点 — 确保所有测试通过，如有问题请告知
|
||
|
||
- [x] 10. 统计分析与导出接口
|
||
- [x] 10.1 实现团队统计接口 `/api/statistics/team`
|
||
- 统计下属团队平均分、优秀/合格/需激励人数及占比
|
||
- _Requirements: 7.4, 7.5_
|
||
- [x] 10.2 实现全公司统计接口 `/api/statistics/company`
|
||
- 按部门、岗位、绩效等级多维度统计
|
||
- _Requirements: 8.1, 8.2_
|
||
- [x] 10.3 实现 Excel 导出接口 `/api/performance/export`
|
||
- 使用 exceljs 生成 Excel 文件，支持单员工历史和团队批量导出
|
||
- _Requirements: 7.3, 7.6, 8.4_
|
||
|
||
- [x] 11. 总经理端接口
|
||
- [x] 11.1 实现考核规则配置接口 `/api/config/rules`
|
||
- 支持修改考核指标权重、评分标准、奖惩金额
|
||
- 修改后记录操作日志，应用于后续考核周期
|
||
- _Requirements: 8.5, 8.6_
|
||
|
||
- [x] 12. 前端基础框架搭建
|
||
- [x] 12.1 配置 React Router，定义三类角色的路由结构
|
||
- 员工路由：`/employee/*`，管理层路由：`/manager/*`，总经理路由：`/gm/*`
|
||
- _Requirements: 1.3_
|
||
- [x] 12.2 实现登录页面和 AuthContext
|
||
- 登录表单（用户名、密码、角色选择），登录成功后存储 token 跳转对应角色首页
|
||
- _Requirements: 1.1, 1.2_
|
||
- [x] 12.3 实现 Axios 请求拦截器
|
||
- 自动携带 token，处理 401/403 响应（跳转登录页）
|
||
- _Requirements: 1.4_
|
||
|
||
- [x] 13. 员工端前端页面
|
||
- [x] 13.1 实现绩效填报页面 `PerformanceForm`
|
||
- 自动带出考核月份、员工基础信息
|
||
- 17 项考核指标逐项填写（完成情况描述 + 自评分 + 可选佐证上传）
|
||
- 考勤数据填写区域、工作汇总文本区域、暂存和提交按钮
|
||
- _Requirements: 2.1, 2.2, 2.3, 2.4, 2.5, 2.6_
|
||
- [x] 13.2 实现个人绩效历史页面 `PerformanceHistory`
|
||
- 绩效记录列表（含状态、总分、等级），月份筛选和分页
|
||
- 点击查看详情（含 AI 评分、AI 问题/建议、审核意见、奖惩说明）
|
||
- _Requirements: 6.1, 6.2, 6.3, 6.4, 6.5_
|
||
|
||
- [x] 14. 管理层端前端页面
|
||
- [x] 14.1 实现下属绩效列表页面 `SubordinateList`
|
||
- 列表展示员工绩效状态，筛选条件（月份、部门、姓名、状态）
|
||
- _Requirements: 4.1, 7.1, 7.2_
|
||
- [x] 14.2 实现绩效审核页面 `PerformanceReview`
|
||
- 展示员工填报内容、自评分、AI 评分及 AI 反馈
|
||
- 可调整各考核项分数并填写说明，提交审核通过或驳回
|
||
- _Requirements: 4.2, 4.3, 4.4, 4.5, 4.6_
|
||
- [x] 14.3 实现团队统计页面 `TeamStatistics`
|
||
- 显示团队平均分、各等级人数及占比，Excel 导出按钮
|
||
- _Requirements: 7.3, 7.4, 7.5_
|
||
|
||
- [x] 15. 总经理端前端页面
|
||
- [x] 15.1 实现全公司绩效总览页面 `CompanyOverview`
|
||
- 各部门、各岗位绩效整体情况，ECharts 柱状图和饼图，多维度筛选
|
||
- _Requirements: 8.1, 8.2, 8.3_
|
||
- [x] 15.2 实现全量数据导出和考核规则配置页面
|
||
- 全量 Excel 导出，考核指标权重和奖惩金额配置表单
|
||
- _Requirements: 8.4, 8.5, 8.6_
|
||
|
||
- [x] 16. 最终检查点 — 确保所有测试通过，前后端联调完成，如有问题请告知
|
||
|
||
## 备注
|
||
|
||
- 标有 `*` 的任务为可选测试任务，可跳过以加快 MVP 交付
|
||
- 每个任务引用了具体的需求条目，便于追溯
|
||
- 检查点任务确保每个阶段的增量验证
|
||
- 属性测试使用 fast-check 库，每个属性最少运行 100 次迭代
|