feat(backend): RBAC admin roles + runtime logs service

backend/app/api/admin_api.py

@@ -15,6 +15,7 @@
 # =============================================================================
 
 import logging
+from datetime import datetime
 from typing import Optional
 from uuid import UUID
 
@@ -895,12 +896,37 @@ async def get_agent_performance(
 async def get_system_logs(
     page: int = Query(1, ge=1, description="页码"),
     page_size: int = Query(50, ge=1, le=200, description="每页条数"),
+    config_key: Optional[str] = Query(None, description="按配置键精确筛选"),
+    changed_by: Optional[str] = Query(None, description="按操作人 agent_id 精确筛选"),
+    from_time: Optional[datetime] = Query(None, alias="from", description="变更时间起始(ISO8601, 闭区间)"),
+    to_time: Optional[datetime] = Query(None, alias="to", description="变更时间截止(ISO8601, 闭区间)"),
     admin: Agent = Depends(require_admin),
     db: AsyncSession = Depends(get_db),
 ):
-    """获取系统日志（配置变更日志）。"""
-    result = await admin_service.get_system_logs(db, page=page, page_size=page_size)
-    return success_response(data=result)# ---------- GET /api/admin/integrations/lianruan/terminals/{devname}/detail ----------
+    """获取系统日志（配置变更日志），支持配置键/操作人/时间范围筛选。
+
+    Args:
+        config_key: 按配置键精确匹配（可选）
+        changed_by: 按操作人 agent_id 精确匹配（可选）
+        from_time: 变更时间起始（别名 from，可选）
+        to_time: 变更时间截止（别名 to，可选）
+
+    Returns:
+        Dict: 统一响应格式，包含筛选后的配置变更日志
+    """
+    result = await admin_service.get_system_logs(
+        db,
+        page=page,
+        page_size=page_size,
+        config_key=config_key,
+        changed_by=changed_by,
+        from_time=from_time,
+        to_time=to_time,
+    )
+    return success_response(data=result)
+
+
+# ---------- GET /api/admin/integrations/lianruan/terminals/{devname}/detail ----------
 @router.get("/integrations/lianruan/terminals/{devname}/detail")
 async def get_lianruan_terminal_detail(
     devname: str,