107 lines
3.7 KiB
Python
107 lines
3.7 KiB
Python
|
# =============================================================================
|
|||
|
|
# 企微IT智能服务台 — 快速回复模板 Pydantic Schema
|
|||
|
|
# =============================================================================
|
|||
|
|
# 说明：定义快速回复模板的请求/响应数据结构
|
|||
|
|
# 支持 CRUD 操作：创建、读取、更新、删除
|
|||
|
|
# =============================================================================
|
|||
|
|
|
|||
|
|
from datetime import datetime
|
|||
|
|
from typing import Any, Dict, List, Optional
|
|||
|
|
|
|||
|
|
from pydantic import BaseModel, Field
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 创建快速回复模板 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class QuickReplyCreate(BaseModel):
|
|||
|
|
"""创建快速回复模板请求 Schema。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
category: 分类（账号/网络/软件/硬件/通用）
|
|||
|
|
title: 模板标题
|
|||
|
|
content: 模板内容（支持 {employee_name} 等变量）
|
|||
|
|
variables: 可用变量列表
|
|||
|
|
sort_order: 排序权重
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
category: str = Field(default="通用", max_length=64, description="分类")
|
|||
|
|
title: str = Field(..., min_length=1, max_length=128, description="模板标题")
|
|||
|
|
content: str = Field(..., min_length=1, description="模板内容")
|
|||
|
|
variables: List[str] = Field(default_factory=list, description="可用变量列表")
|
|||
|
|
sort_order: int = Field(default=0, description="排序权重")
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 更新快速回复模板 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class QuickReplyUpdate(BaseModel):
|
|||
|
|
"""更新快速回复模板请求 Schema。
|
|||
|
|
|
|||
|
|
所有字段可选，只更新传入的字段。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
category: 分类
|
|||
|
|
title: 模板标题
|
|||
|
|
content: 模板内容
|
|||
|
|
variables: 可用变量列表
|
|||
|
|
sort_order: 排序权重
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
category: Optional[str] = Field(None, max_length=64, description="分类")
|
|||
|
|
title: Optional[str] = Field(None, max_length=128, description="模板标题")
|
|||
|
|
content: Optional[str] = Field(None, description="模板内容")
|
|||
|
|
variables: Optional[List[str]] = Field(None, description="可用变量列表")
|
|||
|
|
sort_order: Optional[int] = Field(None, description="排序权重")
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 快速回复模板响应 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class QuickReplyResponse(BaseModel):
|
|||
|
|
"""快速回复模板响应 Schema。
|
|||
|
|
|
|||
|
|
返回给前端的快速回复模板数据结构。
|
|||
|
|
使用 from_attributes=True 支持从 SQLAlchemy 模型直接转换。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
id: 模板ID
|
|||
|
|
category: 分类
|
|||
|
|
title: 模板标题
|
|||
|
|
content: 模板内容
|
|||
|
|
variables: 可用变量列表
|
|||
|
|
sort_order: 排序权重
|
|||
|
|
status: 状态（draft/pending_review/approved/rejected）
|
|||
|
|
version: 版本号
|
|||
|
|
submitted_by: 提交人 agent_id
|
|||
|
|
created_at: 创建时间
|
|||
|
|
updated_at: 更新时间
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
id: str
|
|||
|
|
category: str
|
|||
|
|
title: str
|
|||
|
|
content: str
|
|||
|
|
variables: List[str]
|
|||
|
|
sort_order: int
|
|||
|
|
status: str = "approved"
|
|||
|
|
version: int = 1
|
|||
|
|
submitted_by: Optional[str] = None
|
|||
|
|
created_at: datetime
|
|||
|
|
updated_at: datetime
|
|||
|
|
|
|||
|
|
model_config = {"from_attributes": True}
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 快速回复模板列表响应 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class QuickReplyListResponse(BaseModel):
|
|||
|
|
"""快速回复模板列表响应 Schema。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
items: 模板列表
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
items: List[QuickReplyResponse]
|