README

Yomiya Product Analytics

本目录是 Yomiya 只读产品数据分析的团队入口。它保存可审阅的分析实现、独立审计提示词和按日期冻结的聚合快照，不包含 Admin MCP 扩展、产品改版、首页或付费墙调整、文案修改、Dashboard 或 Slack 样式。

当前结论

项目	当前状态
决策就绪	`not_decision_grade`
数据源	MySQL Readonly MCP、Server Log Access MCP、GA4 Data API、Cloudflare D1
数据处理	原始标识仅在进程内关联，Git 只保存聚合结果
数据库环境	`yomiya-staging`，尚未证明是生产镜像
当前快照	`2026-07-30` 修订版
运行时验收	347 项检查，0 项失败；12 个方法学反例测试通过
团队 Skill	`$yomiya-product-analytics`

“检查通过”只表示已声明的工程与方法学断言通过，不表示数据已达到产品决策级。当前仍不能据此隐藏 Basic、调整额度、改变首页排序、决定 Podcast 预览长度或宣称某个行为促进购买。

当前快照

2026-07-30 修订版包含：

内容表现 1,676 行；
首页 section 表 0 行；
购买前行为 40 行；
套餐表现 3 行；
attraction score 描述性分桶 8 行；
GA4 事件清单 101 行、自定义维度 20 个；
D1 可见 49 个生产 RevenueCat 事件，rows_written=0；
Server Log 可见 access 文件 131 个，本轮实际读取 4 个并安全复用 127 个。

首页表为空不是“没有首页曝光”。当前找到的 157 个目标响应都被源端截断，完整可解析响应为 0，因此首页 delivered impression 分析不可用。

审计修复

本修订针对独立审计中的 P0 问题完成了以下工程修复：

为每个来源和索引窗口区分 complete、left_censored、 right_censored 与 unavailable，不再把未覆盖编码为无行为；
购买前研究使用逐购买时点风险集，允许未来购买者在购买前作为对照，对照不复用，协变量窗口与暴露窗口分离，并输出 caliper、SMD、FDR 和估计状态；
零暴露、无 discordant pair、小样本或失衡结果标为不可估计；
D30/D60/D90 entitlement 只使用观察时点前已发生的 RevenueCat 事件重建；
内容 cohort 改为观察窗内实际发生消费或交付的内容，不再要求内容近期发布；
GA4 保存时区、thresholding、sampling、rowCount 和拆分对账状态，抑制低于 5 用户的 cell，并模板化动态页面路径；
D1 移除低于 5 事件的聚合分组，收入存在抑制时明确标记为 partial；
MySQL 改用有上限的 keyset pagination，并记录查询哈希、耗时、页数和行数；
attraction score 缺少可比曝光分母时只保留描述，不输出校准或异常标签；
验证器加入结构性零、订阅时间穿越、观察资格、匹配平衡、隐私和产物哈希检查。

详细口径见 01-data-engineering-overview.md。

目录与职责

YomiyaProductAnalytics/
├── README.md
├── 01-data-engineering-overview.md
├── 02-chatgpt-independent-audit-prompt.md
├── engineering/yomiya-service-analytics/
│   ├── PROVENANCE.md
│   ├── README.md
│   └── scripts/
└── snapshots/YYYY-MM-DD/
    ├── snapshot-manifest.json
    ├── exports/
    ├── reports/
    └── sources/

Root 中的 engineering/yomiya-service-analytics/ 是分析逻辑的团队审阅源。
数据连接继续复用 yomiya-service checkout 中既有的只读 MCP 配置；不需要把 Admin MCP SQL 能力合入线上服务。
yomiya-service PR #1313 已关闭，其分支只作为本次来源审计记录保留。
本目录不保存凭据、本地 MCP 配置、Keychain、原始日志或用户级缓存。

使用

审核现有快照：

python3 scripts/validate_yomiya_product_analytics.py --snapshot 2026-07-30

刷新数据时使用团队 Skill，或显式把既有只读配置所在 checkout 传给 Root 中的分析入口：

YOMIYA_SERVICE_REPO=/absolute/path/to/yomiya-service \
  node product/YomiyaProductAnalytics/engineering/yomiya-service-analytics/scripts/refresh-analysis.mjs \
  --mode incremental

只有用户明确要求共享时，才把新生成的聚合结果复制到新的日期快照并创建审阅 PR。永远不要复制 analytics/private/。

安全边界

不提交服务账号 JSON、数据库密码、Token、邮箱、姓名、IP、原始用户 ID、原始 access log 或响应体。
MySQL 只允许 SELECT、WITH、SHOW、DESCRIBE 和 EXPLAIN。
D1 只执行聚合 SELECT 并要求 rows_written=0。
GA4 必须 Metadata-first，不查询 Metadata 中不存在的字段。
不调用写入型 Admin MCP，不修改 Cloudflare 配置、数据库或线上产品行为。