feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

apps/backend/app/schemas/xcx_notes.py

@@ -6,21 +6,23 @@
 
 from __future__ import annotations
 
-from pydantic import BaseModel, Field
+from pydantic import Field
+
+from app.schemas.base import CamelModel
 
 
-class NoteCreateRequest(BaseModel):
-    """创建备注请求（含星星评分，评分 1-5 范围约束）。"""
+class NoteCreateRequest(CamelModel):
+    """创建备注请求（含手动评分：再次服务意愿 + 再来店可能性，各 1-5）。"""
 
     target_type: str = Field(default="member")
     target_id: int
     content: str = Field(..., min_length=1)
     task_id: int | None = None
-    rating_service_willingness: int | None = Field(None, ge=1, le=5)
-    rating_revisit_likelihood: int | None = Field(None, ge=1, le=5)
+    rating_service_willingness: int | None = Field(None, ge=1, le=5, description="再次服务意愿（1-5）")
+    rating_revisit_likelihood: int | None = Field(None, ge=1, le=5, description="再来店可能性（1-5）")
 
 
-class NoteOut(BaseModel):
+class NoteOut(CamelModel):
     """备注输出模型（含评分 + AI 评分）。"""
 
     id: int