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

90 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
16337
7e729d3841 修复：企微通知摄像头名称从 WVP 查询，不再显示 cam_xxx 编码 2026-03-19 14:44:39 +08:00
16337
b1b2d78aa3 修复：区域查询地址独立于工单配置，支持 IOT_PLATFORM_URL 环境变量 
区域名称查询不再依赖 WORK_ORDER_BASE_URL，
优先使用 IOT_PLATFORM_URL，降级用工单地址。
 2026-03-19 14:36:30 +08:00
16337
bd24165c58 修复：区域名称缓存加 5 分钟 TTL，改名后自动生效 2026-03-19 14:18:29 +08:00
16337
26ae14f37c 功能：CameraNameService 优先使用 cameraName 字段显示摄像头名称 
format_display_name 优先取 camera_name（用户自定义），
没有则降级到原有的 gbName/app 提取逻辑。
 2026-03-19 11:35:23 +08:00
16337
03082a5934 优化：企微通知时间只显示 MM-DD HH:MM，去掉年份和秒 2026-03-19 11:13:02 +08:00
16337
aaf175b129 修复：告警通知显示真实区域名称，从 IoT 平台查询 area_id 对应的 areaName 
- edge_compat 上报时传入 area_id 到通知流水线
- notify_dispatch 优先从 IoT 平台 API 查区域名（带缓存+token缓存）
- 演示模式下如果已有真实区域名则不覆盖为"演示区域"
 2026-03-19 11:08:33 +08:00
16337
2765525cbc 安全：.env.example 补充工单对接、WVP 地址、群聊 ID 等配置项 2026-03-19 10:35:18 +08:00
16337
6993ef4f2a 修复：群聊图片发送后延迟1秒再发文字，确保消息顺序正确 2026-03-19 10:01:46 +08:00
16337
e14450edbc 优化：企微群聊通知从3条精简为2条 + 卡片跳转详情页 
群聊通知改为：
1. image 截图（可点击放大查看）
2. markdown 告警详情 + @人员（不再重复发图）

私发卡片 card_action.url 改为跳转前端告警详情页
news 图文卡片去除默认企微官网链接

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-19 09:21:45 +08:00
16337
a3797e7508 性能：看板数据合并为单次请求 + 摄像头名称缓存 
- 新增 GET /alert/dashboard 聚合接口，一次返回全部看板数据
- 共用同一个 DB session 执行所有查询，减少连接开销
- 摄像头名称服务增加 5 分钟内存缓存，避免重复查询 WVP
- 设备Top10 和最近告警共用一次批量摄像头名称查询

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 17:31:18 +08:00
16337
6d68e2d9c0 修复：平均响应时间排除 handled_at 早于 event_time 的异常数据 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 17:20:04 +08:00
16337
67bd8881fa 功能：新增看板统计接口（趋势、设备Top、时段分布） 
- GET /alert/trend?days=7 — 按天+按类型的告警趋势
- GET /alert/device-top?limit=10&days=7 — 告警最多设备排行
- GET /alert/hour-distribution?days=7 — 24小时告警分布
- 扩展 statistics 接口：增加 todayCount/yesterdayCount/pendingCount/
  handledCount/avgResponseMinutes 字段

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 17:06:08 +08:00
16337
3b64db7029 文档：告警数据看板设计方案 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 17:01:09 +08:00
16337
b1dd75e7c8 文档：添加工单体系设计方案和数据库 Schema 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 16:41:02 +08:00
16337
dd86da5bcd 功能：告警级别体系统一为 0紧急/1重要/2普通/3轻微 
更新 API 接口、Schema 验证、报告生成、企微通知的级别映射，
与前端和边缘端保持一致。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 16:39:16 +08:00
16337
44c5df7302 功能：area_id 存储 + 工单对接代码完善 + 心跳端点 
- AlarmEvent 模型添加 area_id 字段
- create_from_edge_report 提取 ext_data.area_id 存储
- 心跳端点 POST /api/ai/device/heartbeat
- work_order_client: create_order 支持完整参数（description/priority/triggerSource/cameraId/imageUrl）
- notify_dispatch: 工单标题中文化、alarmType 中文映射、永久 COS URL、triggerSource 来源判断
- oss_storage: 新增 get_permanent_url 方法
- 工单创建测试脚本

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 16:05:05 +08:00
16337
ab338a509c 功能：VLM提示词和告警级别支持车辆违停/拥堵算法 
- vlm_service.py: 新增illegal_parking和vehicle_congestion VLM复核提示词模板
- alarm_event_service.py: 新增违停告警级别逻辑(按停留时长分级)和拥堵告警级别
- wechat_service.py: ALARM_TYPE_NAMES新增车辆违停/拥堵中文映射

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-16 16:54:48 +08:00
16337
c2c272c298 fix: response_code持久化到数据库 + 工单客户端加tenant-id 
1. wechat_service: save/get_response_code 改为内存+数据库双写，
   容器重启后边缘resolve仍能更新企微卡片
2. work_order_client: 请求头加 tenant-id，签名公式加 query_str 参数
3. config: WorkOrderConfig 新增 tenant_id 字段

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-13 13:37:34 +08:00
16337
2a9bf7d575 fix: 卡片终态改用button.replace_name，不重绘整张卡片 
- 终态更新改用 button.replace_name 方式，仅替换按钮文案为不可点击状态
- 原卡片告警信息保持不变，不再重绘整张卡片
- step2 处理中状态 desc_color 改为蓝色(1)表示进行中
- 边缘自动结单：用发送时保存的response_code直接更新卡片（72h有效）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-13 10:23:51 +08:00
16337
f7a69892f6 fix: 注释工单对接代码，修复API响应解析和类型问题 
- 工单创建/自动结单代码全部注释，待本地测试后启用
- 修复create_order响应解析：data直接是orderId，非嵌套对象
- 修复areaId类型：int（文档要求），非str
- 修复auto-complete orderId类型：int
- 两步卡片状态机和先到先得逻辑保留生效

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-12 18:20:30 +08:00
16337
6cbf89a38b feat: 两步卡片状态机 + 安保工单对接 + 先到先得结单 
- 新增 work_order_client.py：SHA256签名的工单API客户端（创建/自动结单）
- 企微卡片改为两步交互：确认接单→[已处理完成/标记误报]→终态
- 告警通知后自动创建工单，orderId存入alarm_event_ext
- 边缘端resolve支持先到先得：终态不可被覆盖
- 边缘端resolve后异步触发工单自动结单+卡片终态更新
- 新增WorkOrderConfig配置项

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-12 16:34:54 +08:00
16337
d2085f73be fix: 群聊@人员改用markdown消息，解决他人看到原始userid问题 
appchat text消息的<@userid>语法对非本人显示为原始文本，
改用markdown消息类型发送@提醒

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-12 14:37:52 +08:00
16337
149e9da59b fix: news图文消息url字段必填，添加默认值 
企微appchat/send的news消息类型要求url必填，否则报errcode 41010

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 22:16:24 +08:00
16337
dd1419303c feat: 企微通知改为原生组合消息，移除H5页面 
- 群聊：image截图 + news图文卡片 + @人员text 组合推送
- 个人：button_interaction模板卡片（前往处理/误报忽略）
- 新增媒体上传能力（upload_media），支持从COS URL下载后上传企微
- 新增群聊配置 WECHAT_GROUP_CHAT_ID
- 删除 alarm_detail.html H5页面及相关接口
- 清理 wechat_callback.py 移除旧的H5回调和群聊测试接口

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 17:43:58 +08:00
16337
9c5c18fb65 fix: 更新卡片时补充 main_title 字段，修复 errcode 41016 
企微更新模板卡片接口要求包含 main_title，否则报 missing title 错误。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 14:50:55 +08:00
16337
c36488c6e6 feat: 企微卡片升级为原生按钮交互型模板卡片 
1. wechat_service.py:
   - send_alarm_card 从 textcard 升级为 button_interaction 模板卡片
   - 卡片直接在对话框展示告警信息 + 操作按钮（前往处理/误报忽略）
   - 新增 update_alarm_card 方法：点击按钮后更新卡片状态（按钮变灰）
   - 保留群聊消息能力（create_group_chat/send_group_text）

2. wechat_callback.py:
   - 回调支持 template_card_event 按钮点击事件
   - 按钮点击自动更新告警状态（handle→HANDLING, ignore→IGNORED）
   - 通过 response_code 更新卡片按钮为已处理状态
   - H5 详情页 snapshot_url 增加 COS key→预签名URL 转换
   - 新增群聊创建和群聊发卡片的测试接口

3. vlm_service.py:
   - VLM 降级策略统一放行（所有类型 confirmed=True）
   - 避免 VLM 不可用时离岗告警无法推送

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 14:36:58 +08:00
16337
78e0076f4a fix: 优化VLM提示词，输出更简洁，传入算法类型和区域名称 
- prompt要求≤15字直接说结论，不再描述画面
- 加入算法类型中文名（离岗/周界入侵）让VLM更准确判断
- roi_name改为查询区域名称，不再传UUID
- 给出告警成立和误报的示例引导输出格式

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-10 10:32:50 +08:00
16337
26f1512a1c feat: 新建工单体系三表（security_work_order/security_user/work_order_log） 
- SecurityWorkOrder: 安保工单表，关联alarm_event一对一，支持告警生成和手动创建
  含派发人信息冗余（责任追溯）、告警合并索引
- SecurityUser: 安保人员表，含企微uid、角色、班组
- WorkOrderLog: 工单操作记录，追踪CREATE/DISPATCH/ACCEPT/FINISH/CLOSE

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-10 09:24:24 +08:00
16337
9143022ee8 fix: 区分误报(IGNORED)和自动结单(DONE)状态 
- VLM误报和手动忽略的handle_status改为IGNORED
- 自动结单(resolve_alarm)检查IGNORED状态，不覆盖误报
- 前端忽略操作兼容转换时自动设置handleStatus=IGNORED

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-10 09:12:14 +08:00
16337
10b25742f8 fix: 剩余服务文件时间统一为北京时间 
- agent_dispatcher、alert_service、report_generator、
  oss_storage、work_order_service 全部使用 beijing_now()
- 全局无遗留 UTC 时间调用

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 16:29:28 +08:00
16337
766ee6a69a fix: 统一所有服务时间为北京时间 + 处理/忽略时计算告警时长 
- notify_dispatch: _mark_false_alarm 使用 beijing_now() + 计算 duration_ms
- alarm_event_service: handle_alarm 处理时自动计算 duration_ms 和 last_frame_time
- notification_service: datetime.utcnow() 替换为 beijing_now()
- device_service: datetime.now(timezone.utc) 替换为 beijing_now()

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 16:27:30 +08:00
16337
1585abf843 fix: alarm_event_service 时间统一为北京时间 
- 所有 datetime.now(timezone.utc) 替换为 beijing_now()
- 保持与边缘端上报时间（北京时间）一致

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 16:25:31 +08:00
16337
b1b96a3ebc fix: 统一数据库时间为北京时间（UTC+8） 
- 新增 app/utils/timezone.py 提供 beijing_now() 工具函数
- models.py 所有表的 created_at/updated_at 默认值从 UTC 改为北京时间
- 解决 event_time（边缘端北京时间）与 handled_at（服务端UTC）差8小时的问题

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 16:23:05 +08:00
16337
24c94ccfbe refactor: 移除企微Webhook机器人代码，修复VLM日志 
- 删除 wechat_service.send_webhook_alarm 方法
- 删除 config.py 中 webhook_url 配置
- 简化 notify_dispatch 通知逻辑（仅保留应用消息）
- 修复 vlm_service 使用项目统一 logger
- 添加 VLM 调用 URL 调试日志

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 15:35:32 +08:00
16337
0fbc1ca7a0 fix: VLM复核前将COS object key转为预签名URL 
snapshot_url存储的是COS对象路径而非完整URL，
VLM无法直接访问，需先生成预签名URL。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 12:58:27 +08:00
16337
d5550d8904 fix: VLM降级跳过时不再自动标记告警为误报 
VLM调用失败(skipped=true)和VLM判定误报是两种情况，
降级跳过时保留告警原始状态，让人工处理。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 12:52:05 +08:00
16337
840bb0e720 feat: 添加企微群机器人Webhook推送（无需IP白名单） 
- wechat_service 新增 send_webhook_alarm 方法（markdown格式）
- notify_dispatch 优先使用Webhook，失败降级到应用消息
- config 新增 WECHAT_WEBHOOK_URL 配置项

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 12:31:55 +08:00
16337
ce5272413b fix: 修复通知日志不可见问题 
- notify_dispatch/agent_dispatcher 改用主logger(alert_platform)
- edge_compat 异常不再静默吞掉，输出错误日志

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 11:22:06 +08:00
16337
7cc4f604d0 feat: 交互Agent + VLM优化 + 企微演示模式 
- 新增交互Agent调度器（意图识别 + 工单/查询/报表/闲聊4个Handler）
- 新增工单服务、Excel报表生成器、企微消息加解密模块
- VLM提示词优化（角色设定、≤25字描述、布尔值优先输出）
- VLM降级策略（入侵默认放行、离岗默认拦截）
- 企微演示模式（WECHAT_TEST_UIDS兜底 + SERVICE_BASE_URL修复）
- 新增Agent回调路由和测试接口

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-09 10:42:32 +08:00
16337
1d84456c0f feat: 重写H5告警详情页，实现状态感知的交互设计 
- 待处理: 显示3个按钮(前往处理/已处理/误报忽略)
- 处理中: 显示2个按钮(已处理/误报忽略)
- 已处理/已忽略/自动关闭: 隐藏按钮，显示结果条
- 添加确认弹窗防止误操作
- 优化移动端显示(word-break, 圆角等)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-06 14:18:01 +08:00
16337
5b00fd0464 feat: 添加告警详情H5页面，企微卡片点击可查看详情并操作 
- 新增 H5 告警详情页面（截图+信息+3个操作按钮）
- 企微卡片"查看详情"跳转到 H5 页面
- 操作按钮改为：前往处理/已处理/误报忽略
- 新增 alarm_detail API 供 H5 页面获取告警+VLM分析数据
- 挂载 /static 目录提供 H5 页面访问
 2026-03-06 13:43:55 +08:00
16337
35386b8e6e feat: V1 VLM复核 + 企微通知 + 手动结单 
- 新增3张通知路由表模型（notify_area, camera_area_binding, area_person_binding）
- 新增VLM复核服务，通过qwen3-vl-flash对告警截图二次确认
- 新增企微通知服务，告警确认后推送文本卡片给责任人
- 新增通知调度服务，编排VLM复核→查表路由→企微推送流水线
- 新增企微回调接口，支持手动结单/确认处理/标记误报
- 新增通知管理API，区域/摄像头绑定/人员绑定CRUD
- 告警上报主流程（edge_compat + yudao_aiot_alarm）接入异步通知
- 扩展配置项支持VLM和企微环境变量
- 添加openai==1.68.0依赖（通过DashScope兼容端点调用）
 2026-03-06 13:35:40 +08:00
16337
09e0dbbc38 docs: 添加 VLM 验证 + 企微通知 V1 实施计划 
包含 9 个任务的详细实施计划：
- 数据库表设计（通知区域、摄像头绑定、人员绑定）
- VLM 视觉验证服务
- 企微通知服务
- 告警主流程集成
- 通知管理 API
 2026-03-06 11:14:57 +08:00
16337
b14ac9eea7 文档：更新 CLAUDE.md 反映生产环境部署 
主要更新：
- 添加生产部署信息（容器名称、端口、部署位置）
- 更新 Docker 部署命令（反映真实的 vsp-service 容器）
- 数据库从 SQLite 改为腾讯云 MySQL
- 补充关键接口说明（边缘端上报、前端访问、WebSocket）
- 移除过时的 MQTT 相关说明
- 强调使用 python -m app.main 作为入口

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-03-05 16:26:27 +08:00
16337
94ad8d8045 fix(aiot): COS 未启用时 get_url 返回空字符串而非裸 object_key 
修复告警截图显示为损坏图片的根因：
- get_url() 保证返回值为 http(s) URL 或空字符串
- _init() 捕获 COS 初始化异常，优雅降级而非崩溃

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-02 14:21:11 +08:00
16337
51dbad6794 fix: 告警列表500错误修复 + 摄像头查询容错 + COS认证重构 
- 添加缺失的 import httpx（修复 _notify_ops_platform NameError）
- 摄像头批量查询加 try/except 容错，失败时降级使用 device_id
- 摄像头查询超时从 5 秒提升到 15 秒
- COS 存储重构：支持 CVM 角色认证 + 密钥认证双模式
- STS 接口改为返回提示（CVM 模式不支持 STS）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-02 13:33:28 +08:00
16337
9cee0a2cac fix: 添加 pymysql 依赖 + Edge 兼容路由 
- requirements.txt 添加 pymysql、cos-python-sdk-v5
- 新增 /api/ai/alert/edge/report 和 /edge/resolve 路由（无认证）
- 使 Edge 设备可直接上报到 FastAPI 服务

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-02 13:18:35 +08:00
16337
f81cc81ce6 refactor(service): 删除MQTT旧代码 + 修复边缘节点重复显示问题 
**删除MQTT旧代码：**
- 删除 mqtt_service.py（已废弃的空壳）
- 从 config.py 删除 MQTTConfig 类和相关配置
- 从 schemas.py 删除 mqtt 字段
- 从 alert_service.py 删除 create_alert_from_mqtt 方法
- 告警上报已改为 HTTP + COS 方案，MQTT机制完全废弃

**修复边缘节点重复显示（方案A）：**
- 清理 edge_devices 表历史数据（删除 edge_device_001、edge_inference_device）
- 禁用 DeviceService 的 handle_heartbeat 自动创建设备功能
- 边缘端未实现心跳机制，告警数从 alarm_event 表统计
- 运行时长、处理帧数字段设为 null（无心跳机制，不可用）
- 添加 count_alarms_by_edge_node 方法统计边缘节点告警数

**影响范围：**
- /admin-api/aiot/edge/device/page 接口返回数据调整
- /admin-api/aiot/edge/device/get 接口返回数据调整
- 确保不破坏现有功能（告警上报已改为HTTP）
 2026-02-25 10:30:01 +08:00
16337
3bac8be70e fix(alarm): 添加intrusion_cleared自动关闭处理 
- resolve_alarm方法支持intrusion_cleared类型
- 自动标记为CLOSED状态，备注"入侵消失自动关闭（持续无人180秒）"
- 与person_returned和non_work_time保持一致
 2026-02-25 09:26:52 +08:00
16337
a927388388 fix(alarm): 修复告警详情接口500错误 
- 更新 get_alert 接口调用 _alarm_to_camel 的参数
- 使用 camera_info_map 替代 name_map
- 正确传递 camera_service 参数
 2026-02-24 16:24:42 +08:00