"""
用户数据模型
- 定义 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}>'