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:
zlwuandCursor AI committed
1 parent
00297e714b
commit
90b13a6e0c
193 files changed
+2726
-409
No files matched your search
@@ -0,0 +1,92 @@
|
||||
# 安全保卫管理模块 - API接口
|
||||
|
||||
## 📋 模块说明
|
||||
- **模块名称**: 安全保卫管理 (Security Management)
|
||||
- **模块简称**: aqbw
|
||||
- **对应后端**: backend/ruoyi-modules/ruoyi-aqbw/
|
||||
- **对应前端**: web/src/views/aqbw/
|
||||
|
||||
## 📁 目录结构
|
||||
此目录用于存放安全保卫管理模块的所有API接口定义，建议按功能模块细分：
|
||||
|
||||
### 🔒 门禁管理 (access/)
|
||||
- `access/index.ts` - 门禁管理API
|
||||
- 门禁权限、进出记录、访客管理
|
||||
|
||||
### 📹 监控管理 (monitor/)
|
||||
- `monitor/index.ts` - 监控管理API
|
||||
- 监控设备、录像查看、异常报警
|
||||
|
||||
### 🚨 安全事件 (incident/)
|
||||
- `incident/index.ts` - 安全事件管理API
|
||||
- 事件报告、事件处理、应急预案
|
||||
|
||||
### 👮 安保人员 (security/)
|
||||
- `security/index.ts` - 安保人员管理API
|
||||
- 人员管理、值班安排、巡逻记录
|
||||
|
||||
### 🚗 车辆管理 (vehicle/)
|
||||
- `vehicle/index.ts` - 车辆管理API
|
||||
- 车辆登记、停车管理、违章处理
|
||||
|
||||
### 📊 统计分析 (statistics/)
|
||||
- `statistics/index.ts` - 安全统计分析API
|
||||
- 安全数据统计、事件分析、风险评估
|
||||
|
||||
## 🎯 API规范
|
||||
- 统一使用TypeScript定义接口类型
|
||||
- 请求路径前缀：`/aqbw/`
|
||||
- 权限编码格式：`aqbw:功能:操作`
|
||||
- 统一使用request工具发送请求
|
||||
- 安全相关接口需要特别的权限控制
|
||||
|
||||
## 📝 接口示例
|
||||
```typescript
|
||||
// 安全事件查询接口
|
||||
export interface SecurityIncidentQuery {
|
||||
pageNum?: number
|
||||
pageSize?: number
|
||||
incidentTitle?: string
|
||||
incidentType?: string
|
||||
severity?: string
|
||||
status?: string
|
||||
startDate?: string
|
||||
endDate?: string
|
||||
}
|
||||
|
||||
export interface SecurityIncidentVO {
|
||||
id: number
|
||||
incidentTitle: string
|
||||
incidentCode: string
|
||||
incidentType: string
|
||||
severity: string
|
||||
description: string
|
||||
location: string
|
||||
reporterId: number
|
||||
reporterName: string
|
||||
handleId?: number
|
||||
handlerName?: string
|
||||
status: string
|
||||
occurTime: string
|
||||
reportTime: string
|
||||
handleTime?: string
|
||||
createTime: string
|
||||
}
|
||||
|
||||
// 获取安全事件列表
|
||||
export function listSecurityIncident(query: SecurityIncidentQuery) {
|
||||
return request({
|
||||
url: '/aqbw/incident/list',
|
||||
method: 'get',
|
||||
params: query
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 注意事项
|
||||
- 所有接口类型定义需要与后端VO对象保持一致
|
||||
- 分页查询统一使用TableDataInfo响应格式
|
||||
- 非分页接口使用R类型响应格式
|
||||
- 安全相关数据需要严格的权限控制
|
||||
- 敏感操作需要详细的日志记录
|
||||
- 紧急事件处理接口需要考虑实时性
|
||||
@@ -0,0 +1,18 @@
|
||||
/**
|
||||
* 安全保卫管理模块 API
|
||||
* @author Cursor AI
|
||||
* @date 2025-01-23
|
||||
*/
|
||||
|
||||
import request from '@/utils/request'
|
||||
|
||||
// 此处导出安全保卫管理模块相关的所有API接口
|
||||
// 示例：
|
||||
// export * from './access' // 门禁管理
|
||||
// export * from './monitor' // 监控管理
|
||||
// export * from './incident' // 安全事件
|
||||
// export * from './security' // 安保人员
|
||||
// export * from './vehicle' // 车辆管理
|
||||
|
||||
// 临时导出一个空对象，防止编译错误
|
||||
export default {}
|
||||
@@ -0,0 +1,83 @@
|
||||
# 财务管理模块 - API接口
|
||||
|
||||
## 📋 模块说明
|
||||
- **模块名称**: 财务管理 (Financial Management)
|
||||
- **模块简称**: cw
|
||||
- **对应后端**: backend/ruoyi-modules/ruoyi-cw/
|
||||
- **对应前端**: web/src/views/cw/
|
||||
|
||||
## 📁 目录结构
|
||||
此目录用于存放财务管理模块的所有API接口定义，建议按功能模块细分：
|
||||
|
||||
### 💰 会计核算 (accounting/)
|
||||
- `accounting/index.ts` - 会计核算相关API
|
||||
- 科目管理、凭证管理、账簿管理
|
||||
|
||||
### 📊 预算管理 (budget/)
|
||||
- `budget/index.ts` - 预算管理API
|
||||
- 预算编制、预算执行、预算分析
|
||||
|
||||
### 💳 资产管理 (asset/)
|
||||
- `asset/index.ts` - 资产管理API
|
||||
- 固定资产、流动资产、资产盘点
|
||||
|
||||
### 💸 费用管理 (expense/)
|
||||
- `expense/index.ts` - 费用管理API
|
||||
- 费用申请、费用审批、费用报销
|
||||
|
||||
### 📈 财务报表 (report/)
|
||||
- `report/index.ts` - 财务报表API
|
||||
- 资产负债表、损益表、现金流量表
|
||||
|
||||
### 📊 统计分析 (statistics/)
|
||||
- `statistics/index.ts` - 财务统计分析API
|
||||
- 财务数据分析、成本分析、收支统计
|
||||
|
||||
## 🎯 API规范
|
||||
- 统一使用TypeScript定义接口类型
|
||||
- 请求路径前缀：`/cw/`
|
||||
- 权限编码格式：`cw:功能:操作`
|
||||
- 统一使用request工具发送请求
|
||||
- 金额字段统一使用number类型，保留2位小数
|
||||
|
||||
## 📝 接口示例
|
||||
```typescript
|
||||
// 预算查询接口
|
||||
export interface BudgetQuery {
|
||||
pageNum?: number
|
||||
pageSize?: number
|
||||
budgetName?: string
|
||||
budgetType?: string
|
||||
fiscalYear?: number
|
||||
status?: string
|
||||
}
|
||||
|
||||
export interface BudgetVO {
|
||||
id: number
|
||||
budgetName: string
|
||||
budgetCode: string
|
||||
budgetType: string
|
||||
fiscalYear: number
|
||||
totalAmount: number
|
||||
usedAmount: number
|
||||
remainingAmount: number
|
||||
status: string
|
||||
createTime: string
|
||||
}
|
||||
|
||||
// 获取预算列表
|
||||
export function listBudget(query: BudgetQuery) {
|
||||
return request({
|
||||
url: '/cw/budget/list',
|
||||
method: 'get',
|
||||
params: query
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 注意事项
|
||||
- 所有接口类型定义需要与后端VO对象保持一致
|
||||
- 分页查询统一使用TableDataInfo响应格式
|
||||
- 非分页接口使用R类型响应格式
|
||||
- 财务数据要特别注意精度和安全性
|
||||
- 金额计算避免使用浮点数运算
|
||||
@@ -0,0 +1,18 @@
|
||||
/**
|
||||
* 财务管理模块 API
|
||||
* @author Cursor AI
|
||||
* @date 2025-01-23
|
||||
*/
|
||||
|
||||
import request from '@/utils/request'
|
||||
|
||||
// 此处导出财务管理模块相关的所有API接口
|
||||
// 示例：
|
||||
// export * from './accounting' // 会计核算
|
||||
// export * from './budget' // 预算管理
|
||||
// export * from './asset' // 资产管理
|
||||
// export * from './expense' // 费用管理
|
||||
// export * from './report' // 财务报表
|
||||
|
||||
// 临时导出一个空对象，防止编译错误
|
||||
export default {}
|
||||
@@ -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 {}
|
||||
@@ -0,0 +1,91 @@
|
||||
# 学工管理模块 - API接口
|
||||
|
||||
## 📋 模块说明
|
||||
- **模块名称**: 学工管理 (Student Affairs Management)
|
||||
- **模块简称**: xg
|
||||
- **对应后端**: backend/ruoyi-modules/ruoyi-xg/
|
||||
- **对应前端**: web/src/views/xg/
|
||||
|
||||
## 📁 目录结构
|
||||
此目录用于存放学工管理模块的所有API接口定义，建议按功能模块细分：
|
||||
|
||||
### 👨🎓 学生管理 (student/)
|
||||
- `student/index.ts` - 学生信息管理API
|
||||
- 学生信息、学生档案、学生状态管理
|
||||
|
||||
### 🏠 宿舍管理 (dormitory/)
|
||||
- `dormitory/index.ts` - 宿舍管理API
|
||||
- 宿舍分配、宿舍检查、住宿费管理
|
||||
|
||||
### 🎓 班级管理 (class/)
|
||||
- `class/index.ts` - 班级管理API
|
||||
- 班级信息、班委管理、班级活动
|
||||
|
||||
### 💰 奖助管理 (scholarship/)
|
||||
- `scholarship/index.ts` - 奖助学金管理API
|
||||
- 奖学金、助学金、困难补助管理
|
||||
|
||||
### 📚 德育管理 (moral/)
|
||||
- `moral/index.ts` - 德育管理API
|
||||
- 德育评价、违纪处理、综合测评
|
||||
|
||||
### 🎯 活动管理 (activity/)
|
||||
- `activity/index.ts` - 活动管理API
|
||||
- 社团活动、文体活动、社会实践
|
||||
|
||||
### 📊 统计分析 (statistics/)
|
||||
- `statistics/index.ts` - 学工统计分析API
|
||||
- 学生数据统计、活动统计、综合分析
|
||||
|
||||
## 🎯 API规范
|
||||
- 统一使用TypeScript定义接口类型
|
||||
- 请求路径前缀：`/xg/`
|
||||
- 权限编码格式：`xg:功能:操作`
|
||||
- 统一使用request工具发送请求
|
||||
|
||||
## 📝 接口示例
|
||||
```typescript
|
||||
// 学生查询接口
|
||||
export interface StudentQuery {
|
||||
pageNum?: number
|
||||
pageSize?: number
|
||||
studentName?: string
|
||||
studentCode?: string
|
||||
classId?: number
|
||||
grade?: string
|
||||
status?: string
|
||||
}
|
||||
|
||||
export interface StudentVO {
|
||||
id: number
|
||||
studentName: string
|
||||
studentCode: string
|
||||
idCard: string
|
||||
classId: number
|
||||
className: string
|
||||
grade: string
|
||||
major: string
|
||||
phone: string
|
||||
email: string
|
||||
dormitoryId?: number
|
||||
dormitoryName?: string
|
||||
status: string
|
||||
createTime: string
|
||||
}
|
||||
|
||||
// 获取学生列表
|
||||
export function listStudent(query: StudentQuery) {
|
||||
return request({
|
||||
url: '/xg/student/list',
|
||||
method: 'get',
|
||||
params: query
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 注意事项
|
||||
- 所有接口类型定义需要与后端VO对象保持一致
|
||||
- 分页查询统一使用TableDataInfo响应格式
|
||||
- 非分页接口使用R类型响应格式
|
||||
- 学生个人信息需要严格的隐私保护
|
||||
- 敏感信息如身份证号需要脱敏处理
|
||||
@@ -0,0 +1,18 @@
|
||||
/**
|
||||
* 学工管理模块 API
|
||||
* @author Cursor AI
|
||||
* @date 2025-01-23
|
||||
*/
|
||||
|
||||
import request from '@/utils/request'
|
||||
|
||||
// 此处导出学工管理模块相关的所有API接口
|
||||
// 示例：
|
||||
// export * from './student' // 学生管理
|
||||
// export * from './dormitory' // 宿舍管理
|
||||
// export * from './class' // 班级管理
|
||||
// export * from './scholarship' // 奖助管理
|
||||
// export * from './activity' // 活动管理
|
||||
|
||||
// 临时导出一个空对象，防止编译错误
|
||||
export default {}
|
||||
@@ -0,0 +1,85 @@
|
||||
# 招生就业管理模块 - API接口
|
||||
|
||||
## 📋 模块说明
|
||||
- **模块名称**: 招生就业管理 (Enrollment & Employment Management)
|
||||
- **模块简称**: zsjy
|
||||
- **对应后端**: backend/ruoyi-modules/ruoyi-zsjy/
|
||||
- **对应前端**: web/src/views/zsjy/
|
||||
|
||||
## 📁 目录结构
|
||||
此目录用于存放招生就业管理模块的所有API接口定义，建议按功能模块细分：
|
||||
|
||||
### 📋 招生管理 (enrollment/)
|
||||
- `enrollment/index.ts` - 招生管理API
|
||||
- 招生计划、报名管理、考试安排、录取管理
|
||||
|
||||
### 💼 就业管理 (employment/)
|
||||
- `employment/index.ts` - 就业管理API
|
||||
- 就业信息发布、就业指导、就业跟踪
|
||||
|
||||
### 🏢 企业管理 (enterprise/)
|
||||
- `enterprise/index.ts` - 企业管理API
|
||||
- 合作企业、招聘信息、校企合作
|
||||
|
||||
### 🎯 职业规划 (career/)
|
||||
- `career/index.ts` - 职业规划API
|
||||
- 职业测评、简历管理、面试指导
|
||||
|
||||
### 🤝 校企合作 (cooperation/)
|
||||
- `cooperation/index.ts` - 校企合作API
|
||||
- 实习基地、合作项目、实习管理
|
||||
|
||||
### 📊 统计分析 (statistics/)
|
||||
- `statistics/index.ts` - 招生就业统计API
|
||||
- 招生统计、就业率统计、质量分析
|
||||
|
||||
## 🎯 API规范
|
||||
- 统一使用TypeScript定义接口类型
|
||||
- 请求路径前缀：`/zsjy/`
|
||||
- 权限编码格式：`zsjy:功能:操作`
|
||||
- 统一使用request工具发送请求
|
||||
|
||||
## 📝 接口示例
|
||||
```typescript
|
||||
// 招生计划查询接口
|
||||
export interface EnrollmentPlanQuery {
|
||||
pageNum?: number
|
||||
pageSize?: number
|
||||
planName?: string
|
||||
major?: string
|
||||
enrollmentYear?: number
|
||||
status?: string
|
||||
}
|
||||
|
||||
export interface EnrollmentPlanVO {
|
||||
id: number
|
||||
planName: string
|
||||
planCode: string
|
||||
major: string
|
||||
majorCode: string
|
||||
enrollmentYear: number
|
||||
plannedNumber: number
|
||||
actualNumber: number
|
||||
remainingNumber: number
|
||||
startDate: string
|
||||
endDate: string
|
||||
status: string
|
||||
createTime: string
|
||||
}
|
||||
|
||||
// 获取招生计划列表
|
||||
export function listEnrollmentPlan(query: EnrollmentPlanQuery) {
|
||||
return request({
|
||||
url: '/zsjy/enrollment/plan/list',
|
||||
method: 'get',
|
||||
params: query
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 注意事项
|
||||
- 所有接口类型定义需要与后端VO对象保持一致
|
||||
- 分页查询统一使用TableDataInfo响应格式
|
||||
- 非分页接口使用R类型响应格式
|
||||
- 招生和就业数据需要确保准确性和时效性
|
||||
- 学生和企业信息需要适当的隐私保护
|
||||
@@ -0,0 +1,18 @@
|
||||
/**
|
||||
* 招生就业管理模块 API
|
||||
* @author Cursor AI
|
||||
* @date 2025-01-23
|
||||
*/
|
||||
|
||||
import request from '@/utils/request'
|
||||
|
||||
// 此处导出招生就业管理模块相关的所有API接口
|
||||
// 示例：
|
||||
// export * from './enrollment' // 招生管理
|
||||
// export * from './employment' // 就业管理
|
||||
// export * from './enterprise' // 企业管理
|
||||
// export * from './career' // 职业规划
|
||||
// export * from './statistics' // 统计分析
|
||||
|
||||
// 临时导出一个空对象，防止编译错误
|
||||
export default {}
|
||||
Reference in new issue
Block a user