chore: 批量整理代码格式与优化细节

- 修复多处代码缩进、换行不规范问题
- 调整部分配置注释与字符串格式对齐
- 优化导入语句与多行表达式的排版
- 统一枚举、模型字段的注释风格
- 调整部分校验逻辑与提示文案
- 重构部分长函数参数与查询语句格式

backend/app/api/v1/module_system/dept/model.py

@@ -23,12 +23,10 @@ class DeptModel(ModelMixin, TenantMixin):
 
     name: Mapped[str] = mapped_column(String(64), nullable=False, comment="部门名称")
     order: Mapped[int] = mapped_column(Integer, nullable=False, default=999, comment="显示排序")
-    code: Mapped[str] = mapped_column(
-        String(16), nullable=False, comment="部门编码"
-    )
+    code: Mapped[str] = mapped_column(String(64), nullable=False, comment="部门编码")
     leader: Mapped[str | None] = mapped_column(String(32), default=None, comment="部门负责人")
-    phone: Mapped[str | None] = mapped_column(String(11), default=None, comment="手机")
-    email: Mapped[str | None] = mapped_column(String(64), default=None, comment="邮箱")
+    phone: Mapped[str | None] = mapped_column(String(20), default=None, comment="手机")
+    email: Mapped[str | None] = mapped_column(String(128), default=None, comment="邮箱")
 
     # 树形结构字段
     parent_id: Mapped[int | None] = mapped_column(

backend/app/api/v1/module_system/dept/schema.py

@@ -9,53 +9,38 @@ from app.core.validator import DateTimeStr, validate_required_code
 class DeptCreateSchema(BaseModel):
     """部门创建模型"""
 
-    name: str = Field(..., max_length=64, description="部门名称")
+    name: str = Field(..., min_length=1, max_length=64, description="部门名称")
     order: int = Field(default=1, ge=0, description="显示顺序")
-    code: str = Field(..., max_length=16, description="部门编码")
+    code: str = Field(..., min_length=2, max_length=64, description="部门编码")
     leader: str | None = Field(default=None, max_length=32, description="部门负责人")
-    phone: str | None = Field(default=None, max_length=11, description="手机")
-    email: str | None = Field(default=None, max_length=64, description="邮箱")
+    phone: str | None = Field(default=None, max_length=20, description="联系电话")
+    email: str | None = Field(default=None, max_length=128, description="邮箱")
     parent_id: int | None = Field(default=None, ge=0, description="父部门ID")
-    status: str = Field(default="0", description="是否启用(0:启用 1:禁用)")
-    description: str | None = Field(default=None, max_length=255, description="备注说明")
+    status: str = Field(default="0", max_length=1, description="状态(0:正常 1:禁用)")
+    description: str | None = Field(default=None, max_length=255, description="备注")
 
     @field_validator("name")
     @classmethod
     def validate_name(cls, value: str):
-        """
-        校验并规范化部门名称（去空格、非空）。
-
-        参数:
-        - value (str): 部门名称。
-
-        返回:
-        - str: 规范化后的部门名称。
-
-        异常:
-        - ValueError: 部门名称为空时抛出。
-        """
-        if not value or len(value.strip()) == 0:
+        """校验部门名称：不能为空"""
+        if not value or not value.strip():
             raise ValueError("部门名称不能为空")
-        value = value.replace(" ", "")
-        return value
+        return value.strip()
 
     @field_validator("code")
     @classmethod
     def validate_code(cls, value: str):
-        """
-        校验部门编码（与角色编码规则一致，见 `validate_required_code`）。
-
-        参数:
-        - value (str): 部门编码。
-
-        返回:
-        - str: 规范化后的部门编码。
-
-        异常:
-        - ValueError: 编码不满足格式要求时抛出。
-        """
+        """校验部门编码：字母开头，2-64 位，仅含字母/数字/下划线"""
         return validate_required_code(value)
 
+    @field_validator("status")
+    @classmethod
+    def validate_status(cls, value: str):
+        """校验状态：仅支持 0(正常)、1(禁用)"""
+        if value not in {"0", "1"}:
+            raise ValueError("状态仅支持 0(正常) 或 1(禁用)")
+        return value
+
 
 class DeptUpdateSchema(DeptCreateSchema):
     """部门更新模型"""

backend/app/api/v1/module_system/dept/service.py

@@ -91,6 +91,11 @@ class DeptService:
         obj = await DeptCRUD(auth).get(code=data.code)
         if obj:
             raise CustomException(msg="创建失败，编码已存在")
+
+        # 检查租户配额
+        from app.api.v1.module_system.tenant.service import TenantService
+        await TenantService.check_quota_service(auth, auth.tenant_id, "dept")
+
         dept = await DeptCRUD(auth).create(data=data)
         return DeptOutSchema.model_validate(dept).model_dump()