Files
FastapiAdmin/backend/app/api/v1/module_system/dept/model.py
T
zhangtao c0d32a7eec refactor: 统一将creator_id重命名为created_id并优化模型关系
feat: 新增系统租户和用户初始化数据

style: 优化代码注释和格式

fix: 修复数据权限检查逻辑中的created_id字段判断

perf: 移除不必要的模型关系以提升性能

docs: 更新初始化数据的描述信息

chore: 清理废弃文件和冗余代码
2025-11-24 01:02:27 +08:00

76 lines
2.8 KiB
Python

# -*- coding: utf-8 -*-
from typing import TYPE_CHECKING
from sqlalchemy import String, Integer, ForeignKey
from sqlalchemy.orm import relationship, Mapped, mapped_column
from app.core.base_model import ModelMixin, TenantMixin
if TYPE_CHECKING:
from app.api.v1.module_system.role.model import RoleModel
from app.api.v1.module_system.user.model import UserModel
class DeptModel(ModelMixin, TenantMixin):
"""
部门模型
部门是租户级别的组织架构,用于实现数据权限控制:
- 部门属于租户(tenant_id必填)
- 部门不属于客户(customer_id不需要)
- 支持无限层级嵌套的树形结构
- tree_path字段用于高效实现"本部门及以下"数据权限
数据权限实现:
- 本部门: WHERE user.dept_id = current_user.dept_id
- 本部门及以下: WHERE dept.tree_path LIKE 'current_dept.tree_path%'
- 自定义: WHERE dept_id IN (role关联的部门ID列表)
tree_path格式:
- 格式: /1/3/5/ 表示从根部门到当前部门的完整路径
- 根部门: /1/
- 二级部门: /1/3/
- 三级部门: /1/3/5/
"""
__tablename__: str = "system_dept"
__table_args__: dict[str, str] = ({'comment': '部门表'})
__loader_options__: list[str] = ["tenant"]
name: Mapped[str] = mapped_column(String(40), nullable=False, comment="部门名称")
order: Mapped[int] = mapped_column(Integer, nullable=False, default=999, comment="显示排序")
code: Mapped[str | None] = mapped_column(String(20), nullable=True, index=True, 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='邮箱')
# 树形结构字段
parent_id: Mapped[int | None] = mapped_column(
Integer,
ForeignKey("system_dept.id", ondelete="SET NULL", onupdate="CASCADE"),
default=None,
index=True,
comment="父级部门ID"
)
# 关联关系 (继承自UserMixin和TenantMixin)
parent: Mapped["DeptModel | None"] = relationship(
back_populates='children',
remote_side="DeptModel.id",
foreign_keys=[parent_id],
uselist=False
)
children: Mapped[list["DeptModel"]] = relationship(
back_populates='parent',
foreign_keys=[parent_id],
lazy="selectin"
)
roles: Mapped[list["RoleModel"]] = relationship(
secondary="system_role_depts",
back_populates="depts",
lazy="selectin"
)
users: Mapped[list["UserModel"]] = relationship(
back_populates="dept",
foreign_keys="UserModel.dept_id",
lazy="selectin"
)