ABD IRS’nin Direct File hizmeti, kodlarını GitHub’da yayımladı

 (chrisgiven.com)
2 puan yazan GN⁺ 2025-06-05 | 1 yorum | WhatsApp'ta paylaş
  • IRS, Direct File’ın kaynak kodunun önemli bir bölümünü GitHub’da açık kaynak olarak yayımladı
  • ABD hükümeti eseri olarak kod kamu malı statüsünde ve herkes tarafından incelenebiliyor
  • Bu yayımlama, SHARE IT Act uygulamasının bir parçası olarak yasal süreden 3 hafta önce duyuruldu
  • Açık kaynak paylaşımının amacı şeffaflığı artırmak ve mükellef güveni oluşturmak
  • Direct File ekibi ayrıca veri güvenliği, adil vergi avantajı uygulaması ve kamusal erişilebilirliğin güçlendirilmesine de önem veriyor

Direct File kaynak kodunun GitHub’da yayımlanması

30 Mayıs 2025’te IRS, Direct File hizmetinin kaynak kodunun büyük bölümünü GitHub’da açık kaynak yazılım olarak yayımladı. ABD hükümeti eseri olan bu kod kamu malı kapsamına giriyor ve herkes içeriğini serbestçe inceleyebiliyor.

Yayımlamanın amacı ve arka planı

Bu kaynak kodu paylaşımı, SHARE IT Act’e (118. Federal Kongre yasa tasarısı 9566) uyum kapsamında atılmış bir adım ve resmî son tarihten 3 hafta önce gerçekleştirildi. IRS tarafından işletilen daha fazla yazılım kodunun da ileride herkesin erişimine açılması bekleniyor.

Açık kaynağın önemi

Direct File hizmetinin kodunun açık kaynak yapılması kısa süre önce planlanmış bir karar değil, uzun süredir ilerletilen bir girişimdi. Geçen yıl Direct File ekibinin açıkladığı gibi, açık kaynak şu açılardan önem taşıyor:

  • IRS, şeffaflığı güçlendirerek kamu güveni oluşturabilir ve çalışmaların bağımsız değerlendirilmesine imkân tanıyabilir
  • Yazılımın, tüm mükelleflerin hak kazandıkları vergi avantajlarından tam olarak yararlanabilmesini sağlayacak şekilde tasarlandığı dışarıya gösterilebilir
  • Bu taahhütlerin yerine getirildiği, yayımlanan yazılım üzerinden teknik olarak ortaya konabilir

Mükellef güveni ve Direct File’ın ilkeleri

Mükellef güveni oluşturmak, Direct File tasarımının temel stratejisiydi. Bunun için aşağıdaki unsurlar vurgulandı:

  • En doğru vergi beyanı seçeneğini sunmak
  • Herkesin vergi beyan sistemine erişebilmesini ve onu kullanabilmesini sağlamak
  • Mükellef verilerinin güvenliği ilkelerine sıkı şekilde uymak
  • Kodu doğrudan yayımlayarak şeffaflığı uygulamaya geçirmek

Kişisel not

Yazar, 2 hafta önce IRS’deki görevini resmen sona erdirmiş durumda. Bu yazı tamamen kişisel görüşlerini yansıtıyor.

GitHub depo adresi

İlgili okumalar

1 yorum

 
GN⁺ 2025-06-05
Hacker News görüşü

  • Direct File içinde Fact Graph adlı bildirimsel ve XML tabanlı bir bilgi grafiği veri yapısı bulunuyor; bu yapı, kısmen doldurulmuş vergi beyannamesi gibi eksik bilgiler üzerinden çıkarım yapacak şekilde tasarlanmış. Fact Graph Scala ile yazılmış, arka uçta JVM üzerinde çalışıyor, istemci tarafında ise Scala.js ile transpile edilerek çalıştırılıyor. Direct File’daki Fact Graph belirli bir alanla sınırlı değil; bu yüzden vergi idareleri ya da başka iş kuralı motorları uygulamak için referans olarak da faydalı olabilir

    • fact graph’ın nasıl çalıştığını tanımlayan kod burada görülebilir. Gerçek vergi tanımları ve türetilmiş hesaplamalar ise burada bulunabilir. Örnek olarak temel indirim (Standard Deduction) ve vergi oranı hesaplamaları var. Bu tanımların MeF (Modernized e-File) şeması temelli olduğunu düşünüyorum. Çünkü sistemin giriş verisini MeF şemasının XML biçimine dönüştürüp MeF sistemine göndermesi gerekiyor. Daha fazla bilgi için IRS resmî sayfasına bakılabilir

    • İlginç görünüyor, daha fazla okumak istiyorum

  • Yaklaşık 2 hafta öncesine kadar IRS’de çalışıyordum ama bunu kişisel sıfatımla söylüyorum. Mevcut yönetimin DirectFile’ı kaldırırken ilgili ekipteki herkesin de işine son vermesi üzücü

  • Ne yazık ki bu program şu anda mevcut yönetim tarafından durduruluyor. Kod deposu gerçekten harika ve Scala fact graph yapısı da gerçekten çok hoş. Eğitim materyallerine de muazzam emek verildiği görülüyor

    • Bence bu projede yer alan insanlar, tek satır kod yazmadan önce bile kaderinin belli olduğunu biliyordu. Sonraki bir (R, Cumhuriyetçi) yönetimde hemen öldürülecek bir proje olduğunu biliyorlardı. Yazılımı gerçekten yayımlamayı başarmış olmaları büyük bir başarı, ama uzun ömürlü olmayacağını herkes biliyordu. Pay-to-file vergi lobisi fazla güçlü ve fazla yozlaşmış

    • Bu yasa tasarısı Cumhuriyetçi Nick Langworthy tarafından sunuldu ve William Timmons da eş sunucu oldu. Lütfen yanlış ya da uydurma bilgi yaymayın

  • Bunun Java’da yaygın olup olmadığını soruyorum, örnek kod bağlantısı

    • Bu, Java’daki reaktif programlamaya bir örnek. İş tamamlandığında çalıştırılacak bir callback döndürüyor. Mono<T> tipi bunun belirgin bir göstergesi

    • Uzun yıllardır Java kullanıyorum ama böyle kodları nadiren görüyorum. Büyük kısmı reaktif tarz programlamadan (reactor.core.publisher.Mono) geliyor. Belki de tüm kodu tek ekrana sığdırmaya çalışmışlardır. Ben ekip lideri olsam daha sadeleştirilmesini isterdim

    • Bu kodlama tarzı, devlet projelerinde ömür boyu iş kapmaya çalışan ya da başkaları okuyamazsa bunun avantaj olduğunu düşünen kişilerde sık görülüyor. Ya da amaç ultra geniş monitör satmaksa da gerekli olabilir

    • atomics biraz tuhaf, ama reactor kullanıldığında sıralı blocking davranışa ihtiyaç varsa genel kod yapısı kolayca darmadağın olabiliyor

    • Benzer şeyleri Java’da da başka dillerde de zaman zaman görüyorum. Muhtemelen tercih ettiğim yaklaşım değil

  • IRS’nin bunu yayımlamasında asıl zor kısmın kaynak kodun kendisinden çok, vergi toplama sistemiyle entegrasyon ve mevcut vergi mevzuatına uyumu garanti etmek olduğunu düşünüyorum. Kaynak kodu yayımlasanız bile yönetim isterse bu kısmı her zaman durdurabilir

    • Kesinlikle katılıyorum. Depodaki açıklamalara göre Direct File, ABD vergi yasasını (26 USC) sade sorulara çevirerek vergi mükelleflerinin ek açıklama olmadan doğrudan yanıt verebilmesini sağladı. Sonra bu yanıtları standart vergi formlarına dönüştürüp resmî Modernized e-File (MeF) API’si üzerinden gönderiyor. Teoride bugün bile kullanılabilir olabilir, ama dediğiniz gibi politika değişirse anlamsız hâle gelme riski var

    • Ayrıca zor kısımlardan biri de, vergi hazırlama sektörünün onlarca yıldır kendi çıkarlarını korumak için lobi yapmış olması. Geçen yıla göre ücretsiz doğrudan beyanı kabul eden eyalet sayısı arttı; şu anda DC dâhil 25 eyalet/yer bunu kabul ediyor, ama kalan 25 eyalette neden olmadığını anlamak zor. (Ben DC’de yaşıyorum)

    • Doğru. Vergi beyanı lobisi için çalışan siyasetçiler veya bürokratlar, yazılımı işe yaramaz hâle getirmek için vergi yasasını istedikleri gibi değiştirebilir

    • Şu an böyle bir özellik var mı bilmiyorum ama eFile yeterince yetenekliyse kâğıt beyanname de üretebilir

    • Hatta bu bir iş fırsatı gibi bile görünüyor

  • Exempted Code bölümünde, Direct File geliştirmede kullanılan tüm kaynak kodun, belgelerin ve metaverinin açık depoya alınmadığı yazıyor. PII, federal vergi bilgileri (FTI), hassas ama sınıflandırılmamış (SBU) veriler ve ulusal güvenlik sistemleri (NSS) için kaynak kod, yasal gereklilikler nedeniyle hariç tutulmuş. Bu kısıtlar yüzünden bazı işlevlerin kaldırıldığı veya yeniden yazıldığı da belirtiliyor. Hangi kısımların çıkarıldığını gerçekten merak ediyorum

  • Hemen herkes en az bir kez depoya gerçek dosyaları koymak yerine sadece bir submodule işaretçisi ekleme hatası yapmıştır. Örnek commit bağlantısı. Kod ABD’den geldiği için doğrudan CC0 kullanılamaması ve bunun yerine ayrıca “kamu malı olduğunu” açıkça belirtmek gerekmesi de ilginç

    • Tek cümleyle söylersek, Creative Commons’ın (merkezi Kaliforniya’da) ABD’deki en büyük kamu kurumunun yazılımına uygun bir lisans yayımlamamış olması demek bu. Ayrıca bu farkın nedenini de merak ediyorum

  • Merak edenler için depo bağlantısı

    • Biri depoyu silmeden önce hızlıca fork’lamak iyi olabilir. Hatta ileride sadece görüntülemenin bile cezalandırıldığı bir noktaya gelebiliriz

  • Sadece kod değil, /docs/design klasöründe harika tasarım belgeleri ve notlar da dolu. Kullanıcı akışlarına göre ayrıntılı süreç diyagramları da var (canlı görünüm yok, zip dosyası olarak sunuluyor; flow1.zip ve flow2.zip dosyalarına bakın)

  • Geçen hafta da (Mayıs 2025 itibarıyla) bununla ilgili bir tartışma vardı: IRS Direct File - Hacker News(62 yorum)