Filament-Approvals 项目中处理已有数据的审批流程迁移方案

Filament-Approvals 项目中处理已有数据的审批流程迁移方案

filament-approvals 项目地址: https://gitcode.com/gh_mirrors/fi/filament-approvals

问题背景

在使用 Filament-Approvals 包为现有项目添加审批流程功能时，开发者常会遇到一个典型问题：如何让安装包之前已经存在的模型数据也能纳入新的审批流程体系。这些"历史数据"由于创建时没有关联审批状态记录，导致无法正常进行审批操作。

核心问题分析

当我们在已有数据的项目中引入 Filament-Approvals 时，系统会面临以下技术挑战：

1. 已有数据缺少关联的审批状态记录
2. 审批流程步骤尚未初始化
3. 数据状态与新审批系统不兼容

解决方案

迁移脚本方案

针对这个问题，我们可以通过编写数据库迁移脚本，为已有数据初始化审批状态记录。以下是具体实现步骤：

1. 创建迁移文件：

php artisan make:migration migrate_existing_data_to_approval_system

2. 在迁移文件中实现数据转换逻辑：

use App\Models\UserLicense;
use EightyNine\Approvals\Models\ApprovalFlowStep;
use EightyNine\Approvals\Enums\ApprovalStatusEnum;

// ...

UserLicense::doesntHave('approvalStatus')->each(function ($license) {
    $license->approvalStatus()->create([
        'steps' => ApprovalFlowStep::forModel($license)
            ->get()
            ->map(function ($step) {
                return [
                    'id' => $step->id,
                    'role_id' => $step->role_id,
                    'action' => $step->action,
                    'process_approval_id' => null,
                    'role_name' => $step->role?->name ?? $step->role_id,
                    'process_approval_action' => null,
                ];
            }),
        'status' => ApprovalStatusEnum::SUBMITTED->value,
        'creator_id' => 1, // 或使用适当的默认管理员ID
    ]);
});

关键实现要点

1. 数据筛选：使用 doesntHave('approvalStatus') 确保只为尚未初始化审批状态的数据执行迁移

2. 审批步骤映射：通过 ApprovalFlowStep::forModel() 获取模型对应的审批流程步骤

3. 状态初始化：根据业务需求设置初始状态，通常设为 SUBMITTED 或 CREATED

4. 创建者设置：合理设置 creator_id，可使用系统管理员ID或留空

实施建议

1. 测试环境验证：先在测试环境执行迁移，验证数据转换效果

2. 分批处理：对于大数据量，考虑使用 chunk 方法分批处理

3. 备份策略：执行前确保有完整的数据备份

4. 状态回滚：准备回滚方案，以防迁移出现问题

扩展思考

这种数据迁移模式不仅适用于 Filament-Approvals 项目，也可以应用于其他需要为已有数据添加新功能的场景。关键在于：

1. 保持数据一致性
2. 确保迁移过程可逆
3. 处理边界条件和异常情况
4. 提供清晰的迁移日志

通过这种系统化的迁移方案，开发者可以平滑地将已有数据纳入新的审批流程体系，实现功能的无缝过渡。

filament-approvals 项目地址: https://gitcode.com/gh_mirrors/fi/filament-approvals