Khi AI thúc đẩy Shopify quay trở lại với Clean Code: Bài học về cấu trúc và khả năng đọc hiểu

Bài viết được dịch và tổng hợp từ tin tức gốc. Bạn có thể đọc bài viết gốc bằng tiếng Anh tại đây.

Điểm tin nhanh:

• Shopify đang chuyển dịch kiến trúc storefront từ JSON sang HTML thuần túy kết hợp với Liquid templating để tối ưu hóa khả năng đọc hiểu.
• AI agents đóng vai trò là động lực chính, yêu cầu mã nguồn phải minh bạch, có cấu trúc rõ ràng và dễ dàng phân tích.
• Kiến trúc mới giúp giảm 93% số dòng code so với theme Horizon hiện tại, đồng thời cải thiện đáng kể trải nghiệm cho cả lập trình viên và các mô hình ngôn ngữ lớn.

Sự bùng nổ của AI trong phát triển phần mềm thường bị gắn mác là nguyên nhân tạo ra những đoạn code cồng kềnh, thiếu kiểm soát. Tuy nhiên, tại Shopify, câu chuyện lại diễn ra theo hướng ngược lại. Khi các AI agents bắt đầu tham gia sâu vào quy trình tùy chỉnh storefront, đội ngũ kỹ thuật của Shopify nhận ra một nghịch lý: để AI làm việc hiệu quả, mã nguồn không được phép trở nên phức tạp hơn, mà ngược lại, phải trở nên tinh gọn và dễ đọc hơn bao giờ hết.

Từ sự phức tạp của JSON đến sự minh bạch của HTML

Trong nhiều năm qua, Shopify đã sử dụng JSON làm ngôn ngữ cấu hình chủ đạo cho các theme. Mặc dù mang lại sự linh hoạt cho người dùng cuối, nhưng cách tiếp cận này vô tình tạo ra một rào cản kỹ thuật. Khi các template trở thành những chuỗi JSON dài dằng dặc, chúng không còn là một bề mặt phát triển (developer surface) thân thiện. Việc debug hay tùy chỉnh trở nên khó khăn hơn khi người lập trình không thể hiểu cấu trúc trang chỉ bằng cách đọc một tệp tin duy nhất.

Để giải quyết vấn đề này, Shopify đang xây dựng một kiến trúc theme mới dựa trên HTML thuần túy, kết hợp với ngôn ngữ Liquid templating. Đây là một bước đi chiến lược nhằm đưa mã nguồn về gần với ngôn ngữ tự nhiên hơn, giúp cả con người và AI dễ dàng phân tích cấu trúc trang mà không cần thông qua các lớp trung gian phức tạp. Điều này tương tự như cách chúng ta tối ưu hóa kiến trúc Transport, Surface và Skin để đảm bảo tính bền vững trước những thay đổi của đặc tả.

Hiệu quả của việc tái cấu trúc

Việc chuyển đổi sang kiến trúc mới không chỉ là một thay đổi về mặt thẩm mỹ mà còn là một cuộc cách mạng về hiệu năng. Dưới đây là bảng so sánh sơ bộ về tác động của kiến trúc mới:

Lưu ý: Việc giảm 93% số dòng code không có nghĩa là mất đi tính năng, mà là nhờ vào việc sử dụng các primitive mới như 'partial' và 'standard actions', giúp loại bỏ hàng nghìn dòng code reactivity không cần thiết.

Tại sao AI lại ưa thích Clean Code?

Ben Sehl, Giám đốc sản phẩm của Shopify, đã chỉ ra rằng các mô hình AI hàng đầu hiện nay đều được huấn luyện trên ngôn ngữ tự nhiên và HTML. Do đó, việc sử dụng HTML giúp AI dễ dàng hiểu được ngữ cảnh, cấu trúc và các mối quan hệ giữa các thành phần trên trang web. Điều này cũng giống như việc tối ưu hóa quy trình làm việc với AI bằng cách cung cấp cho nó một môi trường dữ liệu sạch và có cấu trúc.

Việc áp dụng các quy tắc nghiêm ngặt về cấu trúc, validation và file-size limits giúp đảm bảo rằng mọi theme được tạo ra đều tuân thủ các tiêu chuẩn kỹ thuật cao nhất. Đây là một ví dụ điển hình của việc xây dựng hệ thống RAG Air-gapped hay các pipeline tự động hóa, nơi mà sự minh bạch của dữ liệu đầu vào quyết định chất lượng đầu ra.

Đánh giá & Lời khuyên Thực tiễn

Từ góc nhìn của một Senior Tech Lead, tôi đánh giá cao hướng đi này của Shopify. Việc quay trở lại với HTML thuần túy không phải là bước lùi, mà là sự trưởng thành trong tư duy thiết kế hệ thống.

• Ưu điểm: Tăng tính bảo trì, giảm thiểu lỗi do cấu trúc JSON phức tạp gây ra, và đặc biệt là tối ưu hóa chi phí token khi sử dụng các AI agents để chỉnh sửa giao diện.
• Nhược điểm: Đòi hỏi các nhà phát triển phải làm quen với các quy tắc Liquid mới và tư duy thiết kế theo hướng composable blocks thay vì các cấu hình tĩnh.
• Phạm vi ứng dụng: Phù hợp cho các nền tảng thương mại điện tử quy mô lớn, nơi mà sự ổn định và khả năng tùy biến linh hoạt là ưu tiên hàng đầu.

Mẹo hay: Nếu bạn đang xây dựng các hệ thống tương tự, hãy cân nhắc việc xây dựng API tự động hóa tài liệu mã nguồn đa ngôn ngữ để đảm bảo rằng cấu trúc code luôn đồng nhất và dễ dàng cho AI hoặc các công cụ tự động hóa xử lý.

Câu hỏi thường gặp (FAQ)

Tại sao Shopify lại chọn HTML thay vì các framework hiện đại như React?

HTML là ngôn ngữ nền tảng của web, có tính biểu cảm cao, local và cực kỳ hiệu quả về mặt token cho các mô hình ngôn ngữ lớn (LLM). Việc tránh xa Virtual DOM giúp giảm độ phức tạp không cần thiết cho các trang storefront.

Kiến trúc mới có ảnh hưởng đến các theme hiện tại không?

Shopify cam kết duy trì các theme Liquid hiện tại trong một API vĩnh viễn, đảm bảo tính tương thích ngược cho các merchants đang sử dụng hệ thống cũ.

Làm thế nào để đảm bảo tính toàn vẹn của code khi AI tự động chỉnh sửa?

Shopify đã phát triển 20 quy tắc mới để kiểm soát cấu trúc, hợp đồng (contracts) và validation, đảm bảo mọi thay đổi từ AI đều nằm trong khuôn khổ chính sách của công ty.

Kết luận

Câu chuyện của Shopify là minh chứng rõ ràng cho thấy AI không nhất thiết phải đi kèm với sự phức tạp. Khi chúng ta thiết kế hệ thống với tư duy 'first-principles', tập trung vào sự minh bạch và dễ đọc, chúng ta không chỉ giúp AI làm việc tốt hơn mà còn nâng cao chất lượng trải nghiệm cho chính đội ngũ kỹ sư của mình. Hãy theo dõi hi_dev để cập nhật những xu hướng kiến trúc phần mềm mới nhất và cùng thảo luận về cách tối ưu hóa quy trình phát triển trong kỷ nguyên AI.