System Architecture for Senior Engineers
Trang chủ / Module 13
🗣️ Module 13 / 15 · 1 tuần

Technical Leadership — ADR & Giao tiếp Trade-off

Architecture Decision Records (ADR), giao tiếp trade-off với stakeholder không rành kỹ thuật, và xây đồng thuận không cần quyền lực chức danh.

ADRLeadership
📌 Vì sao module này quan trọng

Kiến trúc tốt trên giấy nhưng không ai đồng thuận, không ai làm theo là kiến trúc thất bại. Đây là kỹ năng thường bị bỏ qua trong đào tạo kỹ thuật nhưng lại quyết định phần lớn thành công thực tế của một Architect — khả năng thuyết phục và giao tiếp quan trọng ngang với khả năng thiết kế đúng.

🎯 Mục tiêu học tập

  • Viết Architecture Decision Record (ADR) đầy đủ, rõ ràng cho 1 quyết định kiến trúc
  • Giao tiếp đánh đổi kỹ thuật cho stakeholder không rành kỹ thuật một cách thuyết phục
  • Xây dựng đồng thuận (consensus) trong tổ chức mà không dựa vào quyền lực chức danh
  • Biết khi nào nên quyết đoán (disagree and commit) và khi nào nên tiếp tục thảo luận

Architecture Decision Record (ADR)

ADR là văn bản ngắn gọn ghi lại 1 quyết định kiến trúc quan trọng, tại sao đưa ra quyết định đó, và những gì đã cân nhắc — trở thành "bộ nhớ tổ chức" giúp người sau (kể cả chính bạn 1 năm sau) hiểu được bối cảnh, không phải tự hỏi "vì sao lại làm thế này" khi không còn ai nhớ lý do gốc:

# ADR-014: Chọn PostgreSQL + pgvector thay vì Vector DB chuyên dụng cho RAG

## Trạng thái: Đã chấp nhận

## Bối cảnh
Cần lưu trữ và truy vấn ~2 triệu vector embedding cho hệ thống RAG nội bộ.
Team đã có kinh nghiệm vận hành PostgreSQL, chưa có kinh nghiệm Qdrant/Pinecone.

## Quyết định
Dùng PostgreSQL + pgvector thay vì triển khai Qdrant riêng.

## Lý do
- Quy mô 2 triệu vector nằm trong khả năng xử lý tốt của pgvector với HNSW index
- Giảm số hệ thống phải vận hành (đã có PostgreSQL cho dữ liệu quan hệ)
- Team đã quen thuộc vận hành/backup/monitoring PostgreSQL

## Đánh đổi đã chấp nhận
- Hiệu năng vector search thuần tuý sẽ thấp hơn Qdrant chuyên dụng ở quy mô rất lớn
- Nếu quy mô vượt 10 triệu vector, cần đánh giá lại (xem điều kiện re-evaluate bên dưới)

## Điều kiện xem xét lại
Khi số vector vượt 10 triệu, hoặc P95 latency truy vấn vượt 500ms.

ADR nên ngắn gọn (1 trang), lưu trong repo code (không phải wiki rời rạc dễ thất lạc), và quan trọng nhất: ghi rõ điều kiện xem xét lại — quyết định kiến trúc không phải vĩnh viễn (Module 1), ADR giúp biết khi nào nên quay lại đánh giá.

Giao tiếp Trade-off với Stakeholder không rành kỹ thuật

Nguyên tắc cốt lõi: dịch đánh đổi kỹ thuật sang ngôn ngữ hệ quả kinh doanh mà stakeholder thực sự quan tâm (đã học ở Module 1):

Ngôn ngữ kỹ thuật (tránh dùng trực tiếp)Ngôn ngữ hệ quả kinh doanh (nên dùng)
"Chọn Eventual Consistency cho service này""Sau khi cập nhật, một số màn hình có thể mất tới 5 giây mới hiển thị thay đổi mới nhất — đổi lại hệ thống nhanh hơn và ổn định hơn khi có sự cố mạng"
"Cần refactor sang Modular Monolith""Đầu tư 3 tuần dọn dẹp cấu trúc code sẽ giúp team ra tính năng mới nhanh hơn khoảng 30% trong 6 tháng tới, thay vì chậm dần theo thời gian như hiện tại"
"Thiếu Circuit Breaker nên hệ thống dễ cascading failure""Nếu nhà cung cấp thanh toán bên thứ ba gặp sự cố, hiện tại toàn bộ website sẽ sập theo — cần 1 tuần để thêm cơ chế bảo vệ, tránh rủi ro này"

Xây Đồng thuận không cần Quyền lực Chức danh

  • Trình bày nhiều lựa chọn kèm đánh đổi, không chỉ 1 đáp án — cho stakeholder cảm giác tham gia quyết định thay vì bị áp đặt, tăng khả năng đồng thuận thực chất (không chỉ đồng ý trên bề mặt).
  • Dùng dữ liệu/số liệu (capacity estimation — Module 12, chi phí ước tính — khoá DevOps Module 12) thay vì ý kiến cá nhân để thuyết phục — số liệu khó phản bác hơn quan điểm chủ quan.
  • Prototype/Proof of Concept nhỏ khi tranh luận kéo dài không đi đến đâu — 1 demo chạy được thường thuyết phục hơn nhiều so với hàng giờ tranh luận lý thuyết.
  • Lắng nghe phản đối nghiêm túc — phản đối thường chứa thông tin bạn chưa biết (ràng buộc thực tế, kinh nghiệm quá khứ), không phải trở ngại cần vượt qua bằng mọi giá.

Disagree and Commit — khi nào quyết đoán

Không phải mọi quyết định đều cần đồng thuận 100% trước khi tiến hành — với quyết định two-way door (dễ đảo ngược — Module 1), đôi khi tốt hơn là quyết định, thử nghiệm, học hỏi thay vì thảo luận kéo dài để tìm sự đồng thuận hoàn hảo (vốn tốn thời gian và có thể không bao giờ đạt được). Nguyên tắc "disagree and commit" (phổ biến ở Amazon): sau khi đã lắng nghe đầy đủ ý kiến trái chiều, người ra quyết định cuối cùng quyết định, và toàn team — kể cả người không đồng ý — cam kết thực hiện hết mình, thay vì âm thầm phá hoại hoặc chỉ làm cho có. Ngược lại, với quyết định one-way door (khó đảo ngược, hệ quả lớn), nên đầu tư thời gian tìm đồng thuận thực chất trước khi hành động.

🏋️ Bài tập thực hành

Viết ADR & Bản dịch Trade-off

Chọn 1 quyết định kiến trúc đã đưa ra ở các module trước (ví dụ chọn kiến trúc ở Module 3, hoặc Saga pattern ở Module 8). Viết 1 ADR đầy đủ theo đúng cấu trúc mẫu. Sau đó viết 1 đoạn giải thích cùng quyết định đó bằng ngôn ngữ hệ quả kinh doanh, dành cho 1 stakeholder không rành kỹ thuật (ví dụ CEO hoặc Product Manager) — không dùng bất kỳ thuật ngữ kỹ thuật nào chưa được giải thích.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Viết được 1 ADR đầy đủ, rõ ràng, có điều kiện xem xét lại
  • Dịch được đánh đổi kỹ thuật sang ngôn ngữ hệ quả kinh doanh
  • Áp dụng được ít nhất 2 kỹ thuật xây đồng thuận không cần quyền lực chức danh
  • Phân biệt được khi nào nên "disagree and commit", khi nào nên tiếp tục tìm đồng thuận