Atis.Reference 2.0.0-preview.4

Atis.Reference

Ortaq ATIS DB-nin lüğət (lookup) cədvəlləri üçün read-only EF Core mapping-ləri və keşlənən oxuyucu. Servislər dbo.EducationLevel, dbo.DocumentType və s. cədvəlləri öz entity-ləri kimi kopyalamır — bu paketi qoşub oxuyur. 27 cədvəl (ReferenceTables sabitləri), hamısı dbo, hamısı yalnız oxu.

Qeydiyyat

// DI
services.AddAtisPersistence<StaffDbContext>(configuration, o => o.Schema = "staff");
services.AddAtisReference<StaffDbContext>();          // AddMemoryCache() + IReferenceService

// Context
public sealed class StaffDbContext(DbContextOptions<StaffDbContext> o, AtisDbContextOptions<StaffDbContext> a)
    : AtisDbContextBase(o, a)
{
    protected override void ConfigureModel(ModelBuilder b)
    {
        b.ApplyAtisReference();                       // 27 lüğət: dbo, ToAtisReadOnlyTable, ExcludeFromMigrations
        b.ApplyConfigurationsFromAssembly(typeof(StaffDbContext).Assembly);
    }
}

AddAtisReference<TContext> IUnitOfWork<TContext>-ə söykənir — deməli AddAtisPersistence<TContext> əvvəl çağırılmalıdır. IReferenceService scoped-dır, keş (IMemoryCache) isə proses-səviyyəlidir.

İstifadə

public sealed class StaffService(IReferenceService references)
{
    public async Task<IReadOnlyList<EducationLevel>> LevelsAsync(CancellationToken ct)
        => await references.GetAllAsync<EducationLevel>(ct);       // 10 dəq keş

    public Task<DocumentType?> DocumentTypeAsync(int id, CancellationToken ct)
        => references.GetAsync<DocumentType>(id, ct);              // eyni keşdən tapır
}

• GetAllAsync<T>() — bütün sətirlər, Id üzrə; ilk çağırışda DB, sonra 10 dəqiqə keş.
• GetAsync<T>(id) — GetAllAsync keşindən; ayrıca DB sorğusu yoxdur.
• Invalidate<T>() — keşi sil (lüğət ATIS Core tərəfindən dəyişdirildikdən sonra, məs. admin əməliyyatı və ya event ilə). Keş prosesə bağlıdır — çox instansiyalı deploy-da hər instansiya öz keşini saxlayır; 10 dəqiqəlik TTL bunun üçün qəbul edilən gecikmədir.

Entity formaları (Atis.Reference.Entities)

Hamısı IReferenceEntity : IOriginEntity<int>. Sütun adları xassə adları ilə eynidir (ATIS Core-da [Column] arqumentsizdir); DisplayName kimi hesablanan xassələr Ignore olunur. Cədvəl adları ATIS DB-dəki faktiki adlardır və hamısı cəm/tək baxımından tutarlı deyil (EducationLevel amma EducationTypes) — ReferenceTables sabitlərini işlət, sətir yazma.

Qoruma

Mapping ToAtisReadOnlyTable ilə gedir: ExcludeFromMigrations (servisin migration-ı dbo-ya toxunmur)

• Atis:Owned=false annotasiyası. Atis.Persistence-in ReadOnlyEntitySaveChangesInterceptor-u bu entity-lərdə Added/Modified/Deleted görəndə AtisReadOnlyEntityException atır — lüğəti servisdən dəyişmək mümkün deyil, sahibi ATIS Core-dur (spec §2.1).

Yeni lüğət əlavə etmək

1. Entities/-də uyğun bazadan (NamedReference və s.) entity; 2. ReferenceTables-a cədvəl adı sabiti;
2. Configurations/-də ReferenceConfiguration<TEntity> ilə mapping; 4. ApplyAtisReference-ə qoş;
3. tests/Atis.Reference.Tests-də SQLite ilə oxu testi. dbo-ya yeni cədvəl bu paketdən yaradılmır — ATIS Core-un SQL script prosesi ilə.