优化代码风格

schema/device_action_schema.py

@@ -4,12 +4,12 @@ from pydantic import BaseModel, Field
 
 
 # ------------------------------
-# 请求模型（新增记录用，极简）
+# 请求模型
 # ------------------------------
 class DeviceActionCreate(BaseModel):
-    """设备操作记录创建模型（0=离线，1=上线）"""
+    """设备操作记录创建模型（0=离线、1=上线）"""
     client_ip: str = Field(..., description="客户端IP")
-    action: int = Field(..., ge=0, le=1, description="操作状态（0=离线，1=上线）")
+    action: int = Field(..., ge=0, le=1, description="操作状态（0=离线、1=上线）")
 
 
 # ------------------------------
@@ -19,7 +19,7 @@ class DeviceActionResponse(BaseModel):
     """设备操作记录响应模型（与自增表对齐）"""
     id: int = Field(..., description="自增主键ID")
     client_ip: Optional[str] = Field(None, description="客户端IP")
-    action: Optional[int] = Field(None, description="操作状态（0=离线，1=上线）")
+    action: Optional[int] = Field(None, description="操作状态（0=离线、1=上线）")
     created_at: datetime = Field(..., description="记录创建时间")
     updated_at: datetime = Field(..., description="记录更新时间")
 

schema/face_schema.py

@@ -6,8 +6,8 @@ from pydantic import BaseModel, Field
 # 请求模型（前端传参校验）
 # ------------------------------
 class FaceCreateRequest(BaseModel):
-    """创建人脸记录请求模型（无需ID，由数据库自增）"""
-    name: str = Field(None, max_length=255, description="名称（可选，最长255字符）")
+    """创建人脸记录请求模型（无需ID、由数据库自增）"""
+    name: str = Field(None, max_length=255, description="名称（可选、最长255字符）")
 
 
 class FaceUpdateRequest(BaseModel):
@@ -20,7 +20,7 @@ class FaceUpdateRequest(BaseModel):
 # 响应模型（后端返回数据）
 # ------------------------------
 class FaceResponse(BaseModel):
-    """人脸记录响应模型（仍包含ID，由数据库生成后返回）"""
+    """人脸记录响应模型（仍包含ID、由数据库生成后返回）"""
     id: int = Field(..., description="主键ID（数据库自增）")
     name: str = Field(None, description="名称")
     eigenvalue: str | None = Field(None, description="特征（可为空）")

schema/response_schema.py

@@ -5,9 +5,9 @@ from pydantic import BaseModel, Field
 
 class APIResponse(BaseModel):
     """统一 API 响应模型（所有接口必返此格式）"""
-    code: int = Field(..., description="状态码：200=成功、4xx=客户端错误、5xx=服务端错误")
-    message: str = Field(..., description="响应信息：成功/错误描述")
-    data: Optional[Any] = Field(None, description="响应数据：成功时返回、错误时为 None")
+    code: int = Field(..., description="状态码: 200=成功、4xx=客户端错误、5xx=服务端错误")
+    message: str = Field(..., description="响应信息: 成功/错误描述")
+    data: Optional[Any] = Field(None, description="响应数据: 成功时返回、错误时为 None")
 
     # Pydantic V2 配置（支持从 ORM 对象转换）
     model_config = {"from_attributes": True}

schema/sensitive_schema.py

@@ -7,7 +7,7 @@ from pydantic import BaseModel, Field
 # ------------------------------
 class SensitiveCreateRequest(BaseModel):
     """创建敏感信息记录请求模型"""
-    # 移除了id字段，由数据库自动生成
+    # 移除了id字段、由数据库自动生成
     name: str = Field(None, max_length=255, description="名称")