feat(ops): ECR-007 行为分析与 ECR-008 内容运营后台
ci / h5 (push) Canceled after 0s
ci / api (push) Canceled after 0s
ci / ess-docs (push) Canceled after 0s

落地埋点 ingest/数据看板、首页宫格 CMS 与测评上下架;含账号引导、问答流式与免责声明去重,以及 review P1 审计同事务修复。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
jackyu66git
2026-08-07 02:26:16 +08:00
co-authored by Cursor
parent 7e9023f0a8
commit 7ab9add5dd
132 changed files with 8276 additions and 491 deletions
+67
View File
@@ -0,0 +1,67 @@
# ECR-008
**Title:** 运营内容配置 Ops-C(首页宫格 CRUD · 测评上下架)
**Status:** Approved
**Date:** 2026-08-07
**Approved:** 2026-08-07Human
**Change Level:** L2(新能力;栈与分层不变)
## Change
1. Active Feature Spec`.ai/product/feature-spec/ops-content.md`Ops-C
2.`home_tools` + migration `000014_ops_content`(种子=现网宫格)
3. User`GET /api/v1/home/tools`DeviceAuth,仅 enabled
4. Admin`GET|PUT /api/v1/admin/home/tools``GET /api/v1/admin/scales``PATCH /api/v1/admin/scales/:id`
5. `user-h5`:首页宫格改为 API 优先 + 静态回退
6. `admin-h5`:侧栏「内容」页(宫格 + 测评)
7. 变更写 `admin_audit_logs`
## Motivation
首页 12 宫格与测评可见性写死/仅靠库改;运营无法自助调入口与上下架。
## Scope
### Allowed
- 上列 Spec / 表 / API / H5 / admin「内容」
- path/icon 白名单;审计
- OpenAPI · ERD · feature-map §7
### ForbiddenNon-goals
- 首页 Feeds CMS · 探索目录全量 CMS · 量表题目编辑器
- 外链/上传图标 · Ops-D/E · UGC
## Risk
| Risk | Mitigation |
|------|------------|
| 错误 path 打穿站外 | 仅允许以 `/` 开头的站内相对路径,长度上限 |
| 空宫格 | PUT 校验至少 1 个 enabled;或允许空但 H5 回退静态 |
| icon 非法 | 服务端白名单对齐 `HomeToolIconName` |
| 误下架全量表 | PATCH 单条;审计可追溯 |
## Acceptance Criteria
- [x] Spec `ops-content.md` §验收通过
- [x] IntegrationPUT tools → GET home/toolsPATCH scale draft → ListPublished 不含
- [x] `go test` · `build:h5` · `build:admin` 绿
- [x] OpenAPI / TRACEABILITY / STATE / TEST_REPORT / CODE_REVIEW
- [x] `ess-validate --phase review`
- [x] Docs + CHANGELOG
## Rollback
- 关 admin 路由;H5 回退静态 catalog
- down migration(非生产可)
## Risk Review
- Path: N/A
## Linked
- Feature Spec: `.ai/product/feature-spec/ops-content.md`
- PRODUCT / ENGINEERING / BACKEND_DESIGN / HANDOFF / TASK / STATE:同号前缀
- 前序:ECR-006 Ops-A · ECR-007 Ops-B