首次提交

app/models/user.py

@@ -0,0 +1,42 @@
+"""
+用户数据模型
+- 定义 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}>'