تصمیمهای معماری تریپیلون
Architecture Decision Record یا ADR دلیل یک تصمیم مهم، گزینههای بررسیشده، پیامدها و برنامه اعتبارسنجی آن را نگه میدارد. Standard میگوید چه قاعدهای الزامآور است؛ ADR توضیح میدهد چرا آن قاعده انتخاب شده است.
چرخه عمر
| وضعیت | معنا |
|---|---|
Proposed |
آماده Review و هنوز غیرالزامآور |
Accepted |
تاییدشده و لازمالاجرا |
Rejected |
بررسی و انتخابنشده |
Deprecated |
دیگر برای کار جدید توصیه نمیشود |
Superseded |
ADR جدید جایگزین آن شده است |
ADR پذیرفتهشده برای تغییر تصمیم بازنویسی نمیشود؛ ADR جدید آن را Supersede میکند. اصلاح نگارشی یا لینک بدون تغییر معنا مجاز است.
طراحی Upload همین جریان در ADR-0003 پردازش خصوصی تصویر ساختمان ثبت شده است.
زمان الزام ADR
- تغییر جهت Dependency یا مرز Module؛
- افزودن Framework، Data Store، Queue، Cache یا Provider سراسری؛
- تغییر روش Authentication، Authorization، Tenant Isolation یا Secret؛
- تصمیم Production، High Availability، Backup یا Data Residency؛
- Breaking Change عمومی یا مهاجرت پرریسک؛
- استثنا از Standard مشترک چند Repository.
شمارهگذاری
نام فایل از adr-<four-digits>-<decision>.md پیروی میکند. شماره حذفشده دوباره استفاده نمیشود و ترتیب عددی زمان ثبت را نشان میدهد، نه اولویت تصمیم را.