AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/Service/S8/S8BizException.cs

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

/// <summary>S8 业务规则异常，由 Controller 捕获后返回 400。</summary>
public class S8BizException : Exception
{
    public S8BizException(string message) : base(message) { }
}

/// <summary>
/// S8-TENANT-FACTORY-P0-CLOSURE-1：目标资源在当前可信作用域内不存在（不存在，或属于其它租户 / 工厂）。
/// 由 Controller 捕获后统一返回 404——对越权 Id 与不存在 Id 给出同一响应，
/// 不泄露「他租户存在该资源」。继承 <see cref="S8BizException"/>，
/// 使既有只捕获 S8BizException 的调用方仍能安全降级为 400，而不是 500。
/// </summary>
public sealed class S8NotFoundException : S8BizException
{
    public S8NotFoundException(string message = "记录不存在") : base(message) { }
}

/// <summary>
/// S8-STEP6D-CFG-ALERT-LEGACY-WRITE-GUARD-CERT-1：该配置对象已转为历史兼容只读，写入口已退役。
/// 由 Controller 捕获后返回 <b>410 Gone</b>——语义是「该能力曾经存在、现已永久退役」，
/// 区别于 400（入参不合法，改对了还能存）与 404（找不到，换个 Id 还能存）。
///
/// 继承 <see cref="S8BizException"/>，与 <see cref="S8NotFoundException"/> 同理：
/// 使既有只捕获 S8BizException 的调用方安全降级为 400，而不是 500。
/// ⚠️ Controller 的 catch 顺序必须把本类型排在 S8BizException 之前，否则会被基类先吞掉降级成 400。
///
/// <see cref="UserMessage"/> 是**固定文案**，供 Controller 直接返回；
/// 不要把 ex.Message 以外的内部信息（异常类型名 / 堆栈 / SQL）暴露给前端。
/// </summary>
public sealed class S8WriteRetiredException : S8BizException
{
    /// <summary>面向用户的统一文案：说明只读原因 + 指出当前真正的运行时权威。</summary>
    public const string UserMessage =
        "告警规则已转为历史兼容只读配置，当前运行时告警判定由监控规则管理。";

    public S8WriteRetiredException() : base(UserMessage) { }
}