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