0. 【前置分析】统一返回{code,msg,data}
功能说明
入住、人员、车辆、工单、投诉、值班分析
关联任务
- 关联前端任务：[前端] 中控大屏前端开发
- 关联测试任务：[测试-后端] 全量接口测试
接口1：房屋入住分析
| 请求方式 | GET |
| 请求路径 | /api/v1/ops/occupancy |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| range | string | 否 | 时间范围 | 筛选 |
响应字段
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| occupancyRate | number | 当前入住率 | 指标 |
| vacancyTrend | array | 空置率趋势 | 图表 |
接口2：人员分析
| 请求方式 | GET |
| 请求路径 | /api/v1/ops/personnel |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| range | string | 否 | 统计周期 | 筛选 |
响应字段
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| historyResidents | array | 历史住户 | 折线 |
| currentDist | array | 当前人员类型分布 | 饼图 |
| abnormalStats | array | 历史异常行为 | 图表 |
接口3：车辆分析
| 请求方式 | GET |
| 请求路径 | /api/v1/ops/vehicles |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| range | string | 否 | 统计周期 | 筛选 |
响应字段
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| inOutStats | array | 进出统计 | 折线 |
| typeDist | array | 类型占比 | 饼图 |
| abnormal | array | 异常记录 | 表格 |
接口4：工单分析
| 请求方式 | GET |
| 请求路径 | /api/v1/ops/workorders |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| category | string | 否 | 户内/公区 | 筛选 |
| status | string | 否 | 最新/全部 | 切换 |
响应字段
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| stats | array | 类型分布 | 图表 |
| latest | array | 最新工单 | 列表 |
接口5：投诉分析
| 请求方式 | GET |
| 请求路径 | /api/v1/ops/complaints |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| category | string | 否 | 投诉分类 | 筛选 |
响应字段
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| aiSummary | array | AI归纳 | 展示 |
| ranking | array | 数量排名 | 图表 |
| latest | array | 最新投诉 | 列表 |
接口6：值班管理
| 请求方式 | GET |
| 请求路径 | /api/v1/ops/duty |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| date | string | 否 | 查询日期 | 日期选择 |
响应字段
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| schedule | array | 排班 | 表格 |
| status | array | 在岗/离岗/异常 | 状态展示 |
| history | array | 历史记录 | 查询 |