Galosys.Foundation.Compliance 26.9.16.1

Galosys.Foundation.Compliance

合规能力核心包：数据分类 + EntityChanges 字段级 diff + 脱敏辅助 + 合规等级。零破坏性变更，薄层引用现有 Microsoft.Extensions.Compliance.Redaction 与 Galosys.Foundation.Core 资产。

设计文档：能力缺口与行动清单 §行动 1 Phase 1 路线图：合规能力路线图 §Phase 1 决策指南：业务方按本文档「## 快速开始」+「## 特性」段落地

特性

• 数据分类：5 个内置分类（PrivateData / PublicData / SensitiveData / FinancialData(SOX) / HealthData(HIPAA)），沿用 .NET 10 官方 DataClassification 抽象
• EntityChanges：EntityChange record + IEntityChangeInterceptor 抽象 + 基于反射的默认实现（捕获字段级 diff）
• 脱敏辅助：MaskingHelper 静态门面封装 Redactor 子类调用，供 DataMaskConverter 和 SensitiveDataFilter 共同使用
• 合规等级：ComplianceLevel 三档（Lenient / Standard / Strict）+ ComplianceOptions 配置 + LogTier 四档审计分层
• DI 集成：AddCompliance() 一行注册所有合规服务

快速开始

// Program.cs
using Galosys.Foundation.Compliance;
using Microsoft.Extensions.Compliance.Classification;

var builder = WebApplication.CreateBuilder(args);

// 注册合规服务
builder.Services.AddCompliance(opts =>
{
    opts.Level = ComplianceLevel.Standard;        // Lenient / Standard(默认) / Strict
    opts.LogTier = LogTier.Business;             // Security / Business / System / Debug
    opts.IsEnabled = true;
    opts.ExcludedActions = new HashSet<string> { "HealthController.Ping" };
});

// 标注实体属性
public class Order
{
    [PrivateData]    public string Phone { get; set; } = "";   // PII
    [SensitiveData]  public string OrderNo { get; set; } = ""; // 业务敏感
    [FinancialData]  public decimal Amount { get; set; }       // SOX 财务
    [HealthData]     public string? Diagnosis { get; set; }    // HIPAA 医疗
    [PublicData]     public string PublicNote { get; set; } = "";
}

脱敏辅助（MaskingHelper）

MaskingHelper 静态门面封装 6 个官方 Redactor 调用，供业务代码直接使用：

using Galosys.Foundation.Compliance;

var masked = MaskingHelper.MaskPhone("13800138000");   // "138****8000"
var idcard = MaskingHelper.MaskIdCard("110101199001011234"); // "110101********1234"
var email  = MaskingHelper.MaskEmail("user@example.com");    // "u***@example.com"

字段级 Diff（EntityChange）

EntityChange record 携带字段级 diff 完整信息（对标 ABP EntityChange + Hibernate Envers）：

public sealed record EntityChange(
    string PropertyName,
    string? OldValue,
    string? NewValue,
    EntityChangeType ChangeType,    // Added / Modified / Deleted
    DataClassification Classification);

捕获规则：

• 仅记录标注了 DataClassification 子类的属性（避免审计日志膨胀）
• JSON 序列化值（自动处理 null / 原始类型 / 复杂对象）
• 仅输出原值与新值不相等的字段

典型用法：EF Core SaveChangesInterceptor 在 SavingChangesAsync 阶段调用 CaptureChanges() → 结果写入 AuditLog.Changes JSON 字段。

依赖

由 Directory.Packages.props 中央包管理，PackageReference 不指定 Version。

不在本包范围（v1 后续落地）

详见 合规能力路线图。

测试覆盖

Galosys.Foundation.Compliance.Tests（25 测试全通过）：

• DataClassificationsTest × 6（5 个分类值 + AttributeUsage）
• EntityChangeTest × 3（record 创建 + JSON 序列化 + enum 值）
• ComplianceOptionsTest × 5（默认值 + 配置覆盖 + enum 值）
• AddComplianceTest × 3（DI 注册 + TryAdd 语义）