feat(ECR-020): QualityFeedback 问答质量反馈并 Closed

新增 ask_quality_feedback、运营/C端评分 API 与 admin-h5 问答反馈区；禁改消息/UGC/真支付。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 23:02:13 +08:00
parent e270a38393
commit 93227d3316
34 changed files with 932 additions and 9 deletions
@@ -461,6 +461,72 @@ paths:
        '200':
          description: OK

+  /api/v1/admin/ask/feedback:
+    get:
+      tags: [admin]
+      summary: List QualityFeedback
+      description: Requires admin.ask.read
+      responses:
+        '200':
+          description: OK
+        '401':
+          description: Unauthorized
+
+  /api/v1/admin/ask/threads/{id}/feedback:
+    post:
+      tags: [admin]
+      summary: Create QualityFeedback (ops)
+      description: Requires admin.ask.feedback.write; writes AuditLog
+      parameters:
+        - in: path
+          name: id
+          required: true
+          schema: { type: string, format: uuid }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [rating]
+              properties:
+                rating: { type: integer, minimum: 1, maximum: 5 }
+                tag: { type: string, enum: [helpful, off_topic, unsafe, other] }
+                note: { type: string }
+                message_id: { type: string, format: uuid }
+      responses:
+        '200':
+          description: OK
+        '400':
+          description: Invalid
+        '403':
+          description: Forbidden
+
+  /api/v1/ask/threads/{id}/feedback:
+    post:
+      tags: [ask]
+      summary: User QualityFeedback on owned thread
+      parameters:
+        - in: path
+          name: id
+          required: true
+          schema: { type: string, format: uuid }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [rating]
+              properties:
+                rating: { type: integer, minimum: 1, maximum: 5 }
+                tag: { type: string }
+                note: { type: string }
+                message_id: { type: string, format: uuid }
+      responses:
+        '200':
+          description: OK
+
  /api/v1/admin/orders:
    get:
      tags: [admin]