# 行为分析中文业务标签设计

## 目标

行为分析页面必须用运营人员能理解的中文展示小程序用户行为，包括用户停留页面、点击操作、创作链路、偏好维度和调用接口。页面不再直接展示 `page_view`、`script_home_view`、`/pages/main/index`、`style/career` 等英文 key。

## 范围

- 后端聚合接口增加中文业务字段，保留原始 key 作为排查依据。
- 小程序请求层补充 API 调用埋点，记录接口路径、中文接口名、成功/失败、耗时。
- web-admin 行为分析页全部中文化，并优化表格信息结构。
- 不迁移历史数据，不改变现有上报字段和存储表结构。

## 后端设计

新增分析字典类，集中维护：

- 事件中文名：如 `page_view` → `浏览页面`、`script_generate_success` → `剧本生成成功`。
- 事件类型中文名：如 `page` → `页面行为`、`script` → `剧本创作`、`api` → `接口调用`。
- 页面中文名：如 `/pages/main/index` → `首页`、`/pages/main/ScriptView` → `爽文生成页`。
- 偏好维度和值：如 `style` → `剧本风格`、`career` → `事业逆袭`。
- 接口中文名：如 `/ai/runtime/stream` → `AI 流式生成`、`/tts/tasks` → `创建朗读任务`。

DTO 增加中文字段：

- `AnalyticsTopEventItem`: `eventLabel`、`eventTypeLabel`、`pagePath`、`pageLabel`、`apiPath`、`apiLabel`。
- `AnalyticsTrendItem`: `eventLabel`。
- `AnalyticsPreferenceItem`: `dimensionLabel`、`valueLabel`。
- `AnalyticsFunnelItem`: `label` 改为中文来源。

后端服务在聚合结果返回前统一填充这些字段。

## 小程序设计

在 `services/request.js` 中记录接口调用埋点：

- 成功：`api_request_success`
- 失败：`api_request_fail`

埋点属性包含 `api_path`、`api_label`、`method`、`status_code`、`duration_ms`。跳过 `/analytics/events/batch`，避免上报接口自身造成循环。

## 管理端设计

行为分析页保持现有暗色主题，优化为：

- 指标卡使用中文：页面浏览量、访问用户数、行为事件数、活跃用户数、朗读请求数、平均停留时长。
- 趋势图图例使用中文事件名。
- 漏斗步骤使用中文业务动作。
- 热门行为表展示中文行为、所在页面、类型、次数、用户。
- 新增接口调用表，展示接口中文名、调用状态、次数、用户。
- 偏好分布表展示中文维度和值。

## 验证

- 后端 `mvn test` 通过。
- web-admin `npm run build` 通过。
- mini-program 执行可用构建或类型检查命令，通过后确认无循环埋点。
