"""GET /api/calls — phone-call / voice-call log list. Read-only query over the mirrored ``phone_call`` table. ``channel`` here is the **call-type** in {``phone_call``, ``voice_call``} (calls are not tied to a messaging channel). Filters: ``channel``, ``user_id``, and a ms-epoch ``[start, end]`` window compared against ``start_call_time`` (inclusive). 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 from fastapi import APIRouter, Depends, Query from sqlalchemy.ext.asyncio import AsyncSession from app.api.deps import get_session from app.api.schemas import CallStatsOut, Page, PhoneCallOut from app.db.models import PhoneCall router = APIRouter(prefix="/api", tags=["calls"]) SessionDep = Annotated[AsyncSession, Depends(get_session)] 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, page: PageParam = 1, page_size: PageSizeParam = 20, channel: Annotated[str | None, Query()] = None, user_id: Annotated[str | None, Query()] = None, start: Annotated[int | None, Query(ge=0)] = None, end: Annotated[int | None, Query(ge=0)] = None, scope: Annotated[Literal["friend", "group"] | None, Query()] = None, ) -> Page[PhoneCallOut]: """List phone/voice calls with optional filters, newest first. ``scope`` filters voice calls by peer kind: ``group`` keeps only group calls (``call_number`` ends ``@chatroom``), ``friend`` excludes them — verified exactly equivalent to the CRM's ``isRoom`` flag (2026-08-18). """ conditions = [] if channel is not None: conditions.append(PhoneCall.channel == channel) if user_id is not None: conditions.append(PhoneCall.user_id == user_id) if scope is not None: is_room = PhoneCall.call_number.endswith("@chatroom") conditions.append(is_room if scope == "group" else ~is_room) if start is not None: conditions.append(PhoneCall.start_call_time >= start) if end is not None: conditions.append(PhoneCall.start_call_time <= end) total_stmt = sa.select(sa.func.count()).select_from(PhoneCall) if conditions: total_stmt = total_stmt.where(*conditions) total = (await session.execute(total_stmt)).scalar_one() list_stmt = sa.select(PhoneCall) if conditions: list_stmt = list_stmt.where(*conditions) list_stmt = ( list_stmt.order_by( sa.nullslast(PhoneCall.start_call_time.desc()), PhoneCall.call_id.asc(), ) .limit(page_size) .offset((page - 1) * page_size) ) rows = (await session.execute(list_stmt)).scalars().all() items = [PhoneCallOut.model_validate(row) for row in rows] return Page(items=items, total=total, page=page, page_size=page_size)