feat: 完善数据库表命名规范,新增后勤管理和系统公共模块前缀
📋 主要变更: - ✅ 补充完整的7个业务模块表命名规范 - ✅ 新增后勤管理模块:hq_ 前缀 - ✅ 明确系统公共模块:common_ 前缀 - ✅ 提供完整的命名示例和实体类映射规则 - ✅ 更新变更记录文档 🎯 覆盖模块: - 后勤管理(hq_)、人事管理(rs_)、财务管理(cw_) - 学工管理(xg_)、招生就业(zsjy_)、安全保卫(aqbw_) - 系统公共(common_) 📚 文件变更: - .cursor/cursorrules-backend.md - 数据库表命名规范 - docs/变更管理/code-adjust-record-2025-01-23-wuzilong.md - 变更记录 - 各业务模块工程文件和前端结构文件 Co-authored-by: Cursor AI <cursor@cursor.sh>
This commit is contained in:
1 parent
00297e714b
commit
90b13a6e0c
193 files changed
+2726
-409
No files matched your search
@@ -0,0 +1,78 @@
|
||||
# 人事管理模块 - API接口
|
||||
|
||||
## 📋 模块说明
|
||||
- **模块名称**: 人事管理 (Human Resources)
|
||||
- **模块简称**: rs
|
||||
- **对应后端**: backend/ruoyi-modules/ruoyi-rs/
|
||||
- **对应前端**: web/src/views/rs/
|
||||
|
||||
## 📁 目录结构
|
||||
此目录用于存放人事管理模块的所有API接口定义,建议按功能模块细分:
|
||||
|
||||
### 👥 员工管理 (employee/)
|
||||
- `employee/index.ts` - 员工信息相关API
|
||||
- 员工列表查询、详情、新增、修改、删除
|
||||
- 员工档案管理、入职离职流程
|
||||
|
||||
### 📊 部门管理 (department/)
|
||||
- `department/index.ts` - 部门组织架构API
|
||||
- 部门树形结构、部门信息管理
|
||||
|
||||
### 💼 岗位管理 (position/)
|
||||
- `position/index.ts` - 岗位职级管理API
|
||||
- 岗位信息、职级体系、岗位分配
|
||||
|
||||
### 💰 薪酬管理 (salary/)
|
||||
- `salary/index.ts` - 薪酬绩效管理API
|
||||
- 薪资结构、绩效考核、福利管理
|
||||
|
||||
### 📈 统计报表 (statistics/)
|
||||
- `statistics/index.ts` - 人事统计分析API
|
||||
- 人员统计、考勤分析、绩效报表
|
||||
|
||||
## 🎯 API规范
|
||||
- 统一使用TypeScript定义接口类型
|
||||
- 请求路径前缀:`/rs/`
|
||||
- 权限编码格式:`rs:功能:操作`
|
||||
- 统一使用request工具发送请求
|
||||
|
||||
## 📝 接口示例
|
||||
```typescript
|
||||
// 员工列表查询接口
|
||||
export interface EmployeeQuery {
|
||||
pageNum?: number
|
||||
pageSize?: number
|
||||
employeeName?: string
|
||||
departmentId?: number
|
||||
status?: string
|
||||
}
|
||||
|
||||
export interface EmployeeVO {
|
||||
id: number
|
||||
employeeName: string
|
||||
employeeCode: string
|
||||
departmentId: number
|
||||
departmentName: string
|
||||
positionId: number
|
||||
positionName: string
|
||||
phone: string
|
||||
email: string
|
||||
status: string
|
||||
createTime: string
|
||||
}
|
||||
|
||||
// 获取员工列表
|
||||
export function listEmployee(query: EmployeeQuery) {
|
||||
return request({
|
||||
url: '/rs/employee/list',
|
||||
method: 'get',
|
||||
params: query
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 注意事项
|
||||
- 所有接口类型定义需要与后端VO对象保持一致
|
||||
- 分页查询统一使用TableDataInfo响应格式
|
||||
- 非分页接口使用R类型响应格式
|
||||
- 人事敏感信息注意权限控制和数据脱敏
|
||||
@@ -0,0 +1,17 @@
|
||||
/**
|
||||
* 人事管理模块 API
|
||||
* @author Cursor AI
|
||||
* @date 2025-01-23
|
||||
*/
|
||||
|
||||
import request from '@/utils/request'
|
||||
|
||||
// 此处导出人事管理模块相关的所有API接口
|
||||
// 示例:
|
||||
// export * from './employee' // 员工管理
|
||||
// export * from './department' // 部门管理
|
||||
// export * from './position' // 岗位管理
|
||||
// export * from './salary' // 薪酬管理
|
||||
|
||||
// 临时导出一个空对象,防止编译错误
|
||||
export default {}
|
||||
Reference in new issue
Block a user