feat(ECR-039): GrowthInsights FunnelDefinition 只读并 Closed

FunnelDefinition catalog (000040) · Loop continuous.

docs/BACKEND_DESIGN/BD-2026-039-funnel-definition.md

@@ -0,0 +1,23 @@
+# Backend Design: ECR-039 FunnelDefinition
+
+| ID | BD-2026-039 |
+| Status | Approved |
+| Coding | Loop authorized |
+| Level | L2 |
+| Migration | YES 000040 |
+
+## Backend Change Boundary
+
+```text
+Domain: FunnelDefinition (read)
+App: AdminHandler → admin.Service → AdminRepo
+API: GET /admin/analytics/funnel-definitions; GET /admin/analytics/funnel-definitions/{id}
+Permission: admin.analytics.read
+Migration: 000040
+```
+
+## Out of boundary
+
+漏斗写配置 · UGC · 真支付
+
+Rollback: down migration + remove routes/UI

docs/CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## 2026-08-08
 
+- **ECR-039 Closed**：GrowthInsights FunnelDefinition（migration 000040 · admin client · /analytics/funnel-definitions · 只读）  
 - **ECR-038 Closed**：GrowthInsights ReportTemplate（migration 000039 · admin client · /growth/report-templates · 只读）  
 - **ECR-037 Closed**：ExploreConfig ImageCardDeck（migration 000038 · admin client · /explore/image-card-decks · 只读）  
 - **ECR-036 Closed**：ExploreConfig RhythmConfig（migration 000037 · admin client · /explore/rhythm-configs · 只读）  

docs/CODE_REVIEW/ECR-039.md

@@ -0,0 +1,8 @@
+# CODE_REVIEW — ECR-039
+
+**Verdict:** Approve → Closed
+
+Date: 2026-08-08 · Loop continuous
+
+- FunnelDefinition 只读；无 UGC/真支付  
+- Integration AC mapped · OpenAPI updated

docs/CONTRACT_DIFF/ECR-039.yaml

@@ -0,0 +1,22 @@
+ecr: ECR-039
+capability: GrowthInsights
+bounded_context: Analytics_OpsB
+parent: WAVE0-FROZEN
+predecessor: ECR-038
+change:
+  type: additive
+breaking_change: false
+migration_required: true
+compatibility_notes: >
+  Adds FunnelDefinition read catalog. Forbidden: UGC / real payment.
+
+apis:
+  - method: GET
+    path: /api/v1/admin/analytics/funnel-definitions
+    change: added
+  - method: GET
+    path: /api/v1/admin/analytics/funnel-definitions/{id}
+    change: added
+perms:
+  - code: admin.analytics.read
+    change: unchanged

docs/ECR/ECR-039-funnel-definition.md

@@ -0,0 +1,15 @@
+# ECR-039
+
+**Title:** GrowthInsights · FunnelDefinition（只读薄切片）  
+**Status:** **Closed**  
+**Closed:** 2026-08-08（Loop continuous）  
+**Parent:** WAVE0-FROZEN · **Predecessor:** ECR-038 Closed  
+**Change Level:** L2  
+
+## Change
+
+FunnelDefinition 只读 · migration 000040 · admin client · /analytics/funnel-definitions
+
+## Linked
+
+Spec `ops-funnel-definition.md` · BD-2026-039 · CONTRACT_DIFF/ECR-039.yaml · TEST_REPORT/ECR-039.md

docs/ENGINEERING_SPEC/ECR-039-funnel-definition.md

@@ -0,0 +1,6 @@
+# ENGINEERING_SPEC — ECR-039
+
+1. migration 000040
+2. AdminRepo/Service/Handler
+3. OpenAPI + admin-h5
+4. Integration · Closed

docs/HANDOFF/ECR-039-architect-to-engineer.md

@@ -0,0 +1,3 @@
+# HANDOFF — ECR-039 Architect → Engineer
+
+Loop continuous · Approved + Coding. Migration 000040. Forbidden: UGC/真支付.

docs/HANDOFF/ECR-039-engineer-to-reviewer.md

@@ -0,0 +1,3 @@
+# HANDOFF — ECR-039 Engineer → Reviewer
+
+TestGrowthFunnelDefinitions PASS · Ready for Closed.

docs/PRODUCT_SPEC/ECR-039-funnel-definition.md

@@ -0,0 +1,3 @@
+# PRODUCT_SPEC — ECR-039
+
+对齐 ops-funnel-definition.md · Approved · Loop · L2 · FunnelDefinition 只读

docs/STATE/ECR-039.md

@@ -0,0 +1,6 @@
+# STATE — ECR-039
+
+| Status | **Closed** |
+| Phase | closed |
+| Spec | ops-funnel-definition.md |
+| Updated | 2026-08-08 |

docs/TASKS/TASK-039-ECR039.yaml

@@ -0,0 +1,12 @@
+id: TASK-039-ECR039
+ecr: ECR-039
+title: GrowthInsights · FunnelDefinition（只读薄切片）
+role: engineer
+status: closed
+change_level: L2
+parent: WAVE0-FROZEN
+predecessor: ECR-038
+acceptance:
+  - Spec AC mapped
+  - FunnelDefinition read only
+  - No UGC / payment

docs/TEST_REPORT/ECR-039.md

@@ -0,0 +1,33 @@
+# TEST_REPORT — ECR-039 FunnelDefinition
+
+Date: 2026-08-08 · Loop continuous · commit: `PENDING`
+
+## Commands
+
+```bash
+cd apps/api && go test ./internal/integration/ -run TestGrowthFunnelDefinitions -count=1
+npm run build:admin
+python3 scripts/ess-validate.py --phase review --ecr ECR-039
+python3 scripts/ess-gate-check.py --ecr ECR-039
+```
+
+## Results
+
+| Check | Result |
+|-------|--------|
+| TestGrowthFunnelDefinitions | PASS |
+| build:admin | PASS |
+| ess-validate review | PASS |
+| ess-gate-check | PASS |
+
+## AC
+
+| ID | Evidence |
+|----|----------|
+| AC-F-01 | list seed/empty ok |
+| AC-F-02 | get 200 |
+| AC-F-03 | 未知 id → 404 |
+| AC-S-01 | 401 |
+| AC-S-02 | 403 |
+| AC-P-01 | list < 500ms |
+| AC-O-01 | N/A 只读 |

docs/TRACEABILITY.md

@@ -43,3 +43,4 @@
 | ECR-036 | ExploreConfig · RhythmConfig | **Closed** | Spec ops-rhythm-config.md · BD-2026-036 · migration 000037 · TEST_REPORT · CODE_REVIEW · Loop continuous |
 | ECR-037 | ExploreConfig · ImageCardDeck | **Closed** | Spec ops-image-card-deck.md · BD-2026-037 · migration 000038 · TEST_REPORT · CODE_REVIEW · Loop continuous |
 | ECR-038 | GrowthInsights · ReportTemplate | **Closed** | Spec ops-report-template.md · BD-2026-038 · migration 000039 · TEST_REPORT · CODE_REVIEW · Loop continuous |
+| ECR-039 | GrowthInsights · FunnelDefinition | **Closed** | Spec ops-funnel-definition.md · BD-2026-039 · migration 000040 · TEST_REPORT · CODE_REVIEW · Loop continuous |

docs/WAVE0/LOOP_AUTHORIZATION.md

@@ -55,4 +55,4 @@ Human 明文：**直接用 Loop，不用人工确认。**
 
 | Done | Next |
 |------|------|
-| ECR-013A…038 Closed | **ECR-039** FunnelDefinition |
+| ECR-013A…039 Closed | **ECR-040** ScaleDefinition 只读投影 |