সারসংক্ষেপ, চিট শিট ও এরপর কী

এই টিউটোরিয়াল শুরু করার সময় আপনি Git ব্যবহার করেননি, সার্ভারও বানাননি। এখন আপনি টার্মিনালে কাজ করতে পারেন, প্রজেক্টকে Git হিস্ট্রিতে রাখতে পারেন, প্রকাশ করতে পারেন, Python থেকে নিরাপদে ওয়েব API কল করতে পারেন, FastAPI দিয়ে নিজের API বানিয়ে ভ্যালিডেট করতে পারেন, আর টেস্ট দিয়ে প্রমাণ করতে পারেন যে সেটা কাজ করে। এই পাতায় সবকিছু এক জায়গায়: কাজের সময় খুলে রাখার চিট শিট, একটা শব্দকোষ, যে ভুলগুলোতে নতুনদের সবচেয়ে বেশি সময় যায়, আর এরপর কী।

যা শিখবেন

• পুরো বিগিনার টিউটোরিয়ালের কমান্ড আর ধারণা এক পাতায়, কাজ ধরে সাজানো।
• AI ব্যাকএন্ডের কাজে বারবার সামনে আসবে এমন শব্দের শব্দকোষ।
• নিজেকে যাচাই করার জন্য সাধারণ ভুলের তালিকা, আর কীভাবে অনুশীলন চালিয়ে যাবেন।
• অ্যাডভান্সড টিউটোরিয়ালে কী আছে, আর AI পথ এরপর কোথায় যায়।

এখন আপনি যা পারেন

• টার্মিনালে চলাফেরা, এনভায়রনমেন্ট ভেরিয়েবল সেট করা, ভার্চুয়াল এনভায়রনমেন্ট বা uv প্রজেক্ট বানানো, আর সিক্রেট কোডের বাইরে রাখা।
• স্পষ্ট বার্তাসহ কমিট বানানো, হিস্ট্রি ও ডিফ পড়া, কাজ না হারিয়ে ভুল শোধরানো, আর ব্রাঞ্চ ও মার্জ ব্যবহার করা।
• রিমোটে push করা, পুল রিকোয়েস্ট খোলা, আর কাজের README লেখা।
• রিকোয়েস্ট ও রেসপন্স ব্যাখ্যা করা, ঠিক মেথড ও স্ট্যাটাস কোড বেছে নেওয়া, আর curl দিয়ে API পরীক্ষা করা।
• টাইমআউট, রিট্রাই ও পেজিনেশনসহ Python থেকে API কল করা, আর ইনপুট ভ্যালিডেট করে ঠিক এরর ফেরত দেওয়া FastAPI সার্ভিস বানানো।
• নকল আপস্ট্রিম দিয়ে pytest টেস্ট লেখা, আর রিভিউ হওয়া পুল রিকোয়েস্টের মাধ্যমে ফলাফল প্রকাশ করা।

চিট শিট ১: টার্মিনাল, এনভায়রনমেন্ট ও প্যাকেজ

চিট শিট ২: Git ও GitHub

টেবিলের বেশির ভাগের পেছনের নিয়ম: git restore আর git reset --hard আপনার ওয়ার্কিং ফোল্ডারের ফাইল বদলায়, git revert একটা নতুন কমিট যোগ করে, আর push না করা কমিট এখনো amend করা যায়। নিশ্চিত না হলে আগে একটা ব্রাঞ্চ বানিয়ে নিন: git switch -c backup-এ কোনো খরচ নেই।

চিট শিট ৩: HTTP, curl ও requests

প্রথম অঙ্কটা পরিবার: 2xx সফল, 3xx রিডাইরেক্ট, 4xx ক্লায়েন্ট ভুল করেছে, 5xx সার্ভার ভুল করেছে। তাই 4xx সাধারণত রিট্রাই করার যোগ্য নয়, কিন্তু 429 বা 503 তা-ই।

চিট শিট ৪: FastAPI, Pydantic ও pytest

রাউট ডেটা ফেরত দেয়, আর FastAPI সেটাকে ঠিক Content-Type-সহ JSON বানিয়ে দেয়। অবৈধ ইনপুট আপনার ফাংশন পর্যন্ত পৌঁছায় না: Pydantic সেটাকে 422 দিয়ে ফিরিয়ে দেয়, যেখানে প্রতিটা সমস্যা তালিকাভুক্ত। রিকোয়েস্টের জীবনচক্র সব ব্যাকএন্ডে একই: রিকোয়েস্ট পার্স করা, ভ্যালিডেট করা, নিজের লজিক চালানো, রেসপন্স সাজানো, স্ট্যাটাস কোড বসানো।

কোডে চিট শিট চেষ্টা করুন

যে চিট শিট শুধু পড়া হয়, এক সপ্তাহে ভুলে যাওয়া হয়। এই ছোট প্রোগ্রাম আপনাকে স্ট্যাটাস কোড নিয়ে কুইজ করে। এতে কোডের একটা নির্দিষ্ট তালিকা আছে, তাই যতবার চালান, উত্তর একই আসবে:

STATUS = {
    200: "OK",
    201: "Created",
    204: "No Content",
    400: "Bad Request",
    401: "Unauthorized",
    403: "Forbidden",
    404: "Not Found",
    409: "Conflict",
    422: "Unprocessable Content",
    429: "Too Many Requests",
    503: "Service Unavailable",
}

FAMILY = {2: "success", 3: "redirection", 4: "client error", 5: "server error"}

def describe(code):
    return f"{code} {STATUS[code]} ({FAMILY[code // 100]})"

def should_retry(code):
    # শুধু যে সমস্যা নিজে থেকে মিটে যেতে পারে, সেটাই রিট্রাই করার যোগ্য।
    return code in (429, 502, 503, 504)

for code in (200, 404, 422, 429, 503):
    print(describe(code), "-> retry" if should_retry(code) else "-> do not retry")

200 OK (success) -> do not retry
404 Not Found (client error) -> do not retry
422 Unprocessable Content (client error) -> do not retry
429 Too Many Requests (client error) -> retry
503 Service Unavailable (server error) -> retry

লক্ষ করুন, রিট্রাইয়ের নিয়মটা মাত্র একটা লাইন। নিয়মটা ফাংশন হিসেবে লিখে রাখা আর চিট শিটে লিখে রাখা একই অভ্যাস, শুধু ফাংশনটা আপনি টেস্ট করতে পারেন। দ্বিতীয় একটা হেল্পার, যা এই টিউটোরিয়ালকে একটা চেকলিস্টে বদলে দেয়, রিভিউ চাওয়ার আগে পুল রিকোয়েস্টের বিবরণে পেস্ট করার জন্য:

CHECKS = {
    "Code": ["Tests pass with the upstream faked", "Every outbound call has a timeout"],
    "Git": ["Small commits with clear messages", "No .env, .venv or data files in the diff"],
    "Docs": ["README explains what, run, use, test, configure"],
}

def checklist(title):
    lines = [f"## Ready to merge: {title}"]
    for area, items in CHECKS.items():
        lines.append(f"### {area}")
        lines.extend(f"- [ ] {item}" for item in items)
    return "\n".join(lines)

print(checklist("Data Explorer API"))

## Ready to merge: Data Explorer API
### Code
- [ ] Tests pass with the upstream faked
- [ ] Every outbound call has a timeout
### Git
- [ ] Small commits with clear messages
- [ ] No .env, .venv or data files in the diff
### Docs
- [ ] README explains what, run, use, test, configure

শব্দকোষ

সাধারণ ভুল: একটা পুনরালোচনা

• সিক্রেট কমিট করা। একবার push হলে সেটা ফাঁস, পরে ফাইল মুছলেও। সমাধান: আগে .gitignore, গড়ন দেখাতে .env.example, আর তবু হয়ে গেলে সবকিছুর আগে কি-টা রোটেট করুন।
• না দেখে git reset --hard বা rm -r চালানো। দুটোই চূড়ান্ত। সমাধান: আগে git status আর git diff, বা একটা ব্যাকআপ ব্রাঞ্চ।
• যে হিস্ট্রি অন্যদের কাছে আছে তা নতুন করে লেখা। push হওয়া কমিটে amend আর reset সহকর্মীদের ঝামেলায় ফেলে। সমাধান: শেয়ার করা ব্রাঞ্চে git revert।
• সরাসরি main-এ কাজ করা। সমাধান: প্রতিটা পরিবর্তনের জন্য একটা ব্রাঞ্চ, পুল রিকোয়েস্টের মাধ্যমে মার্জ।
• টাইমআউট ছাড়া API কল। একটা ধীর আপস্ট্রিম আপনার পুরো সার্ভিস আটকে দিতে পারে। সমাধান: প্রতিটা কলে টাইমআউট, আর তা ঘটলে স্পষ্ট এরর।
• সবকিছু রিট্রাই করা। 401 বা 422 আবার পাঠিয়ে লাভ নেই, আর রেট লিমিটেড সার্ভিসে ঝাঁপিয়ে পড়লে অবস্থা খারাপ হয়। সমাধান: শুধু 429, 5xx আর টাইমআউট রিট্রাই করুন, ব্যাকঅফসহ।
• আপস্ট্রিম যা ফেরত দেয় তা বিশ্বাস করা। ফিল্ড না থাকা, ভুল টাইপ, HTML এরর পেজ, সবই ঘটে। সমাধান: ব্যবহারের আগে Pydantic মডেল দিয়ে রেসপন্স ভ্যালিডেট করুন।
• ভুল স্ট্যাটাস কোড ফেরত দেওয়া। {"error": ...}-সহ 200 ক্লায়েন্ট ও মনিটরের কাছ থেকে ব্যর্থতা লুকিয়ে রাখে। সমাধান: 201, 404, 422 ও বাকিগুলোর অর্থ আছে; সেগুলো ব্যবহার করুন।
• শুধু সুখের পথ টেস্ট করা, বা আসল সার্ভিসের বিরুদ্ধে টেস্ট করা। সমাধান: আপস্ট্রিম নকল করুন, আর টাইমআউট, খারাপ ডেটা ও অবৈধ ইনপুটও টেস্ট করুন।
• কখনো নতুন ক্লোন থেকে না চালানো। সমাধান: শেষ বলার আগে ক্লোন, uv sync, uv run pytest।

অনুশীলন চালিয়ে যাবেন যেভাবে

• যা-ই লিখুন, Git-এ রাখুন, নোট আর ছোট স্ক্রিপ্টও। অভ্যাস আসে পুনরাবৃত্তি থেকে, পড়া থেকে নয়।
• Data Explorer API বাড়ান: নতুন একটা এন্ডপয়েন্ট, নতুন ফিল্টার, আরও একটা ব্যর্থতার কেস, প্রতিটার জন্য একটা ব্রাঞ্চ, একটা টেস্ট আর একটা পুল রিকোয়েস্ট।
• অন্যদের প্রজেক্ট পড়ুন: GitHub-এ পরিচিত একটা Python রিপোজিটরি খুলে তার README, .gitignore, টেস্ট আর কমিট হিস্ট্রি পড়ুন।
• ইচ্ছে করে ভাঙুন: Practice API বন্ধ করে আপনার টাইমআউট আর এরর দেখুন; ইচ্ছে করে একটা মার্জ কনফ্লিক্ট বানিয়ে মেটান; একটা ফেলনা রিপোজিটরিতে নকল সিক্রেট কমিট করে পরিষ্কার করার অনুশীলন করুন।
• আপনার পছন্দের একটা API (আবহাওয়া সার্ভিস, পাবলিক ডেটাসেট) নিজের ছোট FastAPI সার্ভিসে মুড়ে নিন, ভ্যালিডেশন আর টেস্টসহ।
• অন্য কাউকে বলার আগে নিজের পুল রিকোয়েস্ট নিজে রিভিউ করুন, প্রজেক্টের চেকলিস্ট ধরে।

এরপর কী

পরের টিউটোরিয়াল AI-এর জন্য Git, API ও ব্যাকএন্ড: অ্যাডভান্সড। এটা একই টুলগুলোকে প্রোডাকশন স্তরে নিয়ে যায়, ছয়টা অধ্যায়ে:

1. পেশাদারের মতো Git ও GitHub: stash, ইন্টারঅ্যাক্টিভ rebase, cherry-pick, reflog, ট্যাগ ও রিলিজ, টিমের ওয়ার্কফ্লো, আর AI প্রজেক্টের জন্য Git (LFS, DVC, ফাঁস হওয়া সিক্রেট সরানো)।
2. API ডিজাইন ও API ক্লায়েন্ট: HTTP গভীরভাবে, OAuth ও টোকেন, পেজিনেশন, রেট লিমিট, আইডেমপোটেন্সি, ওয়েবহুক ও স্ট্রিমিং, আর httpx ও async ক্লায়েন্ট।
3. প্রোডাকশন FastAPI: প্রজেক্টের আর্কিটেকচার, ডিপেন্ডেন্সি ও lifespan, মিডলওয়্যার, SQLAlchemy ও Alembic, অথেনটিকেশন, ক্যাশিং ও রেট লিমিটিং, আর পেশাদার টেস্টিং।
4. AI সার্ভিস ও নিরাপত্তা: মেশিন লার্নিং মডেল সার্ভ করা, স্ট্রিমিং ও খরচ ট্র্যাকিংসহ LLM অ্যাপ্লিকেশনের ব্যাকএন্ড, আর API নিরাপত্তা।
5. চালু করুন: Docker, Docker Compose, GitHub Actions আর ডিপ্লয়মেন্ট।
6. অনুশীলন ও ক্যাপস্টোন: নম্বর দেওয়া একটা প্র্যাকটিস ল্যাব, আর একটা ক্যাপস্টোন: প্রোডাকশন-প্রস্তুত একটা AI ব্যাকএন্ড।

তারপর পথ এগোয় Prompt Engineering-এ, যেখানে শেখা হয় LLM থেকে নির্ভরযোগ্য ফল পাওয়া, আর তারপর AI Engineer পথে: LLM API, RAG, এজেন্ট, MCP, ইভ্যালুয়েশন ও LLMOps। এর প্রতিটা বিষয় দাঁড়িয়ে আছে আপনি এখানে যা অনুশীলন করেছেন তার ওপর: নিরাপদে API কল করা, নিজের API সার্ভ করা, আর টেস্ট ও পরিচ্ছন্ন Git হিস্ট্রিসহ সেটা চালু করা।

সারসংক্ষেপ

• টার্মিনাল, এনভায়রনমেন্ট ও uv প্রতিটা প্রজেক্টকে নিজস্ব টুল দেয় আর সিক্রেট কোডের বাইরে রাখে।
• Git স্ন্যাপশট রাখে; ব্রাঞ্চ, পুল রিকোয়েস্ট আর রিভিউ নিরাপদে বদলাতে দেয়, আর restore, reset ও revert ভুল শোধরায়।
• HTTP মানে মেথড, স্ট্যাটাস কোড, হেডার আর বডি; curl ও requests দিয়ে তাতে কথা বলা যায়, প্রতিবার একটা টাইমআউট, একটা রিট্রাইয়ের নিয়ম আর ভ্যালিডেশনসহ।
• FastAPI ও Pydantic Python ফাংশনকে ঠিক স্ট্যাটাস কোডসহ ভ্যালিডেটেড এন্ডপয়েন্ট বানায়; নকল আপস্ট্রিমসহ pytest সেগুলোকে সৎ রাখে।
• আসল প্রজেক্টে অনুশীলন করুন, আর যখন পাতা না খুলেই Data Explorer API শূন্য থেকে বানাতে পারবেন, তখন অ্যাডভান্সড টিউটোরিয়ালে এগিয়ে যান।

এরপর: AI-এর জন্য Git, API ও ব্যাকএন্ড: অ্যাডভান্সড, তারপর Prompt Engineering।