Giới thiệu về kiến trúc dự án NX

Chào mừng bạn đến với Phần 1 của series NX Monorepo! Phần này cover các concepts nền tảng và architecture patterns để xây dựng fullstack monorepos có khả năng scale. Phần 2 sẽ là walkthrough thực hành, xây dựng một repository hoàn chỉnh từ đầu.

Quyết Định Chiến Lược Repository

Khi quản lý nhiều projects liên quan, các team thường chọn giữa hai chiến lược:

Polyrepo (các repository riêng biệt): Mỗi project nằm trong repository riêng với versioning độc lập, CI/CD, và release cycles. Phù hợp cho người mới và team nhỏ khi mới bắt đầu.

Monorepo (một repository duy nhất): Tất cả các projects liên quan chia sẻ một repository, cho phép chia sẻ code và thay đổi atomic trên toàn bộ codebase.

Các công ty như Google, Meta, Microsoft, và nhiều công ty khác sử dụng monorepos để quản lý các codebases khổng lồ của họ. Nhưng monorepos không chỉ dành cho big tech—chúng ngày càng phổ biến với các team thuộc mọi quy mô.

Tại Sao Chọn Monorepo?

Vấn Đề: Monorepos Thiếu Tooling Phù Hợp

Chỉ đơn giản gom tất cả code vào một repository (code collocation) là không đủ. Thiếu tooling phù hợp, monorepos trở nên khó quản lý:

Đây là lý do tại sao nhiều team từ bỏ monorepos—không phải vì monorepos tệ, mà vì họ thiếu tooling phù hợp.

NX: Giúp Monorepos Scale Hiệu Quả

NX được tạo ra để giải quyết chính xác những vấn đề này. Nó biến một code collocation đơn giản thành một true monorepo với tooling thông minh:

Cách NX Giải Quyết Mỗi Thách Thức:

1. Task Caching — Không bao giờ rebuild code không thay đổi

• NX cache output của mỗi task (build, test, lint)
• Nếu inputs không thay đổi, NX restore từ cache ngay lập tức
• Với NX Cloud, cache được chia sẻ trên toàn team và CI

2. Affected Commands — Chỉ chạy những gì cần thiết

• NX phân tích các thay đổi code và dependency graph
• Chỉ các projects bị ảnh hưởng được rebuild, test, hoặc lint
• Một thay đổi nhỏ không kích hoạt rebuild toàn bộ repo

3. Module Boundaries — Thực thi các quy tắc kiến trúc

• Định nghĩa projects nào có thể depend on projects nào
• Các quy tắc ESLint ngăn chặn imports không được phép
• Giữ kiến trúc sạch khi codebase phát triển

4. Dependency Graph — Hiểu codebase của bạn

• Trực quan hóa các mối quan hệ project với nx graph
• Hiểu tác động của các thay đổi trước khi thực hiện chúng
• Xác định circular dependencies và các vấn đề kiến trúc

5. Consistent Tooling — Plugins và Generators

• Các commands chuẩn hóa trên tất cả projects
• Generators tạo projects mới với best practices tích hợp sẵn
• Plugins cung cấp các tối ưu hóa cụ thể cho framework