jack/digital-psychology
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(ECR-045): ImageCardDeck 写面闭环并 Closed

Browse Source 
复用 admin.explore.write、POST/PUT+审计、C端 GET /cards/decks、
H5 无 active 空态/失败回退；migration 000054。无牌面内容编辑。
ExploreConfig Loop STOP，禁自动 ECR-046。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
jackyu66git
2026-08-13 21:29:43 +08:00
co-authored by Cursor
parent dc93999f9e
commit 0158036341
33 changed files with 1111 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/BACKEND_DESIGN/BD-2026-045-image-card-deck-write.md
+23
View File
@@ -0,0 +1,23 @@
# Backend Design: ECR-045 ImageCardDeck Write
| Field | Value |
|-------|-------|
| ID | BD-2026-045 |
| Status | **Approved · Implemented** |
| Coding | **Done · Closed** |
| Level | L2 |
| Migration | `000054_ops_image_card_deck_write` |
## Boundary
```text
POST/PUT /api/v1/admin/explore/image-card-decks*
GET /api/v1/cards/decks
Permission: admin.explore.write (reuse)
Table: image_card_decks
Audit: explore.image_card_deck.create|update
```
## Out
牌面/单卡 · Star · Rhythm · Scale · AICore · soft-delete · payment · UGC · auto ECR-046
docs/CHANGELOG.md
+2
View File
@@ -2,6 +2,8 @@
## 2026-08-13
- **ECR-045 Closed：** ExploreConfig ImageCardDeck 薄写面（复用 `admin.explore.write` · POST/PUT · `GET /cards/decks` · `/cards` 空态/失败回退 · migration `000054` · **无牌面编辑**）· **Loop STOP** · 禁自动 ECR-046
- **ECR-045 Candidate Review Approved：** 首刀 = **ImageCardDeck**（不预设 SystemPrompt；禁牌面内容编辑）· Spec/Loop/Coding **未开** · Auth 草案 PENDING
- **ECR-044 Closed：** ExploreConfig RhythmConfig 薄写面（复用 `admin.explore.write` · POST/PUT · `GET /rhythm/configs` · `/rhythm` 空态/失败回退 · migration `000053`）· **Continuous Loop STOP** · 禁自动 ECR-045
- **ECR-044 Candidate Review Approved：** 首刀 = **RhythmConfig**（不预设 SystemPrompt）· Spec/Loop/Coding **未开** · Auth 草案 PENDING
- **ECR-043 Closed：** ExploreConfig StarConfig 薄写面（`admin.explore.write` · POST/PUT · `GET /star/configs` · `/star` 空态/失败回退 · migration `000052`）· **Continuous Loop STOP** · 禁自动 ECR-044
docs/CODE_REVIEW/ECR-045.md
+3
View File
@@ -0,0 +1,3 @@
# CODE_REVIEW — ECR-045
**Verdict:** Approve · ImageCardDeck 目录薄写 only · 无牌面/单卡 CRUD · 复用 explore.write · Closed 后 STOP · 禁自动 ECR-046 · ECR-008 Live Promote 仍 BLOCKED
docs/CONTRACT_DIFF/ECR-045.yaml
+20
View File
@@ -0,0 +1,20 @@
ecr: ECR-045
capability: ExploreConfig
change:
type: additive
breaking_change: false
migration_required: true
apis:
- method: POST
path: /api/v1/admin/explore/image-card-decks
change: added
- method: PUT
path: /api/v1/admin/explore/image-card-decks/{id}
change: added
- method: GET
path: /api/v1/cards/decks
change: added
perms:
- code: admin.explore.write
change: reused
migration: 000054_ops_image_card_deck_write
docs/ECR/ECR-045-image-card-deck-write.md
+21
View File
@@ -0,0 +1,21 @@
# ECR-045
**Title:** ExploreConfig · ImageCardDeck 薄写面
**Status:** **Closed**（2026-08-13）
**Change Level:** L2
**Auth:** `ECR-045_WRITE_AUTHORIZATION.md` · Closed 后 STOP
## Change
1. Spec `ops-image-card-deck-write`
2. 复用 `admin.explore.write` + POST/PUT image-card-decks + 审计
3. C 端 `GET /cards/decks`；`/cards` 空态/失败回退
4. Migration `000054` · OpenAPI · admin-h5
## Forbidden
牌面内容编辑 · Star/Rhythm/Scale · Prompt/Knowledge/Chunk · soft-delete · 支付 · UGC · Crisis/Handoff · **自动 ECR-046**
## Acceptance
TEST_REPORT/ECR-045 · CODE_REVIEW Approve · Done · Closed.
docs/HANDOFF/ECR-045-architect-to-engineer.md
+6
View File
@@ -0,0 +1,6 @@
# HANDOFF — Architect → Engineer · ECR-045
**Coding AUTHORIZED** — Human「Write Auth → Spec → 开码」.
ImageCardDeck write only. Reuse `admin.explore.write`. Migration 000054.
No card-face content edit. After Closed: STOP — no ECR-046.
docs/HANDOFF/ECR-045-engineer-to-reviewer.md
+4
View File
@@ -0,0 +1,4 @@
# HANDOFF — Engineer → Reviewer · ECR-045
TestExploreImageCardDeckWrite PASS · repo-governance PASS (max 000054) · Ready Closed.
禁止自动开 ECR-046 · Loop STOP · 无牌面内容编辑。
docs/PRODUCT_SPEC/ECR-045-image-card-deck-write.md
+3
View File
@@ -0,0 +1,3 @@
# PRODUCT_SPEC — ECR-045
对齐 `ops-image-card-deck-write.md` · **仅 ImageCardDeck** · **Closed**.
docs/PROJECT_PROFILE.md
+6 -5
View File
@@ -53,20 +53,21 @@
- **本仓：** `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-045`（禁自动开）** · **Max=`000053`**
- **Next ECR / Max Migration：** **Next=`ECR-046`（禁自动开）** · **Max=`000054`**
- **Write-Wave CMS：** 041–042 Closed · STOP
- **ExploreConfig：** ECR-043/044 Closed · **Loop STOP** · Prompt/Knowledge/Chunk STOP
- **ExploreConfig：** ECR-043/044/045 Closed · **Loop STOP** · Prompt/Knowledge/Chunk STOP
- **Release：** ECR-008 Live Promote **BLOCKED**（独立门禁 · 勿与 Write-Wave 混谈）
- EXP: （无）
- STATE: `docs/STATE/`（含 ECR-041…044）
- STATE: `docs/STATE/`（含 ECR-041…045）
- TRACEABILITY: `docs/TRACEABILITY.md` · 门禁 `scripts/repo-governance-check.py`
- ADR: `.ai/adr/0007-ess-ai-dual-track.md`
- Product status: `.ai/product/p1-status.md`（**P1 Complete**）· `.ai/product/p2-status.md`（**P2 Complete**）
- Active Spec: `account-auth` · `explore-test` · `home` · `star-profile` · `life-rhythm` · `input-compliance` · `ops-system` · `profile` · `ops-banner-write` · `ops-star-config-write` · `ops-rhythm-config-write`
- Active Spec: `account-auth` · `explore-test` · `home` · `star-profile` · `life-rhythm` · `input-compliance` · `ops-system` · `profile` · `ops-banner-write` · `ops-star-config-write` · `ops-rhythm-config-write` · `ops-image-card-deck-write`
## WIP（尚未单独 ECR）
- （无 · ECR-044 Closed · Loop STOP）
- （无 · ECR-045 Closed · Loop STOP）
- BD-2026-044 状态补丁：工作区可暂留 · **不**自动提交
## Pointers
docs/STATE/ECR-045.md
+7
View File
@@ -0,0 +1,7 @@
# STATE — ECR-045
| Status | **Closed** |
| Spec | ops-image-card-deck-write |
| Migration | 000054_ops_image_card_deck_write |
| Closed | 2026-08-13 |
| Next | STOP · ECR-046 禁自动开 |
docs/TEST_REPORT/ECR-045.md
+11
View File
@@ -0,0 +1,11 @@
# TEST_REPORT — ECR-045 ImageCardDeck Write
**Commit:** (pending Close)
```bash
go test ./internal/integration/ -count=1 -run TestExploreImageCardDeckWrite
python3 scripts/repo-governance-check.py
```
PASS · AC create/409/C-end hide/empty/audit/403 · migration 000054
REPO GOVERNANCE: PASS · max 000054 · Next ECR-046（禁自动开）
docs/TRACEABILITY.md
+3 -2
View File
@@ -4,8 +4,8 @@
| Anchor | Value | Rule |
|--------|-------|------|
| **Next ECR** | `ECR-045` | **冻结：** 须重新 Candidate Review + Human 单独拍板；**禁止自动开刀** |
| **Max Migration** | `000053` | 禁止凭记忆 |
| **Next ECR** | `ECR-046` | **冻结：** 须重新 Candidate Review + Human 单独拍板；**禁止自动开刀** |
| **Max Migration** | `000054` | 禁止凭记忆 |
- ECR identity **全局唯一**（含已 Closed）；禁止同号双义。分叉只用 `ECR-NNN-suffix` / `ECR-NNNA`。
- Migration **6 位版本号唯一**。撞号修复见 `docs/MIGRATION_RENUMBER.md`。
@@ -70,5 +70,6 @@
| EXPLORE-WRITE | ExploreConfig 写面授权 | **Approved · 仅 ECR-043 · Closed 后 STOP** | `EXPLORE_CONFIG_WRITE_AUTHORIZATION.md` |
| ECR-043 | ExploreConfig · StarConfig 薄写面 | **Closed** | Spec ops-star-config-write · BD-2026-043 · migration **000052** · Closed 后 STOP · 禁自动 ECR-044 |
| ECR-044 | ExploreConfig · RhythmConfig 薄写面 | **Closed** | Spec ops-rhythm-config-write · BD-2026-044 · migration **000053** · Closed 后 STOP · 禁自动 ECR-045 |
| ECR-045 | ExploreConfig · ImageCardDeck 薄写面 | **Closed** | Spec ops-image-card-deck-write · BD-2026-045 · migration **000054** · Closed 后 STOP · 禁自动 ECR-046 · 无牌面编辑 |
> **Migration：** 合并后 `000015`–`000023` 曾撞号，已重编号至 `000050`。以 `apps/api/migrations/` 与 `docs/MIGRATION_RENUMBER.md` 为准（文档中旧号引用可能滞后）。
docs/WAVE0/ECR-045-CANDIDATE_REVIEW.md
+80
View File
@@ -0,0 +1,80 @@
# ECR-045 Candidate Review — ExploreConfig 写面（续）
> **RESOLVED 2026-08-13（Human: Candidate Review → Auth/Spec/开码 → Closed）：**
> 首刀 = **ImageCardDeck** · **Closed** · Loop **STOP** · 禁自动 ECR-046
> Continuous Loop / Spec / Coding：本刀已完成并收口
**Date:** 2026-08-13
**Mode:** Candidate Review **Approved** · Spec **Closed** · Coding **Closed**
**Anchors:** Next=`ECR-046`（禁自动开）· Max Migration=`000054`
## 锁定现状（评审输入）
| 项 | 状态 |
|----|------|
| ECR-041 Banner | **CLOSED** |
| ECR-042 FeedSlot | **CLOSED** |
| ECR-043 StarConfig | **CLOSED** · migration **000052** |
| ECR-044 RhythmConfig | **CLOSED** · migration **000053** · origin/main 齐平 |
| Continuous Loop | **STOP**（044 Auth 已耗尽 · 不得继承） |
| ECR-008 RELEASE BLOCK | **独立** Live Promote BLOCKED · **勿与本刀混谈** |
| 支付 / UGC / soft-delete / Crisis·Handoff | **硬 STOP** |
| Prompt / Knowledge / Chunk | **硬 STOP** |
| BD-2026-044 docs 补丁 | 工作区可暂留 · **不**为本评审自动提交 |
## 四刀收益（继续 ExploreConfig 同构）
```text
041–044 已验证闭环：
Admin 写 → explore/cms.write → 审计 → C 端 active 读 → 空态/失败回退
下一刀：ImageCardDeck（ExploreConfig 队列剩余同构项）
复用 admin.explore.write · POST/PUT · active=false 下架
AICoreConfig（SystemPrompt 等）→ 仍排除
ScaleDefinition → 与 ECR-008 content.write 重叠风险 → 慎选/本刀不做
```
## 概念候选（只选一个 · 拆 ECR）
| 优先 | 概念 | 只读基线 | 判定 |
|------|------|----------|------|
| **★ 决议** | **ImageCardDeck** | ECR-037 · `image_card_decks` | 与 Star/Rhythm **同构**（code/title/active/system）；C 端可对标意象牌入口供给显隐；**禁止牌面/卡牌内容编辑** |
| △ 慎选 | ScaleDefinition | ECR-040 | ECR-008 已有上下架；须先定义增量，否则重复 |
| ✕ 排除 | SystemPrompt / Knowledge / Chunk | — | **硬 STOP** · 不预设 |
| ✕ 排除 | Star / Rhythm 再写 | 043–044 | 已 Closed · 禁止回头扩 |
| ✕ 排除 | Banner/FeedSlot | 041–042 | CMS Write-Wave **STOP** |
## 决议（Human Candidate Review approve）
**ECR-045 = ExploreConfig · ImageCardDeck 薄写面（候选已定 · Spec 未写）**
拟议边界（Spec 阶段细化，不得越界）：
- 复用表 `image_card_decks`；**复用** `admin.explore.write`
- Admin POST/PUT；下架仅 `active=false`；无 DELETE / soft-delete
- C 端：active deck list + 意象牌相关页空态/失败回退（对齐 043/044 哲学）
- Migration：编码时占 **000054**（现 Max=`000053`）
- **明确禁止：** 牌面/单卡 CRUD · Star/Rhythm 再写 · Scale · Prompt · Knowledge · Chunk · 支付 · UGC · Crisis/Handoff
- Continuous Loop：**仅**在单独 Auth 批准且 **仅限 ECR-045**；Closed 后立即 STOP · **禁自动 ECR-046**
## 硬 STOP（评审即生效）
| STOP | 说明 |
|------|------|
| 自动 Continuous Loop | 044 Auth **不可继承**；须新 Auth |
| 牌面内容编辑 / UGC 卡面 | 排除 |
| SystemPrompt / Knowledge / Chunk | 排除 |
| 支付 / soft-delete / Crisis·Handoff | 排除 |
| 合并 Deck+Scale+Prompt | 排除 |
| ECR-008 Live Promote | **另一条 Release Gate** · 保持 BLOCKED |
## 下一步（仍不写码）
1. ~~Human：Candidate Review approve~~ **Done**（首刀 = ImageCardDeck）
2. Human：批准 **ECR-045 专用** Write Authorization（Continuous Loop 仅 045）
3. Spec `ops-image-card-deck-write` · ECR-045 · BD → Approve
4. 开码口令后才改 `apps/`
5. Closed → **STOP** · 再谈 ECR-046 须新 Candidate Review
**本回合交付 = Candidate Review RESOLVED；无 Spec · 无 Auth Loop · 无 `apps/`。**
docs/WAVE0/ECR-045_WRITE_AUTHORIZATION.md
+27
View File
@@ -0,0 +1,27 @@
# ExploreConfig Write Authorization — ECR-045 only
| Field | Value |
|-------|-------|
| Date | 2026-08-13 |
| Authorizer | Human |
| Status | **Approved · ECR-045 Closed · Loop STOP** |
| Scope | **ECR-045 · ImageCardDeck 薄写面 ONLY** |
| Continuous Loop | **Finished · STOP** |
| After Closed | **STOP** · 禁止自动 ECR-046 |
## Human 拍板（2026-08-13）
1. Candidate Review = ImageCardDeck
2. Write Auth → Spec → 开码
3. 复用 `admin.explore.write` · **无牌面内容编辑**
4. Continuous Loop **仅限 ECR-045**
## Hard STOP
牌面/单卡 CRUD · Star/Rhythm/Scale · Prompt / Knowledge / Chunk · 支付 · UGC · soft-delete · Crisis/Handoff · Closed 后自动下一刀 · ECR-008 Live Promote 解禁
## Refs
Candidate Review: `ECR-045-CANDIDATE_REVIEW.md`
Spec: `.ai/product/feature-spec/ops-image-card-deck-write.md`
ECR: `docs/ECR/ECR-045-image-card-deck-write.md`