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>
2026-09-09 18:09:20 +08:00
parent 03c08881b6
commit b0ebe8a15a
12 changed files with 657 additions and 32 deletions
@@ -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,
    }),
@@ -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/
@@ -3,14 +3,13 @@ import { computed, onMounted, reactive, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { ElMessage } from 'element-plus'
 import { Download } from '@element-plus/icons-vue'
-import { getGroups } from '@/api'
+import { getAccounts, getGroups } from '@/api'
 import { downloadBlob } from '@/api/client'
-import type { Channel, Group } from '@/api/types'
+import type { Account, Channel, Group } from '@/api/types'
 import { useChannelStore } from '@/stores/channel'
 import { channelLabel, formatTime } from '@/utils/format'
 import { exportListToCsv } from '@/utils/csvExport'
 import { buildGroupSections, readField } from '@/utils/groupFields'
-import { fromTypeLabel } from '@/utils/customerFields'

 /**
 * 群列表 — channel-tabbed view mirroring 云客「沟通」板块的群列表.
@@ -84,10 +83,6 @@ function cellNum(row: Group, camelKey: string, fallback = 0): number {
  const v = cell(row, camelKey)
  return typeof v === 'number' && Number.isFinite(v) ? v : fallback
 }
-/** 数据来源列：fromType 代码→文案（复用 customerFields.fromTypeLabel）。 */
-function fromTypeText(row: Group): string {
-  return fromTypeLabel(cell(row, 'fromType'))
-}
 function imageCell(row: Group, camelKey: string): string | undefined {
  const v = cell(row, camelKey)
  return typeof v === 'string' && v !== '' ? v : undefined
@@ -108,7 +103,16 @@ async function loadTab(ch: TabKey): Promise<void> {
      channel: ch,
      page: st.page,
      page_size: st.pageSize,
-      owner_account_id: ownerId.value ?? undefined,
+      owner_account_id: ch === 'wechat' ? (staffOwner.value || ownerId.value) || undefined : ownerId.value ?? undefined,
+      // 微信群统计筛选(云客「微信群统计」同款,2026-09-09)
+      ...(ch === 'wechat'
+        ? {
+            q: gName.value.trim() || undefined,
+            group_remark: gRemark.value.trim() || undefined,
+            ...(lastRange.value ? { last_start: dayStart(lastRange.value[0]), last_end: dayEnd(lastRange.value[1]) } : {}),
+            ...(statRange.value ? { msg_start: dayStart(statRange.value[0]), msg_end: dayEnd(statRange.value[1]) } : {}),
+          }
+        : {}),
    })
    st.items = res.items
    st.total = res.total
@@ -120,6 +124,47 @@ async function loadTab(ch: TabKey): Promise<void> {
    st.loading = false
  }
 }
+
+// ---- 微信群统计筛选(云客同款:统计时段/最新消息时间段/群名称/群备注/员工) ----
+function defaultStatRange(): [Date, Date] {
+  // 云客默认近 7 天(截图 09-03→09-09)
+  const end = new Date()
+  const start = new Date(end.getTime() - 6 * 86_400_000)
+  return [start, end]
+}
+const statRange = ref<[Date, Date] | null>(defaultStatRange())
+const lastRange = ref<[Date, Date] | null>(null)
+const gName = ref('')
+const gRemark = ref('')
+/** 员工筛选(下拉;入口 query 的 owner_account_id 作初值,选择后接管)。 */
+const staffOwner = ref<string>(ownerId.value ?? '')
+const staffOptions = ref<Account[]>([])
+
+function dayStart(d: Date): number {
+  const x = new Date(d)
+  x.setHours(0, 0, 0, 0)
+  return x.getTime()
+}
+function dayEnd(d: Date): number {
+  const x = new Date(d)
+  x.setHours(23, 59, 59, 999)
+  return x.getTime()
+}
+
+async function loadStaffOptions(): Promise<void> {
+  try {
+    const res = await getAccounts({ channel: 'wechat', page: 1, page_size: 100 })
+    staffOptions.value = res.items
+    if (ownerId.value && !staffOwner.value) staffOwner.value = ownerId.value
+  } catch {
+    // 静默降级:员工筛选为空
+  }
+}
+
+function onSearch(): void {
+  tabState.wechat.page = 1
+  loadTab('wechat')
+}
 function handlePageChange(ch: TabKey, p: number): void {
  tabState[ch].page = p
  loadTab(ch)
@@ -262,6 +307,7 @@ watch(
 )

 onMounted(() => {
+  loadStaffOptions()
  loadTab(activeTab.value)
 })
 </script>
@@ -287,9 +333,52 @@ onMounted(() => {
    </div>

    <!-- ============================================================
-         微信群 — 7 列，对齐云客 wechatdetail/2/{wxId}.
+         微信群统计 — 对齐云客「沟通→微信号管理→微信群统计」
+         (/cms/wechat/wechatgroup,2026-09-09 真机对齐)。
+         统计时段窗内:沟通消息数=本地日汇总;新增/退出成员数=按天进出表
+         求和(上线日起积累,历史日期为 0)。
         ============================================================ -->
    <template v-if="activeTab === 'wechat'">
+        <div class="yk-groups__statfilters">
+          <div class="yk-groups__filterrow">
+            <span class="yk-groups__flabel">数据统计时段：</span>
+            <el-date-picker
+              v-model="statRange"
+              type="daterange"
+              value-format="YYYY-MM-DD"
+              range-separator="→"
+              start-placeholder="开始日期"
+              end-placeholder="结束日期"
+              size="small"
+              style="width: 260px"
+            />
+            <span class="yk-groups__flabel" style="margin-left: 16px">最新消息时间段：</span>
+            <el-date-picker
+              v-model="lastRange"
+              type="daterange"
+              value-format="YYYY-MM-DD"
+              range-separator="→"
+              start-placeholder="开始日期"
+              end-placeholder="结束日期"
+              size="small"
+              style="width: 260px"
+              clearable
+            />
+          </div>
+          <div class="yk-groups__filterrow">
+            <el-input v-model="gName" placeholder="请输入群名称" size="small" clearable style="width: 180px" @keyup.enter="onSearch" />
+            <el-input v-model="gRemark" placeholder="请输入群备注" size="small" clearable style="width: 180px" @keyup.enter="onSearch" />
+            <el-select v-model="staffOwner" placeholder="员工微信昵称" size="small" clearable filterable style="width: 200px">
+              <el-option
+                v-for="a in staffOptions"
+                :key="a.account_id"
+                :label="a.nickname || a.user_name || a.account_id"
+                :value="a.account_id"
+              />
+            </el-select>
+            <el-button type="primary" size="small" @click="onSearch">查 询</el-button>
+          </div>
+        </div>
        <el-alert
          v-if="tabState.wechat.errorMsg"
          :title="tabState.wechat.errorMsg"
@@ -309,40 +398,57 @@ onMounted(() => {
          empty-text="暂无微信群数据"
          @row-click="openDrawer"
        >
-          <el-table-column label="群信息" min-width="180">
-            <template #default="{ row }">
-              <div class="yk-staffinfo__nick" :title="cellText(row, 'chatRoomName')">{{ cellText(row, 'chatRoomName') }}</div>
-            </template>
-          </el-table-column>
-          <el-table-column label="数据来源" min-width="110">
-            <template #default="{ row }">{{ fromTypeText(row) }}</template>
-          </el-table-column>
-          <el-table-column label="群主信息" min-width="180">
+          <el-table-column label="群信息" min-width="200">
            <template #default="{ row }">
              <div class="yk-group-owner">
-                <el-avatar :size="36" :src="imageCell(row, 'ownerImage') || undefined" shape="circle">
-                  {{ (cellText(row, 'ownerName') || '?').slice(0, 1) }}
+                <el-avatar :size="34" :src="row.head_image_url || undefined" shape="circle">
+                  {{ (row.room_name || '?').slice(0, 1) }}
                </el-avatar>
                <div class="yk-group-owner__meta">
-                  <div class="yk-staffinfo__nick">{{ cellText(row, 'ownerName') }}</div>
-                  <div class="yk-staffinfo__muted">{{ cellText(row, 'realName') }}</div>
+                  <div class="yk-staffinfo__nick">{{ row.room_name || '--' }}</div>
                </div>
              </div>
            </template>
          </el-table-column>
-          <el-table-column label="群成员数量" width="110" align="right">
-            <template #default="{ row }">{{ cellNum(row, 'memberCount') }}</template>
+          <el-table-column label="群备注" min-width="110">
+            <template #default="{ row }">{{ row.group_remark || '-' }}</template>
          </el-table-column>
-          <el-table-column label="群成员好友数量" width="130" align="right">
-            <template #default="{ row }">{{ cellNum(row, 'friendCount') }}</template>
+          <el-table-column label="员工微信" min-width="170">
+            <template #default="{ row }">
+              <div class="yk-group-owner">
+                <el-avatar :size="34" :src="row.staff_avatar || undefined" shape="square">
+                  {{ (row.staff_nickname || '?').slice(0, 1) }}
+                </el-avatar>
+                <div class="yk-group-owner__meta">
+                  <div class="yk-staffinfo__nick">{{ row.staff_nickname || '--' }}</div>
+                  <div class="yk-staffinfo__muted">{{ row.staff_wx_alias || row.owner_account_id || '' }}</div>
+                </div>
+              </div>
+            </template>
          </el-table-column>
-          <el-table-column label="消息数量" width="100" align="right">
-            <template #default="{ row }">{{ cellNum(row, 'messageCount') }}</template>
+          <el-table-column label="员工信息" min-width="150">
+            <template #default="{ row }">
+              <div class="yk-staffinfo__nick">{{ row.staff_name || '--' }}</div>
+              <div class="yk-staffinfo__muted">{{ row.staff_phone || '' }}</div>
+            </template>
+          </el-table-column>
+          <el-table-column label="群成员数量" width="105" align="right">
+            <template #default="{ row }">{{ row.member_count ?? '-' }}</template>
+          </el-table-column>
+          <el-table-column label="新增成员数" width="105" align="right">
+            <template #default="{ row }">{{ row.window_added ?? '-' }}</template>
+          </el-table-column>
+          <el-table-column label="退出成员数" width="105" align="right">
+            <template #default="{ row }">{{ row.window_lost ?? '-' }}</template>
+          </el-table-column>
+          <el-table-column label="沟通消息数" width="105" align="right">
+            <template #default="{ row }">{{ row.window_msg_count ?? '-' }}</template>
          </el-table-column>
          <el-table-column label="操作" width="220" fixed="right" align="center">
            <template #default="{ row }">
+              <el-button link type="primary" size="small" @click.stop="openDrawer(row)">查看详情</el-button>
              <el-button link type="primary" size="small" @click.stop="viewChat(row)">查看聊天记录</el-button>
-              <el-button link type="primary" size="small" @click.stop="exportGroupHtml(row)">导出HTML聊天记录</el-button>
+              <el-button link type="primary" size="small" @click.stop="exportGroupHtml(row)">导出HTML</el-button>
            </template>
          </el-table-column>
        </el-table>