diff --git a/.ai/product/feature-spec/ops-star-config-write.md b/.ai/product/feature-spec/ops-star-config-write.md new file mode 100644 index 0000000..91864e5 --- /dev/null +++ b/.ai/product/feature-spec/ops-star-config-write.md @@ -0,0 +1,99 @@ +# Feature Spec: ExploreConfig · StarConfig 写面（Ops · ECR-043） + +> Status: `Active`（**Spec Ready · Coding NOT STARTED**） +> Map: `§7` · Capability: `ExploreConfig` · BC: `Explore_Reports` +> Auth: `docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md`（Human 批准 · **仅 ECR-043**） +> Predecessor: ECR-035 Closed（只读）· CMS 041–042 Closed +> 关联：[ops-star-config.md](ops-star-config.md) · [star-profile.md](star-profile.md) + +--- + +## 1. 目标 + +运营可 **创建 / 更新 / 上下架** `StarConfig`；写操作鉴权 + 审计；C 端可读 active 配置并影响星座入口可用性；失败回退「现网可生成」。 + +验证 ExploreConfig 写面与 CMS 同类闭环；**Closed 后立即 STOP**，不自动 ECR-044。 + +## 2. In / Out + +| In | Out | +|----|-----| +| Admin POST/PUT `/admin/explore/star-configs*` | **RhythmConfig / ImageCardDeck / ScaleDefinition** 一切 | +| 加法权限 `admin.explore.write` | SystemPrompt · KnowledgeSource · Chunk · ToolDefinition | +| 复用表 `star_configs`（code/title/active/system） | soft-delete · 改引擎/宫位制 · 真支付 · UGC | +| C 端 GET active star configs | Crisis / Handoff / ContentSafety 写 | +| 星座页：无 active → 温和不可用态；API 失败 → 回退可生成 | 合并多概念 · 自动开 ECR-044 | +| 审计 `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/star-configs` · `/{id}` | `admin.explore.read`（保持） | +| POST | `/admin/explore/star-configs` | `admin.explore.write` | +| PUT | `/admin/explore/star-configs/{id}` | `admin.explore.write` | + +无 DELETE。 + +### C 端 + +| Method | Path | Auth | 语义 | +|--------|------|------|------| +| GET | `/api/v1/star/configs` | DeviceAuth | 仅 `active=true`；按 code 排序 | + +## 5. C 端生效（可观察） + +| 条件 | user-h5 `/star` | +|------|-----------------| +| 至少 1 条 active | 保持现网生成路径 | +| 成功且 0 条 active | 展示「星座配置暂未开放」类空态；禁用主生成 CTA | +| 请求失败 | **回退**：不阻断现网生成（与 Banner/FeedSlot 失败回退同哲学） | + +不改星历引擎、不改报告 JSON 契约。 + +## 6. Permission / Migration + +- Migration `000052_ops_star_config_write`：授予 `super_admin` → `admin.explore.write` +- 编码时占号（当前 Max=`000051`） +- `knownPermissions` 注册加法码 + +## 7. UI + +| 端 | 行为 | +|----|------| +| admin-h5 探索/星座配置页 | 列表 + 新建/编辑/上下架（仅 StarConfig） | +| user-h5 `/star` | 按 §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 | 无 Rhythm/Card/Scale/Prompt 写路径；无 soft-delete | + +## 9. Closed 后 + +**立即 STOP** Continuous Loop。 +ECR-044 必须重新 Candidate Review + Human 单独拍板。 + +## 10. Trace + +ECR-043 · BD-2026-043 · PRODUCT_SPEC · CONTRACT_DIFF（实现时）· EXPLORE_CONFIG_WRITE_AUTHORIZATION diff --git a/.ai/product/feature-spec/ops-star-config.md b/.ai/product/feature-spec/ops-star-config.md index 6badb5a..50e9314 100644 --- a/.ai/product/feature-spec/ops-star-config.md +++ b/.ai/product/feature-spec/ops-star-config.md @@ -1,13 +1,14 @@ -# Feature Spec: ExploreConfig · StarConfig（Ops · ECR-035） +# Feature Spec: ExploreConfig · StarConfig（Ops · ECR-035 只读基线） -> Status: `Active`（Loop continuous · **ECR-035 Closed**） +> Status: `Active`（**ECR-035 Closed** · 只读） +> **写面：** [ops-star-config-write.md](ops-star-config-write.md)（**ECR-043** · Spec Ready） > Parent: WAVE0-FROZEN · Predecessor: ECR-034 Closed > Capability: `ExploreConfig` · BC: `Explore_Reports` -> 授权：`docs/WAVE0/LOOP_AUTHORIZATION.md` +> 授权（只读队列）：`docs/WAVE0/LOOP_AUTHORIZATION.md` -## Non-goals +## Non-goals（本只读 Spec） -配置写发布 · 引擎改分层 · UGC · 真支付 +配置写发布（见 ECR-043）· 引擎改分层 · UGC · 真支付 ## L2 Domain diff --git a/docs/BACKEND_DESIGN/BD-2026-043-star-config-write.md b/docs/BACKEND_DESIGN/BD-2026-043-star-config-write.md new file mode 100644 index 0000000..60a4d87 --- /dev/null +++ b/docs/BACKEND_DESIGN/BD-2026-043-star-config-write.md @@ -0,0 +1,29 @@ +# Backend Design: ECR-043 StarConfig Write + +| Field | Value | +|-------|-------| +| ID | BD-2026-043 | +| Status | **Approved**（随 Spec） | +| Coding | **NOT STARTED** | +| Level | L2 | +| Migration | `000052_ops_star_config_write`（编码时分配） | + +## Boundary + +```text +Domain: StarConfig write + C-end active read +API: + POST/PUT /api/v1/admin/explore/star-configs* + GET /api/v1/star/configs +Permission: admin.explore.write (additive) +Table: reuse star_configs +Audit: explore.star_config.create|update +``` + +## Out + +RhythmConfig · ImageCardDeck · ScaleDefinition · AICoreConfig · soft-delete · payment · UGC · auto ECR-044 + +## Rollback + +migration down（撤权限）· 移除写路由与 C 端读 · H5 回退始终可生成 diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 279ded4..183f84c 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -2,7 +2,8 @@ ## 2026-08-13 -- **ECR-043 Candidate Review：** ExploreConfig 写面（推荐首刀 StarConfig）；CMS Write-Wave 041–042 STOP；SystemPrompt 不连跑；见 `ECR-043-CANDIDATE_REVIEW.md` +- **ECR-043 Spec Ready：** StarConfig 薄写面（Human 批准 Loop 仅 043）· Coding NOT STARTED · Closed 后禁自动 044 +- **ECR-043 Candidate Review 收口：** 首刀 StarConfig；非 SystemPrompt - **ECR-042 Closed：** OpsCMS FeedSlot 薄写面（复用 `admin.cms.write` · `GET /home/feed-slots` · 首页槽位显隐）· 无新 migration - **ECR-041 Closed：** OpsCMS Banner 薄写面（`admin.cms.write` · `GET /home/banners` · 首页投影回退 · migration `000051`）· Write-Wave 首刀；未做 FeedSlot - **Write-Wave 开启：** `docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md` · Continuous Loop 限定写面边界 diff --git a/docs/ECR/ECR-043-star-config-write.md b/docs/ECR/ECR-043-star-config-write.md new file mode 100644 index 0000000..f53138e --- /dev/null +++ b/docs/ECR/ECR-043-star-config-write.md @@ -0,0 +1,31 @@ +# ECR-043 + +**Title:** ExploreConfig · StarConfig 薄写面 +**Status:** **Approved**（Human 2026-08-13）· **Coding: NOT STARTED** +**Change Level:** L2 +**Auth:** ExploreConfig Continuous Loop · **仅本 ECR** +**Predecessor:** ECR-035 · Candidate Review 通过 + +## Change + +1. Spec `ops-star-config-write` +2. `admin.explore.write` + POST/PUT star-configs + 审计 +3. C 端 `GET /star/configs`；`/star` 无 active 空态、失败回退 +4. Migration `000052`（编码时）· OpenAPI · admin-h5 + +## Forbidden + +Rhythm · Card · ScaleDefinition · SystemPrompt/Knowledge/Chunk · soft-delete · 支付 · UGC · Crisis/Handoff · **Closed 后自动 ECR-044** + +## Acceptance + +见 Spec §8。 + +## Coding gate + +```text +Spec Active · BD Approved · repo-governance-check PASS +→ Human/Loop 开码口令后才改 apps/ +``` + +本回合 **禁止业务代码**。 diff --git a/docs/HANDOFF/ECR-043-architect-to-engineer.md b/docs/HANDOFF/ECR-043-architect-to-engineer.md new file mode 100644 index 0000000..636cc3a --- /dev/null +++ b/docs/HANDOFF/ECR-043-architect-to-engineer.md @@ -0,0 +1,6 @@ +# HANDOFF — Architect → Engineer · ECR-043 + +**Coding NOT STARTED** until explicit 开码. + +Do only StarConfig write per Spec. Perm `admin.explore.write`. Migration 000052. +After Closed: STOP — no ECR-044. diff --git a/docs/PRODUCT_SPEC/ECR-043-star-config-write.md b/docs/PRODUCT_SPEC/ECR-043-star-config-write.md new file mode 100644 index 0000000..0314fdf --- /dev/null +++ b/docs/PRODUCT_SPEC/ECR-043-star-config-write.md @@ -0,0 +1,3 @@ +# PRODUCT_SPEC — ECR-043 + +对齐 `ops-star-config-write.md` · Human Approved · L2 · **仅 StarConfig** · Coding NOT STARTED. diff --git a/docs/PROJECT_PROFILE.md b/docs/PROJECT_PROFILE.md index 5e743ba..673ba10 100644 --- a/docs/PROJECT_PROFILE.md +++ b/docs/PROJECT_PROFILE.md @@ -53,9 +53,9 @@ - **本仓：** `ess_intake: strict` · Retro FAIL · 单 ECR Context - **Ops foundation：** `docs/WAVE0/` · `.ai/domain/boundary-rules.md` · `glossary.yaml` · Loop: `docs/WAVE0/LOOP_AUTHORIZATION.md` - ECR: main 线 ECR-006–016 Closed；Ops 扩展 ECR-013A/B · 017–040；分叉已固定为 `ECR-012-star` / `014-plan` / `015-code` / `016-insight`（见 TRACEABILITY） -- **Next ECR / Max Migration：** **Next=`ECR-043`（Candidate Review）** · **Max=`000051`** -- **Write-Wave CMS：** 041–042 Closed · **STOP 自动连跑** -- **ExploreConfig 写面：** `EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` + `ECR-043-CANDIDATE_REVIEW.md` · 推荐 StarConfig · 非 SystemPrompt +- **Next ECR / Max Migration：** **Next=`ECR-044`（禁自动开）** · **Max=`000051`**（043 编码→052） +- **Write-Wave CMS：** 041–042 Closed · STOP +- **ExploreConfig：** Auth Approved · **ECR-043 StarConfig Spec Ready · Coding NOT STARTED** · Closed 后 STOP - EXP: （无） - STATE: `docs/STATE/`（含 ECR-041） - TRACEABILITY: `docs/TRACEABILITY.md` · 门禁 `scripts/repo-governance-check.py` @@ -65,7 +65,7 @@ ## WIP（尚未单独 ECR） -- **ECR-043** ExploreConfig 写面：Candidate Review 中 · **禁止写码** 直至 Human 点名概念并 Approve Spec +- **ECR-043** StarConfig 写面：Spec/ECR/BD Approved · **禁止业务代码直至「ECR-043 开码」** ## Pointers diff --git a/docs/TRACEABILITY.md b/docs/TRACEABILITY.md index 789289e..af2300b 100644 --- a/docs/TRACEABILITY.md +++ b/docs/TRACEABILITY.md @@ -4,8 +4,8 @@ | Anchor | Value | Rule | |--------|-------|------| -| **Next ECR** | `ECR-043` | ExploreConfig 写面候选评审中；开码前须 Human 点名单一概念 | -| **Max Migration** | `000051` | 新建 migration 必须读仓内实际 max 后 +1；禁止凭记忆；合入前 `repo-governance-check` PASS | +| **Next ECR** | `ECR-044` | **冻结：** 043 Closed 前勿占；043 Closed 后须重新 Candidate Review，禁止自动开刀 | +| **Max Migration** | `000051` | ECR-043 编码时占 `000052`；禁止凭记忆 | - ECR identity **全局唯一**（含已 Closed）；禁止同号双义。分叉只用 `ECR-NNN-suffix` / `ECR-NNNA`。 - Migration **6 位版本号唯一**。撞号修复见 `docs/MIGRATION_RENUMBER.md`。 @@ -67,7 +67,7 @@ | WRITE-WAVE | Ops CMS 写面（041–042） | **CMS 段 Closed** | `WRITE_WAVE_AUTHORIZATION.md` | | ECR-041 | OpsCMS · Banner 薄写面 | **Closed** | Spec ops-banner-write · BD-2026-041 · migration **000051** | | ECR-042 | OpsCMS · FeedSlot 薄写面 | **Closed** | Spec ops-feed-slot-write · BD-2026-042 · 无新 migration · 复用 cms.write | -| EXPLORE-WRITE | ExploreConfig 写面授权 | **Candidate Review** | `EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` | -| ECR-043 | ExploreConfig 写面（候选） | **Candidate Review** | `ECR-043-CANDIDATE_REVIEW.md` · 推荐首刀 StarConfig · **禁止直接 Code** | +| EXPLORE-WRITE | ExploreConfig 写面授权 | **Approved · 仅 ECR-043** | `EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` | +| ECR-043 | ExploreConfig · StarConfig 薄写面 | **Approved · Coding NOT STARTED** | Spec ops-star-config-write · BD-2026-043 · Closed 后 STOP | > **Migration：** 合并后 `000015`–`000023` 曾撞号，已重编号至 `000050`。以 `apps/api/migrations/` 与 `docs/MIGRATION_RENUMBER.md` 为准（文档中旧号引用可能滞后）。 diff --git a/docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md b/docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md index 4265810..0706c39 100644 --- a/docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md +++ b/docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md @@ -1,9 +1,11 @@ # ECR-043 Candidate Review — ExploreConfig 写面 +> **RESOLVED 2026-08-13：** 首刀 = **StarConfig** · ExploreConfig Loop **仅 ECR-043** · Spec Ready · Coding NOT STARTED +> 权威 Spec：`.ai/product/feature-spec/ops-star-config-write.md` · Auth：`EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` + **Date:** 2026-08-13 -**Mode:** Review only · **禁止写码** -**Auth draft:** `docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` -**Anchors:** Next=`ECR-043` · Max Migration=`000051` · origin/main 齐平 +**Mode:** Review **closed** · Spec phase · **禁止业务代码直至开码** +**Anchors:** Next=`ECR-043`（已占用 Spec）· Max Migration=`000051` ## 锁定现状（冻结） diff --git a/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md b/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md index eb18617..06d10e4 100644 --- a/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md +++ b/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md @@ -1,50 +1,25 @@ -# ExploreConfig Write Authorization — ECR-043 波次（Human 待确认首刀） +# ExploreConfig Write Authorization — ECR-043 only | Field | Value | |-------|-------| | Date | 2026-08-13 | -| Status | **Candidate Review** · Coding **NOT STARTED** | -| Parent | Write-Wave（CMS 041–042 **Closed**） | -| Capability | **ExploreConfig only** | -| Payment / UGC / soft-delete / Crisis / Handoff / AICoreConfig 写 | **STOP** | +| Authorizer | Human | +| Status | **Approved** | +| Scope | **ECR-043 · StarConfig 薄写面 ONLY** | +| Continuous Loop | **Allowed inside ECR-043 only** | +| After Closed | **STOP** · 禁止自动 ECR-044 | -## 为什么收窄授权 +## Human 拍板（2026-08-13） -CMS Banner/FeedSlot 已验证「Admin 写 → 权限 → 审计 → C 端读 → 生效」闭环。 -**不得**把 Write-Wave Continuous Loop 无限延伸到 SystemPrompt / Knowledge。 +1. 首刀 = **StarConfig** +2. Continuous Loop 批准，**仅限 ECR-043** -本文件将下一连续授权范围 **重新明确为 ExploreConfig**，且仍须： +## Hard STOP -1. 候选评审（本文 + `ECR-043-CANDIDATE_REVIEW`） -2. Human 点名 **单一概念** 为首刀 -3. Spec → Approve → 再 Code +Rhythm / Card 合并 · ScaleDefinition · SystemPrompt / KnowledgeSource / Chunk · 支付 · UGC · soft-delete · Crisis/Handoff · Closed 后自动下一刀 -## In（本波次） +## Refs -| 允许 | 说明 | -|------|------| -| StarConfig / RhythmConfig / ImageCardDeck **配置写** | 各概念 **独立 ECR**；禁止一刀合并三表 | -| 加法权限码 | 如 `admin.explore.write`（既有 RBAC；非新权限模型） | -| 审计 · active 上下架 · C 端读生效或显隐 | 同 CMS 风险模型 | -| ScaleDefinition **元数据/目录写**（若 Human 选） | **不含**题干编辑器；status PATCH 已有 `content.write`（ECR-008）须避免重复造轮 | - -## Out / STOP - -- SystemPrompt · KnowledgeSource · KnowledgeChunk · ToolDefinition 写 -- 真支付 · UGC · soft-delete -- Crisis / Handoff / ContentSafety 高风险写 -- 合并多 ExploreConfig 概念进同一 ECR -- 改引擎分层 / 宫位制 / 牌面美术大包 -- 扩大为 AICoreConfig - -## Continuous Loop（仅 ExploreConfig） - -Human 确认首刀概念并 Approve Spec 后，允许在该 **单 ECR** 内 Approve→Code→Test→Close→commit（不 push 除非另授）。 -Closed 后 **STOP 自动开下一概念**，须再做 Candidate Review。 - -## 与 CMS Write-Wave 关系 - -| Doc | 状态 | -|-----|------| -| `WRITE_WAVE_AUTHORIZATION.md` | CMS 首段（041–042）**完成**；不再自动连跑 | -| **本文件** | ExploreConfig 写面权威入口 | +Candidate Review: `ECR-043-CANDIDATE_REVIEW.md` +Spec: `.ai/product/feature-spec/ops-star-config-write.md` +ECR: `docs/ECR/ECR-043-star-config-write.md`