'use strict'; /** * 管理员高危操作审计日志 - AdminAuditLog * * 只记录**高危写操作**(不是全量写操作): * 发布/撤回成绩、重置测试数据、删除选手、撤回交卷、 * 管理员账号的增 / 改权限 / 重置口令 / 禁用 / 删除。 * * 为什么不做全量审计:本项目日志无集中采集,全量写接口约 30 个, * 日志量增长快且缺少清理策略;而「多管理员下谁改了成绩 / 谁动了账号」 * 才是真正需要回答的问题。故按「能改变比赛结果或权限边界的动作」划定范围。 * * ⚠️ 写入必须 best-effort:审计失败不得阻断业务(否则日志表故障会连累发布成绩)。 * 统一走 service.admin.recordAudit(),⛔ 不要在控制器里直接 create。 */ module.exports = app => { const { STRING, INTEGER, DATE, TEXT, BIGINT } = app.Sequelize; const AdminAuditLog = app.model.define('adminAuditLog', { id: { type: BIGINT, primaryKey: true, autoIncrement: true, comment: '日志唯一标识', }, admin_id: { type: INTEGER, allowNull: false, comment: '操作人管理员 ID', }, // 冗余存用户名:账号被删除后仍能回答「当时是谁操作的」 admin_username: { type: STRING(50), allowNull: false, comment: '操作人用户名(冗余,防账号删除后不可追溯)', }, action: { type: STRING(64), allowNull: false, comment: '动作标识,如 score.publish / admin.create', }, target: { type: STRING(200), allowNull: true, comment: '操作对象(组别 / 账号名 / 选手 ID)', }, detail: { type: TEXT, allowNull: true, comment: '补充信息(JSON 文本)', }, ip: { type: STRING(64), allowNull: true, comment: '来源 IP', }, created_at: { type: DATE, allowNull: false, defaultValue: app.Sequelize.literal('CURRENT_TIMESTAMP'), comment: '发生时间', }, }, { tableName: 'admin_audit_logs', timestamps: false, underscored: true, }); return AdminAuditLog; };