peanut
9838e7626b
- 后端: WebMvcConfig/拦截器/AnalyticsService/Mapper/测试优化，新增 Knife4jConfig、AnalyticsDictionary、数据库迁移脚本 - 前端: 分析仪表盘 UI 优化、接口管理列表及详情测试面板 - 小程序: analytics 服务优化、request 增强 - 文档: 分析模块中文标签设计文档、品牌重命名设计文档 - 部署: conf 配置优化、deploy.py 脚本更新 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
58 lines
2.6 KiB
Markdown
58 lines
2.6 KiB
Markdown
# 行为分析中文业务标签设计
|
|
|
|
## 目标
|
|
|
|
行为分析页面必须用运营人员能理解的中文展示小程序用户行为，包括用户停留页面、点击操作、创作链路、偏好维度和调用接口。页面不再直接展示 `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 执行可用构建或类型检查命令，通过后确认无循环埋点。
|