API 服务目录结构
📁 优化后的目录结构
根据菜单模块聚合优化,API 服务按照以下结构组织:
api/
├── work/ # 工作管理模块
│ ├── apply_records_server.js # 投递记录 API
│ └── job_postings_server.js # 岗位信息 API
├── profile/ # 账号简历模块
│ ├── pla_account_server.js # 平台账号 API
│ └── resume_info_server.js # 简历信息 API
├── device/ # 设备监控模块
│ └── device_status_server.js # 设备状态 API
├── operation/ # 任务聊天模块
│ ├── task_status_server.js # 任务状态 API
│ └── chat_records_server.js # 聊天记录 API
└── system/ # 系统设置模块
└── system_config_server.js # 系统配置 API
🔄 模块映射关系
| 新模块 | 原模块 | 说明 |
|---|---|---|
work/ |
job/ |
工作管理 = 岗位 + 投递 |
profile/ |
account/ |
账号简历 = 账号 + 简历 |
device/ |
device/ |
设备监控(保持不变) |
operation/ |
task/ + chat/ |
任务聊天 = 任务 + 聊天 |
system/ |
system/ |
系统设置(保持不变) |
📝 API 服务文件说明
1. work/apply_records_server.js
投递记录 API 服务
page(param)- 分页查询投递记录getStatistics()- 获取投递统计数据getById(id)- 获取单条记录详情del(row)- 删除投递记录batchDelete(ids)- 批量删除
2. work/job_postings_server.js
岗位信息 API 服务
page(param)- 分页查询岗位信息getStatistics()- 获取岗位统计数据getById(id)- 获取单条岗位详情del(row)- 删除岗位信息batchDelete(ids)- 批量删除
3. profile/pla_account_server.js
平台账号 API 服务
page(param)- 分页查询平台账号getStatistics()- 获取账号统计数据getById(id)- 获取单条账号详情update(row)- 更新账号信息del(row)- 删除账号
4. profile/resume_info_server.js
简历信息 API 服务
page(param)- 分页查询简历信息getStatistics()- 获取简历统计数据getById(id)- 获取单条简历详情del(row)- 删除简历
5. device/device_status_server.js
设备状态 API 服务
page(param)- 分页查询设备状态getOverview()- 获取设备概览统计updateConfig(data)- 更新设备配置resetError(deviceSn)- 重置设备错误del(row)- 删除设备记录
6. operation/task_status_server.js
任务状态 API 服务
page(param)- 分页查询任务状态getStatistics()- 获取任务统计数据getById(id)- 获取单条任务详情update(row)- 更新任务状态del(row)- 删除任务
7. operation/chat_records_server.js
聊天记录 API 服务
page(param)- 分页查询聊天记录getStatistics()- 获取聊天统计数据getById(id)- 获取单条聊天详情del(row)- 删除聊天记录
8. system/system_config_server.js
系统配置 API 服务
page(param)- 分页查询系统配置getCategories()- 获取配置分类列表get(key)- 获取单条配置详情add(data)- 添加配置update(row)- 更新配置batchUpdate(configs)- 批量更新配置del(row)- 删除配置reset(key)- 重置配置为默认值
🎯 使用示例
// 导入 API 服务
import applyRecordsServer from '@/api/work/apply_records_server'
import deviceStatusServer from '@/api/device/device_status_server'
// 查询投递记录
const result = await applyRecordsServer.page({
seachOption: { applyStatus: 'success' },
pageOption: { page: 1, pageSize: 20 }
})
// 获取设备概览
const overview = await deviceStatusServer.getOverview()
📌 注意事项
- 所有 API 服务都已配置为调用
/admin_api/*路径的后端接口 - 使用
window.framework.http进行 HTTP 请求 - 分页查询统一使用
page(param)方法,参数包含seachOption和pageOption - 所有服务类都已实例化并导出,可直接使用
✅ 迁移完成
- ✅ 所有 API 服务文件已按新目录结构创建
- ✅ 所有接口路径已更新为
/admin_api/*格式 - ✅ 目录结构与 SQL 菜单定义保持一致