<?php

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

/**
 * 应用菜单 code 字段结构迁移
 *
 * 为 admin_menus 表新增 code 字段，作为菜单稳定标识符。
 * 用于应用升级时按 code 匹配旧菜单，保留菜单 ID 和角色关联。
 *
 * 设计决策：
 * - VARCHAR(100)，足够容纳 slug 化生成的 code（最长 path 场景约 60 字符）
 * - nullable，兼容历史数据回填前为空的状态
 * - 不加 UNIQUE 约束，避免回填期间的历史重复数据导致迁移失败
 * - 加 (app_id, code) 复合索引，加速升级匹配查询
 */
return new class extends Migration
{
    public function up(): void
    {
        if (!Schema::hasColumn('admin_menus', 'code')) {
            Schema::table('admin_menus', function (Blueprint $table) {
                // after('path') 仅 MySQL 生效，SQLite 自动忽略
                $table->string('code', 100)->nullable()->after('path');
                $table->index(['app_id', 'code'], 'idx_admin_menus_app_code');
            });
        }
    }

    public function down(): void
    {
        if (Schema::hasColumn('admin_menus', 'code')) {
            Schema::table('admin_menus', function (Blueprint $table) {
                $table->dropIndex('idx_admin_menus_app_code');
                $table->dropColumn('code');
            });
        }
    }
};
