AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/Infrastructure/S8/S8DepartmentScopeValidator.cs

using Admin.NET.Plugin.AiDOP.Entity.S0.Warehouse;

namespace Admin.NET.Plugin.AiDOP.Infrastructure.S8;

/// <summary>
/// S8-RULE-READINESS-1：「这个部门 Id 在当前租户下是否可用」的<b>唯一</b>判定实现。
///
/// <para><b>为什么必须只有一份</b>：同一个判据现在有两个调用方 ——
/// 启用前的就绪门禁（<c>S8RuleReadinessGate</c>）与运行时的自动建单
/// （<c>S8ManualReportService.ResolveAutoWatchDepartmentsAsync</c>）。
/// 两者一旦各写一份，就会出现最坏的那种结局：<b>启用检查通过、建单却失败</b>，
/// 而管理员在页面上只看到「已启用 / 最近结果：成功 / 异常 0 条」，没有任何线索。
/// 这正是本轮要消灭的静默失败，所以判据必须物理同源，不是"两处写成一样"。</para>
///
/// <para>判据三条，缺一不可：主键命中 · 属于该租户 · <c>IsActive</c>。
/// 工厂<b>不参与</b> —— 真库 <c>factory_ref_id = 1000</c> 横跨两个租户
/// （824585161322565 / 797403760988229），按工厂校验会把别家的部门判为合法。</para>
///
/// <para><c>ClearFilter()</c>：边界由本方法显式声明，不依赖全局 multi-tenant AOP 的当前行为，
/// 结果与是否开启该过滤器无关（两者判据同为 tenant_id == 传入租户）。</para>
/// </summary>
public interface IS8DepartmentScopeValidator
{
    /// <summary>部门是否存在于该租户且启用。</summary>
    Task<bool> ExistsInTenantAsync(long? deptId, long tenantId);
}

/// <summary>
/// 正式实现。<b>生产代码里只有这一份</b> —— 接口的存在是为了给测试留 seam，
/// 不是为了允许出现第二种判据。
/// </summary>
public sealed class S8DepartmentScopeValidator : IS8DepartmentScopeValidator, ITransient
{
    private readonly SqlSugarRepository<AdoS0DepartmentMaster> _deptRep;

    public S8DepartmentScopeValidator(SqlSugarRepository<AdoS0DepartmentMaster> deptRep) => _deptRep = deptRep;

    /// <summary>
    /// 部门是否存在于该租户且启用。<c>deptId</c> 为空 / 非正数、或 <c>tenantId</c> 非正数一律返回 false
    /// —— 调用方需要区分「没配」与「配了但非法」时，请在调用前自行判空，本方法不承担该语义。
    /// </summary>
    public async Task<bool> ExistsInTenantAsync(long? deptId, long tenantId)
    {
        if (!deptId.HasValue || deptId.Value <= 0 || tenantId <= 0) return false;
        return await _deptRep.AsQueryable().ClearFilter()
            .Where(x => x.Id == deptId.Value && x.TenantId == tenantId && x.IsActive)
            .AnyAsync();
    }
}