iot-device-management-service/app/routers/yudao_aiot_alarm.py

"""
AIoT 告警路由 - 芋道规范（新三表结构）

统一到 /admin-api/aiot/alarm 命名空间，与 aiot 平台架构对齐。

API 路径规范：
    - /admin-api/aiot/alarm/alert/page - 分页查询
    - /admin-api/aiot/alarm/alert/get - 获取详情
    - /admin-api/aiot/alarm/alert/handle - 处理告警
    - /admin-api/aiot/alarm/alert/delete - 删除告警
    - /admin-api/aiot/alarm/alert/statistics - 获取统计
    - /admin-api/aiot/alarm/device-summary/page - 设备告警汇总
"""

from fastapi import APIRouter, Query, Depends, HTTPException
from typing import Optional
from datetime import datetime

from app.yudao_compat import YudaoResponse, get_current_user
from app.services.alarm_event_service import get_alarm_event_service, AlarmEventService
from app.services.notification_service import get_notification_service
from app.services.oss_storage import get_oss_storage
from app.schemas import EdgeAlarmReport

router = APIRouter(prefix="/admin-api/aiot/alarm", tags=["AIoT-告警"])


def _alarm_to_camel(alarm_dict: dict) -> dict:
    """将 alarm_event 字典转换为前端 camelCase 格式"""
    # snapshot_url: 如果是 COS object_key，转为预签名 URL
    storage = get_oss_storage()
    snapshot_url = alarm_dict.get("snapshot_url")
    if snapshot_url:
        snapshot_url = storage.get_url(snapshot_url)

    return {
        "alarmId": alarm_dict.get("alarm_id"),
        "alarmType": alarm_dict.get("alarm_type"),
        "alarmTypeName": _get_alarm_type_name(alarm_dict.get("alarm_type")),
        "algorithmCode": alarm_dict.get("algorithm_code"),
        "deviceId": alarm_dict.get("device_id"),
        "deviceName": alarm_dict.get("device_id"),
        "sceneId": alarm_dict.get("scene_id"),
        "eventTime": alarm_dict.get("event_time"),
        "firstFrameTime": alarm_dict.get("first_frame_time"),
        "lastFrameTime": alarm_dict.get("last_frame_time"),
        "durationMs": alarm_dict.get("duration_ms"),
        "alarmLevel": alarm_dict.get("alarm_level"),
        "confidenceScore": alarm_dict.get("confidence_score"),
        "alarmStatus": alarm_dict.get("alarm_status"),
        "handleStatus": alarm_dict.get("handle_status"),
        "snapshotUrl": snapshot_url,
        "videoUrl": alarm_dict.get("video_url"),
        "edgeNodeId": alarm_dict.get("edge_node_id"),
        "handler": alarm_dict.get("handler"),
        "handleRemark": alarm_dict.get("handle_remark"),
        "handledAt": alarm_dict.get("handled_at"),
        "createdAt": alarm_dict.get("created_at"),
        "updatedAt": alarm_dict.get("updated_at"),
        # 扩展数据（详情时可能包含）
        "ext": alarm_dict.get("ext"),
        "llmAnalyses": alarm_dict.get("llm_analyses"),
    }


# ==================== 告警管理 ====================

@router.get("/alert/page")
async def get_alert_page(
    pageNo: int = Query(1, ge=1, description="页码"),
    pageSize: int = Query(20, ge=1, le=100, description="每页大小"),
    deviceId: Optional[str] = Query(None, description="摄像头/设备ID"),
    edgeNodeId: Optional[str] = Query(None, description="边缘节点ID"),
    alarmType: Optional[str] = Query(None, description="告警类型"),
    alarmStatus: Optional[str] = Query(None, description="告警状态: NEW/CONFIRMED/FALSE/CLOSED"),
    alarmLevel: Optional[int] = Query(None, description="告警级别: 1提醒/2一般/3严重/4紧急"),
    startTime: Optional[datetime] = Query(None, description="开始时间"),
    endTime: Optional[datetime] = Query(None, description="结束时间"),
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user)
):
    """分页查询告警列表"""
    alarms, total = service.get_alarms(
        device_id=deviceId,
        alarm_type=alarmType,
        alarm_status=alarmStatus,
        alarm_level=alarmLevel,
        edge_node_id=edgeNodeId,
        start_time=startTime,
        end_time=endTime,
        page=pageNo,
        page_size=pageSize,
    )

    alarm_list = [_alarm_to_camel(a.to_dict()) for a in alarms]

    return YudaoResponse.page(
        list_data=alarm_list,
        total=total,
        page_no=pageNo,
        page_size=pageSize
    )


@router.get("/alert/get")
async def get_alert(
    alarmId: str = Query(..., description="告警ID"),
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user)
):
    """获取告警详情"""
    alarm_dict = service.get_alarm(alarmId)
    if not alarm_dict:
        raise HTTPException(status_code=404, detail="告警不存在")

    return YudaoResponse.success(_alarm_to_camel(alarm_dict))


@router.put("/alert/handle")
async def handle_alert(
    alarmId: str = Query(..., description="告警ID"),
    alarmStatus: Optional[str] = Query(None, description="告警状态: CONFIRMED/FALSE/CLOSED"),
    handleStatus: Optional[str] = Query(None, description="处理状态: HANDLING/DONE"),
    remark: Optional[str] = Query(None, description="处理备注"),
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user)
):
    """处理告警"""
    handler = current_user.get("username", "admin")

    alarm = service.handle_alarm(
        alarm_id=alarmId,
        alarm_status=alarmStatus,
        handle_status=handleStatus,
        remark=remark,
        handler=handler,
    )
    if not alarm:
        raise HTTPException(status_code=404, detail="告警不存在")

    return YudaoResponse.success(True)


@router.delete("/alert/delete")
async def delete_alert(
    alarmId: str = Query(..., description="告警ID"),
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user)
):
    """删除告警"""
    success = service.delete_alarm(alarmId)
    if not success:
        raise HTTPException(status_code=404, detail="告警不存在")

    return YudaoResponse.success(True)


@router.get("/alert/statistics")
async def get_statistics(
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user)
):
    """获取告警统计"""
    stats = service.get_statistics()

    return YudaoResponse.success(stats)


# ==================== 设备告警汇总 ====================

@router.get("/device-summary/page")
async def get_device_summary_page(
    pageNo: int = Query(1, ge=1, description="页码"),
    pageSize: int = Query(20, ge=1, le=100, description="每页大小"),
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user)
):
    """获取设备告警汇总（分页）"""
    result = service.get_device_summary(page=pageNo, page_size=pageSize)

    return YudaoResponse.page(
        list_data=result.get("list", []),
        total=result.get("total", 0),
        page_no=pageNo,
        page_size=pageSize
    )


# ==================== 边缘端告警上报 ====================

@router.post("/edge/report")
async def edge_alarm_report(
    report: EdgeAlarmReport,
    service: AlarmEventService = Depends(get_alarm_event_service),
    current_user: dict = Depends(get_current_user),
):
    """
    边缘端告警上报接口

    边缘设备通过 HTTP POST 上报告警元数据，截图已预先上传到 COS。
    支持幂等：通过 alarm_id 判断是否已存在。
    """
    alarm = service.create_from_edge_report(report.model_dump())

    if alarm is None:
        return YudaoResponse.error(500, "告警创建失败")

    # WebSocket 通知
    try:
        notification_svc = get_notification_service()
        notification_svc.notify_sync("new_alert", alarm.to_dict())
    except Exception:
        pass  # WebSocket 通知失败不影响主流程

    return YudaoResponse.success({
        "alarmId": alarm.alarm_id,
        "created": True,
    })


# ==================== 辅助函数 ====================

def _get_alarm_type_name(alarm_type: Optional[str]) -> str:
    """获取告警类型名称"""
    type_names = {
        "leave_post": "离岗检测",
        "intrusion": "周界入侵",
        "crowd": "人群聚集",
        "fire": "火焰检测",
        "smoke": "烟雾检测",
        "fall": "跌倒检测",
        "helmet": "安全帽检测",
        "unknown": "未知类型",
    }
    return type_names.get(alarm_type, alarm_type or "未知类型")