আর্কিটেকচার সিদ্ধান্ত রেকর্ড (ADR)
আর্কিটেকচার সিদ্ধান্ত নথিভুক্ত করার জন্য টেমপ্লেট, উদাহরণ ও নির্দেশনা।
আর্কিটেকচার সিদ্ধান্ত রেকর্ড (ADR) এমন একটি নথি, যা গৃহীত একটি গুরুত্বপূর্ণ আর্কিটেকচার সিদ্ধান্ত তার প্রেক্ষাপট ও ফলাফলসহ ধারণ করে।
ভাষা: العربية, Български, भोजपुरी, বাংলা, Čeština, Cymraeg, Dansk, Deutsch, Ελληνικά, English, Español, Eesti, Euskara, فارسی, Suomi, Français, Gaeilge, Gàidhlig, ગુજરાતી, Hausa, עברית, हिन्दी, Hrvatski, Magyar, Bahasa Indonesia, Íslenska, Italiano, 日本語, Basa Jawa, ខ្មែរ, ಕನ್ನಡ, 한국어, kernewek, Lëtzebuergesch, ລາວ, Lietuvių, Latviešu, मराठी, Bahasa Melayu, Malti, Norsk bokmål, Nederlands, ਪੰਜਾਬੀ, Naijá, Polski, Português, Română, Русский, Scots, Slovenčina, Slovenščina, Svenska, Kiswahili, தமிழ், తెలుగు, ไทย, Filipino, Türkçe, Українська, اردو, Tiếng Việt, 吴语, 粵語, 中文
- আর্কিটেকচার সিদ্ধান্ত রেকর্ড কী?
একটি আর্কিটেকচার সিদ্ধান্ত রেকর্ড (ADR) হলো এমন একটি নথি, যা গৃহীত একটি গুরুত্বপূর্ণ আর্কিটেকচার সিদ্ধান্তকে তার প্রেক্ষাপট ও পরিণতিসহ লিপিবদ্ধ করে।
- ADR ব্যবহার শুরু করার উপায়
ADR ব্যবহার শুরু করতে আপনার সহকর্মীদের সঙ্গে এই বিষয়গুলো নিয়ে কথা বলুন।
- ভালো ADR লেখার পরামর্শ
যুক্তি: নির্দিষ্ট AD নেওয়ার কারণ ব্যাখ্যা করুন। এর মধ্যে থাকতে পারে প্রেক্ষাপট (নিচে দেখুন), বিভিন্ন সম্ভাব্য পছন্দের সুবিধা-অসুবিধা, বৈশিষ্ট্যের তুলনা, খরচ/উপকারের…
- ADR উদাহরণ টেমপ্লেট
Michael Nygard-এর ADR টেমপ্লেট (সহজ ও জনপ্রিয়)
- ADR-এর জন্য দলগত কাজের পরামর্শ
আপনি যদি আপনার দলে সিদ্ধান্ত রেকর্ড ব্যবহারের কথা ভাবছেন, তাহলে অনেক দলের সঙ্গে কাজ করে আমরা যে পরামর্শ পেয়েছি তা এখানে দেওয়া হলো।
- কোড হিসেবে সিদ্ধান্তের ফিটনেস ফাংশন
ফিটনেস ফাংশন হলো প্রোগ্রামিং কোড দিয়ে লেখা বস্তুনিষ্ঠ স্বয়ংক্রিয় পরীক্ষা, যা যাচাই করে যে সিদ্ধান্তগুলো বজায় রাখা হচ্ছে।
কোনো গুরুত্বপূর্ণ সিস্টেমে ব্যবহারের আগে এই সম্পদগুলো নিজে যথাযথভাবে যাচাই করে নিন।
সূচিপত্র:
- আর্কিটেকচার সিদ্ধান্ত রেকর্ড কী?
- ADR ব্যবহার শুরু করার উপায়
- টুল দিয়ে ADR ব্যবহার শুরু করার উপায়
- git দিয়ে ADR ব্যবহার শুরু করার উপায়
- ADR-এর জন্য Claude Code স্কিল
- ফাইলের নামকরণ রীতি
- ভালো ADR লেখার পরামর্শ
- ADR উদাহরণ টেমপ্লেট
- ADR-এর জন্য দলগত কাজের পরামর্শ
- ADR-এর জন্য দলগত কাজের প্রশ্ন
- ADR-এর পরবর্তী ধাপের ধারণা
- আর্কিটেকচার ডায়াগ্রাম, ভিউ ও ভিউপয়েন্ট
- কোড হিসেবে সিদ্ধান্তের ফিটনেস ফাংশন
- পুল রিকোয়েস্টের জন্য সিদ্ধান্তের গার্ডরেল
- আরও তথ্যের জন্য
টেমপ্লেট:
- জেফ টাইরি ও আর্ট আকারম্যানের সিদ্ধান্ত রেকর্ড টেমপ্লেট
- মাইকেল নাইগার্ডের সিদ্ধান্ত রেকর্ড টেমপ্লেট
- EdgeX-এর সিদ্ধান্ত রেকর্ড টেমপ্লেট
- arc42-এর সিদ্ধান্ত রেকর্ড টেমপ্লেট
- আলেকজান্দ্রীয় প্যাটার্নের সিদ্ধান্ত রেকর্ড টেমপ্লেট
- ব্যবসায়িক যুক্তির সিদ্ধান্ত রেকর্ড টেমপ্লেট
- MADR প্রকল্পের সিদ্ধান্ত রেকর্ড টেমপ্লেট
- Planguage ব্যবহারকারী সিদ্ধান্ত রেকর্ড টেমপ্লেট
- Paulo Merson-এর সিদ্ধান্ত রেকর্ড টেমপ্লেট
- Olaf Zimmermann-এর সিদ্ধান্ত রেকর্ড টেমপ্লেট
- গ্যারেথ মর্গানের সিদ্ধান্ত রেকর্ড টেমপ্লেট
- GIG Cymru NHS Wales-এর সিদ্ধান্ত রেকর্ড টেমপ্লেট
- Ignacio Larrañaga-র গুরুত্বপূর্ণ প্রযুক্তিগত সিদ্ধান্তের (ITD) সিদ্ধান্ত রেকর্ড টেমপ্লেট
উদাহরণ:
- CSS ফ্রেমওয়ার্ক
- এনভায়রনমেন্ট ভেরিয়েবল কনফিগারেশন
- মেট্রিক, মনিটর, সতর্কবার্তা
- মাইক্রোসফট Azure DevOps
- মনোরেপো বনাম মাল্টিরেপো
- প্রোগ্রামিং ভাষাসমূহ
- গোপন তথ্য সংরক্ষণ
- টাইমস্ট্যাম্প ফরম্যাট
- আরও অনেক...
আর্কিটেকচার সিদ্ধান্ত রেকর্ড কী?
একটি আর্কিটেকচার সিদ্ধান্ত রেকর্ড (ADR) হলো এমন একটি নথি, যা গৃহীত একটি গুরুত্বপূর্ণ আর্কিটেকচার সিদ্ধান্তকে তার প্রেক্ষাপট ও পরিণতিসহ লিপিবদ্ধ করে।
একটি আর্কিটেকচার সিদ্ধান্ত (AD) হলো একটি সফটওয়্যার নকশাগত পছন্দ, যা কোনো গুরুত্বপূর্ণ প্রয়োজনীয়তার সমাধান করে।
একটি আর্কিটেকচার সিদ্ধান্ত লগ (ADL) হলো কোনো নির্দিষ্ট প্রকল্পের (বা সংগঠনের) জন্য তৈরি ও রক্ষণাবেক্ষণ করা সব ADR-এর সংকলন।
একটি আর্কিটেকচারগতভাবে গুরুত্বপূর্ণ প্রয়োজনীয়তা (ASR) হলো এমন একটি প্রয়োজনীয়তা, যার সফটওয়্যার সিস্টেমের আর্কিটেকচারের ওপর পরিমাপযোগ্য প্রভাব আছে।
এই সবই আর্কিটেকচার জ্ঞান ব্যবস্থাপনা (AKM) বিষয়ের অন্তর্ভুক্ত।
এই নথির লক্ষ্য হলো ADR-এর একটি দ্রুত সংক্ষিপ্ত বিবরণ দেওয়া, সেগুলো কীভাবে তৈরি করতে হয় এবং আরও তথ্যের জন্য কোথায় দেখতে হবে তা জানানো।
সংক্ষিপ্ত রূপ:
AD: আর্কিটেকচার সিদ্ধান্ত
ADL: আর্কিটেকচার সিদ্ধান্ত লগ
ADR: আর্কিটেকচার সিদ্ধান্ত রেকর্ড
AKM: আর্কিটেকচার জ্ঞান ব্যবস্থাপনা
ASR: আর্কিটেকচারগতভাবে গুরুত্বপূর্ণ প্রয়োজনীয়তা
ADR ব্যবহার শুরু করার উপায়
ADR ব্যবহার শুরু করতে আপনার সহকর্মীদের সঙ্গে এই বিষয়গুলো নিয়ে কথা বলুন।
সিদ্ধান্ত শনাক্তকরণ:
AD কতটা জরুরি এবং কতটা গুরুত্বপূর্ণ?
এটি কি এখনই নিতে হবে, নাকি আরও তথ্য জানা পর্যন্ত অপেক্ষা করা যায়?
ব্যক্তিগত ও সমষ্টিগত অভিজ্ঞতা, পাশাপাশি স্বীকৃত নকশা পদ্ধতি ও অনুশীলন সিদ্ধান্ত শনাক্তকরণে সাহায্য করতে পারে।
আদর্শভাবে পণ্যের করণীয় তালিকার পরিপূরক হিসেবে একটি সিদ্ধান্তের করণীয় তালিকা রাখুন।
সিদ্ধান্ত গ্রহণ:
সিদ্ধান্ত গ্রহণের অনেক কৌশল আছে, সাধারণ কৌশলও আছে এবং সফটওয়্যার আর্কিটেকচার-নির্দিষ্ট কৌশলও আছে, যেমন ডায়ালগ ম্যাপিং।
দলগত সিদ্ধান্ত গ্রহণ একটি সক্রিয় গবেষণার বিষয়।
সিদ্ধান্ত কার্যকরকরণ ও প্রয়োগ:
AD সফটওয়্যার নকশায় ব্যবহৃত হয়; তাই সিস্টেমের যেসব অংশীজন সেটির অর্থায়ন, উন্নয়ন ও পরিচালনা করেন, তাঁদের কাছে এগুলো জানাতে হবে এবং তাঁদের কাছ থেকে গ্রহণযোগ্যতা পেতে হবে।
আর্কিটেকচারগতভাবে স্পষ্ট কোডিং শৈলী এবং আর্কিটেকচারগত উদ্বেগ ও সিদ্ধান্তের ওপর মনোযোগী কোড পর্যালোচনা দুটি সম্পর্কিত অনুশীলন।
সফটওয়্যার বিবর্তনে একটি সফটওয়্যার সিস্টেম আধুনিকীকরণের সময়ও AD (পুনরায়) বিবেচনা করতে হয়।
সিদ্ধান্ত ভাগ করে নেওয়া (ঐচ্ছিক):
অনেক AD এক প্রকল্প থেকে আরেক প্রকল্পে পুনরাবৃত্ত হয়।
তাই স্পষ্ট জ্ঞান ব্যবস্থাপনা কৌশল ব্যবহার করলে অতীত সিদ্ধান্ত নিয়ে ভালো ও মন্দ অভিজ্ঞতা মূল্যবান পুনর্ব্যবহারযোগ্য সম্পদ হতে পারে।
সিদ্ধান্ত নথিভুক্তকরণ:
সিদ্ধান্ত লিপিবদ্ধ করার অনেক টেমপ্লেট ও টুল আছে।
অ্যাজাইল সম্প্রদায়গুলো দেখুন, যেমন M. Nygard-এর ADR।
ঐতিহ্যবাহী সফটওয়্যার প্রকৌশল ও আর্কিটেকচার নকশা প্রক্রিয়া দেখুন, যেমন IBM UMF এবং CapitalOne-এর Tyree ও Akerman-এর প্রস্তাবিত টেবিল বিন্যাস।
আরও জানতে:
- উপরের ধাপগুলো উইকিপিডিয়ার Architectural Decision এন্ট্রি থেকে নেওয়া।
টুল দিয়ে ADR ব্যবহার শুরু করার উপায়
- MySpec — প্রকল্পের সংবিধান, প্রযুক্তিগত আর্কিটেকচার ও ADR-কে পরিচ্ছন্ন Markdown-এ সাজিয়ে MCP-র মাধ্যমে সরবরাহকারী স্বয়ংক্রিয় স্পেসিফিকেশন ও আর্কিটেকচার সিদ্ধান্ত প্ল্যাটফর্ম।
আপনি যেভাবে খুশি টুল দিয়ে ADR ব্যবহার শুরু করতে পারেন।
উদাহরণস্বরূপ:
আপনি যদি Google Drive ও অনলাইন সম্পাদনা ব্যবহার করতে পছন্দ করেন, তাহলে একটি Google Doc বা Google Sheet তৈরি করতে পারেন।
আপনি যদি git-এর মতো সোর্স কোড ভার্সন কন্ট্রোল ব্যবহার করতে পছন্দ করেন, তাহলে প্রতিটি ADR-এর জন্য একটি ফাইল তৈরি করতে পারেন।
আপনি যদি Atlassian Jira-র মতো প্রকল্প পরিকল্পনা টুল ব্যবহার করতে পছন্দ করেন, তাহলে টুলটির পরিকল্পনা ট্র্যাকার ব্যবহার করতে পারেন।
আপনি যদি MediaWiki-র মতো উইকি ব্যবহার করতে পছন্দ করেন, তাহলে একটি ADR উইকি তৈরি করতে পারেন।
git দিয়ে ADR ব্যবহার শুরু করার উপায়
আপনি যদি git ভার্সন কন্ট্রোল ব্যবহার করতে পছন্দ করেন, তাহলে সোর্স কোডসহ একটি সাধারণ সফটওয়্যার প্রকল্পে আমরা যেভাবে git দিয়ে ADR ব্যবহার শুরু করতে পছন্দ করি, তা এখানে দেওয়া হলো।
ADR ফাইলের জন্য একটি ডিরেক্টরি তৈরি করুন:
$ mkdir adr
প্রতিটি ADR-এর জন্য একটি টেক্সট ফাইল তৈরি করুন, যেমন database.txt:
$ vi database.txt
ADR-এ আপনার যা খুশি লিখুন। ধারণার জন্য এই রিপোজিটরির টেমপ্লেটগুলো দেখুন।
ADR-টি আপনার git রিপোতে কমিট করুন।
ADR-এর জন্য Claude Code স্কিল
এই রিপজিটরি skills/-এর অধীনে দুটি Claude Code স্কিল সরবরাহ করে, যাতে একটি এআই কোডিং এজেন্ট এই প্রকল্পের সুপারিশ অনুযায়ী ADR লিখতে ও রক্ষণাবেক্ষণ করতে পারে:
architecture-decision-record-skill— সাধারণ উদ্দেশ্যের, যেকোনো প্রকল্পে ADR লেখা যে কারও জন্য। একটি সিদ্ধান্তে ADR দরকার কি না তা ঠিক করতে,adr/বাdecisions/ডিরেক্টরি তৈরি করতে, ফাইলের নাম দিতে, সঙ্গে থাকা এগারোটি কাঠামো থেকে একটি টেমপ্লেট বেছে নিতে এবং ভালো প্রেক্ষাপট/সিদ্ধান্ত/ফলাফল অংশ লিখতে সাহায্য করে।architecture-decision-record-maintainer-skill— বিশেষভাবে এই রিপজিটরির রক্ষণাবেক্ষণকারীদের জন্য। রিপজিটরির কাঠামো, README/locales মিলিয়ে রাখার রীতি এবং নতুন টেমপ্লেট, উদাহরণ বা টুল লিঙ্ক যোগ করার সঠিক ধাপগুলো নথিভুক্ত করে।
একটি স্কিল ব্যবহার করতে এর ফোল্ডারটি আপনি যে রিপজিটরিতে কাজ করছেন তার মূলে .claude/skills/-এ (অথবা প্রতিটি প্রকল্পে পেতে ~/.claude/skills/-এ) কপি করুন, তারপর Claude Code-কে একটি ADR লিখতে বা পর্যালোচনা করতে বলুন।
ফাইলের নামকরণ রীতি
আপনি যদি সাধারণ টেক্সট ফাইল ব্যবহার করে ADR তৈরি করার সিদ্ধান্ত নেন, তাহলে আপনার নিজস্ব ADR ফাইলের নামকরণ রীতি ঠিক করে নিতে পারেন।
আমরা একটি নির্দিষ্ট বিন্যাসের ফাইলের নামকরণ রীতি ব্যবহার করতে পছন্দ করি।
উদাহরণ:
choose-database.md
format-timestamps.md
manage-passwords.md
handle-exceptions.md
আমাদের ফাইলের নামকরণ রীতি:
নামে বর্তমান কালের আদেশসূচক একটি ক্রিয়াপদগুচ্ছ থাকে। এটি পাঠযোগ্যতা বাড়ায় এবং আমাদের কমিট বার্তার বিন্যাসের সঙ্গে মেলে।
নামে ছোট হাতের অক্ষর ও ড্যাশ ব্যবহার করা হয় (এই রিপোজিটরির মতোই)। এটি পাঠযোগ্যতা ও সিস্টেমের ব্যবহারযোগ্যতার মধ্যে ভারসাম্য।
এক্সটেনশন মার্কডাউন। সহজে ফরম্যাট করার জন্য এটি কার্যকর হতে পারে।
ভালো ADR লেখার পরামর্শ
একটি ভালো ADR-এর বৈশিষ্ট্য:
যুক্তি: নির্দিষ্ট AD নেওয়ার কারণ ব্যাখ্যা করুন। এর মধ্যে থাকতে পারে প্রেক্ষাপট (নিচে দেখুন), বিভিন্ন সম্ভাব্য পছন্দের সুবিধা-অসুবিধা, বৈশিষ্ট্যের তুলনা, খরচ/উপকারের আলোচনা ও আরও অনেক কিছু।
সুনির্দিষ্ট: প্রতিটি ADR একটি AD নিয়ে হওয়া উচিত, একাধিক AD নিয়ে নয়।
টাইমস্ট্যাম্প: ADR-এর প্রতিটি অংশ কখন লেখা হয়েছে তা চিহ্নিত করুন। খরচ, সময়সূচি, সম্প্রসারণ ইত্যাদির মতো যেসব দিক সময়ের সঙ্গে বদলাতে পারে, সেগুলোর জন্য এটি বিশেষভাবে গুরুত্বপূর্ণ।
অপরিবর্তনীয়: ADR-এর বিদ্যমান তথ্য বদলাবেন না। বরং নতুন তথ্য যোগ করে ADR সংশোধন করুন, অথবা নতুন ADR তৈরি করে সেটিকে প্রতিস্থাপন করুন।
ADR-এর একটি ভালো “প্রেক্ষাপট” অংশের বৈশিষ্ট্য:
আপনার সংগঠনের পরিস্থিতি ও ব্যবসায়িক অগ্রাধিকার ব্যাখ্যা করুন।
আপনার দলগুলোর সামাজিক ও দক্ষতাগত গঠনের ভিত্তিতে যুক্তি ও বিবেচনা অন্তর্ভুক্ত করুন।
প্রাসঙ্গিক সুবিধা-অসুবিধা অন্তর্ভুক্ত করুন এবং সেগুলো আপনার প্রয়োজন ও লক্ষ্যের সঙ্গে সামঞ্জস্যপূর্ণ ভাষায় বর্ণনা করুন।
ADR-এর একটি ভালো “পরিণতি” অংশের বৈশিষ্ট্য:
সিদ্ধান্ত নেওয়ার ফলে কী ঘটে তা ব্যাখ্যা করুন। এর মধ্যে থাকতে পারে প্রভাব, ফলাফল, আউটপুট, পরবর্তী পদক্ষেপ ও আরও অনেক কিছু।
পরবর্তী যেকোনো ADR সম্পর্কে তথ্য অন্তর্ভুক্ত করুন। একটি ADR আরও ADR-এর প্রয়োজন তৈরি করা তুলনামূলকভাবে প্রচলিত, যেমন যখন একটি ADR বড় ও সামগ্রিক পছন্দ নেয়, যা পরে আরও ছোট সিদ্ধান্তের প্রয়োজন তৈরি করে।
কাজ-পরবর্তী যেকোনো পর্যালোচনা প্রক্রিয়া অন্তর্ভুক্ত করুন। দলগুলো সাধারণত এক মাস পর প্রতিটি ADR পর্যালোচনা করে, যাতে ADR-এর তথ্য বাস্তব অনুশীলনে যা ঘটেছে তার সঙ্গে তুলনা করে শেখা ও এগিয়ে যাওয়া যায়।
নতুন ADR আগের ADR-এর স্থান নিতে পারে:
- যখন এমন একটি AD নেওয়া হয় যা আগের ADR-কে প্রতিস্থাপন বা অকার্যকর করে, তখন একটি নতুন ADR তৈরি করা উচিত
ADR উদাহরণ টেমপ্লেট
আমরা ইন্টারনেট থেকে যে ADR উদাহরণ টেমপ্লেটগুলো সংগ্রহ করেছি:
Michael Nygard-এর ADR টেমপ্লেট (সহজ ও জনপ্রিয়)
Jeff Tyree ও Art Akerman-এর ADR টেমপ্লেট (আরও পরিশীলিত)
Alexandrian প্যাটার্নের জন্য ADR টেমপ্লেট (প্রেক্ষাপটের বিশদসহ সহজ)
ব্যবসায়িক ক্ষেত্রের জন্য ADR টেমপ্লেট (এমবিএ-ঘেঁষা, খরচ, SWOT ও আরও মতামতসহ)
Markdown Any Decision Records (MADR) প্রকল্পের ADR টেমপ্লেট (সহজ ও বিস্তারিত দুটি সংস্করণ; শেষোক্তটি বিকল্প এবং তাদের সুবিধা-অসুবিধার ওপর জোর দেয়)
Planguage ব্যবহারকারী ADR টেমপ্লেট (মান নিশ্চিতকরণ-ঘেঁষা)
Ignacio Larrañaga-এর গুরুত্বপূর্ণ প্রযুক্তিগত সিদ্ধান্ত (ITD)-এর টেমপ্লেট (সংক্ষিপ্ত ও সিদ্ধান্ত-প্রথম, দ্রুত নির্বাহী পর্যালোচনার জন্য অপ্টিমাইজ করা)
ADR-এর জন্য দলগত কাজের পরামর্শ
আপনি যদি আপনার দলে সিদ্ধান্ত রেকর্ড ব্যবহারের কথা ভাবছেন, তাহলে অনেক দলের সঙ্গে কাজ করে আমরা যে পরামর্শ পেয়েছি তা এখানে দেওয়া হলো।
“কী” চাপিয়ে দেওয়ার বদলে “কেন” নিয়ে একসঙ্গে কথা বলার মাধ্যমে আপনি সহকর্মীদের নেতৃত্ব দেওয়ার সুযোগ পান। উদাহরণস্বরূপ, সিদ্ধান্ত রেকর্ড হলো দলগুলোর আরও বুদ্ধিমত্তার সঙ্গে ভাবা এবং আরও ভালোভাবে যোগাযোগ করার একটি উপায়; সিদ্ধান্ত রেকর্ড যদি কেবল ঘটনার পরে বাধ্যতামূলক কাগজপত্রের প্রয়োজনীয়তা হয়, তাহলে তা মূল্যবান নয়।
কিছু দল “ADR” সংক্ষিপ্ত রূপের চেয়ে “সিদ্ধান্ত” (decisions) নামটি অনেক বেশি পছন্দ করে। কিছু দল যখন ডিরেক্টরির নাম “decisions” ব্যবহার করে, তখন যেন একটি বাতি জ্বলে ওঠে, এবং দল ডিরেক্টরিতে আরও তথ্য রাখতে শুরু করে, যেমন বিক্রেতা-সংক্রান্ত সিদ্ধান্ত, পরিকল্পনা-সংক্রান্ত সিদ্ধান্ত, সময়সূচি-সংক্রান্ত সিদ্ধান্ত ইত্যাদি। এই সব ধরনের তথ্যে একই টেমপ্লেট ব্যবহার করা যায়। আমরা অনুমান করি যে সংক্ষিপ্ত রূপের (“ADR”) চেয়ে শব্দে (“decisions”) মানুষ দ্রুত শেখে, “রেকর্ড” শব্দটি সরিয়ে দিলে মানুষ চলমান কাজের নথি লিখতে বেশি অনুপ্রাণিত হয়, এবং কিছু ডেভেলপার ও কিছু ম্যানেজার “আর্কিটেকচার” শব্দটি অপছন্দ করেন।
তত্ত্বগতভাবে অপরিবর্তনীয়তা আদর্শ। বাস্তবে পরিবর্তনযোগ্যতা আমাদের দলগুলোর জন্য ভালো কাজ করেছে। আমরা বিদ্যমান ADR-এ নতুন তথ্য যোগ করি, তারিখের ছাপ এবং এই নোটসহ যে তথ্যটি সিদ্ধান্তের পরে এসেছে। এই ধরনের পদ্ধতি একটি “জীবন্ত নথি” তৈরি করে, যা আমরা সবাই হালনাগাদ করতে পারি। সাধারণ হালনাগাদ ঘটে যখন আমরা নতুন সহকর্মী, নতুন পণ্য, আমাদের ব্যবহারের বাস্তব ফলাফল, অথবা বিক্রেতার সক্ষমতা, মূল্য পরিকল্পনা, লাইসেন্স চুক্তি ইত্যাদির মতো সিদ্ধান্তের পরে ঘটা তৃতীয় পক্ষের পরিবর্তনের কারণে তথ্য পাই।
ADR-এর জন্য দলগত কাজের প্রশ্ন
কে ADR তৈরি করতে পারেন?
নির্দিষ্ট ব্যক্তি, নির্দিষ্ট ভূমিকা, নির্দিষ্ট দল বা নির্দিষ্ট বিভাগের মতো ক্ষেত্র বিবেচনা করুন; এছাড়া এমন ব্যক্তি, ভূমিকা, দল বা বিভাগ আছে কি না যারা ADR কমিশন করতে পারে, অর্থাৎ এমন একটি ADR চাইতে পারে যা অন্য কেউ লিখবেন, তাও বিবেচনা করুন।
উদাহরণ উত্তর: আমাদের সংগঠনের যেকোনো ব্যক্তি যিনি আর্কিটেকচার সিদ্ধান্ত রেকর্ডের README পৃষ্ঠা পড়েছেন, তিনি একটি ADR প্রস্তাব করতে পারেন, অর্থাৎ তিনি সেটি লেখা শুরু করতে এবং দলের সঙ্গে শেয়ার করতে পারেন।
কোন কারণে ADR তোলা যুক্তিযুক্ত?
আপনার সংগঠনের দলীয় কাজের ধরন, আপনার সফটওয়্যার সিস্টেমের কাঠামো, আন্তঃদল সমন্বয়, দীর্ঘমেয়াদি রক্ষণাবেক্ষণযোগ্যতা, বাহ্যিক ইন্টারফেস, আপনি কাদের উপকৃত করতে চান ইত্যাদি ক্ষেত্র বিবেচনা করুন।
উদাহরণ উত্তর: আমরা যখন চাই ভবিষ্যতের ডেভেলপাররা আমরা যা করছি তার “কেন” বুঝুক, তখন আমরা একটি ADR তৈরি করতে চাই।
কোন কারণে ADR না তোলা যুক্তিযুক্ত?
এমন ক্ষেত্র বিবেচনা করুন যেমন আর্কিটেকচার সম্পর্কিত নয় এমন সিদ্ধান্ত, অথবা ক্ষুদ্র সিদ্ধান্ত, যেমন ন্যূনতম ঝুঁকির বা স্বয়ংসম্পূর্ণ বা একক-ডেভেলপারের সিদ্ধান্ত, অথবা অন্যত্র ইতিমধ্যে সম্পূর্ণ আলোচিত সিদ্ধান্ত, যেমন মান বা নীতি বা নথিতে, অথবা অস্থায়ী সিদ্ধান্ত, যেমন সাময়িক সমাধান বা প্রুফ অব কনসেপ্ট বা পরীক্ষা-নিরীক্ষা।
উদাহরণ উত্তর: কোনো সিদ্ধান্তের পরিধি, সময়, ঝুঁকি ও খরচ সীমিত হলে অথবা তা অন্যত্র ইতিমধ্যে আলোচিত হলে আমরা ADR এড়িয়ে যেতে চাই।
ADR-এর জীবনচক্র কী?
তৈরির প্রক্রিয়া, গবেষণা প্রক্রিয়া, সিদ্ধান্ত গ্রহণ প্রক্রিয়া, বাস্তবায়ন প্রক্রিয়া এবং অবসান প্রক্রিয়ার মতো ক্ষেত্র বিবেচনা করুন। সময়ের সঙ্গে ADR-এর জীবনচক্র কীভাবে ট্র্যাক করবেন তা বিবেচনা করুন, যেমন ADR-কে এক অবস্থা থেকে পরবর্তী অবস্থায় কীভাবে নেবেন এবং অংশীজনদের কাছে তা কীভাবে জানাবেন।
উদাহরণ উত্তর: আমরা চাই একটি ADR-এর পাঁচটি জীবনচক্র ধাপ থাকুক: সূচনা → গবেষণা → মূল্যায়ন → বাস্তবায়ন → রক্ষণাবেক্ষণ → অবসান।
ADR-এর জীবনচক্র ধাপের মানদণ্ড কী?
ADR-এর গ্রহণযোগ্যতার মানদণ্ডের মতো ক্ষেত্র বিবেচনা করুন, অর্থাৎ আপনি কীভাবে জানবেন যে এটি এক জীবনচক্র ধাপ থেকে পরবর্তী ধাপে যাওয়ার জন্য যথেষ্ট ভালো? সমস্যাটি কি স্পষ্টভাবে ব্যক্ত হয়েছে? বিকল্পগুলো কি বিবেচনা করা হয়েছে? ট্রেড-অফ কি যথেষ্ট ভালোভাবে বোঝা ও নথিভুক্ত হয়েছে? সব প্রাসঙ্গিক প্রেক্ষাপট কি যথাস্থানে আছে? সব প্রাসঙ্গিক অংশীজন কি যুক্ত? সব প্রতিক্রিয়া কি অন্তর্ভুক্ত হয়েছে?
উদাহরণ উত্তর: আমরা চাই সক্রিয় দল ১) গবেষণা সম্পন্ন করলে, ২) মূল্যায়ন সম্পন্ন করলে, ৩) মন্তব্যের অনুরোধ ও এক সপ্তাহের সময়সীমাসহ অংশীজনদের কাছে ADR প্রস্তাব প্রকাশ করলে, এবং ৪) অংশীজনদের সব মন্তব্য অন্তর্ভুক্ত ও সমাধান করা হলে অংশীজনরা ADR-এ ভোট দিক।
কোন ভূমিকা ও দায়িত্ব ADR-এর সঙ্গে মিথস্ক্রিয়া করে?
প্রস্তাবক, গবেষক, মূল্যায়নকারী, পর্যালোচক, অনুমোদনকারী, রক্ষণাবেক্ষণকারী ইত্যাদি ভূমিকা বিবেচনা করুন। অংশীজনদের সঙ্গে যোগাযোগ, প্রত্যাশা পূরণ নিশ্চিত করা, ওয়েবসাইটে বা ইন্ট্রানেটে শেয়ার করা এবং নিয়মিত ও বিশেষত প্রাসঙ্গিক পরিবর্তন ঘটলে কাজ পর্যালোচনা করার মতো দায়িত্ব বিবেচনা করুন।
উদাহরণ উত্তর: আমরা চাই প্রতিটি ADR-এর সব সময় একজন প্রাথমিক যোগাযোগকারী, একজন গৌণ যোগাযোগকারী এবং একটি দায়বদ্ধ দল থাকুক; তারা যোগাযোগ, প্রকাশনা, রক্ষণাবেক্ষণ, বছরে অন্তত একবার নিয়মিত পর্যালোচনা এবং প্রয়োজনে চূড়ান্ত অবসানের জন্য দায়ী।
শাসনব্যবস্থা কীভাবে ADR-এর সঙ্গে মিথস্ক্রিয়া করে?
আপনার সংগঠনের কাজের ধরন, আইনি বা মানবসম্পদ দিকের মতো বিশেষ সম্মতির প্রয়োজন, এবং ঐকমত্য বনাম দ্বন্দ্ব বনাম উচ্চতর স্তরে পাঠানো আপনি কীভাবে সামলাতে চান, এমন ক্ষেত্র বিবেচনা করুন। ADR-এর ব্যাপারে অন্যদের চেয়ে বেশি প্রভাব রাখতে পারে এমন ক্ষেত্র, ব্যক্তি বা দল আছে কি, যেমন সেটি অনুমোদন করা, তাতে ভোট দেওয়া বা ভেটো দেওয়ার ক্ষমতা?
উদাহরণ উত্তর: ADR-এর শাসনব্যবস্থা এই অগ্রাধিকারক্রমে: CEO, CTO, CLO, যে দল ADR বাস্তবায়ন করে, দলের যেসব বিশেষজ্ঞ ADD সম্পর্কে সবচেয়ে বেশি জানেন। ADR-এ বর্ণিত না থাকলে আর কারও শাসন-ক্ষমতা নেই।
কোন নীতি ADR-এর সঙ্গে মিথস্ক্রিয়া করে?
আপনার সংগঠনের কাজের ধরনের মতো ক্ষেত্র বিবেচনা করুন, যার মধ্যে রয়েছে দ্রুত এগোনো বনাম ধীরে এগোনো, সিদ্ধান্ত-ঐকমত্য বনাম সিদ্ধান্ত-দ্বন্দ্ব, ঝুঁকির পছন্দ বনাম নিরাপত্তার পছন্দ, প্রকাশ্য আলোচনা বনাম ব্যক্তিগত আলোচনা ইত্যাদি।
উদাহরণ উত্তর: আমরা নেতৃত্বের এই নীতিগুলো ব্যবহার করি: কাজের প্রতি ঝোঁক, দ্বিমত-করো-এবং-প্রতিশ্রুতি-দাও, সহজে-ফেরানো-যায় ও সহজে-বিচ্ছিন্ন-করা-যায় এমন সিদ্ধান্তের জন্য ৭০% অনুমান যথেষ্ট ভালো, এবং আমাদের সংগঠনের গোপনীয়তা চুক্তিতে বর্ণিত গোপনীয় তথ্য ছাড়া প্রকাশ্য কাজের ধরন।
ADR-এর পরবর্তী ধাপের ধারণা
Arc42 দুটি প্রশ্নের ব্যবহারিক উত্তর দেয় এবং আপনার নির্দিষ্ট প্রয়োজন অনুযায়ী সাজানো যায়। আপনার আর্কিটেকচার সম্পর্কে কী নথিভুক্ত/জানানো উচিত? কীভাবে নথিভুক্ত/জানানো উচিত? Arc42-এ আর্কিটেকচার সিদ্ধান্ত রেকর্ডের পাশাপাশি লক্ষ্য, সীমাবদ্ধতা, প্রেক্ষাপট, মান, ঝুঁকি ইত্যাদি বিষয়ে নির্দেশনা আছে।
C4 মডেল সফটওয়্যার আর্কিটেকচারের ডায়াগ্রাম আঁকার একটি সহজে শেখা যায় এমন, ডেভেলপার-বান্ধব পদ্ধতি। C4 হলো প্রেক্ষাপট, কনটেইনার, কম্পোনেন্ট ও কোডের স্তরবিন্যস্ত ডায়াগ্রামের একটি সেট, সঙ্গে সিস্টেম ল্যান্ডস্কেপ, ডায়নামিক ও ডিপ্লয়মেন্টের সহায়ক ডায়াগ্রাম।
আর্কিটেকচার ডায়াগ্রাম, ভিউ ও ভিউপয়েন্ট
একটি আর্কিটেকচার ডায়াগ্রামকে "আর্কিটেকচার ভিউ" বলা হয়।
একটি "আর্কিটেকচার ভিউ" হলো একটি "আর্কিটেকচার ভিউপয়েন্টের" দৃষ্টান্ত।
একটি "আর্কিটেকচার ভিউপয়েন্টে" নির্দিষ্ট উদ্বেগসম্পন্ন একটি নির্দিষ্ট শ্রোতাগোষ্ঠী মাথায় রাখা হয়।
আর্কিটেকচার ভিউপয়েন্টের উদাহরণ, ভিউয়ের উদাহরণ ও ডায়াগ্রামের উদাহরণ:
ব্যবসায়িক সক্ষমতা
উচ্চ-স্তরের ব্যবসায়িক প্রক্রিয়া
অ্যাপ্লিকেশন কম্পোনেন্টে ম্যাপ করা সফটওয়্যার ফাংশন
C4 Model কনটেক্সট ডায়াগ্রাম (TO-BE / AS-IS)
C4 Model কনটেইনার ডায়াগ্রাম (TO-BE / AS-IS)
এনটিটি-রিলেশনশিপ ডায়াগ্রাম (ERD) ডেটা এনটিটিকে অ্যাপ্লিকেশন কম্পোনেন্টে ম্যাপ করতে
সিকোয়েন্স ডায়াগ্রাম সিস্টেমের ভেতরের ও ইন্টিগ্রেশনের কার্যকরী প্রবাহ বর্ণনা করতে
বিজনেস প্রসেস মডেল অ্যান্ড নোটেশন (BPMN) অ্যাপ্লিকেশন কম্পোনেন্টজুড়ে ডেটা প্রবাহ বর্ণনার ডায়াগ্রাম
বিজনেস প্রসেস মডেল অ্যান্ড নোটেশন (BPMN) ব্যবসায়িক প্রক্রিয়া / ব্যবহারকারীর পরিস্থিতি বর্ণনার ডায়াগ্রাম
আইডেন্টিটি অ্যান্ড অ্যাক্সেস ম্যানেজমেন্ট (IAM) ডায়াগ্রাম
রোল-বেসড অ্যাক্সেস কন্ট্রোল (RBAC) প্রতিটি অ্যাপ্লিকেশন কম্পোনেন্টের ভূমিকাসহ ডায়াগ্রাম
অ্যাট্রিবিউট-বেসড অ্যাক্সেস কন্ট্রোল (ABAC) প্রতিটি অ্যাপ্লিকেশন কম্পোনেন্টের অ্যাট্রিবিউটসহ ডায়াগ্রাম
গোপনীয়তা ডায়াগ্রাম
সম্পর্কিত ডায়াগ্রাম:
ইউজ কেস ডায়াগ্রাম ব্যবস্থাপনা/গ্রাহকদের কাছে ব্যবহারের পরিস্থিতি দেখায়, যা প্রয়োজনীয়তার আগে আসে, আর প্রয়োজনীয়তা আসে সফটওয়্যার আর্কিটেকচারের আগে।
ডিপ্লয়মেন্ট ডায়াগ্রাম সেই ভৌত হার্ডওয়্যার/কম্পিউটার দেখায়, যেখানে সফটওয়্যার কম্পোনেন্ট মোতায়েন করা হয়।
ডেটা ফ্লো ডায়াগ্রাম দেখায় সিস্টেমের মধ্য দিয়ে ডেটা কীভাবে চলে ও রূপান্তরিত হয়।
সিকোয়েন্স ডায়াগ্রাম সময়ের অক্ষে HTTP-র মতো প্রোটোকল কীভাবে কাজ করে তা দেখাতে ব্যবহৃত হয়।
অ্যাক্টিভিটি ডায়াগ্রাম একটি সফটওয়্যার সিস্টেমের কার্যকলাপের কর্মপ্রবাহ চিত্রিত করে, যেমন একটি NPC এআই।
কোড হিসেবে সিদ্ধান্তের ফিটনেস ফাংশন
ফিটনেস ফাংশন হলো প্রোগ্রামিং কোড দিয়ে লেখা বস্তুনিষ্ঠ স্বয়ংক্রিয় পরীক্ষা, যা যাচাই করে যে সিদ্ধান্তগুলো বজায় রাখা হচ্ছে।
ফিটনেস ফাংশন সিদ্ধান্তকে পরীক্ষণযোগ্য ও নিশ্চিতযোগ্য করে তোলে।
সিদ্ধান্তের জন্য ফিটনেস ফাংশন মান নিশ্চিতকরণ, নিয়ন্ত্রক প্রক্রিয়া এবং শাসনব্যবস্থার লক্ষ্যে প্রচুর সাহায্য করতে পারে।
ফিটনেস ফাংশন কীভাবে সিদ্ধান্তের সঙ্গে সম্পর্কিত
সিদ্ধান্ত রেকর্ড সিদ্ধান্তটি নথিভুক্ত করে, আর ফিটনেস ফাংশন সিদ্ধান্তটি নিশ্চিত করে।
সিদ্ধান্তের উদাহরণ: নিরীক্ষার প্রয়োজনীয়তার জন্য আমরা ইভেন্ট সোর্সিং ব্যবহার করি।
ফিটনেস ফাংশনের উদাহরণ: আমরা ধারাবাহিক সমন্বয় সার্ভার ব্যবহার করে পরীক্ষা করি যে প্রতিটি অবস্থা পরিবর্তনকে অবশ্যই ইভেন্ট তৈরি করতে হবে।
কেন ফিটনেস ফাংশন সিদ্ধান্তে সাহায্য করে
বস্তুনিষ্ঠ পরিমাপ: ফিটনেস ফাংশন পাস বা ফেইল করে, তাই কাজ দৃশ্যমান ও স্পষ্ট থাকে।
নিরন্তর ব্যবহার: ফিটনেস ফাংশন আপনার জীবন্ত নিয়ম, যা প্রতিটি কমিট ও বিল্ডে চলে।
রিফ্যাক্টর করার আত্মবিশ্বাস: ফিটনেস ফাংশন সিদ্ধান্তের নিয়মের ত্রুটি স্বয়ংক্রিয়ভাবে ধরে ফেলে।
সম্প্রসারণযোগ্য শাসনব্যবস্থা: ফিটনেস ফাংশন বাধা তৈরি না করেই মান নিশ্চিত করে।
ফিটনেস ফাংশন কি AI ব্যবহার করতে পারে?
ফিটনেস ফাংশন আপনার কাজ, যেমন পরিকল্পনা, কোড, স্কিমা, API ও আরও অনেক কিছু সম্পর্কে প্রশ্ন করে সিদ্ধান্তের জন্য AI LLM ব্যবহার করতে পারে:
IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning.
IMPORTANT: Turn on extended thinking. Turn on expert advice. Turn on search.
This is a fitness function to evaluate if our work is
using all our decisions, and is correct and accurate.
- Our decisions are here: {url}
- Our work to evaluate is here: {url}
Explain any errors, problems, gaps, weaknesses. Be direct. Be decisive.
আর্কিটেকচার ইউনিট টেস্টিং
ArchUnit: যেকোনো সাধারণ Java ইউনিট টেস্ট ফ্রেমওয়ার্ক ব্যবহার করে Java কোডের আর্কিটেকচার নিয়ম পরীক্ষা করুন।
ArchUnitTS: Jest, Vitest, Jasmine ইত্যাদি ব্যবহার করে TypeScript কোড ও JavaScript কোডের আর্কিটেকচার নিয়ম পরীক্ষা করুন।
পুল রিকোয়েস্টের জন্য সিদ্ধান্তের গার্ডরেল
Decision Guardian সঠিক সময়ে সঠিক সিদ্ধান্ত রেকর্ড স্বয়ংক্রিয়ভাবে সামনে আনে, অর্থাৎ যখন একজন ডেভেলপার সেই সিদ্ধান্তগুলোর আওতাভুক্ত কোড সক্রিয়ভাবে পরিবর্তন করছেন। মার্জ করার আগে ডেভেলপাররা ডকুমেন্ট ফোল্ডার পড়বেন এই আশায় না থেকে, প্রাসঙ্গিক তথ্য সরাসরি পুল রিকোয়েস্টে দেখা যায়।
এটি যেকোনো ধরনের সিদ্ধান্ত রেকর্ডের জন্য কাজ করে: আর্কিটেকচার সিদ্ধান্ত, ডেটা সিদ্ধান্ত, কমপ্লায়েন্স সিদ্ধান্ত, ক্লিনিক্যাল ও চিকিৎসা সিদ্ধান্ত, নিরাপত্তা সিদ্ধান্ত এবং আরও অনেক।
যেকোনো CI সিস্টেমের (GitLab, Jenkins, CircleCI) সঙ্গে এবং pre-commit হুক হিসেবে কাজ করে। ওপেন সোর্স। MIT লাইসেন্স।
ADR Guard একটি GitHub
অ্যাকশন, যা কোনো আর্কিটেকচার সিদ্ধান্ত রেকর্ড যোগ বা হালনাগাদ না করে পর্যবেক্ষণাধীন কোড পথ বদলালে পুল রিকোয়েস্ট ব্যর্থ করে। ছাড় স্পষ্ট: কারণসহ একটি
ADR-Exempt: লাইন গেট পার করে এবং জবের সারসংক্ষেপে লেখা হয়। টেমপ্লেট-নিরপেক্ষ, কোনো নির্ভরতা নেই। ওপেন সোর্স। MIT লাইসেন্স।
আরও তথ্যের জন্য
ভূমিকা:
টেমপ্লেট:
Documenting architecture decisions - Michael Nygard (thinkrelevance.com)
Template for documenting architecture alternatives and decisions (stackoverflow.com)
গভীরে:
The Decision View's Role in Software Architecture Practice (computer.org)
Documenting Software Architectures: Views and Beyond (resources.sei.cmu.edu)
Architecture Decisions: Demystifying Architecture (utdallas.edu)
ThoughtWorks Technology Radar: Lightweight Architecture Decision Records (thoughtworks.com)
A Skeptic’s Guide to Software Architecture Decisions (infoq.com)
Architectural Retrospectives: the Key to Getting Better at Architecting
Software Architecture Monday with Mark Richards - বিনামূল্যে মাসিক সফটওয়্যার আর্কিটেকচার পাঠ
"Keep the Why: Code Becomes Legacy When Nobody Remembers Why"
টুল:
Command-line tools for working with Architecture Decision Records
kgai - append-only decision log for AI coding agents, a machine-readable companion to ADR files
কোম্পানি-নির্দিষ্ট নির্দেশনা:
উদাহরণ:
ভিডিও:
পডকাস্ট:
বই:
Software Architecture in Practice (SEI Series in Software Engineering)
Documenting Software Architectures: Views and Beyond (SEI Series in Software Engineering)
The Software Architect Elevator: Redefining the Architect's Role in the Digital Enterprise
Fundamentals of Software Architecture: An Engineering Approach - by Mark Richards and Neal Ford
Building Evolutionary Architectures - by Neal Ford, Rebecca Parsons, Patrick Kua, Pramod Sadalage
Foundations of Decision Analysis by Ronald Howard and Ali Abbas
Head First Software Architecture - by Raju Gandhi, Neal Ford and Mark Richards
Communication Patterns: A Guide for Developers and Architects - by Jacqui Read
আরও দেখুন:
REMAP (Representation and Maintenance of Process Knowledge)
DRL (Decision Representation Language)
IBIS (Issue-Based Information System)
QOC (Questions, Options, and Criteria)
IBM’s e-Business Reference Architecture Framework
Decision Reasoning Format (DRF) - সুস্পষ্ট যুক্তি, অনুমান, জ্ঞানীয় অবস্থা ও ট্রেড-অফসহ সিদ্ধান্ত উপস্থাপনের জন্য একটি বিক্রেতা-নিরপেক্ষ, মেশিন-পাঠযোগ্য YAML/JSON ফরম্যাট। সিদ্ধান্ত নথিতে কাঠামোবদ্ধ, যাচাইযোগ্য যুক্তি যোগ করে ADR-কে সম্পূরক করে।