Archify: AI vẽ sơ đồ kiến trúc codebase lớn, click để truy vết luồng code

Tiếp nhận một dự án phần mềm cũ với hàng nghìn file là ác mộng của nhiều kỹ sư: đọc không nổi, đoán không chắc, sửa thì sợ vỡ. Một dự án mã nguồn mở tên Archify đang được cộng đồng chia sẻ với lời giới thiệu ngắn gọn — để AI phân tích toàn bộ project và biến nó thành sơ đồ kiến trúc có thể click, truy vết luồng code, module, dependency và ngữ cảnh liên quan. Bài viết này phân tích công cụ dạng này và giá trị của nó đối với doanh nghiệp phần mềm.

Vấn đề kinh điển: codebase càng lớn càng như mê cung

Bất kỳ đội kỹ thuật nào cũng quen cảnh này: một hệ thống chạy ổn định suốt nhiều năm, do nhiều thế hệ lập trình viên viết, mỗi người một phong cách. Tài liệu thiết kế thất lạc từ lâu, người hiểu rõ nhất đã nghỉ việc. Khi có yêu cầu sửa đổi hay bổ sung tính năng, việc đầu tiên — và tốn kém nhất — không phải là viết code, mà là trả lời câu hỏi: "Cái này nằm ở đâu, gọi từ đâu, ảnh hưởng đến ai?"

Cách truyền thống là mở từng file, lần theo từng lời gọi hàm, tự vẽ sơ đồ bằng tay. Công việc này có thể mất nhiều ngày và kết quả vẫn phụ thuộc vào năng lực người đọc code.

Archify làm được gì

Theo trang giới thiệu dự án, Archify dùng AI phân tích toàn bộ mã nguồn project, sau đó dựng thành một sơ đồ kiến trúc tương tác:

• Sơ đồ có thể click: thay vì một bức ảnh tĩnh, mỗi node trên sơ đồ là một module, service hay thành phần thật của hệ thống — click vào để xem chi tiết.
• Truy vết luồng code: thấy được dữ liệu và lời gọi đi từ đâu đến đâu, module nào phụ thuộc module nào.
• Bản đồ dependency: nhận diện nhanh những phần coupling cao — nơi một thay đổi nhỏ có thể gây hiệu ứng dây chuyền.
• Ngữ cảnh liên quan: khi xem một thành phần, công cụ chỉ ra những file, hàm, cấu hình liên quan cần đọc kèm.

Dự án được công khai mã nguồn tại GitHub (github.com/tt-a1i/archify), cho phép đội kỹ thuật tự triển khai và kiểm chứng.

Giá trị lớn nhất: rút ngắn thời gian hiểu hệ thống

Một công cụ dựng sơ đồ tự động không thay thế kỹ sư, nhưng thay đổi căn bản chi phí của việc "học hệ thống":

Tình huống	Không có sơ đồ	Có sơ đồ tương tác
Tiếp nhận dự án cũ	Đọc lần lượt từng file, đoán kiến trúc	Nhìn tổng thể trước, chỉ đọc sâu nơi cần sửa
Nhân sự mới onboard	Tuần đầu chỉ để tìm đường	Vài ngày nắm được bản đồ và bắt tay vào việc
Lập kế hoạch refactor	Khó đánh giá phạm vi ảnh hưởng	Xem dependency để chặn rủi ro sớm
Kiểm toán bảo mật	Quét thủ công các điểm vào/ra	Truy vết luồng dữ liệu nhạy cảm nhanh hơn

Nguyên tắc chung: người kỹ sư vẫn ra quyết định, nhưng đi từ "không biết bắt đầu từ đâu" sang "biết chính xác cần đọc gì".

Kết hợp với các công cụ AI lập trình

Archify còn có một vai trò thú vị trong hệ sinh thái AI lập trình hiện nay. Claude Code, Copilot hay các trợ lý tương tự chỉ làm việc tốt khi được cung cấp ngữ cảnh đúng — và một sơ đồ kiến trúc chính là lớp ngữ cảnh đắt giá nhất: thay vì dán cả codebase vào chat, bạn đưa cho AI bức tranh tổng thể rồi chỉ dẫn nó đọc đúng vùng liên quan.

Đây là một xu hướng đáng chú ý: các công cụ đang chuyển từ "viết code hộ bạn" sang "giúp bạn và AI cùng hiểu hệ thống". Nhóm công cụ phân tích kiến trúc đóng vai trò cầu nối giữa kho mã khổng lồ và cửa sổ ngữ cảnh hữu hạn của mô hình AI.

Lưu ý khi đưa vào quy trình thực tế

• Sơ đồ chỉ đúng như code nó đọc: với hệ thống sinh code động, cấu hình runtime phức tạp, cần kiểm chứng lại sơ đồ với thực tế vận hành trước khi tin tuyệt đối.
• Cập nhật theo nhịp phát triển: codebase thay đổi liên tục; chạy lại phân tích định kỳ hoặc gắn vào pipeline CI để sơ đồ không lỗi thời.
• Bảo mật: với mã nguồn nội bộ, ưu tiên triển khai tự host (lợi thế của dự án mã nguồn mở) thay vì dịch vụ bên ngoài không kiểm soát được dòng dữ liệu.

Góc nhìn cho doanh nghiệp Việt Nam

Các doanh nghiệp phần mềm Việt Nam, đặc biệt đội ngũ làm gia công và bảo trì hệ thống dài hạn, là nhóm hưởng lợi rõ nhất từ công cụ này. Bối cảnh phổ biến: nhận lại dự án từ đội khác, mua lại hệ thống của khách hàng, hoặc chính nội bộ компании có sản phẩm chạy nhiều năm thiếu tài liệu. Một bản đồ kiến trúc tự động giúp giảm rủi ro bàn giao, rút ngắn thời gian nhân sự mới vào việc và làm cơ sở cho các quyết định đầu tư kỹ thuật (cải tạo, tách module, nâng cấp).

Với doanh nghiệp tại Bắc Ninh — vùng có đông doanh nghiệp sản xuất đang số hóa quy trình vận hành — việc giữ cho các hệ thống MES, ERP tự phát triển lâu năm luôn "có bản đồ" là điều kiện để cải tạo liên tục mà không phá vỡ nền tảng.

Kết luận

Archify đại diện cho một lớp công cụ đang trưởng thành nhanh: AI không chỉ viết code mà còn giúp con người hiểu code. Trong giai đoạn mà chi phí hiểu một hệ thống cũ thường lớn hơn chi phí viết tính năng mới, một bản đồ kiến trúc tự động, luôn cập nhật là khoản đầu tư xứng đáng cho mọi đội kỹ thuật.

Nguồn: tổng hợp từ chia sẻ kỹ thuật trên Facebook, biên tập bởi Wotech Electronics.

Nếu doanh nghiệp của bạn đang cần rà soát, tài liệu hóa hay cải tạo một hệ thống phần mềm cũ, đội ngũ Wotech Electronics tại Bắc Ninh sẵn sàng hỗ trợ khảo sát và tư vấn giải pháp.