feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations
This commit is contained in:
@@ -6,17 +6,19 @@
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
from pydantic import Field
|
||||
|
||||
from app.schemas.base import CamelModel
|
||||
|
||||
|
||||
# ── 微信登录 ──────────────────────────────────────────────
|
||||
|
||||
class WxLoginRequest(BaseModel):
|
||||
class WxLoginRequest(CamelModel):
|
||||
"""微信登录请求。"""
|
||||
code: str = Field(..., min_length=1, description="微信临时登录凭证")
|
||||
|
||||
|
||||
class WxLoginResponse(BaseModel):
|
||||
class WxLoginResponse(CamelModel):
|
||||
"""微信登录响应。"""
|
||||
access_token: str
|
||||
refresh_token: str
|
||||
@@ -25,7 +27,7 @@ class WxLoginResponse(BaseModel):
|
||||
user_id: int
|
||||
|
||||
|
||||
class DevLoginRequest(BaseModel):
|
||||
class DevLoginRequest(CamelModel):
|
||||
"""开发模式 mock 登录请求（仅 WX_DEV_MODE=true 时可用）。"""
|
||||
openid: str = Field(..., min_length=1, description="模拟的微信 openid")
|
||||
status: str | None = Field(None, description="模拟的用户状态；为空时保留已有用户的当前状态，新用户默认 new")
|
||||
@@ -33,24 +35,24 @@ class DevLoginRequest(BaseModel):
|
||||
|
||||
# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
|
||||
|
||||
class DevSwitchRoleRequest(BaseModel):
|
||||
class DevSwitchRoleRequest(CamelModel):
|
||||
"""切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
|
||||
role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
|
||||
|
||||
|
||||
class DevSwitchStatusRequest(BaseModel):
|
||||
class DevSwitchStatusRequest(CamelModel):
|
||||
"""切换用户状态请求。"""
|
||||
status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
|
||||
|
||||
|
||||
class DevSwitchBindingRequest(BaseModel):
|
||||
class DevSwitchBindingRequest(CamelModel):
|
||||
"""切换人员绑定请求。"""
|
||||
binding_type: str = Field(..., description="绑定类型（assistant/staff/manager）")
|
||||
assistant_id: int | None = Field(None, description="助教 ID（binding_type=assistant 时必填）")
|
||||
staff_id: int | None = Field(None, description="员工 ID（binding_type=staff/manager 时必填）")
|
||||
|
||||
|
||||
class DevContextResponse(BaseModel):
|
||||
class DevContextResponse(CamelModel):
|
||||
"""开发调试上下文信息。"""
|
||||
user_id: int
|
||||
openid: str | None = None
|
||||
@@ -67,7 +69,7 @@ class DevLoginRequest(BaseModel):
|
||||
|
||||
# ── 用户申请 ──────────────────────────────────────────────
|
||||
|
||||
class ApplicationRequest(BaseModel):
|
||||
class ApplicationRequest(CamelModel):
|
||||
"""用户申请提交请求。"""
|
||||
site_code: str = Field(..., pattern=r"^[A-Za-z]{2}\d{3}$", description="球房ID")
|
||||
applied_role_text: str = Field(..., min_length=1, max_length=100, description="申请身份")
|
||||
@@ -76,7 +78,7 @@ class ApplicationRequest(BaseModel):
|
||||
nickname: str | None = Field(None, max_length=50, description="昵称")
|
||||
|
||||
|
||||
class ApplicationResponse(BaseModel):
|
||||
class ApplicationResponse(CamelModel):
|
||||
"""申请记录响应。"""
|
||||
id: int
|
||||
site_code: str
|
||||
@@ -89,7 +91,7 @@ class ApplicationResponse(BaseModel):
|
||||
|
||||
# ── 用户状态 ──────────────────────────────────────────────
|
||||
|
||||
class UserStatusResponse(BaseModel):
|
||||
class UserStatusResponse(CamelModel):
|
||||
"""用户状态查询响应。"""
|
||||
user_id: int
|
||||
status: str
|
||||
@@ -99,28 +101,28 @@ class UserStatusResponse(BaseModel):
|
||||
|
||||
# ── 店铺 ──────────────────────────────────────────────────
|
||||
|
||||
class SiteInfo(BaseModel):
|
||||
class SiteInfo(CamelModel):
|
||||
"""店铺信息。"""
|
||||
site_id: int
|
||||
site_name: str
|
||||
roles: list[dict] = []
|
||||
|
||||
|
||||
class SwitchSiteRequest(BaseModel):
|
||||
class SwitchSiteRequest(CamelModel):
|
||||
"""切换店铺请求。"""
|
||||
site_id: int
|
||||
|
||||
|
||||
# ── 刷新令牌 ──────────────────────────────────────────────
|
||||
|
||||
class RefreshTokenRequest(BaseModel):
|
||||
class RefreshTokenRequest(CamelModel):
|
||||
"""刷新令牌请求。"""
|
||||
refresh_token: str = Field(..., min_length=1, description="刷新令牌")
|
||||
|
||||
|
||||
# ── 人员匹配 ──────────────────────────────────────────────
|
||||
|
||||
class MatchCandidate(BaseModel):
|
||||
class MatchCandidate(CamelModel):
|
||||
"""匹配候选人。"""
|
||||
source_type: str # assistant / staff
|
||||
id: int
|
||||
@@ -131,38 +133,38 @@ class MatchCandidate(BaseModel):
|
||||
|
||||
# ── 管理端审核 ────────────────────────────────────────────
|
||||
|
||||
class ApproveRequest(BaseModel):
|
||||
class ApproveRequest(CamelModel):
|
||||
"""批准申请请求。"""
|
||||
role_id: int
|
||||
binding: dict | None = None # {"assistant_id": ..., "staff_id": ..., "binding_type": ...}
|
||||
review_note: str | None = None
|
||||
|
||||
|
||||
class RejectRequest(BaseModel):
|
||||
class RejectRequest(CamelModel):
|
||||
"""拒绝申请请求。"""
|
||||
review_note: str = Field(..., min_length=1, description="拒绝原因")
|
||||
|
||||
|
||||
# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
|
||||
|
||||
class DevSwitchRoleRequest(BaseModel):
|
||||
class DevSwitchRoleRequest(CamelModel):
|
||||
"""切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
|
||||
role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
|
||||
|
||||
|
||||
class DevSwitchStatusRequest(BaseModel):
|
||||
class DevSwitchStatusRequest(CamelModel):
|
||||
"""切换用户状态请求。"""
|
||||
status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
|
||||
|
||||
|
||||
class DevSwitchBindingRequest(BaseModel):
|
||||
class DevSwitchBindingRequest(CamelModel):
|
||||
"""切换人员绑定请求。"""
|
||||
binding_type: str = Field(..., description="绑定类型（assistant/staff/manager）")
|
||||
assistant_id: int | None = Field(None, description="助教 ID（binding_type=assistant 时必填）")
|
||||
staff_id: int | None = Field(None, description="员工 ID（binding_type=staff/manager 时必填）")
|
||||
|
||||
|
||||
class DevContextResponse(BaseModel):
|
||||
class DevContextResponse(CamelModel):
|
||||
"""开发调试上下文信息。"""
|
||||
user_id: int
|
||||
openid: str | None = None
|
||||
@@ -178,24 +180,24 @@ class DevContextResponse(BaseModel):
|
||||
|
||||
# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
|
||||
|
||||
class DevSwitchRoleRequest(BaseModel):
|
||||
class DevSwitchRoleRequest(CamelModel):
|
||||
"""切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
|
||||
role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
|
||||
|
||||
|
||||
class DevSwitchStatusRequest(BaseModel):
|
||||
class DevSwitchStatusRequest(CamelModel):
|
||||
"""切换用户状态请求。"""
|
||||
status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
|
||||
|
||||
|
||||
class DevSwitchBindingRequest(BaseModel):
|
||||
class DevSwitchBindingRequest(CamelModel):
|
||||
"""切换人员绑定请求。"""
|
||||
binding_type: str = Field(..., description="绑定类型（assistant/staff/manager）")
|
||||
assistant_id: int | None = Field(None, description="助教 ID（binding_type=assistant 时必填）")
|
||||
staff_id: int | None = Field(None, description="员工 ID（binding_type=staff/manager 时必填）")
|
||||
|
||||
|
||||
class DevContextResponse(BaseModel):
|
||||
class DevContextResponse(CamelModel):
|
||||
"""开发调试上下文信息。"""
|
||||
user_id: int
|
||||
openid: str | None = None
|
||||
@@ -207,4 +209,3 @@ class DevContextResponse(BaseModel):
|
||||
permissions: list[str] = []
|
||||
binding: dict | None = None
|
||||
all_sites: list[dict] = []
|
||||
|
||||
|
||||
Reference in New Issue
Block a user