Software Architecture: Tổng quan

Section này tập trung vào cách thiết kế hệ thống ở cấp độ code — không phải distributed systems (đã có ở software/distributed-systems/), mà là cách tổ chức code, tách biệt concerns, và đưa ra quyết định kiến trúc.

Độ sâu: Advanced — Edge cases, trade-offs, real-world pitfalls từ kinh nghiệm thực chiến.

Các topic

Khi nào cần kiến thức này?

• ✓ System design interview — câu hỏi về cấu trúc code, layering, dependency management
• ✓ Code review — nhận ra vi phạm design principles
• ✓ Onboarding dự án mới — hiểu tại sao code được tổ chức theo cách đó
• ✓ Tech lead / architect role — đưa ra quyết định kiến trúc có documented reasoning
• ✓ Refactoring legacy code — strategy để incrementally improve codebase

Learning Path

Từng bước (không nhất thiết phải theo trình tự):

1. Foundation: ddd-core-concepts.md — Hiểu business modeling từ DDD
2. Structure: clean-and-hexagonal.md — Cách organize code thành layers
3. Quality: design-principles.md — Design principles để keep code clean
4. Strategy: interview-and-big-picture.md — Quyết định architecture ở scale lớn

Hoặc đọc ngang nếu bạn đã familiar với concepts — mỗi file độc lập, chứa go-to reference + Go code examples.

Real-world Mindset 🎯

Architecture ≠ "Design patterns" hoặc "Clean code"
Architecture = Decision-making framework để quản lý complexity khi hệ thống phát triển

• Không có "perfect architecture" — chỉ có "right trade-off cho constraints hiện tại"
• Decisions phải được document (ADR) để future-self + team hiểu "why"
• Sẵn sàng refactor khi constraints thay đổi, nhưng incremental > big-bang rewrite
• SOLID/DDD không là dogma — nó là tools, biết khi nào dùng khi nào skip

Cheat Sheet: Khi Nghi Ngờ