42 lines
1.4 KiB
Python
42 lines
1.4 KiB
Python
"""
|
|
用户数据模型
|
|
- 定义 users 表结构、字段约束和索引
|
|
- 提供 to_dict() 方法用于 API 响应序列化
|
|
- 注意：不要在模型中直接 import Blueprint 或路由，避免循环导入
|
|
"""
|
|
from datetime import datetime
|
|
from app import db
|
|
|
|
|
|
class User(db.Model):
|
|
"""用户表模型"""
|
|
__tablename__ = 'users'
|
|
|
|
# 主键：自增整数，InnoDB 聚簇索引默认按主键排序
|
|
id = db.Column(db.Integer, primary_key=True, autoincrement=True)
|
|
|
|
# 用户名：唯一约束 + B-tree 索引，加速查询和去重校验
|
|
username = db.Column(db.String(80), unique=True, nullable=False, index=True)
|
|
|
|
# 邮箱：唯一约束，业务层应额外做格式校验
|
|
email = db.Column(db.String(120), unique=True, nullable=False)
|
|
|
|
# 创建时间：默认值为记录插入时的 UTC 时间
|
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
|
|
|
def to_dict(self):
|
|
"""
|
|
将模型实例序列化为字典
|
|
- 用于 API JSON 响应，避免直接暴露内部字段（如密码哈希）
|
|
- datetime 转为 ISO 8601 字符串，前端可直接解析
|
|
"""
|
|
return {
|
|
'id': self.id,
|
|
'username': self.username,
|
|
'email': self.email,
|
|
'created_at': self.created_at.isoformat(),
|
|
}
|
|
|
|
def __repr__(self):
|
|
"""调试友好的字符串表示，在 Flask shell 和日志中显示"""
|
|
return f'<User {self.username}>' |