Guler.Editor.Premium.Audit.EfCore 0.2.0-alpha.0

Stylus.Premium.Audit.EfCore

Production-grade persistent IStylusAuditStore implementation for Stylus.Premium.Audit — EF Core 8 backed.

Sprint 7 yan paketi (ADR-011 §Sonraki Adımlar Faz 5 candidate). Stylus.Premium.Audit'in InMemoryAuditStore default'unu pilot/production'da değiştirir.

Kurulum

public class MyDbContext : DbContext
{
    public MyDbContext(DbContextOptions<MyDbContext> options) : base(options) { }

    public DbSet<StylusAuditVersion> StylusAuditVersions => Set<StylusAuditVersion>();

    protected override void OnModelCreating(ModelBuilder mb)
    {
        // Stylus audit tablo şemasını otomatik konfigüre et
        mb.ApplyStylusAuditConfiguration();
    }
}

// Program.cs
builder.Services.AddDbContext<MyDbContext>(opts =>
    opts.UseSqlite("Data Source=app.db"));

builder.Services.AddStylusPremium(license: cfg["Stylus:LicenseKey"]);
builder.Services.AddStylusAudit(opts => opts.RetentionDays = 90);
builder.Services.AddStylusAuditEfCore<MyDbContext>();   // ← bu paket

AddStylusAuditEfCore<TContext>() çağrısı:

• IStylusAuditStore registration'ını EfCoreAuditStore<TContext> ile override eder (ana paketin InMemoryAuditStore default'unu değiştirir)
• TContext'in DbSet<StylusAuditVersion> propertysi'ne erişebilmesi için marker interface yok — Stylus EF Core internal Context resolution kullanır

Migration

dotnet ef migrations add AddStylusAudit
dotnet ef database update

Veya programmatic:

using var scope = app.Services.CreateScope();
var db = scope.ServiceProvider.GetRequiredService<MyDbContext>();
db.Database.Migrate();

Schema

Tek tablo: StylusAuditVersions

• Id (long, PK, identity)
• ContentKey (string, indexed)
• VersionNumber (int)
• Html (text)
• UserId (string)
• Title (string, nullable)
• Timestamp (DateTimeOffset, indexed)

Composite unique index: (ContentKey, VersionNumber) — concurrent save'lerde çakışma koruması.

Atomik VersionNumber

InMemoryAuditStore Interlocked.Increment ile atomik artırma yapıyor; EF Core'da bu mümkün değil (multi-instance concurrent insert race condition). Çözüm:

• (ContentKey, VersionNumber) UNIQUE INDEX
• INSERT öncesi MAX(VersionNumber) + 1 SELECT (transaction içinde)
• DbUpdateException UNIQUE violation yakalandığında 1 retry

Production'da SERIALIZABLE isolation level + retry policy ek güvence.

Tests

tests/Stylus.Premium.Audit.EfCore.Tests/ — Microsoft.EntityFrameworkCore.Sqlite in-memory ile.

İlgili kaynaklar

• Stylus.Premium.Audit ana paket
• ADR-011 Audit log diff §Sonraki Adımlar
• ADR-003 Yan paket pattern