অ্যাপেন্ডিক্স ও ফিল্ড রেফারেন্স¶
বিষয়বস্তু: ফিল্ড ডিসকাভারি অডিট শিট, গিটহাব কমপ্যানিয়ন কোড চালানোর গাইড, ডিকশনারি ও পেজ বাজেট
১. ফিল্ড ডিসকাভারি ও অন-বোর্ডিং অডিট শিট¶
ক্লায়েন্টের সাইটে প্রথম সপ্তাহে কাজ শুরু করার সময় নিচের চেকলিস্ট এবং প্রশ্নগুলো নিজের নোটবুকে সাথে রাখুন। এই আটটা প্রশ্নের উত্তর আপনার হাতে চলে এলে বুঝবেন আপনার ফিল্ড ডিসকাভারি পর্ব ষোলো আনা সফল হয়েছে:
ফিল্ড ডিসকাভারি অডিট শিট
- মানুষ ও ট্রাস্ট: প্রথম আটচল্লিশ ঘণ্টায় অপারেশন ফ্লোরের কোন কোন স্টাফের সাথে চা খেয়েছেন ও কথা বলেছেন? কে আপনাকে এখনো সন্দেহের চোখে দেখছেন? আপনার অটোমেশনে কার ক্ষমতা বা গুরুত্ব কমে যাওয়ার ফিয়ার তৈরি হতে পারে?
- কাগুজে এসওপি বনাম গ্রাউন্ড রিয়েলিটি: কোম্পানির অফিশিয়াল এসওপি ফাইলে কাজটা কিভাবে লেখা আছে আর ফ্লোরে আসলে কিভাবে চলছে? স্টাফরা কাজ বাঁচানোর জন্য কোন কোন অলিখিত শর্টকাট, লাল খাতা বা পুরনো এক্সেল ফাইল ব্যবহার করছেন?
- সময়ের হিসাব (বটলনেক): পুরো ওয়ার্কফ্লোর প্রতিটা ধাপে এসওপির নির্ধারিত সময় কত আর শ্যাডো সেশনে স্টপওয়াচ ধরে বাস্তবে কত মিনিট লাগছে? কোন ধাপটায় বাস্তবের সময় এসওপির দ্বিগুণের বেশি হয়ে গেছে?
- সাকসেস মেট্রিক ও স্কোপ বাউন্ডারি: এক লাইনের মাপার মতো সাকসেস মেট্রিকটা কী? এবং প্রথম ফেজে কী কী কাজ করা হবে না (Out-of-Scope Contract), তা কি ক্লায়েন্টের সাথে লিখিতভাবে ঠিক হয়েছে?
- ডেটা প্রাইভেসি ও কমপ্লায়েন্স: কোন কোন কাস্টমার ডেটা বা ইনভয়েস অফিসের লোকাল নেটওয়ার্কের বাইরে পাঠানো নিষেধ? ব্যাংক, কাস্টমস বা অডিটরের কোন শর্ত এখানে প্রযোজ্য?
- নেটওয়ার্ক ও লোকাল হার্ডওয়্যার: ওই ব্রাঞ্চে দিনে গড়ে কতবার ইন্টারনেট বা ওয়াইফাই ডাউন হয়? লোকাল অন-প্রেম সার্ভারের সিপিইউ কোর, র্যাম ও ফ্রি ডিস্ক স্পেস কত? জিপিইউ আছে কি না?
- প্রথম সপ্তাহের কুইক উইন: কোন ছোট কিন্তু দৃশ্যমান বটলনেকটা প্রথম পাঁচ-সাত দিনের মধ্যে অটোমেট করে স্টাফদের মুখে হাসি ফোটানো যাবে? (চ্যাপ্টার ৫-এর কুইক-উইন স্কোরার দিয়ে চেক করুন।)
- গোল্ডেন হ্যান্ডওভার প্ল্যান: ক্লায়েন্টের আইটি টিম থেকে কে প্রথম দিন থেকে আপনার শ্যাডো পার্টনার হিসেবে পাশে বসবেন? এক পাতার বাংলা রানবুক কে বুঝে নেবেন এবং ফায়ার ড্রিল কবে হবে?
২. গিটহাব ল্যাব ও কমপ্যানিয়ন কোড চালানোর গাইড¶
বইয়ের প্রতিটা চ্যাপ্টারের কোড যাতে আপনি নিজের ল্যাপটপে বিনা খরচে (কোনো পেইড ক্লাউড বা এপিআই কি ছাড়াই) চালিয়ে দেখতে পারেন, সেজন্য অফিশিয়াল কমপ্যানিয়ন গিটহাব রিপোজিটরিতে (https://github.com/raqueeb/fdebook_companion) সবগুলো স্ক্রিপ্ট ও মক ডেটা সাজিয়ে রাখা হয়েছে।
ধাপ ১: কমপ্যানিয়ন রিপোজিটরি ক্লোন ও পাইথন এনভায়রনমেন্ট সেটআপ¶
আপনার কম্পিউটারে Python 3.10+ এবং Git ইনস্টল থাকলে টার্মিনাল বা পাওয়ারশেলে নিচের কমান্ডগুলো চালান:
# ১. অফিশিয়াল কমপ্যানিয়ন কোড রিপোজিটরি ক্লোন করুন
git clone https://github.com/raqueeb/fdebook_companion.git
cd fdebook_companion
# ২. আলাদা ভার্চুয়াল এনভায়রনমেন্ট তৈরি ও চালু করুন
python3 -m venv .venv
source .venv/bin/activate # উইন্ডোজে: .venv\Scripts\activate
ধাপ ২: লোকাল এলএলএম (Ollama ও Qwen 2.5) সেটআপ¶
চ্যাপ্টার ২ এবং চ্যাপ্টার ৩-এর লোকাল এআই ট্রায়াজ ও ইভ্যালুয়েশন হারনেস চালানোর জন্য https://ollama.com থেকে নিজের ল্যাপটপে Ollama ইনস্টল করে নিন। এরপর টার্মিনালে মাত্র একটা কমান্ড চালিয়ে দেড় বিলিয়ন প্যারামিটারের হালকা মডেলটা নামিয়ে নিন (আর র্যাম বেশি থাকলে বাংলা মেসেজের জন্য 7B মডেলও চালাতে পারেন, যেটা তুখোড় কাজ করে):
ধাপ ৩: চ্যাপ্টারভিত্তিক কমপ্যানিয়ন স্ক্রিপ্ট রান করা¶
রিপোজিটরির ভেতর প্রতিটা চ্যাপ্টারের কোড আলাদা ডিরেক্টরিতে রাখা আছে:
# ইন্ট্রোডাকশন: সাইলেন্ট চর্ন ও শ্যাডো আইটি ডিটেক্টর
python3 intro-silent-churn/detect_silent_abandonment.py
# চ্যাপ্টার ১: ফিল্ড বটলনেক ডায়াগনস্টিক ও ওটিপি এসএলএ ট্র্যাকার
python3 ch01-field-discovery/bottleneck_analyzer.py
python3 ch01-field-discovery/otp_sla_tracker.py
# চ্যাপ্টার ২: SQLite WAL লোকাল কিউ ও লোকাল এলএলএম টিকিট ট্রায়াজ ইঞ্জিন
python3 ch02-local-triage-engine/sqlite_wal_queue.py
python3 ch02-local-triage-engine/triage.py
# চ্যাপ্টার ৩: ডোমেইন স্প্রিন্ট ভ্যাট ইঞ্জিন ও গোল্ডেন ইভ্যালুয়েশন হারনেস
python3 ch03-resilient-pipeline/domain_sprint_vat.py
python3 ch03-resilient-pipeline/eval_harness.py
# চ্যাপ্টার ৪ (ট্র্যাক এ ও বি): আইএসপি রাউটিং ওয়ার্কার, পোর্ট রিকনসিলার ও ম্যানেজার সামারি
python3 ch04-isp-routing-worker/worker.py
python3 ch04-supply-chain-reconciler/audit.py
python3 ch04-supply-chain-reconciler/manager_hero_report.py
# চ্যাপ্টার ৫ ও কনক্লুশন: ফিল্ড-টু-কোর ইঞ্জিন, কুইক-উইন স্কোরার ও হেলথ চেক ওয়াচডগ
python3 ch05-org-scaling/field_to_core_module.py
python3 ch05-org-scaling/quick_win_scorer.py
python3 conclusion-handover/health_check.py
python3 conclusion-handover/hypercare_watchdog.py
৩. ফিল্ড ইঞ্জিনিয়ারিং ও এআই ডিকশনারি (Glossary)¶
প্রযুক্তি, এআই ও অটোমেশন নিয়ে যাঁরা নতুন কাজ শুরু করছেন, তাঁদের সুবিধার জন্য বইয়ে ব্যবহৃত মূল টেকনিক্যাল শব্দগুলোর সহজ বাংলা অর্থ নিচে এক জায়গায় দিলাম:
| টেকনিক্যাল শব্দ | ফিল্ডের সহজ অর্থ |
|---|---|
| এফডিই (FDE) | ফরওয়ার্ড ডেপ্লয়েড ইঞ্জিনিয়ার। যিনি কোডের বাউন্ডারি পার হয়ে সরাসরি কাস্টমারের অফিসে বসে তাঁদের আসল অপারেশনাল সমস্যা বুঝে অটোমেশন তৈরি ও ডেপ্লয় করেন। |
| এসওপি (SOP) | স্ট্যান্ডার্ড অপারেটিং প্রসিডিউর বা কোম্পানির কাগুজে নিয়মবই, যার সাথে অন-গ্রাউন্ডের আসল কাজের প্রায়ই মিল থাকে না। |
| শ্যাডো সেশন (Shadow Session) | স্টাফকে কোনো প্রশ্ন বা জাজমেন্ট না করে তাঁর ডেস্কের পাশে চুপচাপ বসে তিনি আসলে কিভাবে কাজ করেন তা পর্যবেক্ষণ করা। |
| As-Is ও To-Be | কাস্টমারের বর্তমান এলোমেলো ম্যানুয়াল ওয়ার্কফ্লো (As-Is) এবং অটোমেশনের পরের সহজ ও দ্রুত ওয়ার্কফ্লো (To-Be)। |
| বটলনেক (Bottleneck) | পুরো কাজের প্রবাহের সেই নির্দিষ্ট ধাপ, যেখানে এসে ফাইল বা ডেটা আটকে থাকে এবং সবচেয়ে বেশি সময় নষ্ট হয়। |
| ফলসিফায়েবল মেট্রিক | এমন স্পষ্ট ও সংখ্যাভিত্তিক সাকসেস লক্ষ্য (যেমন আড়াই ঘণ্টার কাজ ১০ মিনিটে নামানো), যা ডেটা দেখে সরাসরি সত্য বা মিথ্যা প্রমাণ করা যায়। |
| অন-প্রেম (On-Premises) | পাবলিক ক্লাউডে ডেটা না পাঠিয়ে ক্লায়েন্টের নিজের অফিসের ভেতরে থাকা লোকাল সার্ভারে সফটওয়্যার ও এআই চালানো। |
| কোয়ান্টাইজেশন (4-bit Quantization) | এআই মডেলের ভেতরের বড় দশমিক সংখ্যাগুলোকে সংকুচিত করে ৪-বিটে নামিয়ে আনা, যাতে সাধারণ পিসির কম র্যামেই মডেল দ্রুত চলতে পারে। |
| SQLite WAL মোড | Write-Ahead Logging মোড, যা চালু করলে মূল ডেটাবেজ ফাইল লক না করেই পাশের লগ ফাইলে দ্রুত ডেটা লেখা যায় এবং একসাথে হাজার রিকোয়েস্ট সামলানো যায়। |
| ট্রায়াজ (Triage) | কাস্টমারের শত শত মেসেজ বা টিকিটের ভিড় থেকে কোনটা কোন ডিপার্টমেন্টের কাজ এবং কোনটা কতটা জরুরি তা বাছাই করা। |
| ভাইব কোডিং ও কোড ড্রিফট | গার্ডরেইল ছাড়া এআই এজেন্টকে দিয়ে অন্ধভাবে কোড লেখানো (Vibe Coding), যার ফলে সিস্টেমের মূল ডেটাবেজ বা আর্কিটেকচার নীরবে ভেঙে যায় (Code Drift)। |
| ইভ্যালুয়েশন হারনেস (Eval Harness) | প্রোডাকশনে এআই মডেল নামানোর আগে কাস্টমারের আসল ডেটার গোল্ডেন সেট দিয়ে মডেলের অ্যাকুরেসি ও JSON স্কিমা পরীক্ষা করার টেস্টবেঞ্চ। |
| সেলফ-হিলিং রোলব্যাক | নতুন আপডেট ডেপ্লয় করার পর হেলথ চেক ফেইল করলে মানুষের হস্তক্ষেপ ছাড়াই সিস্টেমের নিজে নিজে আগের ভালো ভার্সনে ফিরে যাওয়া। |
| ওএলটি (OLT) ও এলওএস (LOS) | আইএসপির মেইন অপটিক্যাল সুইচবোর্ড (OLT) এবং ফাইবার ক্যাবল কাটা পড়লে সিগন্যাল বিচ্ছিন্ন হওয়ার লাল অ্যালার্ম (LOS)। |
অ্যাসিনক্রোনাস (asyncio) |
একটা নেটওয়ার্ক কলের উত্তরের জন্য হাত গুটিয়ে বসে না থেকে একই সময়ে সমান্তরালভাবে হাজারটা টিকিট প্রসেস করার স্ট্রাটেজি। |
| ওয়েব্রিজ (Weighbridge) | বন্দর বা কারখানার গেটে ট্রাকসহ কন্টেইনারের আসল ওজন মাপার ডিজিটাল স্কেল। |
| থ্রি-ওয়ে রিকনসিলিয়েশন ও টলারেন্স | কাস্টমস বিল অব এন্ট্রি, সাপ্লায়ার ইনভয়েস এবং ওয়েব্রিজ স্কেলের স্লিপ - এই তিন ডকুমেন্টের হিসাব মেলানো এবং বাস্তবসম্মত ১% ওজনের ছাড় (Tolerance) মেনে নেওয়া। |
| ফিল্ড-টু-কোর লুপ | ক্লায়েন্টের অন-গ্রাউন্ডে বসে বানানো কাস্টম কোড থেকে রিইউজেবল অংশটুকু আলাদা করে কোম্পানির মূল প্রোডাক্ট প্ল্যাটফর্মে যুক্ত করার প্যালান্টিয়ার পদ্ধতি। |
| গোল্ডেন হ্যান্ডওভার ও রানবুক | ক্লায়েন্টের আইটি টিমকে প্রথম দিন থেকে সাথে রেখে শেখানো, এক পাতার বাংলা নির্দেশিকা (Runbook) দেওয়া এবং ফায়ার ড্রিলের মাধ্যমে দায়িত্ব হস্তান্তর করা। |
| হাইপার-কেয়ার (Hyper-Care) | সিস্টেম লাইভ হওয়ার পর প্রথম দুই-তিন সপ্তাহ নিবিড়ভাবে লগ মনিটর করা এবং কাস্টমার ফোন করার আগেই প্রোঅ্যাকটিভভাবে যেকোনো ক্র্যাশ বা ধীরগতি ঠিক করে দেওয়া। |
৪. পেজ বাজেট ও ওয়ার্ড কাউন্ট সামারি¶
প্রকাশকের সাড়ে বারো ফর্মার মুদ্রণ স্ট্যান্ডার্ড অনুযায়ী বইটার অধ্যায়ভিত্তিক পেজ বাজেট:
| চ্যাপ্টার ও সেকশন | পেজ টার্গেট | আনুমানিক ওয়ার্ড কাউন্ট |
|---|---|---|
| বইয়ের ইন্ট্রোডাকশন ও ব্যাকগ্রাউন্ড | ১৫ পেজ | ৪,০০০ ওয়ার্ড |
| চ্যাপ্টার ১: ফিল্ড ডিসকাভারি ও এসওপি অডিট | ৩০ পেজ | ৮,০০০ ওয়ার্ড |
| চ্যাপ্টার ২: লোকাল আর্কিটেকচার ও কোড প্রুফ | ৩৫ পেজ | ৯,৫০০ ওয়ার্ড |
| চ্যাপ্টার ৩: দ্য নিউ এসডিএলসি ও সিআই/সিডি | ৩৫ পেজ | ৯,৫০০ ওয়ার্ড |
| চ্যাপ্টার ৪: দুটো রিয়েল-ওয়ার্ল্ড কেস স্টাডি | ৪৫ পেজ | ১২,৫০০ ওয়ার্ড |
| চ্যাপ্টার ৫: টিম স্কেলিং ও ক্যারিয়ার স্কিলস | ২৫ পেজ | ৭,০০০ ওয়ার্ড |
| কনক্লুশন ও অ্যাপেন্ডিক্স রেফারেন্স | ১৫ পেজ | ৪,৫০০ ওয়ার্ড |
| টোটাল | ১৯৫-২০০ পেজ | ৫৫,০০০ ওয়ার্ড |