feat(calls): 微信语音列表加今日统计卡片+通话时间范围筛选+客户跳转带通话时间定位(对齐云客)

- GET /api/calls/stats:今日(Asia/Shanghai)好友呼入/外呼量+群量+时长聚合(@chatroom判群)
- CallList:5张统计卡片(仅微信语音tab)+datetimerange筛选(服务端start/end)+viewCallCustomer带?start定位
- TDD新增stats聚合测试,全量绿

Co-Authored-By: Claude <noreply@anthropic.com>

yunke-server/app/api/routers/calls.py

@@ -9,6 +9,7 @@ Ordered by ``start_call_time desc`` (nulls last) — most recent calls first.
 
 from __future__ import annotations
 
+import datetime as dt
 from typing import Annotated, Literal
 
 import sqlalchemy as sa
@@ -16,7 +17,7 @@ from fastapi import APIRouter, Depends, Query
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.api.deps import get_session
-from app.api.schemas import Page, PhoneCallOut
+from app.api.schemas import CallStatsOut, Page, PhoneCallOut
 from app.db.models import PhoneCall
 
 router = APIRouter(prefix="/api", tags=["calls"])
@@ -26,6 +27,42 @@ PageParam = Annotated[int, Query(ge=1)]
 PageSizeParam = Annotated[int, Query(ge=1, le=100)]
 
 
+@router.get("/calls/stats")
+async def call_stats(session: SessionDep) -> CallStatsOut:
+    """今日(Asia/Shanghai)微信语音统计卡片 — 对齐云客语音列表顶部。
+
+    好友/群按 ``call_number`` 是否以 ``@chatroom`` 结尾(与 ``scope`` 同判据,
+    与云客 isRoom 实测等价);呼入/出按 ``incoming_call``(1=呼入/0=呼出,
+    None 不计)。
+    """
+    # Asia/Shanghai (UTC+8) 的今日 00:00 → ms epoch,与 /api/sessions 的
+    # today_start 同一约定(部署时区无关)
+    shanghai_now = dt.datetime.now(dt.UTC) + dt.timedelta(hours=8)
+    shanghai_midnight = shanghai_now.replace(hour=0, minute=0, second=0, microsecond=0)
+    today_start_ms = int((shanghai_midnight - dt.timedelta(hours=8)).timestamp() * 1000)
+
+    is_room = PhoneCall.call_number.endswith("@chatroom")
+    base = [PhoneCall.channel == "voice_call", PhoneCall.start_call_time >= today_start_ms]
+
+    async def _count(*extra) -> int:
+        stmt = sa.select(sa.func.count()).select_from(PhoneCall).where(*base, *extra)
+        return (await session.execute(stmt)).scalar_one()
+
+    async def _duration(*extra) -> int:
+        stmt = sa.select(sa.func.coalesce(sa.func.sum(PhoneCall.call_duration), 0)).where(*base, *extra)
+        return (await session.execute(stmt)).scalar_one()
+
+    friend = ~is_room
+    return CallStatsOut(
+        friend_incoming=await _count(friend, PhoneCall.incoming_call == 1),
+        friend_outgoing=await _count(friend, PhoneCall.incoming_call == 0),
+        group_count=await _count(is_room),
+        friend_incoming_duration=await _duration(friend, PhoneCall.incoming_call == 1),
+        friend_outgoing_duration=await _duration(friend, PhoneCall.incoming_call == 0),
+        group_duration=await _duration(is_room),
+    )
+
+
 @router.get("/calls")
 async def list_calls(
     session: SessionDep,

yunke-server/app/api/schemas.py

@@ -194,6 +194,20 @@ class GroupMemberOut(BaseModel):
     avatar: str | None = None
 
 
+class CallStatsOut(BaseModel):
+    """今日微信语音统计卡片(GET /api/calls/stats,对齐云客语音列表顶部)。
+
+    好友呼入/外呼量与时长、群语音量与群录音时长;时长单位秒(call_duration 累加)。
+    """
+
+    friend_incoming: int
+    friend_outgoing: int
+    group_count: int
+    friend_incoming_duration: int
+    friend_outgoing_duration: int
+    group_duration: int
+
+
 class PhoneCallOut(BaseModel):
     """Phone / voice call record. ``channel`` is the call-type.