feat: 新增按国家/地区分组的统计功能

- 后端: 添加 device_region_stats 和 image_region_stats API，支持按地区GROUP BY统计
- 前端: 在用户设备列表和检测历史页面添加国家分布统计条，显示Top10国家占比
- 支持点击国家行进行筛选

api_routes.py

@@ -80,6 +80,8 @@ from database import (
     upsert_device_record,
     fetch_user_devices,
     count_user_devices,
+    fetch_device_region_stats,
+    fetch_image_region_stats,
     clean_debug_data,
     fetch_all,
 )
@@ -535,6 +537,8 @@ from models import (
     CelebrityMatchResponse,
     CategoryStatsResponse,
     CategoryStatItem,
+    RegionStatsResponse,
+    RegionStatItem,
     UserDeviceItem,
     UserDeviceListResponse,
 )
@@ -2320,6 +2324,60 @@ async def list_user_devices(
         raise HTTPException(status_code=500, detail=str(e))
 
 
+@api_router.get("/device_region_stats", response_model=RegionStatsResponse, tags=["用户设备列表"])
+async def get_device_region_stats():
+    """查询用户设备按国家/地区分组的统计信息"""
+    try:
+        rows = await fetch_device_region_stats()
+        stats: List[RegionStatItem] = []
+        for row in rows:
+            region_code = str(row.get("region") or "")
+            region_country = get_country_name_by_region_code(region_code) if region_code else "未知地区"
+            stats.append(RegionStatItem(
+                region=region_code,
+                region_country=region_country,
+                count=int(row.get("count", 0) or 0),
+            ))
+        total = sum(item.count for item in stats)
+        return RegionStatsResponse(stats=stats, total=total)
+    except Exception as e:
+        logger.error(f"Failed to get device region stats: {str(e)}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@api_router.post("/image_region_stats", response_model=RegionStatsResponse, tags=["图片记录"])
+async def get_image_region_stats(
+    category: Optional[str] = Query(None, description="类别筛选"),
+    nickname: Optional[str] = Query(None, description="昵称筛选"),
+    region: Optional[str] = Query(None, description="地区筛选"),
+    platform: Optional[str] = Query(None, description="平台筛选"),
+    is_cropped_face: Optional[int] = Query(None, description="是否裁剪人脸"),
+):
+    """查询图片记录按国家/地区分组的统计信息"""
+    try:
+        rows = await fetch_image_region_stats(
+            category=category,
+            nickname=nickname,
+            region=region,
+            platform=platform,
+            is_cropped_face=is_cropped_face,
+        )
+        stats: List[RegionStatItem] = []
+        for row in rows:
+            region_code = str(row.get("region") or "")
+            region_country = get_country_name_by_region_code(region_code) if region_code else "未知地区"
+            stats.append(RegionStatItem(
+                region=region_code,
+                region_country=region_country,
+                count=int(row.get("count", 0) or 0),
+            ))
+        total = sum(item.count for item in stats)
+        return RegionStatsResponse(stats=stats, total=total)
+    except Exception as e:
+        logger.error(f"Failed to get image region stats: {str(e)}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
 @api_router.post("/clean_debug_data", tags=["系统维护"])
 async def clean_debug_data_api():
     """清理调试数据接口"""

database.py

@@ -496,6 +496,64 @@ async def count_user_devices(
     return int(rows[0].get("total", 0) or 0)
 
 
+async def fetch_device_region_stats() -> List[Dict[str, Any]]:
+    """统计用户设备按地区分组的数量"""
+    query = """
+        SELECT
+            COALESCE(region, '') AS region,
+            COUNT(*) AS count
+        FROM tpl_app_user_devices
+        GROUP BY COALESCE(region, '')
+        ORDER BY count DESC
+    """
+    return await fetch_all(query)
+
+
+async def fetch_image_region_stats(
+    *,
+    category: Optional[str],
+    nickname: Optional[str],
+    region: Optional[str] = None,
+    platform: Optional[str] = None,
+    is_cropped_face: Optional[int] = None,
+) -> List[Dict[str, Any]]:
+    """统计图片记录按地区分组的数量"""
+    where_clauses: List[str] = []
+    params: List[Any] = []
+    if category and category != "all":
+        where_clauses.append("category = %s")
+        params.append(category)
+    if nickname:
+        where_clauses.append("nickname LIKE %s")
+        params.append(f"{nickname}%")
+    if platform == "android":
+        where_clauses.append("nickname LIKE %s")
+        params.append("android%")
+    elif platform == "ios":
+        where_clauses.append("nickname LIKE %s")
+        params.append("ios%")
+    elif platform == "miniprogram":
+        where_clauses.append("region = %s")
+        params.append("")
+    if region:
+        where_clauses.append("region = %s")
+        params.append(region)
+    if is_cropped_face is not None:
+        where_clauses.append("is_cropped_face = %s")
+        params.append(is_cropped_face)
+    where_sql = f"WHERE {' AND '.join(where_clauses)}" if where_clauses else ""
+    query = f"""
+        SELECT
+            COALESCE(region, '') AS region,
+            COUNT(*) AS count
+        FROM tpl_app_processed_images
+        {where_sql}
+        GROUP BY COALESCE(region, '')
+        ORDER BY count DESC
+    """
+    return await fetch_all(query, params)
+
+
 async def record_image_creation(
     *,
     file_path: str,

models.py

@@ -74,6 +74,17 @@ class CategoryStatsResponse(BaseModel):
   total: int
 
 
+class RegionStatItem(BaseModel):
+    region: str
+    region_country: str
+    count: int
+
+
+class RegionStatsResponse(BaseModel):
+    stats: List[RegionStatItem]
+    total: int
+
+
 class UserDeviceItem(BaseModel):
     device_id: str
     device_type: Optional[str] = None