Architecture Decision Record

Active theme: Light

← tài-liệu

Hướng dẫn đạt được quyết định bền vững

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

Chúng tôi đã rút ra những bài học sau trong công việc của mình, có thể dùng làm hướng dẫn và đánh giá để đạt được các quyết định bền vững:

  1. Sử dụng cách tiếp cận tinh gọn/tối giản cho việc lập tài liệu quyết định ban đầu.

  2. Ưu tiên và ghi lại tất cả các quyết định quan trọng đủ liên quan để lập tài liệu và hiểu kiến trúc mục tiêu.

  3. Chỉ chi tiết hóa các quyết định đặc biệt quan trọng bằng các mẫu đầy đủ sau khi công việc ban đầu đã hoàn tất (nghĩa là khi những người ra quyết định hài lòng với các quyết định kiến trúc đã đưa ra và tự tin rằng các quyết định này sẽ không phải sửa đổi sớm).

  4. Sử dụng các phiên bản tinh gọn/tối giản từ bước 1 như một phiên bản ngắn của các quyết định đã lập tài liệu với mức độ chi tiết phù hợp để cung cấp tổng quan về các quyết định chi tiết, cũng như cho các quyết định tầm thường hoặc hiển nhiên.

  5. Bất cứ khi nào có thể, hãy sử dụng kiến thức kiến trúc hiện có, từ các mô hình hướng dẫn hoặc từ các nguồn khác. Xem xét và mở rộng kiến thức đó và điều chỉnh cho phù hợp với bối cảnh của quyết định cụ thể.

  6. Đảm bảo thiết lập các liên kết truy vết giữa các quyết định và cả yêu cầu lẫn thiết kế/mã kiến trúc.

  7. Cung cấp kiểm tra tính nhất quán tự động để đảm bảo các liên kết truy vết luôn đồng bộ sau một thay đổi. Giới hạn số lượng phụ thuộc giữa các quyết định và các tạo phẩm phần mềm khác.

  8. Áp dụng các hướng dẫn về lý giải một cách nhất quán và mạnh mẽ, vì chúng là phần quan trọng nhất của tài liệu quyết định do chúng cung cấp lý do.