跳转至

P3.10 — 效果追踪与报告机制设计

日期: 2026-04-03 状态: 设计完成,待实施 关联里程碑: M7(2026-06-30 首份效果报告)

设计目标

建立量化机制追踪用户生命状态改善,验证系统核心原则:

"注重实践,避免空谈,一切围绕用户生命状态的提升提供服务"

数据模型

已有表提供完整数据基础:

user_levels (10 users)          — 用户等级与进阶
  ├── life_state_tracking (40)  — 五维生命状态自评
  ├── practice_records (55)     — 练习频次与类型
  └── practice_plans (6)        — 计划执行情况

五维追踪指标

维度 数据源 度量方式
身体健康 life_state_tracking.physical_health 滑动平均趋势 (7/30/90天)
心境平和 life_state_tracking.mental_peace 滑动平均趋势
精力水平 life_state_tracking.energy_level 滑动平均趋势
睡眠质量 life_state_tracking.sleep_quality 滑动平均趋势
情绪稳定 life_state_tracking.emotional_stability 滑动平均趋势

效果报告 API 设计

1. 个人趋势报告

GET /api/v1/lifecycle/effect-report/{user_id}?period=30d

返回: - 五维雷达图数据(期初 vs 期末) - 练习频次统计(周均、日均) - 总练习时长 - 等级变化记录 - 主观感受关键词提取

2. 群体效果分析

GET /api/v1/lifecycle/group-analysis?level=初级&period=90d

返回: - 各等级用户数 - 各等级平均五维分数 - 练习类型分布 - 留存率(7天/30天/90天) - 练习转化率(浏览→练习→持续)

3. 系统有效性报告(M7 交付物)

GET /api/v1/lifecycle/system-effectiveness?from=2026-04-01&to=2026-06-30

返回: - 总追踪用户数(目标: ≥100) - 平均生命状态改善率(目标: >5%) - 练习留存率 - 用户等级分布变化 - Top 改善维度和 Top 待改善维度

关键 SQL 查询(核心度量)

练习留存率

WITH weekly AS (
    SELECT user_id,
           DATE_TRUNC('week', practice_date) AS week
    FROM practice_records
    GROUP BY user_id, DATE_TRUNC('week', practice_date)
),
cohort AS (
    SELECT user_id, MIN(week) AS first_week
    FROM weekly GROUP BY user_id
)
SELECT c.first_week,
       COUNT(DISTINCT c.user_id) AS cohort_size,
       COUNT(DISTINCT CASE WHEN w.week = c.first_week + INTERVAL '1 week' THEN c.user_id END) AS week_1,
       COUNT(DISTINCT CASE WHEN w.week = c.first_week + INTERVAL '4 weeks' THEN c.user_id END) AS week_4
FROM cohort c
LEFT JOIN weekly w ON w.user_id = c.user_id
GROUP BY c.first_week;

生命状态改善率

WITH first_last AS (
    SELECT user_id,
           FIRST_VALUE(physical_health + mental_peace + energy_level + sleep_quality + emotional_stability)
               OVER (PARTITION BY user_id ORDER BY tracked_date) AS first_score,
           FIRST_VALUE(physical_health + mental_peace + energy_level + sleep_quality + emotional_stability)
               OVER (PARTITION BY user_id ORDER BY tracked_date DESC) AS last_score,
           ROW_NUMBER() OVER (PARTITION BY user_id ORDER BY tracked_date) AS rn
    FROM life_state_tracking
)
SELECT user_id, first_score, last_score,
       ROUND((last_score - first_score)::numeric / NULLIF(first_score, 0) * 100, 1) AS improvement_pct
FROM first_last WHERE rn = 1;

实施路线

阶段 时间 交付
数据收集 4月-5月 持续积累 user_levels + tracking + records
API 开发 5月中旬 3个报告端点
首份报告 6月底 (M7) 系统有效性报告(≥50用户数据)
自动化 7月 定时生成月度报告

验证标准(三问门控)

  1. 如何帮助实践? — 用户可量化看到自身改善趋势,增强练习动力
  2. 如何验证生命状态改善? — 五维评分的30天/90天趋势对比 + 统计显著性检验
  3. 成功指标? — >5% 平均改善率、>10% 练习转化率、≥100 追踪用户(6月底)