প্রকল্প সম্পর্কে

এই রিপোজিটরিটি কাটানা ম্যানুফ্যাকচারিং ERP API-এর জন্য একটি বহু-ভাষা ক্লায়েন্ট ইকোসিস্টেম প্রদান করে, যার মধ্যে Python এবং TypeScript ক্লায়েন্ট এবং একটি আলফা মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভার অন্তর্ভুক্ত। সমস্ত ক্লায়েন্ট OpenAPI 3.1.0 স্পেসিফিকেশন থেকে তৈরি এবং স্বয়ংক্রিয় রিট্রাই, রেট লিমিট হ্যান্ডলিং এবং স্মার্ট পেজিনেশন বৈশিষ্ট্যযুক্ত। Python ক্লায়েন্ট সম্পূর্ণ Pydantic টাইপ সেফটি সহ সিঙ্ক এবং অ্যাসিঙ্ক উভয় অপারেশন সমর্থন করে, যখন TypeScript ক্লায়েন্ট সম্পূর্ণ টাইপ সেফটি এবং ব্রাউজার সমর্থন সহ শুধুমাত্র অ্যাসিঙ্ক। MCP সার্ভারটি উচ্চ-স্তরের টুলগুলির একটি কিউরেটেড সাবসেট (অনুসন্ধান, পরিবর্তন, পূরণ, যাচাই) মোড়ানো করে এবং লেখার অপারেশনগুলির জন্য প্রিভিউ/অ্যাপ্লাই জোড়া অন্তর্ভুক্ত করে, যা Claude এবং Cursor-এর মতো AI সহায়কদের সাথে ইন্টিগ্রেশন সক্ষম করে। কনফিগারেশন পরিবেশ ভেরিয়েবল, .env ফাইল বা সরাসরি প্যারামিটারের মাধ্যমে নমনীয়। প্রকল্পটি একটি মনোরেপো হিসাবে গঠিত যেখানে ভাগ করা ডকুমেন্টেশন, আর্কিটেকচার ডিসিশন রেকর্ড এবং uv ব্যবহার করে একটি ইউনিফাইড বিল্ড সিস্টেম রয়েছে। ডেভেলপমেন্টে প্রি-কমিট হুক, স্বয়ংক্রিয় রিলিজের জন্য কনভেনশনাল কমিট এবং ব্যাপক টেস্টিং অন্তর্ভুক্ত।