Contexte et objectifs
Direct File est un service gouvernemental américain qui permet aux contribuables de déposer gratuitement leur déclaration fédérale en ligne. Le projet a été conçu pour fonctionner sur smartphone, tablette ou ordinateur, en anglais et en espagnol, afin de répondre à une diversité d’attentes, d’aptitudes et de besoins d’accès. Le dépôt s’appuie sur l’Internal Revenue Code (26 USC) transformé en questions en langage clair, éliminant ainsi la nécessité de consulter des manuels externes.
Architecture logicielle
Le cœur du système repose sur le Fact Graph, un graphe de connaissances déclaratif au format XML. Ce graphe, écrit en Scala, s’exécute sur la JVM côté serveur et est transpilé via Scala.js pour fonctionner dans le navigateur. Cette double compilation assure une logique métier unique partagée entre le backend et le frontend, réduisant les risques d’incohérence entre les deux environnements. Le Fact Graph n’est pas limité aux règles fiscales ; il constitue un moteur de règles générique exploitable par d’autres agences ou projets de business‑rules.
Mécanismes de transmission et d’interopérabilité
Une fois les réponses collectées, le système les convertit en formulaires fiscaux standards puis les transmet à l’API Modernized e‑File (MeF) de l’IRS, accessible aux développeurs autorisés. En outre, Direct File propose une State API qui exporte les données sous forme de XML MeF et d’un JSON enrichi, facilitant l’importation par des outils tiers pour les déclarations d’État ou locales. Cette double sortie (XML et JSON) répond à la demande des administrations étatiques d’obtenir des éléments supplémentaires non couverts par le format MeF classique.
Limites, sécurité et perspectives de réutilisation
Le dépôt GitHub a été archivé et n’est plus maintenu ; le code peut contenir des vulnérabilités non corrigées, ce qui le rend inadapté à un usage en production. De plus, des parties du code et des jeux de données ont été retirées pour protéger les informations personnellement identifiables (PII), les informations fiscales fédérales (FTI) et les données classifiées (SBU, NSS). Cette censure limite la reproductibilité complète du service, mais les composants conservés – notamment le Fact Graph – offrent une base solide pour d’autres projets de règles métier. Le projet s’inscrit dans le cadre légal du Source code Harmonization And Reuse in Information Technology Act de 2024 et des mémorandums fédéraux sur la transparence du code source, illustrant l’engagement du gouvernement américain à publier des outils réutilisables tout en respectant les contraintes de sécurité et de confidentialité.
