<?php

/**
 * 文件功能：创建职务权限使用记录表迁移
 * 记录职务持有者每一次行使职权的操作（任命、撤销、奖励、警告、踢出、禁言、封IP等）
 * 操作人必须有在职职务才会写入此表
 *
 * @author   ChatRoom Laravel
 *
 * @version  1.0.0
 */

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * 创建职务权限使用记录表
     */
    public function up(): void
    {
        Schema::create('position_authority_logs', function (Blueprint $table) {
            $table->id();

            // 操作人信息
            $table->foreignId('user_id')
                ->constrained('users')
                ->cascadeOnDelete()
                ->comment('操作人 user_id');
            $table->foreignId('user_position_id')
                ->constrained('user_positions')
                ->cascadeOnDelete()
                ->comment('操作时使用的职务记录 ID');

            // 操作类型
            $table->enum('action_type', [
                'appoint',  // 任命他人到某职务
                'revoke',   // 撤销他人职务
                'reward',   // 奖励金币
                'warn',     // 警告用户
                'kick',     // 踢出用户
                'mute',     // 禁言用户
                'banip',    // 封锁 IP
                'other',    // 其他操作
            ])->comment('操作类型');

            // 操作对象
            $table->foreignId('target_user_id')
                ->constrained('users')
                ->cascadeOnDelete()
                ->comment('操作对象 user_id');
            $table->foreignId('target_position_id')
                ->nullable()
                ->constrained('positions')
                ->nullOnDelete()
                ->comment('任命/撤销时的目标职务 ID');

            // 附加数据
            $table->unsignedInteger('amount')->nullable()->comment('奖励金额（reward 操作时填写）');
            $table->string('remark', 255)->nullable()->comment('操作备注/理由');

            $table->timestamp('created_at')->comment('操作时间');

            // 查询索引（手动指定短名称，避免超过 MySQL 64 字符限制）
            $table->index(['user_position_id', 'action_type', 'created_at'], 'pal_up_id_action_created_idx');
            $table->index(['user_id', 'created_at'], 'pal_user_created_idx');
            $table->index(['target_user_id', 'created_at'], 'pal_target_created_idx');
        });
    }

    /**
     * 回滚：删除职务权限使用记录表
     */
    public function down(): void
    {
        Schema::dropIfExists('position_authority_logs');
    }
};
