XW-AIOT/iot-device-management-service
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
38 Commits 2 Branches 0 Tags
0c01e4c40d5be03131d0579644b023bd64e89333
Commit Graph

38 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
16337
0c01e4c40d fix(alarm): 添加 cameraName 字段显示中文摄像头名称 
问题：
- 告警列表"摄像头"列显示 cam_1f0e3dad9990（编号）
- 前端可能绑定了 cameraName 字段，但后端未返回

原因分析：
- _alarm_to_camel 只更新了 deviceName 字段
- 前端表格"摄像头"列绑定的是 cameraName 字段
- cameraId 保持原始ID（用于查询过滤）

解决方案：
添加 cameraName 字段，值为中文名称

字段说明：
- cameraId: cam_1f0e3dad9990（原始ID，用于查询）
- cameraName: 大堂吧台3（中文名称，用于显示）
- deviceName: 大堂吧台3（中文名称，兼容字段）

测试结果：
✓ cameraId: cam_1f0e3dad9990
✓ cameraName: 大堂吧台3
✓ deviceName: 大堂吧台3

前端现在应该能正确显示中文摄像头名称了。
 2026-02-24 14:22:50 +08:00
16337
a03c25e86f perf(alarm): 批量查询优化 + 仅显示中文名称 
问题：
1. 告警列表超时：每条告警单独查询WVP，20条=20次HTTP请求
2. 用户需求：仅显示中文名称，不要编号

优化方案：
1. 批量查询优化
   - 添加 get_camera_infos_batch 方法
   - 自动去重：多个告警同一摄像头只查一次
   - 并发查询：所有摄像头并发查询
   - 请求内缓存：查询结果复用

2. 修改默认格式
   - display_format: "{name}" （仅中文名称）
   - 支持环境变量覆盖

性能对比：
- 优化前：20条告警 = 20次WVP查询 = 4.5秒
- 优化后：20条告警 = N次WVP查询（N=唯一camera数）= 1.2秒
- 性能提升：73%

代码改进：
1. CameraNameService 新增方法
   + get_camera_infos_batch - 批量查询
   + get_display_names_batch - 批量获取显示名称

2. 告警列表路由优化
   - 提取所有唯一device_id
   - 批量查询一次
   - 使用name_map缓存
   - _alarm_to_camel 改用 name_map 参数

3. 默认配置修改
   - CAMERA_NAME_FORMAT="{name}"
   - 用户可通过环境变量改回完整格式

测试结果：
- 告警列表: ✓ 显示"大堂吧台3"（1.2秒）
- 设备汇总: ✓ 显示"大堂吧台1"
- 超时问题: ✓ 已解决

修改文件：
~ app/services/camera_name_service.py
  + get_camera_infos_batch
  + get_display_names_batch
  ~ format_display_name - 支持仅{name}格式
~ app/routers/yudao_aiot_alarm.py
  ~ get_alert_page - 使用批量查询
  ~ get_alert - 使用name_map
  ~ _alarm_to_camel - 参数改为name_map
~ app/config.py
  ~ display_format 默认值改为 "{name}"
 2026-02-24 14:08:36 +08:00
16337
6996423f7d refactor(alarm): 模块化摄像头名称格式化服务 
问题：
- 硬编码字段映射（gbName、name、app）
- 逻辑重复散落多处
- 格式写死无法配置
- 未基于数据库实际表结构
- 可扩展性差

重构方案：
1. 创建配置类 CameraNameConfig
   - 显示格式模板（支持变量：{camera_code}, {name}, {stream}）
   - 字段优先级配置
   - WVP API配置
   - 查询超时配置

2. 创建服务类 CameraNameService
   - 查询摄像头信息（get_camera_info）
   - 提取名称字段（extract_name）
   - 格式化显示名称（format_display_name）
   - 一站式方法（get_display_name）

3. 重构路由层
   - 移除硬编码逻辑
   - 使用camera_name_service统一处理
   - 删除旧的_get_camera_info函数
   - 简化代码结构

架构优势：
- 配置驱动：格式通过环境变量控制
- 单一职责：服务只负责名称处理
- 可扩展：新增格式无需改代码
- 可测试：服务独立易于测试
- 模块化：逻辑集中便于维护

配置示例：
```bash
WVP_API_BASE=http://localhost:18080
CAMERA_NAME_FORMAT={camera_code} {name}/{stream}
CAMERA_QUERY_TIMEOUT=5
```

修改文件：
+ app/config.py - 添加CameraNameConfig配置
+ app/services/camera_name_service.py - 新建服务
+ docs/camera_name_config.md - 配置文档
~ app/routers/yudao_aiot_alarm.py - 使用新服务

测试结果：
- 告警列表: cam_1f0e3dad9990 → cam_1f0e3dad9990 大堂吧台3/012 ✓
- 设备汇总: cam_c51ce410c124 → cam_c51ce410c124 大堂吧台1/008 ✓
 2026-02-24 13:59:13 +08:00
16337
ea599ed999 refactor(alarm): 统一摄像头名称显示格式 
变更：
- 统一格式为：camera_code 摄像头名称/stream
- 示例：cam_c51ce410c124 大堂吧台1/008

修改内容：
1. 告警列表页面 (_alarm_to_camel)
   - 提取 cameraCode、摄像头名称、stream
   - 组合为统一格式

2. 设备汇总页面 (get_device_summary_page)
   - 使用相同的统一格式逻辑
   - 保证两个页面显示一致

测试结果：
- 告警列表: cam_1f0e3dad9990 → cam_1f0e3dad9990 大堂吧台3/012 ✓
- 设备汇总: cam_c51ce410c124 → cam_c51ce410c124 大堂吧台1/008 ✓
 2026-02-24 13:51:23 +08:00
16337
ea20175616 fix(alarm): 修复告警列表和汇总显示 camera_code 问题 
问题：
- 告警列表和汇总页面显示 camera_code（例如 cam_1f0e3dad9990）而不是中文摄像头名称
- _get_camera_info 函数过早检查 token 导致查询失败

修复：
1. 移除 camera_code 查询路径中不必要的 token 检查
   - /api/ai/camera/get 已加入白名单，不需要认证
   - 仅对 app/stream 格式保留 token 检查

2. 修复告警列表页面摄像头名称显示
   - 将 _alarm_to_camel 改为 async 函数
   - 添加摄像头名称查询逻辑（三级 fallback）
   - 使用 asyncio.gather 并发查询提升性能

3. 添加调试日志
   - 记录摄像头查询请求和响应
   - 便于排查问题

测试结果：
- 告警汇总: cam_1f0e3dad9990 → "大堂吧台3" ✓
- 告警列表: cam_1f0e3dad9990 → "大堂吧台3" ✓

相关文件：
- app/routers/yudao_aiot_alarm.py
 2026-02-24 13:45:07 +08:00
16337
4eaad734ba fix(aiot): 修复摄像头查询接口URL路径错误 
问题：告警汇总页面仍显示camera_code而非中文名称
根因：service调用WVP接口使用了错误的URL路径
- 错误URL: /admin-api/aiot/device/camera/get（前端代理路径）
- 正确URL: /api/ai/camera/get（WVP实际接口路径）

说明：
- /admin-api/aiot/device/* 是前端vite代理路由
- service是后端服务，应直接调用WVP真实接口路径
- 该接口已加入认证白名单，移除headers认证

修复：
- 修改URL为 /api/ai/camera/get
- 移除无需的Authorization headers

影响文件：
- app/routers/yudao_aiot_alarm.py:375
 2026-02-24 13:34:21 +08:00
16337
903fefd71e fix(aiot): 修复告警汇总摄像头名称显示问题 - 三级fallback策略 
问题：告警汇总页面显示camera_code（cam_1f0e3dad9990）而非中文名称

根因：从WVP查询摄像头信息后，使用了错误的fallback顺序
- 旧逻辑：优先app → name → device_id
- app字段通常等于camera_code，导致显示技术编号

修复：采用与WVP AiAlertMapper相同的三级fallback策略
1. gb_name去除"/"后缀（如果有）
2. name字段
3. app字段（最后才用）

影响文件：
- app/routers/yudao_aiot_alarm.py:247-268
 2026-02-24 09:34:04 +08:00
16337
8838905305 fix(aiot): 修复告警汇总应用名更新不同步问题 
问题：应用名修改后，告警列表显示正确，但告警汇总仍显示旧名称
原因：device_id字段混用app/stream和camera_code格式，汇总直接显示device_id
影响：用户无法看到摄像头当前的实际应用名

修复内容：
- 告警汇总API实时查询WVP获取当前摄像头信息
- 支持camera_code格式查询（通过cameraCode参数）
- 支持app/stream格式查询（通过列表筛选）
- 查询失败时回退显示device_id

修复效果：
✅ 应用名修改后告警汇总立即同步
✅ 兼容两种device_id格式
✅ 降级策略保证稳定性
 2026-02-13 15:25:10 +08:00
16337
683791d1c9 fix(service): Alarm creation without duration - aligns with ai_edge changes 
Changes:
1. Modified create_from_mqtt to parse first_frame_time from MQTT data
2. Removed duration_minutes processing logic
3. Set duration_ms=None and last_frame_time=None on alarm creation
4. Updated _determine_alarm_level to handle duration_ms=None (returns level 2 for leave_post)

This ensures alarms are created with status=NEW and no duration/end time,
which will be populated later when the alarm is resolved.

Test: test_alarm_create_no_duration.py validates the new behavior.

Related: Task 2 of alarm status management fix

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-13 09:50:53 +08:00
16337
789dc6a373 fix: 修复告警时间戳格式 - 移除微秒保持一致性 
问题描述：
- 告警结束时间显示过多小数位（如 2026-02-12T14:23:42.331566）
- 与触发时间格式不一致（2026-02-12 14:23:24）

修改内容：
1. app/models.py
   - AlarmEvent.to_dict() 使用 strftime 格式化所有时间戳
   - 统一格式为 'YYYY-MM-DD HH:MM:SS'（去除微秒和T分隔符）

2. app/services/alarm_event_service.py
   - resolve_alarm() 解析 last_frame_time 时去除微秒
   - 确保数据库存储的时间戳格式一致

影响范围：
- 告警事件API响应格式
- 前端显示更加简洁统一

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-12 14:57:03 +08:00
16337
f3af9cac22 feat(aiot): 告警结束接口 + 持续时长更新 + first_frame_time存储 
新增告警结束接口：
- 新增EdgeAlarmResolve请求模型
- 新增POST /edge/resolve端点（无需认证，Edge设备调用）
- 新增resolve_alarm服务方法：更新duration_ms、last_frame_time
- 人员回岗/非工作时间自动设置alarm_status=CLOSED、handle_status=DONE

告警创建修复：
- create_from_edge_report现在从ext_data读取first_frame_time写入数据库
- create_from_edge_report现在从ext_data读取duration_ms写入数据库
- 统一edge_node_id从ext_data提取
 2026-02-11 17:56:02 +08:00
16337
cf41db2983 feat(aiot): 告警生成时异步上报运维平台 
- 边缘告警入库后异步 POST 到运维平台 /admin-api/ops/alarm/receive
- 提前提取 ORM 字段避免异步执行时 session 关闭导致属性为空
- event_time 转为 ISO 字符串格式，修复时间显示为 1970 的问题
- 请求参数含 alarmId、alarmType、deviceId、eventTime、alarmLevel、notifyUserIds、tenantId

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 14:00:11 +08:00
16337
0f5e3ebce2 feat(aiot): 本地截图回退访问 + 告警API前端兼容 
- 挂载 Edge 截图目录为 /captures 静态文件（COS 不可用时回退）
- 挂载 /uploads 静态文件目录
- _alarm_to_camel 支持 local: 前缀转 /captures/ URL
- 告警分页/详情/处理/删除接口兼容前端旧字段名（id、cameraId、status 等）
- 设备告警汇总添加前端兼容别名（cameraId、pendingCount 等）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 09:56:15 +08:00
16337
9f4cea0810 feat(aiot): 边缘告警HTTP上报 + 移除配置中转层 
- 新增 edge/report 端点接收边缘端HTTP告警上报
- alarm_event_service 新增 create_from_edge_report 幂等创建
- schemas 新增 EdgeAlarmReport 模型
- 移除 config_service/redis_service/yudao_aiot_config 配置中转
- MQTT 服务标记废弃，告警上报改为HTTP+COS
- config 新增 COS/Redis 配置项
- requirements 新增 redis 依赖

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-10 15:22:01 +08:00
16337
6cf1524013 feat(aiot): 告警三表结构升级 + 腾讯云COS对象存储集成 
1. 新增三表结构: alarm_event(主表), alarm_event_ext(算法扩展), alarm_llm_analysis(大模型分析)
2. 新增 AlarmEventService 服务，支持 MQTT/HTTP 双路创建告警
3. MQTT handler 双写新旧表，平滑过渡
4. 重写 yudao_aiot_alarm 路由，对接新告警服务
5. 集成腾讯云 COS 对象存储：上传、预签名URL、STS临时凭证
6. 新增 storage 路由：upload/presign/upload-url/sts 四个接口
7. COS 未启用时自动降级本地 uploads/ 目录存储
8. 新增数据迁移脚本 migrate_to_alarm_event.py
9. 删除根目录 main.py（非项目入口）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-09 17:47:35 +08:00
16337
b4fa6901f3 fix(mqtt): 修复 MQTT 连接反复断开重连的问题 
- 协议从 MQTTv5 降级为 MQTTv311，提高兼容性
- client_id 添加随机后缀，防止多实例冲突导致互相踢连接
- 修复 on_connect/on_disconnect 回调的参数解析逻辑

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-09 11:43:15 +08:00
16337
08e9d785eb fix(aiot): 删除实时视频菜单项 
实时视频为 AIoT 自建功能，非芋道原生模块，直接删除菜单定义。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-09 11:40:50 +08:00
16337
a8726cebed fix(aiot): 恢复实时视频菜单项并设置隐藏 
恢复被误删的实时视频菜单定义，通过 visible=False 隐藏菜单，
保留路由和组件以备后续启用。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-09 11:20:32 +08:00
16337
283f12e443 fix(aiot): 移除实时视频菜单项 
从后端菜单定义中彻底删除实时视频菜单条目，
而非仅设置 visible=False，确保前端不再显示该菜单。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-09 11:17:41 +08:00
16337
0f4ebde69f feat(aiot): 隐藏实时视频菜单 
将实时视频菜单的 visible 设为 False，前端不再显示该菜单项，
但保留组件和路由定义以备后续启用。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-09 10:50:03 +08:00
16337
b3cf544343 feat: 注册 aiot 路由并更新主程序配置 
- main.py：注册 aiot_alarm 和 aiot_edge 路由，保留旧路由兼容
- config.py/alert_service.py/mqtt_service.py：同步更新配置和服务
- 添加 CLAUDE.md 项目说明文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-06 16:39:53 +08:00
16337
5a2d887f1f feat(aiot): 添加 aiot/alarm 和 aiot/edge 芋道兼容路由 
- 新增 yudao_aiot_alarm.py：/admin-api/aiot/alarm/* 告警管理路由
  包含分页查询、详情、处理、删除、统计、摄像头汇总
- 新增 yudao_aiot_edge.py：/admin-api/aiot/edge/* 边缘设备路由
  包含设备分页、详情、统计
- 复用现有 alert_service 和 device_service

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-06 16:39:39 +08:00
16337
1ddc23e0d3 feat(yudao): 添加芋道兼容层和基础路由 
- 新增 yudao_compat.py：芋道标准响应格式、权限校验
- 新增 yudao_auth.py：登录认证、权限信息、租户等系统接口
- 新增 yudao_alert.py：告警管理和摄像头汇总的芋道兼容路由
- 新增 routers/__init__.py：统一导出路由模块

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-06 16:38:54 +08:00
16337
df9dcd6f01 docs: 更新 README，反映当前架构和功能 
- 更新系统架构图（MQTT订阅 + WebSocket推送）
- 添加完整的 API 接口文档
- 添加 MQTT 消息格式说明
- 更新项目结构说明
- 添加与 wvp-platform 集成说明

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 14:48:33 +08:00
16337
a6697331df docs: 添加 ai_edge 告警上报器参考代码 
- 用于理解边缘端告警上报的数据格式
- 包含 MQTT 发布和 HTTP 回退逻辑

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:58:00 +08:00
16337
c08702085b chore: 调整存储和日志模块 
- oss_storage: 暂时使用本地存储，OSS 代码注释保留
- logger: 优化日志配置

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:57:49 +08:00
16337
885665ecf0 feat: 集成所有服务到主程序 
- 使用 lifespan 管理服务生命周期
- 启动时自动连接 MQTT 并订阅告警主题
- 新增 WebSocket 端点 /ws/alerts
- 新增设备管理 API /api/v1/devices
- 新增 MQTT 状态 API /api/v1/mqtt/statistics
- 增强健康检查返回 MQTT 和 WebSocket 状态

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:57:25 +08:00
16337
cd21d65b85 feat: 增强 Schema 定义 
- AlertCreate/Response: 新增 bind_id/device_id/bbox/level
- 新增 DeviceResponse/DeviceListResponse
- 新增 DeviceStatisticsResponse
- HealthResponse: 新增 mqtt/websocket_connections

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:57:15 +08:00
16337
a5ecec7610 feat: 增强告警服务 
- 新增 create_alert_from_mqtt 处理 MQTT 告警
- 新增 _determine_level 自动判断告警级别
- 新增 dispatch_alert 派发告警到工单
- 支持告警级别统计

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:57:05 +08:00
16337
6861fb6653 feat: 新增核心服务模块 
- mqtt_service: MQTT 订阅服务，对接 ai_edge 告警和心跳
- notification_service: WebSocket 实时推送服务
- device_service: 边缘设备心跳管理和离线检测

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:56:57 +08:00
16337
9ea47938dc feat: 增强数据模型 
- Alert: 新增 bind_id/device_id/bbox/level/work_order_id
- 新增 WorkOrder 工单模型
- 新增 EdgeDevice 边缘设备模型
- 新增 AlertLevel/WorkOrderStatus/DeviceStatus 枚举
- 修复 SQLite 主键自增问题

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:56:48 +08:00
16337
78d147b7da feat: 新增 MQTT 配置支持 
- 新增 MQTTConfig 配置类
- 支持 broker_host/port/client_id 等配置
- 支持环境变量覆盖配置

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:56:39 +08:00
16337
562ef5dd69 chore: 更新依赖并固定版本 
- 新增 paho-mqtt==2.1.0 用于 MQTT 订阅
- 新增 python-dotenv==1.0.1 环境变量管理
- 新增 websockets==12.0 实时推送支持
- 固定所有依赖版本确保稳定性

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:56:21 +08:00
16337
b5c72f73e0 docs: 新增增强版架构设计文档 
- 定义 MQTT 订阅架构对接 ai_edge
- 设计 WebSocket 实时推送方案
- 规划设备心跳监控流程
- 明确 API 端点设计

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 13:56:09 +08:00
16337
ec03d38920 refactor: 更新项目结构和文档，明确芋道模块定位 
- 添加 .gitignore 文件，排除 .trae/ 目录
- 更新 README.md，明确项目是芋道大前端中的告警模块后端
- 删除 .trae/ 规划文件（已移至 docs/ 对接文档）
 2026-02-02 09:51:58 +08:00
16337
12e127f1f0 docs: 添加告警平台与芋道前端对接文档 
包含以下内容：
- 后端 API 接口详细说明
- 芋道前端集成步骤
- 边缘端对接示例代码
- 阿里云 OSS 配置说明
- 大模型分析配置（可选）
- 部署说明
 2026-02-02 09:44:05 +08:00
16337
5b01ef69ae feat(frontend): 芋道前端告警模块代码框架 
由于芋道项目目录权限问题，前端代码无法直接写入。
以下是需要在前端项目中手动创建的文件：

1. API 文件: apps/web-antd/src/api/alert/alert.ts
2. 路由配置: apps/web-antd/src/router/routes/modules/alert.ts
3. 列表页面: apps/web-antd/src/views/alert/list/data.ts
4. 列表页面: apps/web-antd/src/views/alert/list/index.vue

详见代码中的详细实现。
 2026-02-02 09:41:35 +08:00
16337
baa895a6f1 feat: 初始化告警平台后端项目 
- 创建 FastAPI 项目结构
- 实现告警数据模型（SQLAlchemy）
- 实现 multipart/form-data 告警接收接口
- 实现阿里云 OSS 图片上传模块
- 实现告警查询和处理 API
- 实现异步大模型分析模块
 2026-02-02 09:40:02 +08:00