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>

yunkes/src/api/index.ts

@@ -178,6 +178,14 @@ export interface GroupQuery {
   room_id?: string
   /** 群名称模糊搜索(通讯录群 tab 搜索框)。 */
   q?: string
+  /** 群备注子串(微信群统计筛选)。 */
+  group_remark?: string
+  /** 最新消息时间段(ms,含端点)。 */
+  last_start?: number
+  last_end?: number
+  /** 统计时段(ms,含端点)——窗内输出沟通消息数/新增/退出成员数聚合。 */
+  msg_start?: number
+  msg_end?: number
   page?: number
   page_size?: number
 }
@@ -191,6 +199,11 @@ export function getGroups(query: GroupQuery = {}): Promise<Page<Group>> {
       user_id: query.user_id,
       room_id: query.room_id,
       q: query.q,
+      group_remark: query.group_remark,
+      last_start: query.last_start,
+      last_end: query.last_end,
+      msg_start: query.msg_start,
+      msg_end: query.msg_end,
       page: query.page ?? 1,
       page_size: query.page_size ?? 20,
     }),

yunkes/src/api/types.ts

@@ -113,6 +113,19 @@ export interface Group {
   friend_count?: number | null
   /** 建群时间 ms-epoch */
   create_time?: number | null
+  /** 群备注(微信群统计页;getChatroomList.remark,2026-09-09) */
+  group_remark?: string | null
+  /** 员工微信列(getChatroomList 同款):昵称/微信号/头像 */
+  staff_nickname?: string | null
+  staff_wx_alias?: string | null
+  staff_avatar?: string | null
+  /** 员工信息列:姓名/手机(staff 关联) */
+  staff_name?: string | null
+  staff_phone?: string | null
+  /** 统计时段窗内聚合(仅请求带 msg_start/msg_end 时非 null) */
+  window_msg_count?: number | null
+  window_added?: number | null
+  window_lost?: number | null
   /**
    * Verbatim upstream chatroom record (camelCase keys: chatRoomId/chatRoomName,
    * memberCount/memberIds, headImageUrl, wechatId/wechatNickName, userName/