IRS, ücretsiz beyanname hizmeti Direct File'ın kodunu açık kaynak yaptı ama üretimde çalıştırmayın uyarısıyla

IRS, ABD mükelleflerinin federal beyannamelerini doğrudan vergi dairesiyle ücretsiz olarak verebilmesini sağlayan devlet hizmeti Direct File'ın kaynak kodunu yayımladı. IRS-Public organizasyonu altında GitHub'da barındırılan depo, Hacker News ana sayfasına ulaşmasının ardından dikkat çekti. Depo, hizmetin ardündeki kodun büyük bölümünü belgeliyor; ancak dikkat çekici bir uyarıyla: depo arşivlenmiş, bakımı yapılmıyor ve hiçbir yerde dağıtılmamalı.

Direct File ne yapıyor

Deponun README'sine göre Direct File, görüşme tarzı bir beyanname aracı. Boş vergi formları göstermek yerine, mükellefleri sade bir dille yazılmış sorulardan geçiriyor; bu sorular, cevapların harici talimatlara veya IRS yayınlarına bakılmadan bilinebilecek şekilde tasarlanmış. Hizmet telefonda da masaüstünde de aynı iyi şekilde çalışacak biçimde geliştirildi, İngilizce ve İspanyolca sunuluyor ve geniş bir yelpazedeki yetiler ile erişim ihtiyaçlarını karşılayacak şekilde tasarlandı.

Cevaplar standart vergi formlarına dönüştürülüyor ve IRS'nin Modernized e-File (MeF) API'si üzerinden gönderiliyor; README bu API'nin yetkili kamu kullanımına açık olduğunu belirtiyor. Soru seti ve mantığı, IRS Hukuk Müşavirliği Ofisi ile birlikte geliştirildi ve 2024 Vergi Yılı itibarıyla ABD vergi mevzuatını yansıtıyor. README, eşlik eden test senaryolarının ve vakaların, ABD vergi mevzuatını doğru şekilde yorumlaması gereken ürünler geliştiren herkese yararlı olabileceğini öne sürüyor.

Fact Graph

Teknik olarak en özgün bileşen, README'nin Fact Graph adını verdiği yapı: kısmi verilerden — örneğin yarı tamamlanmış bir beyannameden — sonuçlar çıkarabilmek için geliştirilmiş, bildirimsel, XML tabanlı bir bilgi grafiği. Scala ile yazıldı, backend'de JVM üzerinde çalışıyor ve Scala.js ile transpile edilerek aynı mantığın beyanname oturumu sırasında tarayıcıda da yürütülmesi sağlanıyor.

README, Fact Graph'ın vergilendirmeye özgü olmadığını belirtiyor ve diğer gelir idarelerine yararlı olabileceğini ya da iş kuralları motoru (business rules engine) uygulayanlara referans oluşturabileceğini söylüyor.

Eyalet beyannamelerine devir

Direct File yalnızca federal beyannameleri işliyor; ancak ABD mükellefleri genellikle eyalet ve yerel vergiler de ödüyor. Bu boşluğu kapatmak için hizmet, mükelleflerin federal verilerini, bilgileri yeniden girmeden eyalet veya yerel beyanname verebilen üçüncü taraf bir araca aktarmasını sağlayan bir State API sunuyor. README'ye göre aktarım, standart MeF XML'inin yanı sıra, eyalet gelir idarelerinin eyalet beyanname deneyimini basitleştirmede yararlı olduğunu belirttiği ek veri öğelerini taşıyan zenginleştirilmiş bir JSON formatını içeriyor.

Bir ürün değil, bir arşiv

GitHub deposu açıkça arşivlenmiş durumda ve artık bakımı yapılmıyor. README, kodun yamanmamış veya bilinmeyen güvenlik açıkları içerebileceğini ve üretim sistemlerinde kullanılmaması gerektiği uyarısında bulunarak yayını canlı bir açık kaynak projesi değil, tarihsel bir referans olarak çerçeveliyor.

Ayrıca tasarımı gereği eksik. 40 U.S.C. § 11103 kapsamında tanımlanan kategoriler olan kişisel tanımlayıcı bilgi, federal vergi bilgisi, hassas ama sınıflandırılmamış materyal veya Ulusal Güvenlik Sistemleri kaynak kodu olarak sınıflandırılan kod ve veriler yayım dışı tutuldu; IRS, belirli işlevlerin bu nedenle kaldırıldığını veya yeniden yazıldığını söylüyor. Direct File'ı yerel olarak çalıştırmak isteyenler için depoda bir onboarding dosyası bulunuyor.

Hukuki dayanak ve arkasındaki ekip

README, yayın背后的 hukuki yetkileri listeliyor; en önemlisi, federal kurumların belirli kaynak kodlarını paylaşmasını öngören Source Code Harmonization and Reuse in Information Technology Act of 2024, Public Law 118-187. Ayrıca federal kaynak kodu politikasına ilişkin OMB Memorandum M-16-21'e, Federal Acquisition Regulation'ın patent ve veri hükümlerine ve E-Government Act of 2002 ile Clinger-Cohen Act of 1996 gibi daha önceki yasalara atıf yapıyor.

Hizmetin kendisi, IRS içindeki teknolojistlerden oluşan bir ekip tarafından geliştirildi; bu ekipte ABD Digital Service ve General Services Administration'ın desteğinin yanı sıra TrussWorks, Coforma ve ATI'den tedarikçi ekipleri de yer aldı.

Neden önemli

Arşivlenmiş hâliyle bile bu alışılmadık bir yayın. Bir ülkenin vergi otoritesinin Internal Revenue Code'u sıradan bir mükellefin cevaplayabileceği bir dile çevirmek için kullandığı gerçek soru mantığını, test senaryolarıyla birlikte ortaya koyuyor; bu, vergi yazılımı geliştiricileri ve bu tür sistemlerin nasıl doğrulandığını inceleyenler için değerli bir referans materyali. Fact Graph, eksik veriye tahammül etmesi gereken kurallar motorları için yeniden kullanılabilir bir örüntü sunuyor; bu fikrin relevance'ı vergi beyanının çok ötesine uzanıyor. Ve 2024 federal kaynak kodu paylaşım yasası kapsamındaki daha görünür kod yayınlarından biri olarak, kurumların bu tür görevleri nasıl yerine getirebileceğini gösteriyor: şeffaflık ve yeniden kullanım için yayınlamak, ama referans kodu üretim sistemlerinden net biçimde ayırmak. Mükellefler için pratik kazanç, federal beyanname için ücretsiz ve doğrudan bir kanal olan Direct File'ın kendisi; açık kaynak yapılan kod ise bu kanalın nasıl çalıştığının belgelenmesi.