| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172 |
- from datetime import datetime
- from zoneinfo import ZoneInfo
- from app.constants import OperationType, OperationStatus
- from app.models import db
- class Operation(db.Model):
- """
- 操作模型类，表示数据库中的 'operation' 表。
- 包括操作类型、描述、耗时、状态、用户信息等，用于系统的审计、监控和分析。
- Attributes:
- operation_id (int): 操作记录 ID，自动增长的主键。
- operation_type (str): 操作类型，使用枚举定义，如 'authenticate', 'create', 'read', 'update', 'delete' 等。
- description (str): 对操作的详细描述，帮助理解操作的背景和过程。
- duration (float): 操作耗时，单位为秒（s）。
- failure_message (str): 当操作失败时，记录失败信息，帮助诊断问题。
- ip_address (str): 用户进行操作时的 IP 地址，记录操作来源的网络地址。
- device_info (str): 用户操作时的设备信息，通常为浏览器类型、操作系统等。
- status (str): 操作状态，表示操作是否成功，使用枚举定义，'success' 或 'failure'。
- created_at (datetime): 操作记录的时间戳，自动记录每条操作的创建时间。
- owner_id (int): 操作执行者的用户 ID，外键关联用户表，标识执行该操作的用户。
- Relationships:
- owner (User): 每条操作日志记录一个用户，表示该操作由哪个用户执行。
- """
- __tablename__ = 'operation'
- operation_id = db.Column(db.Integer, primary_key=True, autoincrement=True) # 操作记录 ID
- operation_type = db.Column(db.Enum(OperationType), default=OperationType.READ, nullable=False) # 操作类型
- description = db.Column(db.Text, nullable=False) # 操作描述
- duration = db.Column(db.Float, default=0.0, nullable=False) # 操作耗时（s）
- failure_message = db.Column(db.Text, default='无') # 失败信息
- ip_address = db.Column(db.String(45), nullable=False) # IP 地址
- device_info = db.Column(db.String(255), nullable=False) # 设备信息
- status = db.Column(db.Enum(OperationStatus), default=OperationStatus.SUCCESS, nullable=False) # 操作状态
- created_at = db.Column(db.DateTime, default=lambda: datetime.now(ZoneInfo("Asia/Shanghai"))) # 操作时间
- owner_id = db.Column(db.Integer, db.ForeignKey('user.user_id')) # 所属用户 ID（外键）
- # 设置与 User 的关系：一个操作记录只属于一个用户
- owner = db.relationship('User', backref=db.backref('operations', lazy=True))
- def __repr__(self):
- return (f"Operation(operation_id: {self.operation_id}, "
- f"operation_type: {self.operation_type.name}, "
- f"description: {self.description}, "
- f"duration: {self.duration}, "
- f"failure_message: {self.failure_message}, "
- f"ip_address: {self.ip_address}, "
- f"device_info: {self.device_info}, "
- f"status: {self.status.name}, "
- f"created_at: {self.created_at}, "
- f"owner_id: {self.owner_id})")
- def to_dict(self):
- """
- 将 Operation 实例转化为字典。
- """
- return {
- 'operation_id': self.operation_id,
- 'operation_type': self.operation_type.name,
- 'description': self.description,
- 'duration': self.duration,
- 'failure_message': self.failure_message,
- 'ip_address': self.ip_address,
- 'device_info': self.device_info,
- 'status': self.status.name,
- 'created_at': self.created_at,
- 'owner_id': self.owner_id
- }
|
