competition-website/app/model/admin.js

'use strict';

/**
 * 管理员模型 - Admin
 *
 * 存储后台管理员账号信息，管理员通过用户名和密码进行登录。
 */

module.exports = app => {
  const { STRING, INTEGER, DATE, TEXT, TINYINT } = app.Sequelize;

  const Admin = app.model.define('admin', {
    // 主键 ID，自增
    id: {
      type: INTEGER,
      primaryKey: true,
      autoIncrement: true,
      comment: '管理员唯一标识',
    },
    // 管理员用户名，唯一
    username: {
      type: STRING(50),
      allowNull: false,
      unique: true,
      comment: '管理员用户名',
    },
    // 管理员密码（明文存储，生产环境应使用 bcrypt 加密）
    password: {
      type: STRING(100),
      allowNull: false,
      comment: '管理员密码',
    },
    // 🔴 R178 最高管理员标记：唯一、不可改权限 / 不可禁用 / 不可删除 / 不可重置口令。
    // 判据只认本字段（不认 username，避免改名绕过；也不认 id，避免误伤后续自增行）。
    is_super: {
      type: TINYINT,
      allowNull: false,
      defaultValue: 0,
      comment: '最高管理员：1=不可变动（唯一）',
    },
    // 权限点 JSON 数组（见 lib/adminPermissions.js 的 PERMISSIONS）。
    // NULL / 空数组 = 无任何业务权限；is_super=1 的账号忽略本列（恒全权）。
    permissions: {
      type: TEXT,
      allowNull: true,
      comment: '权限点 JSON 数组',
    },
    // 1=启用 0=禁用。禁用后：禁止登录，且已签发的令牌在下一次请求即被拒。
    status: {
      type: TINYINT,
      allowNull: false,
      defaultValue: 1,
      comment: '1=启用 0=禁用',
    },
    // 令牌版本：改密 / 禁用 / 改权限时自增 ⇒ 旧 JWT 中的 tv 与之不匹配即失效。
    // 这是「改密后旧会话立即下线」的唯一判据（本项目无会话表）。
    token_version: {
      type: INTEGER,
      allowNull: false,
      defaultValue: 0,
      comment: '令牌版本（改密/禁用时自增，使旧 JWT 失效）',
    },
    last_login_at: {
      type: DATE,
      allowNull: true,
      comment: '最近登录时间',
    },
    last_login_ip: {
      type: STRING(64),
      allowNull: true,
      comment: '最近登录 IP',
    },
    remark: {
      type: STRING(200),
      allowNull: true,
      comment: '备注（姓名 / 岗位）',
    },
    // 记录创建时间
    created_at: {
      type: DATE,
      allowNull: false,
      defaultValue: app.Sequelize.literal('CURRENT_TIMESTAMP'),
      comment: '创建时间',
    },
    // 记录更新时间
    updated_at: {
      type: DATE,
      allowNull: false,
      defaultValue: app.Sequelize.literal('CURRENT_TIMESTAMP'),
      comment: '更新时间',
    },
  }, {
    // 表名
    tableName: 'admins',
    // 时间戳字段
    timestamps: false,
    // 下划线命名
    underscored: true,
  });

  return Admin;
};