feat(ops): ECR-007 行为分析与 ECR-008 内容运营后台

落地埋点 ingest/数据看板、首页宫格 CMS 与测评上下架；含账号引导、问答流式与免责声明去重，以及 review P1 审计同事务修复。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 02:26:16 +08:00
parent 7e9023f0a8
commit 7ab9add5dd
132 changed files with 8276 additions and 491 deletions
@@ -0,0 +1,30 @@
+# ENGINEERING_SPEC — ECR-007 运营行为分析 Ops-B
+
+权威设计：`docs/BACKEND_DESIGN/ECR-007-ops-analytics.md`  
+产品：`.ai/product/feature-spec/ops-analytics.md` · `docs/PRODUCT_SPEC/ECR-007-ops-analytics.md`
+
+## Implement order
+
+1. Migration `000013_analytics_ops`（sessions / events；可选 daily_page）+ ERD 同步  
+2. `repository/analytics_repo.go`（ingest + 聚合查询）  
+3. `service/analytics`（校验、截断 props、限流语义）  
+4. `handler`：`POST /analytics/events` 挂 **既有 DeviceAuth gated group**  
+5. `service/admin` + handler：`GET /admin/analytics/{overview,pages,exits,clicks,funnel}`  
+6. OpenAPI 增补  
+7. `user-h5`：`lib/analytics.ts` 队列 / session / dwell / click / beacon；关键控件 `data-track`  
+8. `admin-h5`：路由「数据」+ Dashboard 筛选与图表/表  
+9. 测试：repo/service 或 integration 上报→聚合；H5 analytics 单测  
+10. TRACEABILITY · STATE · CHANGELOG · feature-map §7  
+
+## Constraints
+
+- 函数 ≤50 行 · 文件 ≤400 行（超标先拆）  
+- UI → sdk 或既有 thin client → Handler → Service → Repository（禁止 Handler SQL）  
+- Admin 聚合不得走 DeviceAuth  
+- props 白名单键；禁止 PII  
+- 不提交 `config.local.yaml` / 密钥  
+- 不引入新中间件栈（无 Kafka）  
+
+## Done when
+
+ECR Acceptance 勾完 + `.ai/definition-of-done.md` Review Report + `ess-validate`（Approved 后门禁）
@@ -0,0 +1,28 @@
+# ENGINEERING_SPEC — ECR-008 运营内容 Ops-C
+
+权威设计：`docs/BACKEND_DESIGN/ECR-008-ops-content.md`  
+产品：`.ai/product/feature-spec/ops-content.md`
+
+## Implement order
+
+1. Migration `000014_ops_content`（`home_tools` + seed 12 格）+ ERD  
+2. `repository/home_tools_repo.go` · 扩展 `ScaleRepo` admin list/update status  
+3. `service/home`（或 `service/content`）+ admin 扩展：校验白名单、整表替换、审计  
+4. Handler：`GET /home/tools` 挂 DeviceAuth；admin home/scales 挂 AdminAuth  
+5. OpenAPI  
+6. SDK：`getHomeTools`  
+7. `user-h5`：`useHomePage` 拉 API + 静态回退  
+8. `admin-h5`：「内容」页两 Tab  
+9. Integration + 单测  
+10. TRACEABILITY · STATE · CHANGELOG · feature-map  
+
+## Constraints
+
+- 函数 ≤50 · 文件 ≤400  
+- UI → sdk/thin client → Handler → Service → Repository  
+- PUT home_tools：整批事务替换；失败整批回滚  
+- 不提交密钥  
+
+## Done when
+
+ECR Acceptance + DoD Review + ess-validate review