using System.Security.Cryptography;
using System.Text;
using System.Text.Json.Nodes;
using Admin.NET.Core;
using Admin.NET.Plugin.AiDOP.Entity.S6;
using Admin.NET.Plugin.ApprovalFlow;
using Microsoft.Extensions.Logging;
namespace Admin.NET.Plugin.AiDOP.Service.S6;
/// 迁移结果。分项计数,运维要能看出「这次到底动了什么、什么被挡下了」。
public sealed class S6FlowAuthorityMigrationResult
{
/// 通过全部安全谓词、进入逐条处理的候选实例数。
public int CandidatesSelected { get; set; }
/// 本次实际改写快照的实例数。
public int Applied { get; set; }
/// 目标租户角色缺失 / 禁用 / 无同租户成员 / 角色不唯一 → 未改。
public int BlockedByTargetAuthority { get; set; }
/// 回滚来源缺失或不唯一 → 未改。
public int BlockedByRollbackSource { get; set; }
/// UPDATE 影响行数 ≠ 1(期间被并发改动)→ 已回滚。
public int BlockedByConcurrentModification { get; set; }
}
///
/// S6-LEGACY-SNAPSHOT-MIGRATION-1:把**仍在运行**的 S6 流程实例快照里冻结的
/// 跨租户物理 RoleId 改写为 RoleCode,让它们能在租户本地化模型下继续流转。
///
/// 问题形态(已取证,非推测):StartFlowCore 落实例时把
/// ApprovalFlow.FlowJson 整体冻结进 FlowJsonSnapshot,此后**所有推进路径
/// 一律读快照、再不看定义**。因此 2026-09-14 的租户本地化迁移(把定义的 approverIds
/// 从默认租户物理 RoleId 改成 RoleCode)**只对新发起的实例生效**;此前发起且仍未走完的
/// 实例,快照里那个跨租户 RoleId 会被 EnsureRoleAuthorityTenantScopedAsync
/// 直接 fail-closed 拒绝,单据永久卡死。
///
/// 为什么不做 runtime auto-heal:引擎里「跨租户 RoleId 一律拒绝」是刚建立的
/// 门禁,放宽它会同时影响**新**实例,等于把门拆掉;而运行时隐式把 A 角色当 B 角色执行,
/// 会让「执行的」与「快照里展示的」永久分离,比显式改写更难解释。故本服务是
/// 显式、一次性、可审计的数据迁移,不是 resolver 兼容层。
///
/// 批次边界(关键):只处理 之前发起的实例。
/// 该时点之后发起的实例本就会拿到 RoleCode 快照 —— 若之后仍出现跨租户 RoleId,
/// 那是**新的 authority regression**,必须让它响亮地失败、被人看见,
/// 绝不能被本服务静默治好。这条边界是「一次性迁移」与「长期 auto-heal」的分界线。
///
/// 只修坏的,不碰好的:终态实例一律不动(对 runtime 已无影响,改了没用,
/// 却百分之百是纯历史记录);同租户的物理 RoleId 也不动(numeric ≠ bad)。
///
public class S6LegacyFlowAuthorityMigrationService : ITransient
{
/// 与 FlowEngineService.TenantStrictRoleBizTypes 逐字一致:只有被严格守卫的链才需要迁。
internal static IReadOnlyList TargetBizTypes { get; } =
new List { "IPQC_INSPECTION", "S6_PROCESS_INSPECTION" };
///
/// 批次边界。租户本地 RoleCode 定义于 2026-09-14 发布,此后发起的实例快照本就是 RoleCode。
/// 之后再出现跨租户 RoleId = 新缺陷,不属本次迁移范围,必须 fail-closed 暴露。
///
private static readonly DateTime BatchCutoff = new(2026, 9, 14, 0, 0, 0, DateTimeKind.Unspecified);
private const string BatchPrefix = "S6-LEGACY-SNAPSHOT-MIGRATION-1";
private readonly ISqlSugarClient _db;
private readonly SqlSugarRepository _logRep;
private readonly ILogger _logger;
public S6LegacyFlowAuthorityMigrationService(
ISqlSugarClient db,
SqlSugarRepository logRep,
ILogger logger)
{
_db = db;
_logRep = logRep;
_logger = logger;
}
///
/// 选出候选(只读,不写任何东西)。Apply 与 dry-run 共用同一段谓词,
/// 避免「预演看到的」和「实际改的」是两套逻辑。
///
public async Task> SelectCandidatesAsync()
{
var candidates = new List();
// ① 运行中 + 批次边界内。ApprovalFlowInstance 无 TenantId 列,租户后面由业务实体反查。
// bizTypes / cutoff 取局部变量:SqlSugar 的表达式解析器无法把静态成员翻成 SQL 参数。
var bizTypes = TargetBizTypes.ToList();
var cutoff = BatchCutoff;
var instances = await _db.Queryable().ClearFilter()
.Where(x => bizTypes.Contains(x.BizType)
&& x.Status == FlowInstanceStatusEnum.Running
&& x.StartTime < cutoff)
.ToListAsync();
foreach (var inst in instances)
{
// ② ACTIVE 的完整判据:不能只看 Status —— 终态实例的 CurrentNodeId 可能仍停在
// N3_* 而非 end(CompleteInstance 不重写该字段),只看状态字段会误判。
var hasPending = await _db.Queryable().ClearFilter()
.AnyAsync(t => t.InstanceId == inst.Id && t.Status == FlowTaskStatusEnum.Pending);
if (!hasPending) continue;
// ③ Effective Tenant 必须由业务实体反查,禁止取登录用户租户 —— 迁移的租户判定
// 绝不能复制「推进时按登录租户解析」那个既有结构缺陷。
var tenantId = await ResolveEffectiveTenantAsync(inst.BizType, inst.BizId);
if (tenantId is not > 0) continue;
// ④ 快照里是否还存在「Role 节点 + 纯数字 token」。这同时就是幂等判据的补集:
// 迁完之后本条恒为 false,第二次运行自然选不中。
var refs = ParseNumericRoleRefs(inst.FlowJsonSnapshot);
if (refs.Count == 0) continue;
candidates.Add(new S6MigrationCandidate
{
Instance = inst,
EffectiveTenantId = tenantId.Value,
NumericRefs = refs,
});
}
return candidates;
}
/// 执行迁移。每个候选独立事务:留证 INSERT 与快照 UPDATE 原子提交,任一失败整条回滚。
public async Task MigrateAsync(CancellationToken ct = default)
{
var result = new S6FlowAuthorityMigrationResult();
var batch = $"{BatchPrefix}@{DateTime.Now:yyyyMMddHHmmss}";
List candidates;
try
{
candidates = await SelectCandidatesAsync();
}
catch (Exception ex)
{
_logger.LogError(ex, "S6 legacy flow authority migration: 候选选取失败,本次跳过");
return result;
}
result.CandidatesSelected = candidates.Count;
foreach (var c in candidates)
{
if (ct.IsCancellationRequested) break;
await MigrateOneAsync(c, batch, result);
}
// 无条件记一行汇总 —— 「本次 0 候选 0 改动」本身就是要被看见的结论:
// 迁移已收敛的证据,以及「未来若冒出新候选会被立刻发现」的可观测性基础。
_logger.LogInformation(
"S6LegacyFlowAuthorityMigration batch={Batch} selected={Selected} applied={Applied} "
+ "blockedTargetAuthority={BlockedTarget} blockedRollbackSource={BlockedRollback} blockedConcurrent={BlockedConcurrent}",
batch, result.CandidatesSelected, result.Applied,
result.BlockedByTargetAuthority, result.BlockedByRollbackSource, result.BlockedByConcurrentModification);
return result;
}
private async Task MigrateOneAsync(S6MigrationCandidate c, string batch, S6FlowAuthorityMigrationResult result)
{
var inst = c.Instance;
var before = inst.FlowJsonSnapshot ?? string.Empty;
var beforeMd5 = Md5(before);
// ── Gate 1:逐 token 解析目标角色。任一 token 映射不出来 → 整条实例不迁(禁止部分迁移,
// 否则会留下半新半旧的快照,比全旧更难排查)。
var mappings = new List();
var tokenMap = new Dictionary(StringComparer.Ordinal);
foreach (var r in c.NumericRefs)
{
foreach (var token in r.NumericTokens)
{
if (tokenMap.ContainsKey(token)) continue;
var legacyRole = await _db.Queryable().ClearFilter()
.Where(x => x.Id == long.Parse(token)).FirstAsync();
if (legacyRole == null)
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_TARGET_AUTHORITY",
$"legacy RoleId {token} 在 SysRole 中不存在", result, r => result.BlockedByTargetAuthority++);
return;
}
// 同租户的物理 RoleId 是合法引用,不是缺陷 —— 不得因为「是数字」就改它。
if (legacyRole.TenantId == c.EffectiveTenantId)
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_TARGET_AUTHORITY",
$"RoleId {token} 属于本租户 {c.EffectiveTenantId},非跨租户引用,不在迁移范围",
result, _ => result.BlockedByTargetAuthority++);
return;
}
var code = legacyRole.Code;
if (string.IsNullOrWhiteSpace(code))
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_TARGET_AUTHORITY",
$"legacy RoleId {token} 无 Code,无法映射", result, _ => result.BlockedByTargetAuthority++);
return;
}
// Gate 2:目标租户下该 Code 必须**恰好一个**启用角色。不得 First() 随便挑。
var targets = await _db.Queryable().ClearFilter()
.Where(x => x.TenantId == c.EffectiveTenantId && x.Code == code && x.Status == StatusEnum.Enable)
.ToListAsync();
if (targets.Count != 1)
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_TARGET_AUTHORITY",
targets.Count == 0
? $"目标租户 {c.EffectiveTenantId} 下不存在启用的 {code}"
: $"目标租户 {c.EffectiveTenantId} 下 {code} 有 {targets.Count} 个,AMBIGUOUS TARGET ROLE",
result, _ => result.BlockedByTargetAuthority++);
return;
}
var target = targets[0];
// Gate 3:目标角色必须至少有一个**同租户**成员,否则迁完仍旧解析 0 人。
var memberIds = await _db.Queryable().ClearFilter()
.Where(x => x.RoleId == target.Id).Select(x => x.UserId).ToListAsync();
var sameTenantMembers = memberIds.Count == 0 ? 0
: await _db.Queryable().ClearFilter()
.CountAsync(u => memberIds.Contains(u.Id) && u.TenantId == c.EffectiveTenantId);
if (sameTenantMembers == 0)
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_TARGET_AUTHORITY",
$"目标角色 {code}@{c.EffectiveTenantId}(RoleId {target.Id})无同租户成员",
result, _ => result.BlockedByTargetAuthority++);
return;
}
tokenMap[token] = code;
mappings.Add($"node={r.NodeId};{token}=>{code}@{target.Id};members={sameTenantMembers}");
}
}
// ── Gate 4:回滚来源必须唯一且与当前快照逐字节一致。ApprovalFlowVersion 全库存在
// (FlowId,Version) 重复行,该表也没有唯一约束 —— 这道门禁不是形式主义。
var versionRows = await _db.Queryable().ClearFilter()
.Where(v => v.FlowId == inst.FlowId && v.Version == inst.FlowVersion).ToListAsync();
var usable = versionRows.Where(v => Md5(v.FlowJson ?? string.Empty) == beforeMd5).ToList();
if (versionRows.Count != 1 || usable.Count != 1)
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_ROLLBACK_SOURCE",
$"ApprovalFlowVersion(FlowId={inst.FlowId},Version={inst.FlowVersion}) 命中 {versionRows.Count} 行、"
+ $"其中与当前快照 MD5 一致 {usable.Count} 行;要求恰好 1/1",
result, _ => result.BlockedByRollbackSource++);
return;
}
var rollbackSource = $"ApprovalFlowVersion#{usable[0].Id}";
// ── 结构化改写:只动 Role 节点的 approverIds,其余一律不碰。禁止字符串替换。
var after = RewriteAuthority(before, tokenMap);
if (after == null || after == before)
{
await BlockAsync(c, batch, beforeMd5, mappings, "BLOCKED_TARGET_AUTHORITY",
"结构化改写未产生变化或解析失败", result, _ => result.BlockedByTargetAuthority++);
return;
}
var afterMd5 = Md5(after);
// ── 留证 + 改写同一事务。任一失败整条回滚:不接受「改了但没留证」,
// 也不接受「留证说改了但实际没改」。
var tran = await _db.AsTenant().UseTranAsync(async () =>
{
await _logRep.AsInsertable(new AdoS6FlowAuthorityMigrationLog
{
MigrationBatch = batch,
InstanceId = inst.Id,
BizType = inst.BizType,
BizId = inst.BizId,
EffectiveTenantId = c.EffectiveTenantId,
BeforeSnapshot = before,
AfterSnapshot = after,
BeforeMd5 = beforeMd5,
AfterMd5 = afterMd5,
AuthorityMapping = string.Join(" | ", mappings),
RollbackSource = rollbackSource,
Reason = "运行中实例的快照冻结了跨租户物理 RoleId,被 TenantStrictRoleBizTypes 守卫 fail-closed;"
+ "改写为 RoleCode 后由引擎在本租户内重新解析",
Outcome = "APPLIED",
}).ExecuteCommandAsync();
// 并发守卫:实例表无 version/checksum,只能用「改前 MD5 + 状态」作乐观锁。
// 用裸 SQL 精确只改这一列,避免整实体 Updateable 把过期读到的其它列一并回写。
var affected = await _db.Ado.ExecuteCommandAsync(
"""
UPDATE ApprovalFlowInstance
SET FlowJsonSnapshot=@after
WHERE Id=@id AND Status=@running AND MD5(FlowJsonSnapshot)=@beforeMd5
""",
new List
{
new("@after", after), new("@id", inst.Id),
new("@running", (int)FlowInstanceStatusEnum.Running), new("@beforeMd5", beforeMd5),
});
if (affected != 1)
throw Oops.Oh($"CONCURRENT MODIFICATION:实例 {inst.Id} 期间被改动,affected={affected}");
});
if (!tran.IsSuccess)
{
result.BlockedByConcurrentModification++;
_logger.LogWarning(tran.ErrorException,
"S6LegacyFlowAuthorityMigration: 实例 {InstanceId} 迁移失败已整体回滚", inst.Id);
return;
}
result.Applied++;
_logger.LogInformation(
"S6LegacyFlowAuthorityMigration APPLIED instance={InstanceId} bizType={BizType} bizId={BizId} "
+ "tenant={Tenant} beforeMd5={BeforeMd5} afterMd5={AfterMd5} mapping={Mapping}",
inst.Id, inst.BizType, inst.BizId, c.EffectiveTenantId, beforeMd5, afterMd5, string.Join(" | ", mappings));
}
/// 挡下的候选同样留证 —— 「为什么没迁」和「为什么迁了」一样需要能回答。
private async Task BlockAsync(S6MigrationCandidate c, string batch, string beforeMd5,
List mappings, string outcome, string reason,
S6FlowAuthorityMigrationResult result, Action bump)
{
bump(result);
await _logRep.AsInsertable(new AdoS6FlowAuthorityMigrationLog
{
MigrationBatch = batch,
InstanceId = c.Instance.Id,
BizType = c.Instance.BizType,
BizId = c.Instance.BizId,
EffectiveTenantId = c.EffectiveTenantId,
BeforeSnapshot = c.Instance.FlowJsonSnapshot,
BeforeMd5 = beforeMd5,
AuthorityMapping = mappings.Count == 0 ? null : string.Join(" | ", mappings),
Reason = reason,
Outcome = outcome,
}).ExecuteCommandAsync();
_logger.LogWarning("S6LegacyFlowAuthorityMigration {Outcome} instance={InstanceId} reason={Reason}",
outcome, c.Instance.Id, reason);
}
///
/// Effective Tenant 由业务实体反查。ApprovalFlowInstance 自身没有 TenantId 列,
/// 而推进时引擎用的是登录租户 —— 迁移绝不能沿用那条路径,否则会把租户判定建立在
/// 「谁在执行迁移」而不是「这条单据属于谁」之上。
///
private async Task ResolveEffectiveTenantAsync(string bizType, long bizId) => bizType switch
{
"S6_PROCESS_INSPECTION" => await _db.Ado.SqlQuerySingleAsync(
"SELECT tenant_id FROM ado_s6_process_inspection_bill WHERE id=@id LIMIT 1",
new List { new("@id", bizId) }),
"IPQC_INSPECTION" => await _db.Ado.SqlQuerySingleAsync(
"SELECT tenant_id FROM qms_gcjyd WHERE id=@id LIMIT 1",
new List { new("@id", bizId) }),
_ => null,
};
///
/// 解析快照中「approverType==Role 且 approverIds 含纯数字 token」的节点。
///
/// 必须按 JSON 结构解析、结合 approverType 判断语义,不能只 grep 数字:
/// 实测同一个 Id 既可能是合法 SysRole.Id 又是合法 SysUser.Id,而
/// SpecificUser / Department 节点里的数字分别是 UserId / OrgId,
/// 纯数字匹配会把它们误判成 RoleId。
///
internal static List ParseNumericRoleRefs(string? snapshot)
{
var refs = new List();
if (string.IsNullOrWhiteSpace(snapshot)) return refs;
JsonNode? root;
try { root = JsonNode.Parse(snapshot); }
catch { return refs; }
if (root?["nodes"] is not JsonArray nodes) return refs;
foreach (var node in nodes)
{
var props = node?["properties"];
if (props == null) continue;
if (props["approverType"]?.GetValue() != nameof(ApproverTypeEnum.Role)) continue;
var ids = props["approverIds"]?.GetValue();
if (string.IsNullOrWhiteSpace(ids)) continue;
var numeric = ids.Split(',', StringSplitOptions.RemoveEmptyEntries)
.Select(s => s.Trim())
.Where(s => s.Length > 0 && long.TryParse(s, out var v) && v > 0)
.Distinct(StringComparer.Ordinal)
.ToList();
if (numeric.Count == 0) continue;
refs.Add(new S6NumericRoleRef
{
NodeId = node?["id"]?.GetValue() ?? string.Empty,
ApproverIds = ids,
NumericTokens = numeric,
});
}
return refs;
}
///
/// 结构化改写:只把 Role 节点 approverIds 里的数字 token 换成对应 RoleCode,
/// 保持 token 原顺序与原数量。节点 id / 名称 / edges / 网关条件 / approverNames 一概不动。
///
internal static string? RewriteAuthority(string snapshot, IReadOnlyDictionary tokenMap)
{
JsonNode? root;
try { root = JsonNode.Parse(snapshot); }
catch { return null; }
if (root?["nodes"] is not JsonArray nodes) return null;
var changed = false;
foreach (var node in nodes)
{
var props = node?["properties"];
if (props == null) continue;
if (props["approverType"]?.GetValue() != nameof(ApproverTypeEnum.Role)) continue;
var ids = props["approverIds"]?.GetValue();
if (string.IsNullOrWhiteSpace(ids)) continue;
var tokens = ids.Split(',', StringSplitOptions.RemoveEmptyEntries).Select(s => s.Trim()).ToList();
if (tokens.Count == 0) continue;
var rewritten = tokens.Select(t => tokenMap.TryGetValue(t, out var code) ? code : t).ToList();
var joined = string.Join(",", rewritten);
if (joined == ids) continue;
props["approverIds"] = joined;
changed = true;
}
return changed ? root!.ToJsonString() : null;
}
private static string Md5(string s)
{
var bytes = MD5.HashData(Encoding.UTF8.GetBytes(s));
return Convert.ToHexString(bytes).ToLowerInvariant();
}
}
/// 候选实例 + 其反查出的租户 + 快照中待迁的数字角色引用。
public sealed class S6MigrationCandidate
{
public ApprovalFlowInstance Instance { get; set; } = null!;
public long EffectiveTenantId { get; set; }
public List NumericRefs { get; set; } = new();
}
/// 快照中一个 Role 节点里的数字角色引用。
public sealed class S6NumericRoleRef
{
public string NodeId { get; set; } = string.Empty;
public string ApproverIds { get; set; } = string.Empty;
public List NumericTokens { get; set; } = new();
}