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

Stylus.Premium.Audit

Stylus editör için Audit Log + Version History premium paketi. ADR-011 implementasyonu.

⚠️ Ticari lisans gereklidir. Çekirdek Stylus paketleri MIT (ADR-004 kalıcı taahhüt); bu paket ayrı bir lisansla satılır. Trial mode (30 gün) varsayılan; sonrası geçerli Stylus.Premium.Audit audience'lı STY1 token zorunludur.

Özellikler (alpha)

Kurulum

// Program.cs (ASP.NET Core)
builder.Services.AddStylus();
builder.Services.AddStylusPremium(license: builder.Configuration["Stylus:LicenseKey"]);
builder.Services.AddStylusAudit(opts =>
{
    opts.RetentionDays = 30;       // default
});

Save akışına entegrasyon (consumer)

public class ArticleController(IStylusAuditLogger audit) : Controller
{
    [HttpPost("/admin/save")]
    public async Task<IActionResult> Save(ArticleInput input, CancellationToken ct)
    {
        // 1. İçeriği consumer'ın kendi DB'sine yaz
        await _db.SaveArticleAsync(input);

        // 2. Stylus audit log'a versiyon ekle (lazy cleanup tetiklenir)
        await audit.LogChangeAsync(new ContentChangeEvent
        {
            ContentKey = $"article:{input.Id}",
            Html = input.HtmlBody,
            UserId = User.Identity!.Name ?? "anonymous",
            Title = input.Title,
        }, ct);

        return RedirectToAction("Index");
    }
}

Admin "Geçmiş" sayfası

public class HistoryModel(IStylusAuditLogger audit, IStylusDiffRenderer diffRenderer) : PageModel
{
    public IReadOnlyList<ContentVersion> Versions { get; set; } = Array.Empty<ContentVersion>();
    public string? DiffHtml { get; set; }

    public async Task OnGetAsync(string slug, int? oldV, int? newV, CancellationToken ct)
    {
        Versions = await audit.GetHistoryAsync($"article:{slug}", ct);

        if (oldV is not null && newV is not null)
        {
            var diff = await audit.ComputeDiffAsync($"article:{slug}", oldV.Value, newV.Value, ct);
            DiffHtml = diffRenderer.RenderAsHtml(diff);
        }
    }
}

<link rel="stylesheet" href="~/_stylus/audit/diff.css" />

<ul>
@foreach (var v in Model.Versions)
{
    <li>v@(v.VersionNumber) — @v.UserId — @v.Timestamp.ToString("yyyy-MM-dd HH:mm")</li>
}
</ul>

@if (Model.DiffHtml is not null)
{
    @Html.Raw(Model.DiffHtml)
}

Mimari

ContentChangeEvent (consumer save handler)
  ↓ LogChangeAsync
StylusAuditLogger (lisans gate + lazy retention)
  ↓ SaveVersionAsync
IStylusAuditStore (default: InMemoryAuditStore; production: özel impl)
  ↓ ComputeDiffAsync (oldV vs newV)
htmldiff.net (HTML-aware word-level diff)
  ↓ DiffResult { OldHtml, NewHtml, Stats }
IStylusDiffRenderer.RenderAsHtml
  → <div class="stylus-audit-diff"><ins/><del/></div>

Sınırlamalar (alpha)

• InMemoryAuditStore production'da uygun değil: Restart'ta veri kaybı. Consumer kendi IStylusAuditStore impl'ini yazmalı (~80 satır EF Core örneği docs/tr/audit-log.md'de).
• Stylus.Core'da otomatik audit hook yok: Consumer save handler'ında elle LogChangeAsync çağırır. Auto-instrument Faz 5.
• Rollback / branching / blame yok: Faz 5 candidate'ları.
• htmldiff.net paragraph reorder yanlış işaretler: Pilot feedback gelirse Faz 5'te HTML node-tree custom diff.
• Lazy cleanup inactive content miss: 1 yıl save almayan content temizlenmez; hosted background service Faz 5.

XSS uyarısı

htmldiff.net çıktısı <ins>/<del> HTML tag'leri içerir; consumer'ın user content'ini diff öncesi sanitize etmesi gerekir. Stylus.Core'un IStylusSanitizer'ı save akışında zaten çalışıyor — LogChangeAsync'a sanitized HTML geliyor.

İlgili kaynaklar

• ADR-011 audit log diff algoritması: decisions/ADR-011-audit-log-diff.md
• ADR-005 Premium feature scope: decisions/ADR-005-premium-feature-scope.md
• .NET diff library research: research/dotnet-diff-libraries.md