{Judul Anda di Sini}
!!! info
**Status**: { Proposed | Under Review | Accepted | Rejected | Superseded | Deprecated }
**Diperbarui**: {YYYY-MM-DD}
Ringkasan
{Ini adalah 'ringkasan eksekutif' atau 'elevator pitch' untuk ADR Anda. Dalam beberapa kalimat ringkas (biasanya 2-4), nyatakan dengan jelas masalah inti, pertanyaan, atau peluang yang ditangani ADR ini. Sertakan petunjuk singkat tentang keputusan yang dibuat atau area fokusnya. Tujuannya adalah membantu pembaca dengan cepat memahami tentang apa ADR ini dan memutuskan apakah ADR ini relevan bagi mereka, tanpa perlu membaca seluruh dokumen. Anggap ini seperti abstrak makalah teknis atau pengantar yang sangat singkat tentang topik utama.}
Pendorong
{Bagian ini menjelaskan mengapa keputusan ini dibuat sekarang. Uraikan dengan jelas motivasi, kebutuhan, atau masalah utama yang menuntut keputusan arsitektur ini. Pikirkan alasan dan tekanan yang mendasarinya.}
{mis. Kami sedang mengembangkan fitur/kemampuan baru yang membutuhkan...}
{mis. Kami perlu meningkatkan kinerja, aksesibilitas, menghapus utang...}
{mis. Masukan dari pengguna menunjukkan bahwa...}
{mis. Pendekatan saat ini menimbulkan keterbatasan berikut...}
Opsi
{Di sinilah Anda mendaftar berbagai opsi yang sedang dipertimbangkan. Tetaplah pada fakta dan hindari opini, karena bagian berikutnya membahas analisis. Sertakan deskripsi singkat, tautan ke dokumentasi atau contoh yang relevan.
Sertakan semua alternatif signifikan yang Anda telusuri, meskipun pada akhirnya tidak dipilih. Tujuannya adalah memberi pembaca pemahaman yang jelas dan tidak bias tentang setiap alternatif sebelum Anda masuk ke evaluasi.}
{Judul Opsi 1}
{Jelaskan opsi tersebut, berikan ringkasan, daftarkan fakta, berikan tautan, dsb.}
{Judul Opsi n}
...
Analisis Opsi
{Di sinilah Anda mengevaluasi secara kritis setiap opsi yang disajikan pada bagian Opsi. Untuk setiap opsi, berikan pandangan yang seimbang tentang kelebihan, kekurangan, dan pertimbangan atau trade-off relevan lainnya. Bersikap spesifik dan, jika memungkinkan, kaitkan poin Anda kembali ke Pendorong.
Pertimbangkan aspek seperti:
Biaya (pengembangan, operasional, lisensi)
Kompleksitas (implementasi, pemeliharaan, kurva belajar)
Risiko (teknis, operasional, keamanan)
Keselarasan dengan prinsip arsitektur atau standar yang ada
Dampak pada kinerja, skalabilitas, kegunaan, pemeliharaan, keamanan, dsb.
Sertakan pernyataan Pro/Kontra/Lainnya sebanyak yang diperlukan. }
{Penilaian Opsi 1}
Pro: {Kelebihan atau manfaat spesifik dari opsi ini.}
Kontra: {Kekurangan, risiko, atau biaya spesifik yang terkait dengan opsi ini.}
Lainnya: {Poin relevan yang tidak sepenuhnya merupakan pro atau kontra.}
{Penilaian Opsi n}
...
Rekomendasi
{Di sinilah Anda menyatakan dengan jelas keputusan akhir, dan menyebutkan secara eksplisit opsi yang dipilih. Jelaskan secara rinci mengapa opsi ini dipilih. Anda harus menguraikan dengan jelas bagaimana opsi yang dipilih paling baik menangani Pendorong dan memenuhi persyaratan utama atau menyelesaikan masalah yang dinyatakan.}
Konsekuensi
{Bagian ini opsional.}
{Setelah keputusan dibuat, apa saja hasil dan dampak yang diharapkan, baik positif maupun negatif? Keterbatasan, biaya, atau risiko apa yang diterima dengan membuat keputusan ini? Bagaimana keputusan ini akan memengaruhi para pemangku kepentingan yang berbeda, sistem lain, praktik pengembangan, prosedur operasional, atau pengalaman pengguna?}
Pro: {Hasil positif atau manfaat spesifik yang diharapkan dari keputusan ini.}
Kontra: {Kerugian, biaya, atau risiko spesifik yang diterima akibat keputusan ini. }
Lainnya: {Konsekuensi yang tidak sepenuhnya merupakan pro atau kontra.}
Konfirmasi
{Bagian ini opsional.}
{Uraikan bagaimana implementasi keputusan ini akan diverifikasi dan bagaimana kepatuhan yang berkelanjutan akan dipastikan. Ini membantu menunjukkan bahwa keputusan tersebut bukan sekadar teori tetapi akan benar-benar dipraktikkan dan dipantau.
Bagaimana Anda akan memeriksa bahwa keputusan telah diimplementasikan dengan benar? (mis., tinjauan kode, pengujian khusus, demonstrasi, tinjauan sejawat).
Bagaimana kepatuhan terhadap keputusan ini akan dijaga dari waktu ke waktu? (mis., pemeriksaan otomatis, audit berkala, pembaruan pedoman tim, pelatihan).
Apakah ada metrik atau indikator spesifik yang akan menunjukkan bahwa keputusan ini mencapai hasil positif yang diinginkan? (mis., tolok ukur kinerja, tingkat adopsi, penurunan kesalahan tertentu, skor umpan balik pengguna).
Siapa yang bertanggung jawab mengawasi hal ini, dan apa yang terjadi jika keputusan tidak diikuti?}
Informasi Lebih Lanjut
{Bagian ini opsional.}
{Gunakan bagian ini untuk memberikan informasi tambahan yang mendukung keputusan, menambah konteks, atau memandu tindakan di masa depan. Tautan ke keputusan dan sumber daya lain juga dapat muncul di sini.
Anda dapat mencatat secara singkat siapa saja yang terlibat dalam proses pengambilan keputusan dan apakah/bagaimana konsensus dicapai. Anda juga dapat menyarankan jangka waktu atau peristiwa tertentu yang mungkin mendorong evaluasi ulang keputusan ini di masa depan.}