Architecture Decision Record

Active theme: Light

← แม่แบบบันทึกการตัดสินใจ

{ใส่ชื่อเรื่องที่นี่}

!!! info

**สถานะ**: { Proposed | Under Review | Accepted |  Rejected | Superseded | Deprecated }

**อัปเดตเมื่อ**: {YYYY-MM-DD}

สรุป

{นี่คือ "รายงานสั้น" หรือ "คำพูดลิฟต์" ของ ADR ด้วยประโยคกระชับไม่กี่ประโยค (โดยทั่วไป 2-4 ประโยค) ระบุอย่างชัดเจนถึงปัญหาหลัก คำถาม หรือโอกาสที่ ADR นี้ตอบสนอง ใบ้สั้น ๆ ถึงการตัดสินใจที่ทำหรือประเด็นที่เน้น เป้าหมายคือช่วยให้ผู้อ่านเข้าใจอย่างรวดเร็วว่า ADR นี้เกี่ยวกับอะไรและ เกี่ยวข้องกับพวกเขาหรือไม่ โดยไม่ต้องอ่านทั้งเอกสาร ให้คิดว่าเป็น บทคัดย่อของบทความทางเทคนิคหรือบทนำสั้นมากของหัวข้อหลัก}

ปัจจัยขับเคลื่อน

{ส่วนนี้อธิบายว่าทำไมจึงทำการตัดสินใจนี้ตอนนี้ ทำให้ชัดเจนว่า แรงจูงใจ ความต้องการ หรือปัญหาหลักที่ทำให้ต้องมีการตัดสินใจด้านสถาปัตยกรรมนี้คืออะไร คิดถึง เหตุผลพื้นฐานและแรงกดดัน}

  • {ตัวอย่าง: เรากำลังพัฒนาฟีเจอร์/ความสามารถใหม่ที่ต้องการ ...}

  • {ตัวอย่าง: เราต้องปรับปรุงประสิทธิภาพ การเข้าถึง จัดการหนี้...}

  • {ตัวอย่าง: ข้อเสนอแนะของผู้ใช้ชี้ว่า...}

  • {ตัวอย่าง: แนวทางปัจจุบันกำหนดข้อจำกัดเช่น...}

ทางเลือก

{ที่นี่คุณระบุทางเลือกต่าง ๆ ที่กำลังพิจารณา ยึดตามข้อเท็จจริงและหลีกเลี่ยง ความคิดเห็น การวิเคราะห์จะอยู่ในส่วนถัดไป ใส่คำอธิบายสั้น ๆ และลิงก์ไปยัง เอกสารหรือตัวอย่างที่เกี่ยวข้อง

ใส่ทางเลือกสำคัญทั้งหมดที่ได้สำรวจ แม้ว่าท้ายที่สุดจะไม่ได้ เลือกก็ตาม เป้าหมายคือให้ผู้อ่านเข้าใจแต่ละทางเลือกอย่างชัดเจนและเป็นกลาง ก่อนที่การประเมินจะเริ่มต้น}

{ชื่อทางเลือก 1}

{อธิบายทางเลือก ให้สรุป ระบุข้อเท็จจริง ให้ลิงก์ ฯลฯ}

{ชื่อทางเลือก n}

...

การวิเคราะห์ทางเลือก

{ที่นี่คุณประเมินอย่างวิพากษ์ทุกทางเลือกที่นำเสนอในส่วน ทางเลือก สำหรับแต่ละ ทางเลือก ให้ภาพที่สมดุลของข้อดี ข้อเสีย และข้อพิจารณาหรือ ข้อแลกเปลี่ยนอื่นที่เกี่ยวข้อง ให้เฉพาะเจาะจงและเชื่อมโยงกับ ปัจจัยขับเคลื่อน เมื่อเป็นไปได้

พิจารณาด้านต่าง ๆ เช่น:

  • ต้นทุน (การพัฒนา การดำเนินงาน ใบอนุญาต)

  • ความซับซ้อน (การนำไปใช้ การบำรุงรักษา เส้นโค้งการเรียนรู้)

  • ความเสี่ยง (ทางเทคนิค ด้านปฏิบัติการ ด้านความปลอดภัย)

  • ความสอดคล้องกับหลักการสถาปัตยกรรมหรือมาตรฐานที่มีอยู่

  • ผลกระทบต่อประสิทธิภาพ การปรับขนาด การใช้งาน การบำรุงรักษา ความปลอดภัย ฯลฯ

ใส่ข้อความข้อดี/ข้อเสีย/อื่น ๆ ให้มากเท่าที่จำเป็น }

{การประเมินทางเลือก 1}

  • ข้อดี: {ข้อได้เปรียบหรือประโยชน์เฉพาะของทางเลือกนี้}

  • ข้อเสีย: {ข้อเสียเปรียบ ความเสี่ยง หรือต้นทุนเฉพาะที่เกี่ยวข้องกับทางเลือกนี้}

  • อื่น ๆ: {ประเด็นที่เกี่ยวข้องซึ่งโดยเคร่งครัดไม่ใช่ทั้งข้อดีและข้อเสีย}

{การประเมินทางเลือก n}

...

ข้อเสนอแนะ

{ที่นี่คุณระบุการตัดสินใจสุดท้ายอย่างชัดเจนและระบุชื่อทางเลือกที่เลือกอย่างชัดแจ้ง อธิบายโดยละเอียดว่าทำไมจึงเลือกทางเลือกนี้ ทำให้ชัดเจนว่าทางเลือกที่เลือก ตอบสนอง ปัจจัยขับเคลื่อน ได้ดีที่สุดอย่างไร และตอบสนองข้อกำหนดหลักหรือแก้ปัญหาที่อธิบายไว้ ได้อย่างไร}

ผลที่ตามมา

{ส่วนนี้เป็นทางเลือก}

{ตอนนี้เมื่อการตัดสินใจได้ทำแล้ว ผลลัพธ์และผลกระทบที่คาดหวังคืออะไร ทั้งเชิงบวกและ เชิงลบ ข้อจำกัด ต้นทุน หรือความเสี่ยงที่ทราบอะไรบ้างที่ยอมรับด้วยการตัดสินใจนี้ การตัดสินใจนี้ส่งผลต่อผู้มีส่วนได้ส่วนเสียต่าง ๆ ระบบอื่น แนวปฏิบัติด้านการพัฒนา ขั้นตอนการดำเนินงาน หรือประสบการณ์ผู้ใช้อย่างไร}

  • ข้อดี: {ผลลัพธ์เชิงบวกหรือประโยชน์ที่คาดหวังเฉพาะของการตัดสินใจนี้}

  • ข้อเสีย: {ข้อเสียเปรียบ ต้นทุน หรือความเสี่ยงเฉพาะที่ยอมรับอันเป็นผลจากการตัดสินใจนี้ }

  • อื่น ๆ: {ผลที่ตามมาซึ่งโดยเคร่งครัดไม่ใช่ทั้งข้อดีและข้อเสีย}

การยืนยัน

{ส่วนนี้เป็นทางเลือก}

{ร่างภาพรวมว่าจะตรวจสอบการนำการตัดสินใจนี้ไปใช้อย่างไร และจะ รับประกันการปฏิบัติตามอย่างต่อเนื่องอย่างไร ซึ่งช่วยแสดงว่าการตัดสินใจจะ นำไปปฏิบัติและเฝ้าติดตาม ไม่ใช่เพียงทฤษฎี

คุณยืนยันว่าการตัดสินใจนำไปใช้อย่างถูกต้องได้อย่างไร (เช่น การทบทวนโค้ด การทดสอบเฉพาะ การสาธิต การทบทวนโดยเพื่อนร่วมงาน)

การปฏิบัติตามการตัดสินใจนี้คงอยู่เมื่อเวลาผ่านไปอย่างไร (เช่น การตรวจสอบ อัตโนมัติ การตรวจสอบเป็นระยะ การอัปเดตแนวทางของทีม การฝึกอบรม)

มีเมตริกหรือตัวบ่งชี้เฉพาะที่จะแสดงว่าการตัดสินใจบรรลุผลลัพธ์เชิงบวก ที่ตั้งใจหรือไม่ (เช่น เกณฑ์เปรียบเทียบประสิทธิภาพ อัตราการนำไปใช้ การลดลงของ ข้อผิดพลาดเฉพาะ คะแนนข้อเสนอแนะของผู้ใช้)

ใครรับผิดชอบดูแลเรื่องนี้ และจะเกิดอะไรขึ้นหากไม่ปฏิบัติตาม การตัดสินใจ}

ข้อมูลเพิ่มเติม

{ส่วนนี้เป็นทางเลือก}

{ใช้ส่วนนี้เพื่อให้ข้อมูลเสริมที่สนับสนุนการตัดสินใจ เพิ่มบริบท หรือชี้นำการดำเนินการในอนาคต ลิงก์ไปยังการตัดสินใจหรือทรัพยากรอื่นก็อาจปรากฏที่นี่ได้

คุณอาจระบุสั้น ๆ ว่าใครมีส่วนร่วมในกระบวนการตัดสินใจ และบรรลุฉันทามติหรือไม่/อย่างไร คุณอาจเสนอกรอบเวลาหรือเหตุการณ์เฉพาะที่อาจกระตุ้นให้มีการประเมินใหม่ในอนาคต ของการตัดสินใจนี้}