基于项目追踪器的变更日志撤销功能实现技术问询

嘿，你已经把变更日志的基础框架搭得很扎实了，接下来咱们一步步把撤销功能落地就行～

1. 明确撤销逻辑的核心动作 #

你的部件处理方法需要覆盖这几个关键步骤：

• 从UserHistory记录中提取目标字段名、旧值，以及关联的UserSettings实例
• 将UserSettings对应字段的值恢复为OldValue
• 持久化更新后的UserSettings
• （推荐）把这次撤销操作也记录到UserHistory里，方便后续追踪操作链路

2. 前端按钮与触发逻辑 #

在变更日志表格的对应行添加撤销按钮，记得只对管理员可见：

<!-- 以Blazor组件为例，可替换为你使用的框架语法 -->
@if (User.IsInRole("Admin"))
{
    <button class="btn btn-sm btn-warning" @onclick="() => TriggerUndo(historyItem)">撤销</button>
}

前端方法里直接调用后端的撤销接口（或部件处理方法），传递目标UserHistory的ID即可。

3. 后端撤销方法的具体实现 #

以C# EF Core为例，你的部件处理方法可以这么写：

public async Task<bool> ExecuteUndo(int historyRecordId)
{
    // 1. 获取要撤销的历史记录及关联的UserSettings
    var targetHistory = await _dbContext.UserHistory
        .Include(h => h.UserSettings)
        .FirstOrDefaultAsync(h => h.Id == historyRecordId);
    
    if (targetHistory == null || targetHistory.UserSettings == null)
        return false;

    // 2. 通过反射动态设置旧值（适配不同字段类型）
    var targetProperty = typeof(UserSettings).GetProperty(targetHistory.FieldName);
    if (targetProperty == null)
        return false;

    // 处理类型转换：如果OldValue是字符串存储，需转成对应字段的类型
    var restoredValue = Convert.ChangeType(targetHistory.OldValue, targetProperty.PropertyType);
    targetProperty.SetValue(targetHistory.UserSettings, restoredValue);

    // 3. 开启事务确保操作原子性
    using var transaction = await _dbContext.Database.BeginTransactionAsync();
    try
    {
        // 更新UserSettings
        _dbContext.UserSettings.Update(targetHistory.UserSettings);
        
        // 记录撤销操作到历史表
        _dbContext.UserHistory.Add(new UserHistory
        {
            FieldName = targetHistory.FieldName,
            CreatedBy = User.Identity.Name, // 当前操作的管理员
            CreatedDate = DateTime.UtcNow,
            OldValue = targetHistory.NewValue, // 把之前的新值作为本次的旧值
            NewValue = targetHistory.OldValue, // 恢复的旧值作为本次的新值
            UserSettingsId = targetHistory.UserSettingsId,
            ChangeType = "Undo" // 自定义字段标记这是撤销操作
        });

        await _dbContext.SaveChangesAsync();
        await transaction.CommitAsync();
        return true;
    }
    catch
    {
        await transaction.RollbackAsync();
        return false;
    }
}

这里要注意几个细节：

• 一定要加权限校验，确保只有管理员能调用这个方法
• 处理类型转换：如果OldValue是字符串存储，要适配数字、布尔、枚举等不同字段类型
• 用事务包裹操作，避免更新UserSettings和记录历史时出现部分成功的情况

4. 错误处理与用户反馈 #

• 后端方法返回成功/失败状态，前端根据状态给出明确提示（比如“撤销成功”或“该记录已被修改，无法撤销”）
• 处理并发场景：如果目标字段在撤销前已被其他操作修改，最好弹出提示让管理员确认是否继续

5. 额外优化建议 #

• 在UserHistory中新增IsUndone字段，标记该记录是否已被撤销，防止重复操作
• 点击撤销按钮时弹出确认框，避免管理员误操作

内容的提问来源于stack exchange，提问作者Johan W.