feat(ECR-044): RhythmConfig 写面闭环并 Closed

复用 admin.explore.write、POST/PUT+审计、C端 GET /rhythm/configs、 H5 无 active 空态/失败回退；migration 000053。ExploreConfig Loop STOP，禁自动 ECR-045。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-13 20:43:08 +08:00
parent fcc7667ba3
commit 87b463b2bb
33 changed files with 1006 additions and 35 deletions
@@ -51,7 +51,8 @@
 | [ops-privacy-request.md](ops-privacy-request.md) | AdminGovernance PrivacyRequest | §7 | `/admin/privacy/requests*` | Ops · **ECR-034** |
 | [ops-star-config.md](ops-star-config.md) | ExploreConfig StarConfig（只读） | §7 | `/admin/explore/star-configs*` | Ops · **ECR-035** |
 | [ops-star-config-write.md](ops-star-config-write.md) | StarConfig **写面** | §7 | admin 写 · `GET /star/configs` | ExploreConfig · **ECR-043** |
-| [ops-rhythm-config.md](ops-rhythm-config.md) | ExploreConfig RhythmConfig | §7 | `/admin/explore/rhythm-configs*` | Ops · **ECR-036** |
+| [ops-rhythm-config.md](ops-rhythm-config.md) | ExploreConfig RhythmConfig（只读） | §7 | `/admin/explore/rhythm-configs*` | Ops · **ECR-036** |
+| [ops-rhythm-config-write.md](ops-rhythm-config-write.md) | RhythmConfig **写面** | §7 | admin 写 · `GET /rhythm/configs` | ExploreConfig · **ECR-044** |
 | [ops-image-card-deck.md](ops-image-card-deck.md) | ExploreConfig ImageCardDeck | §7 | `/admin/explore/image-card-decks*` | Ops · **ECR-037** |
 | [ops-report-template.md](ops-report-template.md) | GrowthInsights ReportTemplate | §7 | `/admin/growth/report-templates*` | Ops · **ECR-038** |
 | [ops-funnel-definition.md](ops-funnel-definition.md) | GrowthInsights FunnelDefinition | §7 | `/admin/analytics/funnel-definitions*` | Ops · **ECR-039** |
@@ -0,0 +1,98 @@
+# Feature Spec: ExploreConfig · RhythmConfig 写面（Ops · ECR-044）
+
+> Status: `Active`（**Implemented · ECR-044 Closed**）  
+> Map: `§7` · Capability: `ExploreConfig` · BC: `Explore_Reports`  
+> Auth: `docs/WAVE0/ECR-044_WRITE_AUTHORIZATION.md`（Human 批准 · **仅 ECR-044**）  
+> Predecessor: ECR-036 Closed（只读）· ECR-043 Closed（StarConfig 写）  
+> 关联：[ops-rhythm-config.md](ops-rhythm-config.md) · [life-rhythm.md](life-rhythm.md)
+
+---
+
+## 1. 目标
+
+运营可 **创建 / 更新 / 上下架** `RhythmConfig`；写操作鉴权 + 审计；C 端可读 active 配置并影响节律入口可用性；失败回退「现网可生成」。
+
+验证 ExploreConfig 写面同构复用；**Closed 后立即 STOP**，不自动 ECR-045。
+
+## 2. In / Out
+
+| In | Out |
+|----|-----|
+| Admin POST/PUT `/admin/explore/rhythm-configs*` | **StarConfig / ImageCardDeck / ScaleDefinition** 一切 |
+| 复用权限 `admin.explore.write` | SystemPrompt · KnowledgeSource · Chunk · ToolDefinition |
+| 复用表 `rhythm_configs`（code/title/active/system） | soft-delete · 改节律引擎 · 真支付 · UGC |
+| C 端 GET active rhythm configs | Crisis / Handoff / ContentSafety 写 |
+| 节律页：无 active → 温和不可用态；API 失败 → 回退可生成 | 合并多概念 · 自动开 ECR-045 |
+| 审计 `admin_audit_logs` | 新权限子系统 |
+
+## 3. Domain
+
+| 字段 | 规则 |
+|------|------|
+| `code` | 唯一；`^[a-z][a-z0-9_]{1,62}$`；`system=true` 不可改 code |
+| `title` | 必填 · ≤128 |
+| `active` | `false` = 下架（唯一下架手段） |
+| `system` | 种子行；禁止物理删除 |
+
+## 4. API
+
+### Admin
+
+| Method | Path | 权限 |
+|--------|------|------|
+| GET | `/admin/explore/rhythm-configs` · `/{id}` | `admin.explore.read`（保持） |
+| POST | `/admin/explore/rhythm-configs` | `admin.explore.write` |
+| PUT | `/admin/explore/rhythm-configs/{id}` | `admin.explore.write` |
+
+无 DELETE。
+
+### C 端
+
+| Method | Path | Auth | 语义 |
+|--------|------|------|------|
+| GET | `/api/v1/rhythm/configs` | DeviceAuth | 仅 `active=true`；按 code 排序 |
+
+## 5. C 端生效（可观察）
+
+| 条件 | user-h5 `/rhythm` |
+|------|-------------------|
+| 至少 1 条 active | 保持现网生成路径 |
+| 成功且 0 条 active | 展示「节律配置暂未开放」类空态；禁用主生成 CTA |
+| 请求失败 | **回退**：不阻断现网生成 |
+
+不改节律引擎、不改报告 JSON 契约。
+
+## 6. Permission / Migration
+
+- Migration `000053_ops_rhythm_config_write`：幂等确认 `super_admin` → `admin.explore.write`（043 已授）  
+- 编码时占号（当前 Max=`000052`）  
+
+## 7. UI
+
+| 端 | 行为 |
+|----|------|
+| admin-h5 节律配置页 | 列表 + 新建/编辑/上下架（仅 RhythmConfig） |
+| user-h5 `/rhythm` | 按 §5 显隐 CTA |
+
+## 8. AC
+
+| ID | Then |
+|----|------|
+| AC-F-01 | POST 合法 → list/get 可见 |
+| AC-F-02 | PUT `active=false` → C 端 list 不含 |
+| AC-F-03 | 有 active → C 端 list 非空；节律页可生成 |
+| AC-F-04 | 重复 code → 409 |
+| AC-S-01/02 | 401；仅 read → POST 403 |
+| AC-A-01 | 写产生审计 |
+| AC-C-01 | 全下架后节律页空态/禁 CTA |
+| AC-C-02 | C 端 API 失败不白屏、仍可走回退生成 |
+| AC-O-01 | 无 Star/Card/Scale/Prompt 写路径；无 soft-delete |
+
+## 9. Closed 后
+
+**立即 STOP** Continuous Loop。  
+ECR-045 必须重新 Candidate Review + Human 单独拍板。
+
+## 10. Trace
+
+ECR-044 · BD-2026-044 · PRODUCT_SPEC · CONTRACT_DIFF · ECR-044_WRITE_AUTHORIZATION  
@@ -1,6 +1,7 @@
 # Feature Spec: ExploreConfig · RhythmConfig（Ops · ECR-036）

 > Status: `Active`（Loop continuous · **ECR-036 Closed**）  
+> **写面：** [ops-rhythm-config-write.md](ops-rhythm-config-write.md)（**ECR-044**）  
 > Parent: WAVE0-FROZEN · Predecessor: ECR-035 Closed  
 > Capability: `ExploreConfig` · BC: `Explore_Reports`  
 > 授权：`docs/WAVE0/LOOP_AUTHORIZATION.md`