feat(group-stats): 微信群列表对齐云客「微信群统计」——getChatroomList 数据源+窗内统计

用户报微信群列表数据/内容不对,应对齐云客「沟通→微信号管理→微信群统计」
(/cms/wechat/wechatgroup)。真机探明(表单登录+页面导航抓 network):

- 数据源=POST /wechatweb/chatroom/getChatroomList(form:departmentId+
  startTime/endTime 窗+分页;信封 data.overviews[]/totalCount 1,854 行)
- 云客窗是任意时间窗实时算:沟通消息数实测同群全史 417/7天 36/单日 6
- **修正存量映射错误**:member_count 原存 friendNum(员工好友数),真群成员
  数是 friendCount/getChatroomList.memberCount
- 新增/退出成员数云客按窗实时算,本地无事件流 → 按天积累

实现:
- ChatGroup 补 group_remark 列(备注仅 friend_list/es 携带,两归一化均
  「有值才写」防互清);迁移含存量 raw_json 回填(须先于基线抓取执行)
- 新表 chat_group_member_stats(渠道×账号×群×天一行 added/lost)
- 新实体 chatroom-stats:全窗刷档案列(真成员数/群备注/员工信息,owner
  经 wechat_account alias 解析)+ --day 单日窗落进出日行;full_sync 5c 步
- /api/groups 扩展:msg_start/msg_end 窗内聚合(window_msg_count=
  msg_daily_stats 按天和、window_added/lost=日表和)、last_start/end
  最新消息窗、group_remark 子串;行补员工微信/员工信息关联列
- GroupList 微信 tab:统计时段(默认近7天)/最新消息时间段/群名称/群备注/
  员工下拉/查询 + 9 列(群信息|群备注|员工微信|员工信息|群成员数量|
  新增成员数|退出成员数|沟通消息数|操作);WA tab 不动

700 测试绿(新增窗聚合/筛选/员工列 3 例)。本地实测:基线 1,854 群=云客
total 一字不差,今日日窗 added 407/lost 166 落表,页面 9 列/员工列渲染正常。

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

yunke-server/tests/test_api_groups.py

@@ -344,3 +344,79 @@ async def test_q_room_name_substring_filter(make_client):
     # 空串 -> 不过滤
     r3 = await client.get("/api/groups", params={"q": ""})
     assert r3.json()["total"] == 3
+
+
+# ---------------------------------------------------------------------------
+# 微信群统计扩展(2026-09-09):统计时段窗聚合 + 员工列 + 群备注/最新消息筛选
+# ---------------------------------------------------------------------------
+
+async def _seed_stat(session: AsyncSession) -> None:
+    from app.db.models import ChatGroupMemberStats, MsgDailyStats, Staff, WechatAccount
+
+    session.add_all([
+        WechatAccount(wx_id="wx_owner_1", nick_name="玉", alias="Nancyjade",
+                      user_id="u_wx_1", raw_json={"headImageUrl": "http://a/h.png"}),
+        Staff(user_id="u_wx_1", name="聂玉婷", phone="18500000000"),
+        ChatGroup(room_id="stat_room@chatroom", channel="wechat", room_name="统计群",
+                  owner_account_id="wx_owner_1", owner_user_id="u_wx_1",
+                  member_count=46, group_remark="VIP群", last_chat_time=5000),
+        # 窗内两天日行(0907+0908):沟通 3+4=7 条
+        MsgDailyStats(channel="wechat", owner_account_id="wx_owner_1", peer_kind="room",
+                      peer_id="stat_room@chatroom", day=20260907, send_cnt=1, recv_cnt=2),
+        MsgDailyStats(channel="wechat", owner_account_id="wx_owner_1", peer_kind="room",
+                      peer_id="stat_room@chatroom", day=20260908, send_cnt=2, recv_cnt=2),
+        # 窗外日行(0901)不应计入
+        MsgDailyStats(channel="wechat", owner_account_id="wx_owner_1", peer_kind="room",
+                      peer_id="stat_room@chatroom", day=20260901, send_cnt=99, recv_cnt=99),
+        # 窗内进出:0907 +2/-1
+        ChatGroupMemberStats(channel="wechat", owner_account_id="wx_owner_1",
+                             room_id="stat_room@chatroom", day=20260907, added=2, lost=1),
+    ])
+    await session.commit()
+
+
+async def test_group_window_aggregates_and_staff_columns(make_client):
+    """msg_start/msg_end 窗内三聚合 + 员工微信/员工信息关联列。"""
+    client = await make_client(_seed_stat)
+    # 2026-09-07 ~ 2026-09-09(上海日 20260907..20260909,UTC ms)
+    r = await client.get("/api/groups", params={
+        "channel": "wechat", "room_id": "stat_room@chatroom",
+        "msg_start": 1788758400000, "msg_end": 1789017600000,
+    })
+    assert r.status_code == 200
+    it = r.json()["items"][0]
+    assert it["window_msg_count"] == 7      # 窗内日行求和,0901 排除
+    assert it["window_added"] == 2
+    assert it["window_lost"] == 1
+    assert it["group_remark"] == "VIP群"
+    assert it["staff_nickname"] == "玉"
+    assert it["staff_wx_alias"] == "Nancyjade"
+    assert it["staff_avatar"] == "http://a/h.png"
+    assert it["staff_name"] == "聂玉婷"
+    assert it["staff_phone"] == "18500000000"
+
+    # 无窗请求 → 聚合三列为 None(不误显 0)
+    r2 = await client.get("/api/groups", params={
+        "channel": "wechat", "room_id": "stat_room@chatroom"})
+    it2 = r2.json()["items"][0]
+    assert it2["window_msg_count"] is None
+    assert it2["window_added"] is None
+
+
+async def test_group_remark_and_last_window_filters(make_client):
+    """群备注子串 + 最新消息时间段过滤。"""
+    client = await make_client(_seed_stat)
+    r = await client.get("/api/groups", params={
+        "channel": "wechat", "group_remark": "VIP"})
+    assert [i["room_id"] for i in r.json()["items"]] == ["stat_room@chatroom"]
+    r2 = await client.get("/api/groups", params={
+        "channel": "wechat", "group_remark": "不存在"})
+    assert r2.json()["total"] == 0
+
+    # last_chat_time=5000 → last_start=4000 命中,last_start=6000 排除
+    r3 = await client.get("/api/groups", params={
+        "channel": "wechat", "last_start": 4000, "last_end": 9999})
+    assert "stat_room@chatroom" in [i["room_id"] for i in r3.json()["items"]]
+    r4 = await client.get("/api/groups", params={
+        "channel": "wechat", "last_start": 6000, "last_end": 9999})
+    assert r4.json()["total"] == 0