ট্রাংক-বেসড ডেভেলপমেন্ট ও ফিচার ফ্ল্যাগ

১ · ট্রাংক-বেসড ডেভেলপমেন্ট কী

ট্রাংক-বেসড ডেভেলপমেন্টTrunk-Based Developmentএকটি হালকা-ওজনের ব্রাঞ্চিং স্ট্র্যাটেজি যেখানে সব ডেভেলপার ঘন ঘন সরাসরি একটি শেয়ার্ড ব্রাঞ্চে কমিট করে, দীর্ঘস্থায়ী ফিচার ব্রাঞ্চ ছাড়াই। হলো L41-এর Git Flow-এর সরাসরি বিপরীত এক দর্শন। Git Flow-এ আমরা দেখেছি পাঁচটি নির্দিষ্ট ধরনের ব্রাঞ্চ (main, develop, feature/*, release/*, hotfix/*) — একটি কাঠামোবদ্ধ, তুলনামূলক ভারী মডেল। ট্রাংক-বেসড ডেভেলপমেন্টে এই কাঠামো নেই — সব ডেভেলপার প্রায়ই দিনে একাধিকবার সরাসরি একটি শেয়ার্ড "trunk" ব্রাঞ্চে (সাধারণত main) কমিট করে। ফিচার ব্রাঞ্চ ব্যবহার করা হলেও তা মাত্র কয়েক ঘণ্টার জন্য বেঁচে থাকে — দিন বা সপ্তাহের জন্য নয় — তারপরই আবার trunk-এ মার্জ হয়ে যায়।

২ · কেন এটি কাজ করে — L36-এর সাথে সরাসরি সম্পর্ক

এই পদ্ধতির মূল যুক্তি সরাসরি M8/L36-এর মার্জ কনফ্লিক্ট আলোচনার সাথে যুক্ত। মনে করুন, একটি মার্জ কনফ্লিক্ট ঘটে যখন দুটো ব্রাঞ্চ একই লাইনে ভিন্নভাবে পরিবর্তন করে — এবং একটি ব্রাঞ্চ যত বেশি দিন ধরে trunk থেকে বিচ্যুত থাকে, তত বেশি পরিবর্তন জমা হয়, ফলে কনফ্লিক্টের সম্ভাবনা ও তীব্রতা দুটোই বাড়ে। ট্রাংক-বেসড ডেভেলপমেন্ট এই সমস্যাটির মূলেই আঘাত করে — প্রতিটি ইন্টিগ্রেশন ছোট ও ঘন ঘন হওয়ায়, কোনো ব্রাঞ্চ কখনোই বেশিদূর বিচ্যুত হওয়ার সুযোগ পায় না, ফলে প্রতিটি মার্জ সাধারণত ছোট, সহজ ও কম-ঝুঁকিপূর্ণ থাকে।

৩ · আসল সমস্যা — অসম্পূর্ণ ফিচার প্রোডাকশনে যাওয়া

কিন্তু এখানে একটি বাস্তব, গুরুত্বপূর্ণ সমস্যা তৈরি হয়: যদি সবাই ঘন ঘন সরাসরি trunk-এ কমিট করে, তাহলে অসম্পূর্ণ, এখনো-টেস্ট-না-হওয়া ফিচারের কোড কীভাবে প্রোডাকশনে পাঠানো থেকে ঠেকানো যায়? Git Flow-এ feature/* ব্রাঞ্চ ফিচার সম্পূর্ণ না হওয়া পর্যন্ত develop-এ যাওয়া থেকে বিরত রাখে — কিন্তু ট্রাংক-বেসড ডেভেলপমেন্টে সেই সুরক্ষা নেই, কারণ কোড প্রায় সাথে সাথেই trunk-এ চলে যায়।

৪ · সমাধান — ফিচার ফ্ল্যাগ

ফিচার ফ্ল্যাগFeature Flag / Feature Toggleকোডের একটি কন্ডিশনাল চেক (যেমন if flag_is_enabled(...)) যা অসম্পূর্ণ ফাংশনালিটি নিরাপদে প্রোডাকশনে ডিপ্লয় করতে দেয়, বাস্তব ইউজারের কাছে তা সক্রিয় না করেই। (aka ফিচার টগল) হলো এই সমস্যার প্রমিত সমাধান — কোডে একটি সাধারণ কন্ডিশনাল চেক থাকে, যেমন:

if feature_flags.is_enabled("new_checkout_flow", user_id): ... নতুন কোড ...
else: ... পুরনো, স্থিতিশীল কোড ...

এভাবে নতুন, এখনো-অসম্পূর্ণ কোড কমিট এবং এমনকি প্রোডাকশনে ডিপ্লয় করা যায়, কিন্তু ফ্ল্যাগ চালু না করা পর্যন্ত বাস্তব ইউজারের কাছে তা সম্পূর্ণ নিষ্ক্রিয়/অদৃশ্য থাকে। এটি জেনুইনভাবে ডিপ্লয় করা (কোড প্রোডাকশন সার্ভারে পাঠানো) এবং রিলিজ করা (ফিচার বাস্তব ইউজারের কাছে সক্রিয় করা) — এই দুটো কাজকে সম্পূর্ণ আলাদা করে দেয়। ফ্ল্যাগ প্রায়ই ধীরে ধীরে বাড়ানো হয় — প্রথমে অভ্যন্তরীণ টেস্ট অ্যাকাউন্টের জন্য, তারপর ইউজারদের একটি ছোট শতাংশের জন্য, ধীরে ধীরে ১০০% পর্যন্ত — একে "পার্সেন্টেজ রোলআউট" বলা হয়।

নিচের কোড সেলে আমরা একটি বাস্তব FeatureFlagManager ইমপ্লিমেন্ট করব যা উভয় ধরনের ফ্ল্যাগ সাপোর্ট করে — সাধারণ অন/অফ, এবং পার্সেন্টেজ রোলআউট। পার্সেন্টেজ রোলআউট বাস্তবায়নের জন্য প্রতিটি ইউজারের জন্য একটি ধারাবাহিক (deterministic) "বাকেট" দরকার — একই ইউজার সবসময় একই বাকেটে পড়বে, যাতে একজন ইউজার একবার ফিচার দেখলে পরের বার হঠাৎ সেটি অদৃশ্য হয়ে না যায়। Python-এর নিজস্ব hash() ফাংশন প্রতিটি রান-এ ভিন্ন ফলাফল দেয় (randomized) — তাই আমরা একটি সরল, নিজস্ব ধারাবাহিক হ্যাশ ফাংশন লিখব।

# একটি ফিচার ফ্ল্যাগ ম্যানেজার -- পার্সেন্টেজ রোলআউট সাপোর্ট সহ।
# নোট: Python-এর বিল্ট-ইন hash() প্রতি রান-এ randomized, তাই reproducible রেজাল্টের জন্য
# আমরা নিজেদের সরল, ধারাবাহিক (deterministic) হ্যাশ ফাংশন লিখছি।

def simple_deterministic_hash(text):
    h = 5381
    for ch in text:
        h = (h * 33 + ord(ch)) % 1000003
    return h

class FeatureFlagManager:
    def __init__(self):
        self.flags = {}  # flag_name -> rollout_percentage (0-100)

    def set_flag(self, flag_name, rollout_percentage):
        self.flags[flag_name] = rollout_percentage

    def is_enabled(self, flag_name, user_id):
        rollout_percentage = self.flags.get(flag_name, 0)
        if rollout_percentage <= 0:
            return False
        if rollout_percentage >= 100:
            return True
        bucket = simple_deterministic_hash(f"{flag_name}:{user_id}") % 100
        return bucket < rollout_percentage

manager = FeatureFlagManager()
sample_users = [f"user{i}" for i in range(2000)]

# ০% রোলআউট -- কেউ দেখে না
manager.set_flag("new_checkout_flow", 0)
count_0 = sum(1 for u in sample_users if manager.is_enabled("new_checkout_flow", u))
print(f"0% রোলআউট -- {count_0}/{len(sample_users)} ইউজার ফিচারটি দেখছে")

# ৫০% রোলআউট -- আনুমানিক অর্ধেক ইউজার দেখবে
manager.set_flag("new_checkout_flow", 50)
count_50 = sum(1 for u in sample_users if manager.is_enabled("new_checkout_flow", u))
pct_50 = count_50 / len(sample_users) * 100
print(f"50% রোলআউট -- {count_50}/{len(sample_users)} ইউজার দেখছে ({pct_50:.1f}%)")

# 100% রোলআউট -- সবাই দেখে
manager.set_flag("new_checkout_flow", 100)
count_100 = sum(1 for u in sample_users if manager.is_enabled("new_checkout_flow", u))
print(f"100% রোলআউট -- {count_100}/{len(sample_users)} ইউজার দেখছে")