Model Çağrısı Maliyet Etiketleme

Ne çözüyor?#

Sağlayıcı dökümü çağrıları tek havuzda toplar. Kurum içindeki soru ise başka bir dilde gelir: bu tutarı hangi ürün, hangi müşteri, hangi deneme üretti. İki görünüm arasındaki boşluk, çağrı anında etiket yazılmadıysa sonradan kapatılamaz; geçmişe dönük tahmin, muhasebe kaydı yerine geçmez. Kit isteği gönderirken akış kimliğini isteğin yanına ve kendi defterine yazar, dönemsel dökümü de bu deftere karşı uzlaştırır.

Bileşenler#

• Sarmalayıcı: sağlayıcı istemcisinin önüne geçer; istemin içeriğine dokunmadan etiketleri kendi defterine yazar, sağlayıcı bir üstveri alanı kabul ediyorsa aynı etiketleri oraya da geçirir.
• Bağlam taşıyıcısı: akış kimliğini çağrı zincirinde elden ele geçirir, böylece derindeki yardımcı işlev kendi etiketini bilmek zorunda kalmaz.
• Kullanım defteri: her çağrı için etiketleri, sağlayıcının yanıtında bildirdiği token sayaçlarını ve gecikme alanını eklemeli olarak saklar.
• Fiyat çizelgesi: birim ücretlerin elle girildiği tek dosya; kit içinde gömülü hiçbir ücret gelmez.
• Uzlaştırıcı: sağlayıcı dökümünü defterle karşılaştırır, eşleşmeyen kalemleri ayrı listede bırakır.

Etiket kümesi#

Etiketler serbest metin değil dar bir kümedir ve her alanın kim tarafından doldurulduğu bellidir. Akış, aşama ve ortam alanı kodun kendisinden; maliyet merkezi ve kullanıcı türü çağrıyı başlatan istekten gelir. Küme genişledikçe sorulabilen soru çeşidi artar ama defterin hacmi ve raporlama maliyeti de büyür; bu yüzden alan eklemek bir yapılandırma kararı olarak bırakılmıştır.

{
  "akis": "sozlesme-ozeti",
  "asama": "tasnif",
  "ortam": "uretim",
  "maliyetMerkezi": "hukuk",
  "kullaniciTuru": "ic-ekip",
  "istekKimligi": "<istek başında üretilen kimlik>"
}

Kurulum akışı#

1. 1Tek giriş bırak

   Uygulamadaki her sağlayıcı çağrısı tek bir modülden geçirilir. İkinci bir doğrudan çağrı yolu açık kalırsa defter eksik başlar ve bu eksiklik ancak dökümle uzlaştırma yapıldığında görünür hale gelir.

2. 2Etiket sözlüğünü yaz

   Alan adları ve izin verilen değerler kurum sözlüğüne göre sabitlenir. Eksik etiketle gelen çağrı reddedilmez ama etiketsiz kovasında görünür kalır.

3. 3Bağlamı uçtan uca geçir

   Akış kimliği istek girişinde üretilir ve arka plan işlerine de taşınır. Kuyruğa giren iş etiketini kaybederse o maliyetin sahibi bulunamaz.

4. 4Fiyat çizelgesini doldur

   Birim ücretler sözleşmeden okunup çizelgeye girilir; değiştiğinde eski satır silinmez, tarih damgasıyla yeni satır eklenir.

5. 5Uzlaştırmayı kapanışa bağla

   Dönem dökümü geldiğinde uzlaştırıcı çalıştırılır. Eşleşmeyen kalemler ayrı listede birikir; bu liste kısalmadıkça defterden çıkan dağılım raporu iç tahmin sayılır, muhasebe kaydı sayılmaz.

Yapılandırmaya bırakılan kararlar#

Kapsam dışı#

Kit bir maliyet iyileştirici değildir; hangi çağrının gereksiz olduğuna, hangi istemin kısaltılabileceğine karar vermez. Önbellek, toplu istek ve model seçimi gibi tasarruf yolları uygulamanın kendi işidir. Sağlayıcı faturasının doğruluğunu denetlemek de kapsam dışıdır: uzlaştırıcı yalnızca kendi defteriyle döküm arasındaki farkı görünür kılar, farkın hangi tarafta olduğunu söylemez.