IRS, Fact Graph’ı açık kaynak olarak yayımladı

• ABD Gelir İdaresi (IRS), Fact Graph adlı bir bilgi grafiğini açık kaynak olarak yayımladı
• Fact Graph, ABD vergi yasaları ve ilgili mevzuatı modellemek için kullanılıyor ve hem JVM hem de JavaScript ortamlarında kullanılabiliyor
• Projenin kaynak kodu sık sık güncelleniyor; geliştirme özel bir depoda yapılıyor ve onaylanan değişiklikler gerçek zamanlı olarak yansıtılıyor
• Fact Graph, çeşitli yasal dayanaklar ve federal açık kaynak politikaları doğrultusunda geliştiriliyor ve yayımlanıyor
• Yazılımın kullanımı ve değiştirilmesinden doğan tüm sorumluluk kullanıcıya ait; IRS ayrıca herhangi bir garanti veya destek sunmuyor

---

Açık kaynak yayımlamanın önemi ve avantajları

• IRS’nin Fact Graph projesini açık kaynak hâline getirmesi, kamu verileri ve hukuki bilginin şeffaflığı ile yeniden kullanılabilirliğini artıran eğilim içinde anlamlı bir adım
• Diğer yaygın bilgi grafiği projelerinden farklı olarak, ABD vergi yasaları ve federal düzenlemelere özel yüksek kaliteli, üretim ortamına uygun bir yapı ile tasarlandığı için aynı alanda kullanım değeri ve güvenilirliği yüksek
• Hem JavaScript’i hem de JVM dil ailesini (ör. Java, Kotlin, Scala, Clojure vb.) destekleyerek geniş bir teknoloji yığınıyla uyumluluk sunuyor
• Sık depo güncellemeleri ve gerçek zamanlı yansıtma sistemi sayesinde güncel kalıyor
• Yasal dayanakları ve açık kaynak politikalarını açıkça takip ederek kamu kurumları, özel sektör ve bireylerin güvenle kullanabileceği bir temel sağlıyor

Projeye genel bakış

• Fact Graph, doğrudan üretim ortamında kullanılabilecek bir bilgi grafiği olup, başlıca ABD federal vergi yasasını (Internal Revenue Code) ve ilgili vergi mevzuatını modellemeyi amaçlıyor
• JavaScript’in yanı sıra tüm JVM tabanlı dillerde (Java, Kotlin, Scala, Clojure vb.) kullanılabiliyor; böylece farklı platformlara ve geliştirme ortamlarına uygulanabiliyor

Deponun kullanımı ve geliştirmeye katılım

• Geliştirme ortamı ve kurulum yöntemi ONBOARDING.md dosyasında görülebilir
• En güncel sürümde (v3.1), önceki sürüme kıyasla yapılan iyileştirmeler ayrı belge ve bağlantılarda sunuluyor
• Açık kaynak katkı yöntemleri ve rehberi CONTRIBUTING.md içinde ayrıntılı olarak açıklanıyor

Başlıca özellikler

• Projenin kaynak kodu düzenli olarak güncelleniyor; gerçek geliştirme özel bir depoda yapıldıktan sonra, yalnızca incelenmiş değişiklikler ana depoya (main branch) gerçek zamanlı olarak merge ediliyor
• Belgelerde ScalaTest (test framework’ü) ve scala-xml (XML implementasyonu) anılıyor; temel bağımlılıklar ve araçlar açık biçimde açıklanıyor

Yasal haklar ve bilgilendirmeler

• Projenin hukuki temeli, birden fazla ABD federal yasası ve politikası (ör. Source Code Harmonization And Reuse in Information Technology Act, Federal Source Code Policy, Digital Government Strategy vb.) ile oluşturulmuş durumda
• IRS, söz konusu kodun doğruluğu, eksiksizliği veya işlevselliği konusunda garanti vermiyor ve sorumluluk üstlenmiyor
• Yazılımın kullanımına ilişkin tüm sorumluluk kullanıcıya aittir (vergi sonuçları, hesaplama hataları, veri kaybı vb. dâhil)
• Açık kaynak lisansı ve üçüncü taraf lisanslarına uyum gerekli

Dil ve teknik bilgiler

• Tüm kaynak kodunun %99,9’u Scala ile yazılmış
• Bunun dışında Makefile gibi bazı küçük bölümler de bulunuyor

Diğer bilgiler

• Bu proje için henüz resmî bir sürüm yayımlanmadı; ayrıca 235 yıldız (star) ve 11 çatal (fork) bulunuyor
• Toplam 11 katkıda bulunan kişi projeye katılıyor

[GN⁺]

Hacker News görüşleri

• Bir şeyi mi karıştırıyorum diye merak ediyorum, yoksa bu depoda vergi yasasıyla ilgili gerçek olgular gerçekten yok mu? /demo/all-facts dosyasının “gerçek” olgular olarak kabul edilip edilmemesi gerektiğini ve XML olgu dosyalarının başka bir yerden alınıp alınamayacağını merak ediyorum. IRS’in vergi formüllerini tanımlama ve yönetme biçimi oldukça havalı, ayrıca bunun makine tarafından okunabilir vergi yasası olması da gerçekten ilginç.
  • Gerçek IRS vergi yasası uygulaması ayrı bir depoda bulunuyor: https://github.com/IRS-Public/direct-file. İlk bağlantısı verilen depo, vergi uygulamasından ayrılmış fact graph araçlarını kapsıyor.
  • Buradaki belgede şöyle deniyor: "Olgu sözlüklerini standartlaştırarak vergi mantığını bildirimsel biçimde modellemek için kanonik bir format oluşturmak"
  • Bu, gerçek veriden ziyade veritabanı için bir HTTP arayüzü gibi görünüyor.
  • Bildiğim kadarıyla fact, paylaşılan bir varsayım ya da gerçeği ifade ediyor. Vergi hukukunda bu yaklaşım tamamen mantıklı.
• TurboTax ile aşırı karmaşık arayüz, para tasarrufu sağlıyormuş gibi yapıp aslında öyle olmayan agresif veri toplama ve IRS kadar karmaşık ücret yapısı yüzünden çok sinir bozucu bir deneyim yaşadım. Umarım bu proje, alan uzmanlarının ya da iyi niyetli insanların TurboTax’in pazar hakimiyetine meydan okuyabilecek şeffaf ve kullanıcı dostu alternatifler geliştirmesini kolaylaştırır. Bu sorunları iyileştiren iyi araçlar ya da yaklaşımlarla karşılaşmış olan var mı diye merak ediyorum.
  • DirectFile’ı yalnızca bir yıl kullandım ama gerçekten iyiydi ve yukarıda bahsedilen sorunları çözdü. Sonrasında bununla ilgili adımlar da atıldı, dolayısıyla endişelenmeye gerek yok. İlgili haber
  • FreeTaxUSA gerçekten harika.
  • Bence TurboTax reklamları neredeyse dolandırıcılık seviyesinde. Freetaxusa.com (bağlantım yok) aynı derecede iyi ve gerçekten ücretsiz.
  • Geçen yıl Free Fill Fillable Forms’u hem federal hem eyalet için kullandım. Neden daha önce kullanmadığıma şaşırdım; beyannamemi kendim doldurmak gözümü korkutmuştu ama benim durumumda gerçekten çok basitti.
• ABD vergi yasasının açık kaynak olarak uygulanmış olduğunu görmek sevindirici. Bu kod, IRS Direct File kod tabanının bir parçasıydı ve insanların IRS’e doğrudan ücretsiz vergi beyannamesi vermesini sağlıyordu. Bu yılın başında Trump yönetimi bunu durdurdu. Fact Graph zaten birkaç ay önce açık kaynak yapılmıştı ve o sürüm burada yer alıyor. Ama neden ikinci bir depo açıldığını merak ediyorum.
  • Ben de merak ediyorum. Muhtemelen genel amaçlı kullanım için bağımsız olarak da kullanılabilsin diye direct file projesinden ayırmak istemişlerdir.
  • Direct File’ın ortadan kalkmasına hâlâ üzülüyorum, gerçekten umut vadeden bir başlangıçtı.
• Bunun LLM ile birleştirilip vergi yasası hakkında ilginç tavsiyeler sunmak için kullanılıp kullanılamayacağını merak ediyorum. Vergi yasasıyla ilgili merak ettiklerimi düzenli olarak kolayca sorabilmek gerçekten güzel olurdu.
  • patio11’in şimdiden 2.000 $’dan fazla tasarruf ettiğini söylediği aktarılıyor. Muhtemelen bir gün daha resmî bir değerlendirme yazısı da yazar. (İlgili zincirler: birinci, ikinci)
  • Birinin vergi yasasıyla eğitilmiş bir model yapıp yapmadığını merak ediyorum. Kesinlikle ilginç olurdu.
  • Sadece eğlence amaçlı kullanım için sorun olmayabilir ama LLM’nin halüsinasyon üretip verdiği yanlış vergi/hukuk tavsiyelerine gerçekten uymak kesinlikle HAYIR.

• Bu proje, ABD hükümeti tarafından üretilmiş bir çalışma olduğu için ABD içinde public domain’dir.<br>“ABD içinde public domain” lisans ifadesinin ne anlama geldiğini merak ediyorum. Bu yazılım ABD dışında kullanılamıyor mu?

  • “ABD içinde public domain”in ne anlama geldiğini merak ediyorsanız, mutlaka tüm cümleyi okuyun (hatta hemen öncesindeki iki cümleyi de, CC 1.0 Universal metninden önce olanları). <br>> ABD dışında kullanılamıyor mu? <br>Lisans iki şeyi açıklıyor:<br> (1) Ayrı bir lisansa gerek olmaksızın, ABD federal hükümeti eseri olduğu için ABD’de otomatik olarak public domain’dir. <br>(2) ABD dışında, telif hakkı sahibi ABD federal hükümeti olduğunda (özellikle Bern Sözleşmesi ilkelerini uygulayan ülkelerde), dünya çapındaki telif hakkı feragatini CC 1.0 Universal beyanı yoluyla yapıyor. <br>Dolayısıyla pratikte dünyanın her yerinde telif kısıtı olmadan serbestçe kullanılabilir.

  • Bazı ülkeler public domain kavramını tanımıyor. ABD’de hükümet çalışmaları büyük ölçüde public domain’dir. Bu tür uluslararası hukuki farklar nedeniyle ABD hükümeti bir yandan public domain olduğunu söylerken, diğer yandan uluslararası düzeyde public domain’e benzer amaç taşıyan bir lisans vererek hedefini gerçekleştirmeye çalışıyor.
  • Güzel soru. Telif hakkı yasaları ülkeye göre değiştiği için, ABD dışında ayrıca hangi lisansın geçerli olduğunu netleştirme girişimi olabilir.
• Bana kaynak Scala gibi göründü ama beynim bunu Clojure sanınca ilk birkaç saniye neden parantez olmadığını anlamakta zorlandım.
• Direct File kodu yayımlandığında gerçekten eğlenceli ve havalı kısımlardan biriydi. Eski HN tartışması Özellikle o sürümde hâlâ oldukça iyi bir satır içi eğitim içeriği duruyor, bakmak için faydalı: eğitim bağlantısı
• Kuralların (vergi kurallarının) sürüm kontrolüne tabi olup olmadığını merak ediyorum. Baktım ama bulamadım.
• Bununla paradan tasarruf etmek için nasıl bir hack yapılabileceğini merak ediyorum.
• IRS’in hâlâ var olmasına şaşırdım.