zlwuandCursor AI
90b13a6e0c
📋 主要变更： - ✅ 补充完整的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>
安全保卫管理模块 - 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工具发送请求
- 安全相关接口需要特别的权限控制
📝 接口示例
// 安全事件查询接口
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类型响应格式
- 安全相关数据需要严格的权限控制
- 敏感操作需要详细的日志记录
- 紧急事件处理接口需要考虑实时性