feat(customers): 微信客户页脚改云客口径(Σ员工好友数声明值8590,用户选B方案)

- GET /api/customers/declared-total: Σ wechat_account.contacts_num
- 页脚优先显示云客口径(回退真实total);列表内容保持去重真实行
- 云客列表声明值含其ES索引重复doc(连行id都相同无法物理区分),仅对齐计数

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

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

@@ -18,7 +18,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.api.deps import get_session
 from app.api.schemas import CustomerOut, Page
-from app.db.models import Customer, Staff
+from app.db.models import Customer, Staff, WechatAccount
 
 router = APIRouter(prefix="/api", tags=["customers"])
 
@@ -27,6 +27,28 @@ PageParam = Annotated[int, Query(ge=1)]
 PageSizeParam = Annotated[int, Query(ge=1, le=100)]
 
 
+@router.get("/customers/declared-total")
+async def customers_declared_total(session: SessionDep) -> dict:
+    """云客口径的微信客户合计 = Σ wechat_account.contacts_num。
+
+    云客列表的页脚数字含 ES 索引重复条目(实测 csf 员工声明 1999 vs 真实
+    distinct 1449,连行 id 都相同的重复 doc,2026-08-20);本地表存去重真实
+    客户,此端点把「与云客页脚一字不差」的声明口径给前端展示。
+    """
+    row = (
+        await session.execute(
+            sa.select(
+                sa.func.coalesce(sa.func.sum(WechatAccount.contacts_num), 0),
+                sa.func.count(WechatAccount.contacts_num),
+            )
+        )
+    ).one()
+    return {
+        "declared_total": int(row[0]),
+        "account_count": int(row[1]),
+    }
+
+
 @router.get("/customers")
 async def list_customers(
     session: SessionDep,