From ec20e9744eb2aecd9efc57803b2cb3ab94350e30 Mon Sep 17 00:00:00 2001 From: jackyu66git Date: Thu, 13 Aug 2026 20:04:36 +0800 Subject: [PATCH] =?UTF-8?q?docs(ECR-043):=20ExploreConfig=20=E5=86=99?= =?UTF-8?q?=E9=9D=A2=E5=80=99=E9=80=89=E8=AF=84=E5=AE=A1=EF=BC=9B=E6=94=B6?= =?UTF-8?q?=E7=AA=84=20Continuous=20Loop?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CMS 041–042 锁定 Closed;下一刀不进 SystemPrompt;推荐首刀 StarConfig;禁止直接写码。 Co-authored-by: Cursor --- docs/CHANGELOG.md | 1 + docs/PROJECT_PROFILE.md | 7 ++- docs/TRACEABILITY.md | 8 +-- docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md | 63 +++++++++++++++++++ .../EXPLORE_CONFIG_WRITE_AUTHORIZATION.md | 50 +++++++++++++++ docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md | 14 ++--- 6 files changed, 128 insertions(+), 15 deletions(-) create mode 100644 docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md create mode 100644 docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 8c806d3..279ded4 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -2,6 +2,7 @@ ## 2026-08-13 +- **ECR-043 Candidate Review:** ExploreConfig 写面(推荐首刀 StarConfig);CMS Write-Wave 041–042 STOP;SystemPrompt 不连跑;见 `ECR-043-CANDIDATE_REVIEW.md` - **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/PROJECT_PROFILE.md b/docs/PROJECT_PROFILE.md index 0a56222..5e743ba 100644 --- a/docs/PROJECT_PROFILE.md +++ b/docs/PROJECT_PROFILE.md @@ -53,8 +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`** · **Max=`000051`** -- **Write-Wave:** Active · ECR-041/042 Closed;下一刀须再评估边界 +- **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 - EXP: (无) - STATE: `docs/STATE/`(含 ECR-041) - TRACEABILITY: `docs/TRACEABILITY.md` · 门禁 `scripts/repo-governance-check.py` @@ -64,7 +65,7 @@ ## WIP(尚未单独 ECR) -(无;FeedSlot 写面须新 ECR,不在 041) +- **ECR-043** ExploreConfig 写面:Candidate Review 中 · **禁止写码** 直至 Human 点名概念并 Approve Spec ## Pointers diff --git a/docs/TRACEABILITY.md b/docs/TRACEABILITY.md index efaf6b3..07dea8d 100644 --- a/docs/TRACEABILITY.md +++ b/docs/TRACEABILITY.md @@ -4,7 +4,7 @@ | Anchor | Value | Rule | |--------|-------|------| -| **Next ECR** | `ECR-043` | 下一空闲裸号(Write-Wave 候选须再评估);或 `--print-anchors` | +| **Next ECR** | `ECR-043` | ExploreConfig 写面候选评审中;开码前须 Human 点名单一概念 | | **Max Migration** | `000051` | 新建 migration 必须读仓内实际 max 后 +1;禁止凭记忆;合入前 `repo-governance-check` PASS | - ECR identity **全局唯一**(含已 Closed);禁止同号双义。分叉只用 `ECR-NNN-suffix` / `ECR-NNNA`。 @@ -64,8 +64,8 @@ | ECR-038 | GrowthInsights · ReportTemplate | **Closed** | Spec ops-report-template.md · BD-2026-038 | | ECR-039 | GrowthInsights · FunnelDefinition | **Closed** | Spec ops-funnel-definition.md · BD-2026-039 | | ECR-040 | ExploreConfig · ScaleDefinition | **Closed** | Spec ops-scale-definition.md · BD-2026-040 | -| WRITE-WAVE | Ops 写面加深授权 | **Active** | `docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md` · 真支付最后 · 禁 UGC/soft-delete | -| ECR-041 | OpsCMS · Banner 薄写面 | **Closed** | Spec ops-banner-write · BD-2026-041 · migration **000051** · 禁 FeedSlot | -| ECR-042 | OpsCMS · FeedSlot 薄写面 | **Closed** | Spec ops-feed-slot-write · BD-2026-042 · 无新 migration · 复用 cms.write | +| WRITE-WAVE | Ops CMS 写面(041–042) | **CMS 段 Closed** | `WRITE_WAVE_AUTHORIZATION.md` | +| EXPLORE-WRITE | ExploreConfig 写面授权 | **Candidate Review** | `EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` | +| ECR-043 | ExploreConfig 写面(候选) | **Candidate Review** | `ECR-043-CANDIDATE_REVIEW.md` · 推荐首刀 StarConfig · **禁止直接 Code** | > **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 new file mode 100644 index 0000000..4265810 --- /dev/null +++ b/docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md @@ -0,0 +1,63 @@ +# ECR-043 Candidate Review — ExploreConfig 写面 + +**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 齐平 + +## 锁定现状(冻结) + +| 项 | 状态 | +|----|------| +| ECR-041 Banner | **CLOSED** | +| ECR-042 FeedSlot | **CLOSED** | +| Git | origin/main 齐平 | +| Migration | **000051** | +| `admin.cms.write` | 复用成功 | +| Banner / FeedSlot | **独立 Context**(未合并) | +| 支付 / UGC / soft-delete / Crisis·Handoff | **STOP** | +| SystemPrompt 等 AICoreConfig 写 | **不做下一刀** | + +## 为何下一刀是 ExploreConfig 而非 SystemPrompt + +```text +CMS 写面(已验证) + Admin写 → 权限 → 审计 → C端读 → 配置生效 + +ExploreConfig 写面(同类风险) + 同上 · 探索供给开关/目录 + +AICoreConfig 写面(高一档) + 直接改变模型行为与输出质量 → 须单独评估,不自动连跑 +``` + +## 概念候选(须拆 ECR · 本刀只选一个) + +| 优先建议 | 概念 | 表 | 已有只读 | 备注 | +|----------|------|-----|----------|------| +| **★ 推荐首刀** | **StarConfig** | `star_configs` | ECR-035 | 字段极简(code/title/active);与星座 C 端供给对齐清晰 | +| 2 | RhythmConfig | `rhythm_configs` | ECR-036 | 同构;可作 043 后下一刀 | +| 3 | ImageCardDeck | `image_card_decks` | ECR-037 | 同构;勿扩牌面内容编辑 | +| △ 慎选 | ScaleDefinition | `scales` | ECR-040 | **status 上下架已有** `admin.content.write`(ECR-008);043 若做须定义「增量」避免重复 | + +## 推荐决议草案(待 Human 拍板) + +**ECR-043 = ExploreConfig · StarConfig 薄写面** + +- 复用表;加法 `admin.explore.write` +- Admin POST/PUT;下架 `active=false`;禁 soft-delete +- C 端:读 active 配置影响供给显隐或选用(Spec 细化时锁定一条可观察路径) +- **不**做 Rhythm / Card / Scale / Prompt +- Continuous Loop **仅**在本 ECR 内;Closed 后重新 Candidate Review + +## STOP(评审即生效) + +合并 Star+Rhythm+Card · 题干编辑器 · SystemPrompt · 真支付 · UGC · soft-delete · 无限 Write-Wave + +## 下一步(仍不写码) + +1. Human:**确认首刀 = StarConfig**(或改选上表其它单一概念) +2. Human:批准 `EXPLORE_CONFIG_WRITE_AUTHORIZATION` Continuous Loop(单 ECR 范围) +3. 再写 Spec · ECR-043 · BD → Approve → 开码 + +**本回合交付 = 候选评审 + 收窄授权草案;无 `apps/` 实现。** diff --git a/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md b/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md new file mode 100644 index 0000000..eb18617 --- /dev/null +++ b/docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md @@ -0,0 +1,50 @@ +# ExploreConfig Write Authorization — ECR-043 波次(Human 待确认首刀) + +| 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** | + +## 为什么收窄授权 + +CMS Banner/FeedSlot 已验证「Admin 写 → 权限 → 审计 → C 端读 → 生效」闭环。 +**不得**把 Write-Wave Continuous Loop 无限延伸到 SystemPrompt / Knowledge。 + +本文件将下一连续授权范围 **重新明确为 ExploreConfig**,且仍须: + +1. 候选评审(本文 + `ECR-043-CANDIDATE_REVIEW`) +2. Human 点名 **单一概念** 为首刀 +3. Spec → Approve → 再 Code + +## In(本波次) + +| 允许 | 说明 | +|------|------| +| 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 写面权威入口 | diff --git a/docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md b/docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md index 27360b7..144557d 100644 --- a/docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md +++ b/docs/WAVE0/WRITE_WAVE_AUTHORIZATION.md @@ -57,14 +57,12 @@ Write → Read → C 端生效 → 权限 → 审计 / 可回滚 | `docs/WAVE0/LOOP_AUTHORIZATION.md` | 只读队列 **STOP after ECR-040** — **仍有效**;不复活只读连跑 | | **本文件** | 写面波次权威;与上者并列,互不吞并 | -## First slice lock +## First slice lock(CMS 段 · 已完成) -- **ECR-041** = Banner only -- FeedSlot = 后续独立 ECR -- SystemPrompt ≠ 首刀 -- 编码前:Active Spec · ECR · BD · contract_diff;**本回合仅交付授权 + Spec,不写码** +- **ECR-041** Banner · **ECR-042** FeedSlot · 均 **Closed** +- CMS Continuous Loop **到此 STOP**;不得自动延伸到 AICoreConfig -## Repo anchors +## Next wave -- Next ECR / Max Migration:`docs/TRACEABILITY.md` -- Gate:`python scripts/repo-governance-check.py` +ExploreConfig 写面:见 `docs/WAVE0/EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` ++ 候选评审 `docs/WAVE0/ECR-043-CANDIDATE_REVIEW.md`(**先 Review,后 Code**)