106 lines
2.8 KiB
Python
106 lines
2.8 KiB
Python
"""用户管理服务 - 数据模型定义模块。
|
||
|
||
定义系统中使用的 Pydantic 模型，包括请求体和响应体的数据结构。
|
||
"""
|
||
|
||
from datetime import datetime
|
||
from typing import Optional
|
||
|
||
from pydantic import BaseModel, EmailStr, Field
|
||
|
||
|
||
class UserCreate(BaseModel):
|
||
"""用户创建请求模型。
|
||
|
||
Attributes:
|
||
username: 用户名，3-50个字符
|
||
email: 邮箱地址
|
||
password: 密码，6-100个字符
|
||
"""
|
||
|
||
username: str = Field(..., min_length=3, max_length=50, description="用户名")
|
||
email: str = Field(..., description="邮箱地址")
|
||
password: str = Field(..., min_length=6, max_length=100, description="密码")
|
||
|
||
|
||
class UserUpdate(BaseModel):
|
||
"""用户更新请求模型。
|
||
|
||
Attributes:
|
||
username: 可选，用户名
|
||
email: 可选，邮箱地址
|
||
"""
|
||
|
||
username: Optional[str] = Field(None, min_length=3, max_length=50, description="用户名")
|
||
email: Optional[str] = Field(None, description="邮箱地址")
|
||
|
||
|
||
class UserLogin(BaseModel):
|
||
"""用户登录请求模型。
|
||
|
||
Attributes:
|
||
username: 用户名
|
||
password: 密码
|
||
"""
|
||
|
||
username: str = Field(..., description="用户名")
|
||
password: str = Field(..., description="密码")
|
||
|
||
|
||
class UserResponse(BaseModel):
|
||
"""用户信息响应模型。
|
||
|
||
Attributes:
|
||
id: 用户唯一标识
|
||
username: 用户名
|
||
email: 邮箱地址
|
||
created_at: 创建时间
|
||
is_active: 是否激活
|
||
"""
|
||
|
||
id: str = Field(..., description="用户ID")
|
||
username: str = Field(..., description="用户名")
|
||
email: str = Field(..., description="邮箱地址")
|
||
created_at: str = Field(..., description="创建时间")
|
||
is_active: bool = Field(default=True, description="是否激活")
|
||
|
||
|
||
class UserInDB(BaseModel):
|
||
"""数据库中的用户模型（包含密码哈希）。
|
||
|
||
Attributes:
|
||
id: 用户唯一标识
|
||
username: 用户名
|
||
email: 邮箱地址
|
||
hashed_password: 密码哈希值
|
||
created_at: 创建时间
|
||
is_active: 是否激活
|
||
"""
|
||
|
||
id: str = Field(..., description="用户ID")
|
||
username: str = Field(..., description="用户名")
|
||
email: str = Field(..., description="邮箱地址")
|
||
hashed_password: str = Field(..., description="密码哈希值")
|
||
created_at: str = Field(..., description="创建时间")
|
||
is_active: bool = Field(default=True, description="是否激活")
|
||
|
||
|
||
class ErrorResponse(BaseModel):
|
||
"""错误响应模型。
|
||
|
||
Attributes:
|
||
detail: 错误详情描述
|
||
"""
|
||
|
||
detail: str = Field(..., description="错误描述")
|
||
|
||
|
||
class SuccessResponse(BaseModel):
|
||
"""成功响应模型。
|
||
|
||
Attributes:
|
||
message: 成功消息
|
||
"""
|
||
|
||
message: str = Field(..., description="成功消息")
|