Files

T

peanut 763e1df662 docs: 调用日志列表增加用户字段设计文档

2026-05-25 20:52:05 +08:00

3.5 KiB

Raw Blame History

author, created_at, purpose

author	created_at	purpose
Claude	2026-05-25	在管理后台调用日志列表中增加"调用用户"列，显示用户昵称+ID，方便排查用户反馈问题

调用日志列表增加用户字段设计

背景

管理后台 /aiconfig/list AI 配置管理页面的"调用日志"tab 中，列表当前不显示调用用户信息。运营人员排查用户反馈问题时，需要点开每条日志的详情弹窗才能看到 userId，效率低。

改动范围

1. 后端 — 实体新增字段

文件: backend-single/src/main/java/com/emotion/entity/AiCallLog.java

在 userId 字段下方新增：

@TableField("user_name")
private String userName;

2. 数据库 — 表新增列

ALTER TABLE t_ai_call_log ADD COLUMN user_name VARCHAR(100) COMMENT '用户昵称' AFTER user_id;

3. 后端 — 日志保存时写入 userName

文件: backend-single/src/main/java/com/emotion/service/impl/AiRuntimeServiceImpl.java

两处日志创建位置（第 68-73 行 invokeStream 方法、第 219-225 行 invokeEndpointStream 方法），在 callLog.setUserId(...) 之后补充：

callLog.setUserName(request.getUserName());

invokeStream 方法：request 已由 AiRoutingController.withCurrentUser() 注入 userName
invokeEndpointStream 方法：request 在 invokeEndpointStream 内部创建（第 214 行），已通过 UserContextHolder.getCurrentUsername() 注入 userName

4. 前端 — 类型定义

文件: web-admin/src/types/aiconfig.ts

AiCallLog 接口中 userId 字段下方新增：

userName?: string

5. 前端 — 列表新增列

文件: web-admin/src/views/aiconfig/AiRoutingList.vue

在调用日志表格的"调用时间"列之后、"场景"列之前，新增一列：

<el-table-column label="调用用户" width="180" show-overflow-tooltip>
  <template #default="{ row }">
    {{ userDisplay(row) }}
  </template>
</el-table-column>

新增辅助函数：

function userDisplay(row: AiCallLog): string {
  const name = row.userName
  const id = row.userId
  if (name && id) return `${name}(${id})`
  if (name) return name
  if (id) return `-(ID: ${id})`
  return '-'
}

6. 前端 — 详情弹窗格式统一

文件: web-admin/src/views/aiconfig/components/AiCallLogDetailDialog.vue

将基本信息区域中的"用户 ID"行改为"调用用户"，显示格式与列表一致：

<div class="info-item">
  <span class="info-label">调用用户</span>
  <span class="info-value">{{ userDisplay(log) }}</span>
</div>

同样复用 userDisplay 辅助函数。

数据流

路径 1（场景调用）：
用户发起 AI 请求
  → AiRoutingController.withCurrentUser() 注入 userName
  → AiRuntimeServiceImpl.invokeStream() 创建 callLog 时写入 userName
  → 保存到 t_ai_call_log.user_name

路径 2（Endpoint 直接调用）：
用户发起 Endpoint 请求
  → AiRuntimeServiceImpl.invokeEndpointStream() 内部通过 UserContextHolder.getCurrentUsername() 获取 userName
  → 创建 callLog 时写入 userName
  → 保存到 t_ai_call_log.user_name

两条路径最终都：
  → 前端查询日志列表，列表/弹窗显示 昵称(ID)

兜底策略

历史数据 user_name 为 NULL 时，列表显示 -(ID: xxx)
userId 也为空时，显示 -

不做的

不在筛选栏新增用户搜索框（需求仅列表展示，搜索后续按需扩展）
不修改 AiCallLogQueryRequest（暂不支持按用户筛选）

3.5 KiB Raw Blame History Unescape Escape