Mỹ công bố mã nguồn Direct File khai thuế miễn phí

IRS vừa đưa mã nguồn của Direct File — dịch vụ khai thuế liên bang miễn phí của chính phủ Mỹ — lên GitHub. Đây là lần hiếm hoi một hệ thống thuế cấp quốc gia mở mã cho công chúng, dù kho mã đã được lưu trữ và không còn được bảo trì.

Direct File là gì?

Direct File là dịch vụ của chính phủ Mỹ cho phép người nộp thuế tự khai tờ khai thuế liên bang trực tiếp với IRS, hoàn toàn miễn phí. Dịch vụ hoạt động theo dạng phỏng vấn (interview-based): người dùng trả lời từng câu hỏi, và hệ thống dựa trên câu trả lời để điền vào các biểu mẫu thuế chuẩn.

Dịch vụ chạy tốt trên điện thoại di động, máy tính bảng và máy tính để bàn, hỗ trợ tiếng Anh và tiếng Tây Ban Nha, đồng thời được thiết kế để tiếp cận được với nhiều nhóm người dùng có năng lực và nhu cầu truy cập khác nhau.

Cách hệ thống vận hành

Direct File diễn giải Bộ luật Thuế vụ Mỹ (Internal Revenue Code, 26 USC) thành các câu hỏi ngôn ngữ đơn giản, mà người nộp thuế có thể trả lời mà không cần tài liệu hướng dẫn bên ngoài. Câu trả lời sau đó được chuyển thành biểu mẫu thuế chuẩn và gửi tới Modernized e-File (MeF) API của IRS.

Bộ câu hỏi và logic này được xây dựng với sự phối hợp chặt chẽ của Văn phòng Cố vấn trưởng IRS, kèm theo các ca kiểm thử (test case) và kịch bản. Theo mô tả trong kho mã, những tài liệu này có thể hữu ích cho bất kỳ ai đang xây dựng sản phẩm cần diễn giải chính xác luật thuế Mỹ tính đến năm thuế 2024.

Fact Graph — điểm đáng chú ý về mặt kỹ thuật

Direct File tích hợp Fact Graph, một cấu trúc dữ liệu đồ thị tri thức (knowledge graph) khai báo dựa trên XML, được thiết kế để suy luận trên thông tin chưa đầy đủ — ví dụ một tờ khai thuế mới hoàn thành một phần.

Fact Graph viết bằng ngôn ngữ Scala, chạy trên JVM ở phía máy chủ (backend) và được biên dịch chéo qua Scala.js để chạy cả ở phía máy khách (client). Theo tài liệu trong kho mã, Fact Graph không gắn với lĩnh vực thuế cụ thể và có thể hữu ích cho các cơ quan thuế khác, hoặc như một tài liệu tham chiếu khi triển khai business rules engine (bộ máy quy tắc nghiệp vụ).

Liên kết với khai thuế bang

Dù chỉ xử lý thuế liên bang, Direct File có hỗ trợ nghĩa vụ khai thuế bang và địa phương. Người dùng có thể tùy chọn xuất dữ liệu tờ khai liên bang sang công cụ của bên thứ ba để khai thuế bang, mà không phải nhập lại thông tin.

Giao dịch này diễn ra qua State API, truyền cả XML chuẩn MeF lẫn định dạng JSON được làm giàu thêm các trường dữ liệu mà các cơ quan thuế bang cho là hữu ích.

Ai đã xây dựng?

Direct File do đội ngũ công nghệ nội bộ của IRS phát triển, với sự hỗ trợ của USDS và GSA, cùng các nhà cung cấp TrussWorks, Coforma và ATI.

Lưu ý quan trọng khi sử dụng

Kho mã đã được lưu trữ và không còn được bảo trì. Theo cảnh báo trong tài liệu, mã chỉ nhằm mục đích tham khảo lịch sử và có thể chứa lỗ hổng chưa được vá hoặc chưa biết. Không nên dùng trong hệ thống production.

Ngoài ra, không phải toàn bộ mã nguồn đều được công bố. Các phần được miễn trừ gồm mã và dữ liệu liên quan đến thông tin định danh cá nhân (PII), thông tin thuế liên bang (FTI), thông tin nhạy cảm nhưng chưa mật (SBU), và mã nguồn phát triển cho hệ thống an ninh quốc gia (NSS). Vì lý do này, một số chức năng đã bị loại bỏ hoặc viết lại.

Việc công bố dựa trên các cơ sở pháp lý như Đạo luật Hài hòa và Tái sử dụng mã nguồn trong Công nghệ Thông tin 2024 (Public Law 118-187), bản ghi nhớ OMB M-16-21 về chính sách mã nguồn mở của chính phủ liên bang, và các quy định mua sắm công nghệ thông tin khác.

Góc nhìn

Với kỹ sư phần mềm, giá trị lớn nhất ở đây không phải là mã của một dịch vụ thuế, mà là cách một nhóm kỹ sư chuyển hóa một hệ thống luật phức tạp thành các câu hỏi tuần tự và một mô hình suy luận khai báo. Bài toán "diễn giải quy định thành luồng câu hỏi, rồi ánh xạ sang biểu mẫu chuẩn" xuất hiện rất nhiều trong thực tế — từ bảo hiểm, ngân hàng đến thủ tục hành chính công.

Cách triển khai Fact Graph bằng Scala chạy được cả backend lẫn client cũng là một hướng tham khảo đáng chú ý: cùng một logic nghiệp vụ, một nguồn sự thật duy nhất, nhưng thực thi ở hai môi trường khác nhau. Tuy nhiên, vì kho mã đã lưu trữ và thiếu nhiều phần do giới hạn PII/FTI, các đội ngũ nên coi đây là tài liệu học tập về kiến trúc, không phải nền tảng để tái sử dụng trực tiếp.