অধ্যায় 5 · মান, রিলিজ ও সামনের পথ
সফটওয়্যার রিলিজ ও রক্ষণাবেক্ষণ
- পৃষ্ঠা 16 / 18
- 18 মিনিট পড়া
টেস্ট পাস করেছে আর নাদিয়া ClinicQueue গ্রহণ করেছেন। এখন এটাকে আসল রোগীদের কাছে পৌঁছাতে হবে, আর ঠিক এই মুহূর্তে যত্নশীল টিমগুলো গতি কমায়। একটা রিলিজ (release) হলো এই প্রতিশ্রুতি যে ঠিক এই ভার্সনটা কাজ করে, আর না করলে কী করা হবে তার একটা পরিকল্পনা। রিলিজের পর সফটওয়্যার তার সবচেয়ে লম্বা পর্বে ঢোকে: বছরের পর বছর ঠিক করা, মানিয়ে নেওয়া আর উন্নত করা, এমন মানুষদের হাতে যাঁদের হয়তো মনেই থাকবে না কোডটা কেন এমন দেখতে।
আগের পাতা সফটওয়্যারের মান, টেস্টিং ও QA-তে দেখেছেন, টিম কীভাবে জানে যে একটা বিল্ড ভালো। এই পাতা সেই বিল্ডকে দরজার বাইরে অনুসরণ করে: সিমান্টিক ভার্সনিং দিয়ে কীভাবে ভার্সন নম্বর দেবেন (একটা ছোট Python ফাংশনসহ), রিলিজ নোট আর রোলব্যাক পরিকল্পনায় কী থাকে, সফটওয়্যার কেন কয়েকটা এনভায়রনমেন্টের মধ্য দিয়ে যায়, রক্ষণাবেক্ষণের (maintenance) চার ধরন, টেকনিক্যাল ডেট, আর যে ডকুমেন্টগুলো রক্ষণাবেক্ষণ সম্ভব করে। ClinicQueue-এর ভার্সন, তারিখ আর সমস্যাগুলো কাল্পনিক।
যা শিখবেন
- সিমান্টিক ভার্সনিং (SemVer 2.0.0) কীভাবে রিলিজের নম্বর দেয়, আর কয়েক লাইন Python দিয়ে কীভাবে পরের ভার্সন হিসাব করবেন।
- ভালো রিলিজ নোট আর রোলব্যাক পরিকল্পনায় কী থাকে।
- টিমগুলো কেন আলাদা ডেভেলপমেন্ট, টেস্টিং (স্টেজিং) আর প্রোডাকশন এনভায়রনমেন্ট ব্যবহার করে।
- রক্ষণাবেক্ষণের চার ধরন (কারেক্টিভ, অ্যাডাপ্টিভ, পারফেক্টিভ, প্রিভেন্টিভ), ClinicQueue-এর উদাহরণসহ।
- টেকনিক্যাল ডেট কী, কীভাবে জমে আর টিমগুলো কীভাবে তা শোধ করে, আর কোন ডকুমেন্ট (README, চেঞ্জ লগ) পরের রক্ষণাবেক্ষণকারীকে সাহায্য করে।
একটা ভার্সন রিলিজ করা
রিলিজ হলো সফটওয়্যারের একটা নির্দিষ্ট, শনাক্তযোগ্য ভার্সন, যা ইউজারদের হাতে দেওয়া হয়। "শনাক্তযোগ্য" শব্দটাই আসল: রিনা কোনো সমস্যা জানালে টিমকে ঠিক জানতে হবে তিনি কোন কোড চালাচ্ছেন। তাই প্রতিটা রিলিজ একটা ভার্সন নম্বর পায়, আর যে কমিট থেকে সেটা বানানো হয়েছে তা ভার্সন কন্ট্রোলে চিহ্নিত করা হয় (সাধারণ উপায় হলো Git ট্যাগ; Git নিজে শেখানো হয়েছে AI-এর জন্য Git, API ও ব্যাকএন্ড: বিগিনার-এ)।
সিমান্টিক ভার্সনিং
অনেক প্রজেক্ট Semantic Versioning 2.0.0 (semver.org) মেনে চলে; এটা MAJOR.MINOR.PATCH আকারের ভার্সন নম্বরের একটা প্রকাশিত রীতি (convention)। এটা এমন একটা স্পেসিফিকেশন যা প্রজেক্টগুলো নিজেরা মানতে বেছে নেয়, কোনো আইন বা ISO স্ট্যান্ডার্ড নয়। এর তিনটা নিয়ম, তার নিজের ভাষায়, বলে বাড়াতে হবে:
- "MAJOR version when you make incompatible API changes": API-তে অসামঞ্জস্যপূর্ণ (আগের সাথে না মেলা) পরিবর্তন করলে MAJOR,
- "MINOR version when you add functionality in a backward compatible manner": আগের সাথে সামঞ্জস্য রেখে নতুন কার্যকারিতা যোগ করলে MINOR,
- "PATCH version when you make backward compatible bug fixes": আগের সাথে সামঞ্জস্য রেখে বাগ ঠিক করলে PATCH।
ওপরের সংখ্যা বাড়লে নিচের সংখ্যাগুলো শূন্য হয়ে যায়: "Patch version MUST be reset to 0 when minor version is incremented", আর "Patch and minor versions MUST be reset to 0 when major version is incremented"। তাই 1.4.7-এর পরে আসে 1.4.8 (একটা ফিক্স), 1.5.0 (একটা ফিচার) বা 2.0.0 (একটা ভাঙনধরানো পরিবর্তন), কখনো 1.5.7 বা 2.4.7 নয়।
শুরুর দিকে আরও তিনটা নিয়ম গুরুত্বপূর্ণ। "Major version zero (0.y.z) is for initial development. Anything MAY change at any time." অর্থাৎ 0.y.z শুরুর ডেভেলপমেন্টের জন্য, যখন যা খুশি বদলাতে পারে। "Version 1.0.0 defines the public API", মানে তখন থেকে সংখ্যাগুলো প্রতিশ্রুতি দেয়। আর বাড়তি লেবেলও চলে: একটা প্রি-রিলিজ হাইফেন আর ডট দিয়ে আলাদা করা শনাক্তকারী যোগ করে (1.0.0-alpha.1), আর বিল্ড মেটাডেটা একটা প্লাস চিহ্ন যোগ করে (1.0.0+20130313144700)।
ClinicQueue-এর "public API" কী? SemVer লেখা হয়েছে এমন সফটওয়্যারের জন্য যার ওপর অন্য প্রোগ্রাম নির্ভর করে। ClinicQueue-এর ক্ষেত্রে সেটা হলো বুকিং API, যাকে ক্লিনিকের ওয়েবসাইটের উইজেট কল করে। কোনো পরিবর্তনের কারণে উইজেটকেও বদলাতে হলে সেটা অসামঞ্জস্যপূর্ণ, আর মেজর সংখ্যা বাড়ে। যে পরিবর্তন রোগীরা শুধু স্ক্রিনে দেখেন, সেটা সাধারণত মাইনর বা প্যাচ রিলিজ।
Python-এ একটা ভার্সন বাম্প
নিয়মগুলো যান্ত্রিক, তাই ছোট একটা ফাংশন এগুলো প্রয়োগ করতে পারে। লেনা টেস্ট বিল্ড 0.9.3-এর পর থেকে প্রতিটা রিলিজের ধরনের একটা তালিকা রাখেন:
def bump(version, part):
"""Next Semantic Versioning 2.0.0 version for a 'major', 'minor' or 'patch' change."""
pieces = version.split(".")
if len(pieces) != 3 or not all(p.isdigit() for p in pieces):
raise ValueError(f"not a plain MAJOR.MINOR.PATCH version: {version}")
major, minor, patch = (int(p) for p in pieces)
if part == "major":
return f"{major + 1}.0.0" # minor and patch reset to 0
if part == "minor":
return f"{major}.{minor + 1}.0" # patch resets to 0
if part == "patch":
return f"{major}.{minor}.{patch + 1}"
raise ValueError(f"unknown part: {part}")
# ClinicQueue releases after the test phase (invented)
releases = [
("major", "first stable release for real patients; booking API frozen"),
("patch", "fix: holiday dates were shown as open slots"),
("minor", "add: reminders in Bangla"),
("patch", "fix: some patients got the SMS twice"),
("minor", "add: AI-drafted reminder text, off by default"),
("major", "change: every booking API call now needs a clinic id"),
]
version = "0.9.3"
for part, note in releases:
new = bump(version, part)
print(f"{version:>6} -> {new:<6} {part:<6} {note}")
version = new 0.9.3 -> 1.0.0 major first stable release for real patients; booking API frozen
1.0.0 -> 1.0.1 patch fix: holiday dates were shown as open slots
1.0.1 -> 1.1.0 minor add: reminders in Bangla
1.1.0 -> 1.1.1 patch fix: some patients got the SMS twice
1.1.1 -> 1.2.0 minor add: AI-drafted reminder text, off by default
1.2.0 -> 2.0.0 major change: every booking API call now needs a clinic id0.9.3 থেকে 1.0.0-তে লাফটা সেই মুহূর্ত, যখন বুকিং API একটা প্রতিশ্রুতি হয়ে গেল। বাংলা রিমাইন্ডার আর AI খসড়া কিছু না ভেঙে ফিচার যোগ করে, তাই এগুলো মাইনর রিলিজ। শেষ পরিবর্তনটা ক্লিনিক id না পাঠানো প্রত্যেক কলারকে ভেঙে দেয়, তাই এটাকে 2.0.0 হতেই হবে, যদিও কোডের পরিবর্তনটা নিজে ছোট ছিল। ভার্সন নম্বর বোঝায় API-র ইউজারদের ওপর প্রভাব, কাজের আকার নয়।
ফাংশনটা শুধু সাধারণ MAJOR.MINOR.PATCH ভার্সন নেয়, আর অনুমান না করে অন্য সবকিছু প্রত্যাখ্যান করে। ছোট রাখার জন্য প্রি-রিলিজ লেবেল আর "v" উপসর্গ (Git ট্যাগের নামে প্রচলিত) বাদ রাখা হয়েছে:
for text in ["1.2", "1.0.0-alpha.1", "v1.2.3"]:
try:
bump(text, "patch")
except ValueError as error:
print("refused:", error)refused: not a plain MAJOR.MINOR.PATCH version: 1.2
refused: not a plain MAJOR.MINOR.PATCH version: 1.0.0-alpha.1
refused: not a plain MAJOR.MINOR.PATCH version: v1.2.3কমিট মেসেজ দিয়ে বাম্প বেছে নেওয়া
একটা জনপ্রিয় রীতি, Conventional Commits 1.0.0, কমিট মেসেজকে SemVer-এর সাথে যুক্ত করে। মেসেজ শুরু হয় একটা টাইপ, ঐচ্ছিক একটা স্কোপ আর একটা কোলন দিয়ে: fix(sms): retry once। fix মেলে PATCH-এর সাথে আর feat MINOR-এর সাথে; কোলনের আগে একটা ! বা একটা BREAKING CHANGE: ফুটার ভাঙনধরানো পরিবর্তন বোঝায় আর MAJOR-এর সাথে মেলে। docs, test আর refactor-এর মতো অন্য টাইপও চলে। এটা কিছু টিমের বেছে নেওয়া রীতি, বাধ্যবাধকতা নয়। ধরুন টিম এখনো 1.2.0-তে আছে:
def next_version(version, commits):
"""Choose the bump from Conventional Commits messages: breaking > feat > fix."""
headers = [message.split(":")[0] for message in commits]
if any(h.endswith("!") for h in headers) or any("BREAKING CHANGE:" in m for m in commits):
return bump(version, "major")
if any(h.split("(")[0] == "feat" for h in headers):
return bump(version, "minor")
if any(h.split("(")[0] == "fix" for h in headers):
return bump(version, "patch")
return version # only docs, tests, refactoring: no new release number
print(next_version("1.2.0", ["fix(sms): retry once when the provider times out",
"docs: explain the reminder settings"]))
print(next_version("1.2.0", ["feat(queue): show an 'arrived' mark", "fix: typo on the queue screen"]))
print(next_version("1.2.0", ["feat(api)!: require a clinic id in every booking call"]))
print(next_version("1.2.0", ["test: add boundary tests for can_book"]))1.2.1
1.3.0
2.0.0
1.2.0সবচেয়ে বেশি প্রভাবের কমিটটাই জেতে: একটা ফিচার আর একটা ফিক্স মিলে একটা মাইনর রিলিজ। যে কমিট শুধু ডকুমেন্টেশন বা টেস্ট ছোঁয়, তার জন্য নতুন ভার্সনেরই দরকার নেই।
রিলিজ নোট
রিলিজ নোট ইউজার আর সাপোর্ট কর্মীদের জানায় একটা রিলিজে কী বদলেছে, তাঁদের ভাষায়, ডেভেলপারদের ভাষায় নয়। রিনার "refactored slot service" দরকার নেই; তাঁর দরকার "ছুটির দিনগুলো আর খালি স্লট হিসেবে দেখায় না"।
টেমপ্লেট:
ClinicQueue 1.1.0 - released 2026-11-30
New
- Reminders can be sent in Bangla. Choose the language in Settings > Reminders.
Fixed
- The queue screen now shows bookings made after 17:00 for the next day.
Known issues
- The queue screen does not yet show the "arrived" mark. Planned for a later release.
Action needed
- None for patients. Front desk: check the reminder language for each doctor once.
Questions: Lena (project lead)রোলব্যাক পরিকল্পনা
রোলব্যাক (rollback) মানে কোনো রিলিজে গোলমাল হলে প্রোডাকশনকে আগের কাজ-করা ভার্সনে ফিরিয়ে নেওয়া। রিলিজের আগে, যখন সবাই শান্ত, তখনই এর পরিকল্পনা করুন, লঞ্চের দিন সকাল ০৯:০৫-এ রোগীরা অপেক্ষা করার সময় নয়। কঠিন অংশটা সাধারণত ডেটা: নতুন ভার্সন ডেটাবেস বদলে থাকলে পুরোনো ভার্সন হয়তো সেটা আর বুঝবে না।
টেমপ্লেট:
Release: ClinicQueue 2.0.0 (booking API needs a clinic id)
Previous version: 1.2.0, build kept ready to redeploy
Go/no-go: Nadia and Lena, 2026-12-20 18:00, after the staging check
Roll back if: bookings fail for more than 5 minutes, or reminders stop being sent
How: redeploy 1.2.0 (about 10 minutes, Farhan); website widget keeps its old version
Data: database change only ADDS a column, so 1.2.0 still works with it
Who decides: Lena, on call 18:00-22:00; Farhan and Kwame on call with her
Tell users: front desk by phone; a notice on the booking page if it takes longer than 30 minডেটার লাইনটা খেয়াল করুন। পরিবর্তনগুলো এমনভাবে ডিজাইন করা, যাতে পুরোনো ভার্সনও নতুন ডেটার সাথে কাজ করে (একটা কলামের নাম বদলানোর বদলে নতুন কলাম যোগ করা), সেটাই রোলব্যাককে আদৌ সম্ভব করে। কিছু টিম ঝুঁকিপূর্ণ ফিচারকে একটা সেটিংয়ের পেছনে লুকিয়েও রাখে, যেমন ClinicQueue AI খসড়ার ক্ষেত্রে করেছে ("off by default"), যাতে নতুন করে ডিপ্লয় না করেই সেটা বন্ধ করা যায়।
এনভায়রনমেন্ট: ডেভেলপমেন্ট, স্টেজিং, প্রোডাকশন
একটা এনভায়রনমেন্ট (environment) হলো এমন একটা পূর্ণাঙ্গ জায়গা যেখানে সফটওয়্যার চলে: সার্ভার, ডেটাবেস, কনফিগারেশন আর যুক্ত সার্ভিসগুলো। টিমগুলো কয়েকটা রাখে, যাতে পরীক্ষা-নিরীক্ষা আর টেস্ট কখনো আসল রোগীদের ছুঁয়ে না যায়।
| এনভায়রনমেন্ট | উদ্দেশ্য | ডেটা | ClinicQueue-এর উদাহরণ |
|---|---|---|---|
| ডেভেলপমেন্ট | যেখানে ডেভেলপাররা কোড লেখেন আর চালিয়ে দেখেন | অল্প কাল্পনিক ডেটা | ফারহানের ল্যাপটপ; SMS যায় একটা নকল প্রেরকে, যা শুধু প্রিন্ট করে |
| টেস্টিং / স্টেজিং | সিস্টেম ও অ্যাকসেপ্টেন্স টেস্টের জন্য প্রোডাকশনের একটা কপি | আসলের মতো কিন্তু কাল্পনিক, বা ঠিকভাবে পরিচয়মুক্ত (anonymised) | যে টেস্ট সার্ভারে কোয়ামে আর নাদিয়া টেস্ট করেন; SMS শুধু টিমের নিজেদের ফোনে |
| প্রোডাকশন | আসল ইউজারদের ব্যবহার করা আসল সিস্টেম | রোগীদের আসল ডেটা | ক্লিনিকের চালু বুকিং সাইট |
উদাহরণ:
developer laptop test / staging server production
+----------------+ +----------------------+ +--------------------+
| write + unit | ---> | same build 2.0.0 | ---> | same build 2.0.0 |
| tests | push | system + acceptance | go | real patients |
| fake SMS | | team phones only | | real SMS provider |
+----------------+ +----------------------+ +--------------------+
only the configuration differs (addresses, keys, SMS sender), never the codeদুটো অভ্যাস এনভায়রনমেন্টকে কাজের করে তোলে। প্রথমত, স্টেজিং থেকে প্রোডাকশনে একই বিল্ড তুলুন; প্রোডাকশনের জন্য "একই কোড" আবার বিল্ড করলে চুপচাপ ভিন্ন কিছু ঢুকে যেতে পারে। দ্বিতীয়ত, কনফিগারেশন (পাসওয়ার্ড, SMS-এর API কি (key), ডেটাবেসের ঠিকানা) কোডের বাইরে রাখুন, প্রতিটা এনভায়রনমেন্টে আলাদা। আর রোগীদের আসল ডেটা ডেভেলপমেন্ট ও টেস্টিংয়ের বাইরে রাখুন: এতে রোগীরা সুরক্ষিত থাকেন, আর অনেক দেশে ডেটা সুরক্ষা আইন আসল ব্যক্তিগত ডেটা কীভাবে ব্যবহার করা যাবে তা সীমিত করে, তাই আপনার প্রজেক্টে কোন নিয়ম খাটে তা জেনে নিন।
রক্ষণাবেক্ষণ: সবচেয়ে লম্বা পর্ব
ডেলিভারির পর সফটওয়্যারের ওপর যা কিছু করা হয়, সবই রক্ষণাবেক্ষণ। এর আন্তর্জাতিক স্ট্যান্ডার্ড হলো ISO/IEC/IEEE 14764 (বর্তমান সংস্করণ ২০২২, যা ২০০৬ সংস্করণের জায়গা নিয়েছে), আর এটা রক্ষণাবেক্ষণের ধরনগুলোর সংজ্ঞা নির্ধারণ করে। Software Engineering Body of Knowledge (SWEBOK), ২০০৬ সংস্করণের উদ্ধৃতি দিয়ে, চার ধরনের বর্ণনা দেয়:
| ধরন | অর্থ | ClinicQueue-এর উদাহরণ |
|---|---|---|
| কারেক্টিভ (corrective) | "Reactive modification … after delivery to correct discovered problems": ডেলিভারির পর খুঁজে পাওয়া সমস্যা ঠিক করার প্রতিক্রিয়ামূলক পরিবর্তন | রোগীদের জানানো দুবার SMS যাওয়ার সমস্যা ঠিক করা (1.1.1) |
| অ্যাডাপ্টিভ (adaptive) | সফটওয়্যারকে "in a changed or changing environment", মানে বদলে যাওয়া বা বদলাতে থাকা পরিবেশে, ব্যবহারযোগ্য রাখা | SMS প্রোভাইডার তার পুরোনো ইন্টারফেস বন্ধ করে দিচ্ছে, তাই রিমাইন্ডার মডিউল নতুনটায় যায় |
| পারফেক্টিভ (perfective) | "Provide enhancements for users … improve software performance, maintainability, or other software attributes": ইউজারদের জন্য উন্নতি, আর পারফরম্যান্স, রক্ষণাবেক্ষণযোগ্যতা বা অন্য গুণ বাড়ানো | রিনার চাওয়া "arrived" চিহ্ন যোগ করা; কিউ স্ক্রিন দ্রুত লোড করানো |
| প্রিভেন্টিভ (preventive) | "Detect and correct latent faults … before they become operational faults": সুপ্ত ত্রুটি চালু অবস্থার ত্রুটি হয়ে ওঠার আগেই খুঁজে ঠিক করা | কোয়ামে লক্ষ করেন তারিখগুলো টাইম জোন ছাড়া রাখা হচ্ছে; এখনো ফেল করেনি, কিন্তু ক্লিনিক অন্য টাইম জোনে শাখা খুললে করবে, তাই টিম এখনই ঠিক করে |
SWEBOK কারেক্টিভ আর প্রিভেন্টিভকে এক দলে রাখে সংশোধন (corrections) হিসেবে, আর অ্যাডাপ্টিভ ও পারফেক্টিভকে উন্নয়ন (enhancements) হিসেবে। ধরনগুলো পরিকল্পনায় সাহায্য করে: টিমের বেশির ভাগ সময় কারেক্টিভ কাজে গেলে প্রক্রিয়ার আগের ধাপে মানের দিকে নজর দিতে হবে; অ্যাডাপ্টিভ কাজ বারবার টিমকে চমকে দিলে কাউকে ClinicQueue যেসব সার্ভিসের ওপর নির্ভর করে সেগুলোর দিকে নজর রাখতে হবে।
বাস্তবে সীমারেখা ঝাপসা হয়। একটা লাইব্রেরির নতুন ভার্সনে যাওয়া একই সাথে অ্যাডাপ্টিভ (পুরোনোটা আর সাপোর্ট পায় না) আর প্রিভেন্টিভ (একটা জানা নিরাপত্তা-ফাঁক বন্ধ করে) হতে পারে। প্রধান কারণটা বেছে নিন; ধরনটা পরিকল্পনার টুল, আইনি লেবেল নয়।
টেকনিক্যাল ডেট
ওয়ার্ড কানিংহাম ১৯৯২ সালে WyCash পোর্টফোলিও ম্যানেজমেন্ট সিস্টেম নিয়ে একটা অভিজ্ঞতা-প্রতিবেদনে (OOPSLA '92) ঋণের এই রূপকটা চালু করেন: "Shipping first time code is like going into debt." অর্থাৎ প্রথমবারের কোড শিপ করা ঋণ নেওয়ার মতো। মার্টিন ফাউলার রূপকটা যেভাবে ব্যাখ্যা করেন, অগোছালো কোনো অংশে পরের প্রতিটা পরিবর্তনে যে বাড়তি পরিশ্রম লাগে, সেটাই সুদ (interest)। একটা শর্টকাট ঋণ নেওয়ার মতো: এখন সময় বাঁচে, আর অংশটা গুছিয়ে না নেওয়া পর্যন্ত সুদ দিতে হয়; গুছিয়ে নেওয়া মানে মূল ঋণটাই (আসল, principal) শোধ করা। ঋণ সবসময় ভুল নয়; গুরুত্বপূর্ণ একটা তারিখ ধরতে ঋণ নেওয়া ভালো সিদ্ধান্ত হতে পারে, যদি আপনি জানেন যে নিয়েছেন আর শোধের পরিকল্পনা থাকে।
কীভাবে জমে
- ইচ্ছাকৃত শর্টকাট: সময়মতো লঞ্চের জন্য ফারহান ক্লিনিকের খোলার সময়কে সেটিং না বানিয়ে কোডে সরাসরি লিখে দিয়েছেন।
- পরে শেখা: ডিজাইনের সময়ের চেয়ে টিম এখন কিউটা ভালো বোঝে, আর পুরোনো ডিজাইন ঠিকমতো খাপ খায় না।
- টেস্ট আর ডকুমেন্টের অভাব: রিমাইন্ডার শিডিউলার বদলাতে কেউ সাহস পায় না, কারণ ভুল হলে ধরার কিছু নেই।
- পুরোনো হয়ে যাওয়া ডিপেন্ডেন্সি: লাইব্রেরিগুলো পিছিয়ে পড়ে, আর প্রতিটা আপগ্রেড আরও কঠিন হয়।
- কপি-পেস্ট: একই তারিখ-যাচাই তিন জায়গায় আছে, আর এক জায়গার ফিক্স বাকিগুলোতে ভুলে যাওয়া হয়।
শোধ করা
প্রথম ধাপ হলো ঋণকে দৃশ্যমান করা। ClinicQueue ঋণের আইটেমগুলো ফিচারের একই ব্যাকলগে রাখে, সুদটা লিখে, যাতে প্রোডাক্ট ওনার সেগুলোকে তুলনা করে দেখতে পারেন:
উদাহরণ:
ID Debt Interest (what it costs us) Size
TD-03 Opening hours hard-coded every new clinic needs a code change + release S
TD-05 No tests for the reminder scheduler each change takes a day of manual checking M
TD-08 Date check copied in three places bug CQ-212 had to be fixed three times Sতারপর টিম বেছে নেয় কীভাবে শোধ করবে। সবচেয়ে ভালো উপায় নিয়ে অভিজ্ঞদের মধ্যে মতভেদ আছে:
| পদ্ধতি | পক্ষে | বিপক্ষে |
|---|---|---|
| কাজের সাথে সাথে গোছানো: যে কোড এমনিতেই বদলাচ্ছেন সেটা উন্নত করা | স্থির, সস্তা, যেখানে সুদ সবচেয়ে বেশি সেখানে আগে শোধ হয় | যে অংশ কেউ ছোঁয় না, সেটা কখনো উন্নত হয় না |
| প্রতিটা স্প্রিন্টের একটা অংশ ঋণের আইটেমের জন্য রাখা | অনুমানযোগ্য; প্রোডাক্ট ওনার ট্রেড-অফটা দেখতে পান | ডেডলাইনের চাপে সহজেই বাতিল হয় |
| আলাদা একটা গোছানোর সময়কাল | লাইব্রেরি আপগ্রেডের মতো বড় আইটেমের জন্য ভালো | কিছুদিন কোনো নতুন ফিচার নেই; পরে ঋণ আবার বাড়ে |
| শূন্য থেকে আবার লেখা | কখনো কখনো ছোট, খুব ভাঙা একটা অংশের জন্য একমাত্র উপায় | পুরো সিস্টেমের জন্য এটা ধীর আর ঝুঁকিপূর্ণ, আর পুরোনো সিস্টেমের লুকানো জ্ঞান হারিয়ে যায় |
ClinicQueue-এর মতো ছোট টিমের জন্য প্রথম দুটো একসাথে সাধারণত সবচেয়ে ভালো কাজ করে: কাজের সাথে সাথে রিফ্যাক্টরিং করুন (রক্ষণাবেক্ষণযোগ্য কোড লেখা পাতার রিফ্যাক্টরিং ধাপগুলো), আর সবচেয়ে দামি ঋণের আইটেমগুলোকে প্রতিটা স্প্রিন্টে জায়গা দিন।
রক্ষণাবেক্ষণে সাহায্য করে এমন ডকুমেন্টেশন
দুই বছর পরে যিনি ClinicQueue ঠিক করবেন, তিনি হয়তো একজন নতুন ডেভেলপার, কিংবা ফারহান নিজে, যাঁর ততদিনে খুঁটিনাটি মনে থাকবে না। রিপোজিটরিতে দুটো ছোট ডকুমেন্ট বেশির ভাগ কাজ করে দেয়।
README
README হলো কোডের সামনের দরজা: এটা কী, আর কীভাবে চালু করতে হয়। ছোট আর সঠিক রাখুন; ভুল README ছোট README-র চেয়েও খারাপ।
টেমপ্লেট:
ClinicQueue
Online booking, SMS reminders and a front-desk queue for a small clinic.
Run it locally: steps to install, configure (copy the example settings file) and start
Run the tests: the one command that runs all unit and integration tests
Configuration: which settings exist, which are secret, where each environment keeps them
Release: how a version is built, tagged, deployed and rolled back (link to the checklist)
Architecture: one paragraph and the component diagram from Software Design Basics (p11)
Contacts: who owns the code, who to ask about the clinic's rulesচেঞ্জ লগ
চেঞ্জ লগ (change log) হলো এমন একটা ফাইল, যাতে প্রতিটা ভার্সনের উল্লেখযোগ্য পরিবর্তনগুলো থাকে, নতুনটা সবার ওপরে। রিলিজ নোট একটা রিলিজ নিয়ে ইউজারদের সাথে কথা বলে; চেঞ্জ লগ ডেভেলপার আর রক্ষণাবেক্ষণকারীদের জন্য পুরো ইতিহাস। দুটোই একই তথ্য থেকে আসে, আর সবচেয়ে সহজ হলো পরিবর্তনের একই পুল রিকোয়েস্টে চেঞ্জ লগ হালনাগাদ করা।
উদাহরণ:
2.0.0 - 2026-12-20
Changed (breaking): every booking API call needs a clinic id. Widget 3.x sends it.
1.2.0 - 2026-12-10
Added: AI-drafted reminder text, off by default (setting: reminders.ai_draft).
1.1.1 - 2026-12-02
Fixed: some patients received the SMS reminder twice (CQ-230).
1.1.0 - 2026-11-30
Added: reminders in Bangla. Fixed: queue screen missed bookings made after 17:00.প্রজেক্ট বড় হলে কাজের আরও কিছু জিনিস: গুরুত্বপূর্ণ ডিজাইন সিদ্ধান্ত আর সেগুলোর কারণের একটা ছোট নথি, আর এমন কমেন্ট যা ব্যাখ্যা করে কেন, যেখানে শুধু কোড দেখে তা বোঝা যায় না।
কাজের জায়গায় এটা কোথায় লাগে
- আপনি যে লাইব্রেরি আর API ইনস্টল করেন, সেগুলো SemVer নম্বর ঘোষণা করে; নতুন মেজর ভার্সন হলো আপগ্রেডের আগে চেঞ্জ লগ পড়ার সংকেত।
- টিমগুলো রিলিজের আগে একটা ছোট গো/নো-গো যাচাই করে, আর রিলিজ টিকিটে রোলব্যাক পরিকল্পনা রাখে।
- একটা টিমে যোগ দেওয়া মানে সাধারণত নতুন সিস্টেম শুরু করা নয়, বরং আগের কোডে কাজ করা; লাইব্রেরি আর প্ল্যাটফর্ম আপগ্রেডের মতো অ্যাডাপ্টিভ কাজ কখনো থামে না।
- ফ্রিল্যান্সাররা প্রায়ই ডেলিভারির পরের রক্ষণাবেক্ষণ আলাদা চুক্তি হিসেবে বিক্রি করেন; চার ধরনের নাম জানা থাকলে এর দাম ঠিক করা সহজ হয়।
সাধারণ ভুল
- অনুভূতি দিয়ে ভার্সন নম্বর বাছা। কলারদের ভেঙে দেওয়া একটা "ছোট" পরিবর্তন প্যাচ হিসেবে রিলিজ করলে অন্যদের সিস্টেম ভাঙে। সমাধান: পরিবর্তনের আকার নয়, API-র ওপর প্রভাব বিচার করুন, আর SemVer-এর নিয়ম প্রয়োগ করুন।
- রোলব্যাক পরিকল্পনা ছাড়া রিলিজ। চাপের মধ্যে মানুষ তাৎক্ষণিক কিছু করে আর অবস্থা আরও খারাপ করে। সমাধান: গো/নো-গো মিটিংয়ের আগেই ডেটার প্রশ্নসহ পরিকল্পনাটা লিখুন।
- এক এনভায়রনমেন্টে টেস্ট করে অন্য একটা বিল্ড ডিপ্লয় করা। সমাধান: স্টেজিংয়ে পাস করা হুবহু বিল্ডটাই তুলুন, আর শুধু কনফিগারেশন আলাদা রাখুন।
- টেকনিক্যাল ডেটকে অদৃশ্য ধরে নেওয়া। তবু এটা সুদ নেয়। সমাধান: ঋণের আইটেমগুলো তাদের খরচসহ লিখে রাখুন আর ব্যাকলগে জায়গা দিন।
- README আর চেঞ্জ লগ পুরোনো হতে দেওয়া। সমাধান: পরিবর্তনের একই পুল রিকোয়েস্টে এগুলো হালনাগাদ করুন, আর কোড রিভিউতে যাচাই করুন।
নিজে চেষ্টা করুন
- সহজ: ClinicQueue-এর বুকিং API এখন 1.4.2-তে। একটার পর একটা প্রয়োগ করলে প্রতিটা পরিবর্তনের পর পরের ভার্সন কী? (ক) সন্ধ্যার স্লটে ভুল সময় দেখানো ঠিক করা; (খ) ঐচ্ছিক একটা "আসার কারণ" (reason for visit) ঘর যোগ করা; (গ) যে পুরোনো endpoint স্লটগুলো সাধারণ টেক্সট হিসেবে ফেরত দিত, যা কিছু পার্টনার এখনো ব্যবহার করে, সেটা সরিয়ে দেওয়া।
bumpদিয়ে আপনার উত্তর যাচাই করুন। - মাঝারি: প্রতিটা কাজের রক্ষণাবেক্ষণের ধরন বলুন: (ক) ফোনের অপারেটিং সিস্টেম নোটিফিকেশনের নিয়ম বদলেছে, তাই রিমাইন্ডারের লিংক বদলাতে হবে; (খ) রোগীরা জানান বাতিল করতে গেলে একটা এরর দেখায়; (গ) নাদিয়া সাপ্তাহিক একটা না-আসা (no-show) রিপোর্ট চান; (ঘ) ফারহান দেখেন কয়েক হাজার বুকিংয়ের পর স্লট নম্বর একটা ছোট ডেটাবেস কলামে আর আঁটবে না, সেটা ঘটার অনেক আগেই।
- কঠিন: AI দিয়ে খসড়া করা রিমাইন্ডার টেক্সট (1.2.0-এ যোগ করা, off by default) এবার সব রোগীর জন্য চালু করা হবে; বর্তমান ভার্সন 2.0.0। একটা ছোট রিলিজ পরিকল্পনা লিখুন: ভার্সন (আর কেন), ফ্রন্ট ডেস্কের জন্য তিন লাইনের রিলিজ নোট, রোলব্যাকের শর্ত আর কীভাবে রোলব্যাক হবে, আর একটা টেকনিক্যাল ডেট আইটেম যা টিমের লিখে রাখা উচিত।
উত্তর
- (ক) আগের সাথে সামঞ্জস্যপূর্ণ বাগ ফিক্স: 1.4.3। (খ) নতুন ঐচ্ছিক ঘর মানে নতুন কার্যকারিতা, যা আগের কলারদের ভাঙে না: 1.5.0 (প্যাচ ০ হয়ে যায়)। (গ) কলাররা যা ব্যবহার করে তা সরানো একটা অসামঞ্জস্যপূর্ণ API পরিবর্তন: 2.0.0 (মাইনর আর প্যাচ ০ হয়)।
bump("1.4.2", "patch"), তারপরbump("1.4.3", "minor"), তারপরbump("1.5.0", "major")চালালে আসে 1.4.3, 1.5.0, 2.0.0। - (ক) অ্যাডাপ্টিভ: পরিবেশ বদলেছে। (খ) কারেক্টিভ: ডেলিভারির পর খুঁজে পাওয়া সমস্যা। (গ) পারফেক্টিভ: ইউজারদের জন্য একটা উন্নতি। (ঘ) প্রিভেন্টিভ: চালু অবস্থার ত্রুটি হয়ে ওঠার আগেই ঠিক করা একটা সুপ্ত ত্রুটি।
- মডেল উত্তর: "ভার্সন 2.1.0 যুক্তিসঙ্গত: সবার জন্য ফিচারটা চালু করা চোখে পড়ার মতো নতুন আচরণ, কিন্তু API-র পুরোনো কলাররা আগের মতোই কাজ করে, তাই এটা মাইনর পরিবর্তন, মেজর নয়; নতুন কোড ছাড়া এটা শুধু একটা সেটিং বদল হলে টিম ঠিক করতে পারে যে নতুন ভার্সন লাগবে না, আর পরিবর্তনটা চেঞ্জ লগে লিখে রাখবে। রিলিজ নোট: 'রিমাইন্ডার টেক্সট এখন প্রতিটা বুকিংয়ের জন্য একটা AI টুল লেখে, আর নিয়ম দিয়ে চেক করে আর ফ্রন্ট ডেস্কের অনুমোদনের পর পাঠানো হয়। কোনো টেক্সট যাচাইয়ে ফেল করলে আগের সাধারণ টেক্সটটাই যায়। কোনো রোগী অদ্ভুত রিমাইন্ডারের কথা জানালে লেনাকে বলুন।' রোলব্যাক: এক দিনে অনেক খসড়া নিয়মের যাচাইয়ে ফেল করলে, বা কোনো রিমাইন্ডারে চিকিৎসার তথ্য বা ভুল রোগীর ডেটা থাকলে, লেনা সেটিংটা বন্ধ করে দেন (নতুন ডিপ্লয় ছাড়া, এক মিনিটের কম); আবার সাধারণ টেক্সট ব্যবহার হয়। ঋণের আইটেম: 'নিষিদ্ধ শব্দের তালিকা কোডের ভেতরে আছে; সেটিংয়ে সরালে কোয়ামে রিলিজ ছাড়াই তালিকা হালনাগাদ করতে পারবেন।'" ভালো উত্তর API-র নিয়মের সাথে যুক্ত কারণসহ একটা ভার্সন দেয়, ফ্রন্ট ডেস্কের ভাষায় নোট লেখে, রোলব্যাকের একটা নির্দিষ্ট ও মাপা যায় এমন শর্ত রাখে, রোলব্যাকের উপায় হিসেবে "off by default" সুইচটা ব্যবহার করে, আর সুদসহ একটা ঋণের আইটেম লিখে রাখে।
সারসংক্ষেপ
- SemVer 2.0.0: অসামঞ্জস্যপূর্ণ API পরিবর্তনে MAJOR, আগের সাথে সামঞ্জস্যপূর্ণ ফিচারে MINOR, আগের সাথে সামঞ্জস্যপূর্ণ ফিক্সে PATCH; নিচের সংখ্যাগুলো ০ হয়ে যায়; 0.y.z হলো শুরুর ডেভেলপমেন্ট, আর 1.0.0 public API নির্ধারণ করে।
- প্রতিটা রিলিজে দরকার ইউজারদের ভাষায় রিলিজ নোট আর আগেভাগে লেখা একটা রোলব্যাক পরিকল্পনা, ডেটার কী হবে তা সহ।
- ডেভেলপমেন্ট, স্টেজিং আর প্রোডাকশন এনভায়রনমেন্ট পরীক্ষা-নিরীক্ষাকে আসল ইউজারদের থেকে দূরে রাখে; একই বিল্ড তুলুন আর শুধু কনফিগারেশন বদলান।
- রক্ষণাবেক্ষণ হয় কারেক্টিভ, অ্যাডাপ্টিভ, পারফেক্টিভ বা প্রিভেন্টিভ (ISO/IEC/IEEE 14764; বর্তমান সংস্করণ ২০২২)।
- টেকনিক্যাল ডেট (ওয়ার্ড কানিংহাম, ১৯৯২) প্রতিটা পরিবর্তনে সুদ নেয়; একে দৃশ্যমান করুন আর নিয়মিত শোধ করুন। একটা ছোট README আর হালনাগাদ চেঞ্জ লগ পরের রক্ষণাবেক্ষণকারীকে সবচেয়ে বেশি সাহায্য করে।
এরপর: AI কোডিং অ্যাসিস্ট্যান্টের সাথে সফটওয়্যার ইঞ্জিনিয়ারিং: নিজের কোডের মালিকানা না ছেড়ে কীভাবে লাইফ সাইকেলের বিভিন্ন ধাপে AI কোডিং টুল ব্যবহার করবেন।

