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/app/db/models.py

@@ -344,6 +344,9 @@ class ChatGroup(Base):
     owner_avatar: Mapped[str | None] = mapped_column(String(1024), nullable=True)
     friend_count: Mapped[int | None] = mapped_column(Integer, nullable=True)  # 群成员中员工好友数
     create_time: Mapped[int | None] = mapped_column(BigInteger, nullable=True)  # 建群时间 ms epoch
+    # 群备注(微信群统计页「群备注」列;getChatroomList.remark /
+    # friend_list/es 的 friendWxRemark,2026-09-09)
+    group_remark: Mapped[str | None] = mapped_column(String(255), nullable=True)
 
     version: Mapped[str | None] = mapped_column(String(64), nullable=True)
     raw_json: Mapped[dict[str, Any] | None] = mapped_column(JSON, nullable=True)
@@ -362,6 +365,34 @@ class ChatGroup(Base):
     )
 
 
+class ChatGroupMemberStats(Base):
+    """群成员进出按天统计(chat_group_member_stats,2026-09-09)。
+
+    云客「微信群统计」的新增/退出成员数是 ``getChatroomList`` 按
+    ``startTime~endTime`` 任意窗实时算的;本地无成员进出事件流,改为每夜
+    抓一次「当日窗」的 addMembers/lossMembers 落一行,页面任意日窗=按天
+    求和。**上线日起积累**(历史日期无数据;chat_group.add_members/
+    loss_members 旧列保留作最近一次抓取窗的快照)。
+    """
+
+    __tablename__ = "chat_group_member_stats"
+
+    channel: Mapped[str] = mapped_column(String(16), primary_key=True)
+    owner_account_id: Mapped[str] = mapped_column(String(128), primary_key=True)
+    room_id: Mapped[str] = mapped_column(String(128), primary_key=True)
+    # yyyymmdd(上海自然日,同 msg_daily_stats 口径)
+    day: Mapped[int] = mapped_column(Integer, primary_key=True)
+    added: Mapped[int] = mapped_column(
+        Integer, nullable=False, default=0, server_default=sa.text("0")
+    )
+    lost: Mapped[int] = mapped_column(
+        Integer, nullable=False, default=0, server_default=sa.text("0")
+    )
+
+    fetched_at: Mapped[dt.datetime] = _fetched_at()
+    updated_at: Mapped[dt.datetime] = _updated_at()
+
+
 class GroupMember(Base):
     """群成员 — composite PK (channel, room_id, member_id).