SRD Enterprise Helper Framework

Bu solution, SRD_ULTRA_MASTER_HELPER_FRAMEWORK_SPEC.docx dokümanına göre yeniden düzenlenmiş kurumsal .NET 9 helper/framework altyapısıdır.

Solution Yapısı

• SRD.Core: Ana aggregate package.
• SRD.Core.Extensions: Null, conversion, string, collection, date/time ve numeric extension metotları.
• SRD.Core.Validation: Rule-based validation altyapısı.
• SRD.Core.Security: AES, SHA256, PBKDF2 password hash, OTP, secure random, PII mask ve compact JWT helper.
• SRD.Core.Logging: Structured logging ve correlation context.
• SRD.Core.Diagnostics: Performance scope ve measurement.
• SRD.Core.IO: Güvenli dosya okuma/yazma ve file hash.
• SRD.Core.Json: ToJson, FromJson, IsValidJson, pretty/compressed JSON.
• SRD.Core.Network: HTTP, ping, DNS ve internet bağlantı yardımcıları.
• SRD.Core.Threading: Retry policy, circuit breaker, async lock, timeout ve controlled parallel execution.
• SRD.Core.Expressions: Dynamic filter/order expression builder.
• SRD.Core.Reflection: Reflection property helperları.
• SRD.Core.Data: DataRow/DataTable ve SQL transaction/parameter helperları.
• SRD.Core.Caching: Thread-safe in-memory cache helper.
• SRD.Core.UI: Windows Forms MessageBox/dialog helperları.
• SRD.Core.Localization: Basit culture-based translation manager.
• SRD.Core.Testing: Test data builder foundation.
• SRD.Core.Benchmark: Benchmark projeleri için marker/foundation.
• SRD.Helper: Eski paket adına uyumluluk facade projesi.

Örnek Kullanım

using SRD.Core.Extensions;
using SRD.Core.Data;
using SRD.Core.Security;
using SRD.Core.UI;

var currCode = dr.Get("CustomerCurrCode", "USD", setDefaultWhenNull: true);
var phoneValid = "05559998877".IsNumeric();
var amount = "12,50".ToDecimal().Round(2);
var slug = "Şirket Adı".ToSlug();

var encrypted = CryptoHelper.EncryptAes("secret", "key");
var confirmed = DialogHelper.AskDelete();

Eklenen Atlanmış Alanlar

Belgedeki isteklere ek olarak kurumsal kullanım için Guard, Result<T>, password hashing doğrulama, PII masking, correlation context, retry/circuit breaker, timeout wrapper, dynamic order/filter expression, cache TTL ve SQL transaction rollback güvenliği eklendi.

Komutlar

dotnet build SRD.Core.sln
dotnet test SRD.Core.sln
dotnet pack src/SRD.Core/SRD.Core.csproj -c Release -o artifacts
dotnet pack src/SRD.Helper/SRD.Helper.csproj -c Release -o artifacts

npm ile Kurulum

Bu repo npm paketi olarak da kurulabilir. Paket, .NET NuGet/DLL artifact'lerini node_modules altına taşır.

npm install srd-enterprise-helper-framework
npx srd-helper-info

.NET projede local NuGet source olarak kullanmak için:

dotnet nuget add source ".\node_modules\srd-enterprise-helper-framework\artifacts" -n SRDLocal
dotnet add package SRD.Core --source ".\node_modules\srd-enterprise-helper-framework\artifacts"

Detaylı npm rehberi: docs/NPM-INSTALL.md

Metot Kataloğu

Arama odaklı tam kapsamlı metot kataloğu: docs/METHOD-CATALOG.md