微信小程序页面迁移校验之前 P5任务处理之前

apps/backend/app/schemas/xcx_auth.py

@@ -25,6 +25,46 @@ class WxLoginResponse(BaseModel):
     user_id: int
 
 
+class DevLoginRequest(BaseModel):
+    """开发模式 mock 登录请求（仅 WX_DEV_MODE=true 时可用）。"""
+    openid: str = Field(..., min_length=1, description="模拟的微信 openid")
+    status: str | None = Field(None, description="模拟的用户状态；为空时保留已有用户的当前状态，新用户默认 new")
+
+
+    # ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
+
+    class DevSwitchRoleRequest(BaseModel):
+        """切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
+        role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
+
+
+    class DevSwitchStatusRequest(BaseModel):
+        """切换用户状态请求。"""
+        status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
+
+
+    class DevSwitchBindingRequest(BaseModel):
+        """切换人员绑定请求。"""
+        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):
+        """开发调试上下文信息。"""
+        user_id: int
+        openid: str | None = None
+        status: str
+        nickname: str | None = None
+        site_id: int | None = None
+        site_name: str | None = None
+        roles: list[str] = []
+        permissions: list[str] = []
+        binding: dict | None = None
+        all_sites: list[dict] = []
+
+
+
 # ── 用户申请 ──────────────────────────────────────────────
 
 class ApplicationRequest(BaseModel):
@@ -102,3 +142,69 @@ class RejectRequest(BaseModel):
     """拒绝申请请求。"""
     review_note: str = Field(..., min_length=1, description="拒绝原因")
 
+
+# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
+
+class DevSwitchRoleRequest(BaseModel):
+    """切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
+    role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
+
+
+class DevSwitchStatusRequest(BaseModel):
+    """切换用户状态请求。"""
+    status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
+
+
+class DevSwitchBindingRequest(BaseModel):
+    """切换人员绑定请求。"""
+    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):
+    """开发调试上下文信息。"""
+    user_id: int
+    openid: str | None = None
+    status: str
+    nickname: str | None = None
+    site_id: int | None = None
+    site_name: str | None = None
+    roles: list[str] = []
+    permissions: list[str] = []
+    binding: dict | None = None
+    all_sites: list[dict] = []
+
+
+# ── 开发调试端点（仅 WX_DEV_MODE=true） ─────────────────
+
+class DevSwitchRoleRequest(BaseModel):
+    """切换角色请求。替换当前用户在当前门店下的所有角色为指定角色。"""
+    role_code: str = Field(..., description="目标角色 code（coach/staff/site_admin/tenant_admin）")
+
+
+class DevSwitchStatusRequest(BaseModel):
+    """切换用户状态请求。"""
+    status: str = Field(..., description="目标状态（new/pending/approved/rejected/disabled）")
+
+
+class DevSwitchBindingRequest(BaseModel):
+    """切换人员绑定请求。"""
+    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):
+    """开发调试上下文信息。"""
+    user_id: int
+    openid: str | None = None
+    status: str
+    nickname: str | None = None
+    site_id: int | None = None
+    site_name: str | None = None
+    roles: list[str] = []
+    permissions: list[str] = []
+    binding: dict | None = None
+    all_sites: list[dict] = []
+