jackyu66gitandCursor
93227d3316
新增 ask_quality_feedback、运营/C端评分 API 与 admin-h5 问答反馈区；禁改消息/UGC/真支付。 Co-authored-by: Cursor <cursoragent@cursor.com>
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
# Feature Spec: QualityFeedback（Ops · ECR-020）
|
||
|
||
> Status: `Active`（Loop continuous · **ECR-020 Closed**）
|
||
> Parent: WAVE0-FROZEN · Predecessor: ECR-019 Closed
|
||
> Capability: `AskOperations` · BC: `Ask_Ops`
|
||
> 授权：`docs/WAVE0/LOOP_AUTHORIZATION.md`
|
||
|
||
## Non-goals
|
||
|
||
改写消息正文 · SystemPrompt/Knowledge · HandoffCase 全量 · AICoreConfig · UGC 广场 · 真支付
|
||
|
||
## L2 Domain
|
||
|
||
| 概念 | 语义 |
|
||
|------|------|
|
||
| `QualityFeedback` | 绑定 thread（可选 message）；rating 1–5；tag ∈ {helpful,off_topic,unsafe,other}；source ∈ {admin,user} |
|
||
|
||
## L3 API
|
||
|
||
| Method | Path | 权限 | 语义 |
|
||
|--------|------|------|------|
|
||
| GET | `/admin/ask/feedback` | `admin.ask.read` | 列表 |
|
||
| POST | `/admin/ask/threads/:id/feedback` | `admin.ask.feedback.write` | 运营提交 |
|
||
| POST | `/ask/threads/:id/feedback` | DeviceAuth 用户 | C 端评分 |
|
||
|
||
## Migration
|
||
|
||
`000021`：`ask_quality_feedback` + 授予 `admin.ask.feedback.write`
|
||
|
||
## L4 AC
|
||
|
||
| ID | Then |
|
||
|----|------|
|
||
| AC-F-01 | admin POST feedback → 200 · list 可见 |
|
||
| AC-F-02 | user POST feedback → 200 |
|
||
| AC-F-03 | 无效 rating → 400 |
|
||
| AC-S-01 | 无 Admin → admin list 401 |
|
||
| AC-S-02 | 无 feedback.write → admin POST 403 |
|
||
| AC-P-01 | list < 500ms |
|
||
| AC-O-01 | admin 提交写 AuditLog `ask.feedback.create` |
|
||
|
||
contract_diff: `docs/CONTRACT_DIFF/ECR-020.yaml`
|