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

cb365 Microsoft 365 পরিষেবাগুলোর জন্য কম্যান্ড-লাইন অ্যাক্সেস প্রদান করে, কাস্টম Graph API অ্যাপ্লিকেশন লেখা বা ম্যানুয়াল UI মিথস্ক্রিয়ার বিকল্প হিসেবে কাজ করে। এটি টাস্ক তৈরি, মেইল পাঠানো, ক্যালেন্ডার পরিচালনা, Teams-এ পোস্ট করা এবং SharePoint, OneDrive, Planner ও Loop-এর সাথে মিথস্ক্রিয়া করার মতো স্বয়ংক্রিয়করণের সুবিধা দেয়। টুলটি কাঠামোগত JSON আউটপুট প্রদান করে, যা স্ক্রিপ্ট এবং AI এজেন্ট দ্বারা ব্যবহারের জন্য উপযুক্ত। প্রধান বৈশিষ্ট্য এবং লক্ষ্য শ্রেণিবিভাগগুলো হলো: * **DevOps এবং প্ল্যাটফর্ম ইঞ্জিনিয়ার**: CI থেকে টাস্ক তৈরি বা Teams-এ বিল্ড ফলাফল পোস্ট করার মতো M365 অপারেশন স্ক্রিপ্ট করার জন্য। * **AI এজেন্ট বিল্ডার**: স্বয়ংক্রিয় ওয়ার্কফ্লোয়ের জন্য `--json` আউটপুট এবং নিরাপত্তা ফ্ল্যাগসহ ডিজাইন করা হয়েছে। * **IT অ্যাডমিন**: Graph API অপারেশনের জন্য PowerShell-এর একটি CLI বিকল্প। * **ডেভেলপার**: সাধারণ M365 কাজের জন্য Graph SDK কোডের বয়েলারপ্লেট হ্রাস করে। cb365 Microsoft Graph API-কে র‍্যাপ করে, নিম্নলিখিত জটিলতাগুলো সামলায়: * **প্রমাণীকরণ**: ডিভাইস-কোড, ক্লায়েন্ট ক্রেডেনশিয়াল এবং সার্টিফিকেট ফ্লো সমর্থন করে, টোকেনগুলো OS কিচেইনে নিরাপদে সংরক্ষণ করে। * **নিরাপত্তা**: ৪৪টি হার্ডকোডেড নিয়ম অন্তর্ভুক্ত করে, ডিলিটের জন্য `--force` এবং ব্রডকাস্টের জন্য `--confirm` প্রয়োজন হয়, সমস্ত রাইট অপারেশনের জন্য `--dry-run` উপলব্ধ। টোকেনগুলো কখনোই আউটপুটে প্রকাশ করা হয় না। * **আউটপুট**: পাইপলাইন ইন্টিগ্রেশনের জন্য ডিজাইন করা `--json`, `--plain` (TSV) এবং মানব-পাঠযোগ্য টেবিল ফরম্যাট প্রদান করে। * **প্রোফাইল**: ডেলিগেটেড এবং অ্যাপ-অনলি প্রমাণীকরণ পাশাপাশি পরিচালনা করে, সহজে টেন্যান্ট সুইচ করার সুযোগ দেয়। * **কোনো নির্ভরতা নেই**: কোনো রানটাইম প্রয়োজনীয়তা ছাড়াই একটি সিঙ্গেল Go বাইনারি। ইনস্টলেশন `go install` বা প্রি-বিল্ট রিলিজ বাইনারির মাধ্যমে পাওয়া যায়। ব্যবহারকারীদের অবশ্যই একটি Entra ID অ্যাপ নিবন্ধন করতে হবে এবং প্রয়োজনীয় API অনুমতি কনফিগার করতে হবে। প্রমাণীকরণ ইন্টারঅ্যাক্টিভ ব্যবহারের জন্য ডেলিগেটেড (ডিভাইস কোড) এবং অনঅ্যাটেন্ডেড অটোমেশনের জন্য অ্যাপ-অনলি (ক্লায়েন্ট সিক্রেট বা সার্টিফিকেট) সমর্থন করে, নিরাপত্তার জন্য ক্লায়েন্ট সিক্রেট শুধুমাত্র স্ট্যান্ডার্ড ইনপুট থেকে গ্রহণ করা হয়। বিভিন্ন M365 ওয়ার্কলোডের জন্য কম্যান্ড উপলব্ধ: * **Auth**: লগইন, স্ট্যাটাস, লগআউট, প্রোফাইল পরিচালনা। * **To Do**: টাস্ক লিস্ট এবং টাস্ক তালিকাভুক্ত, তৈরি, আপডেট, সম্পন্ন এবং ডিলিট করা। * **Mail**: মেসেজ তালিকাভুক্ত, পাওয়া, পড়া হিসেবে চিহ্নিত, সরানো, স্থায়ীভাবে ডিলিট, ড্রাফট, পাঠানো এবং অনুসন্ধান করা। * **Calendar**: ইভেন্ট তালিকাভুক্ত, পাওয়া, তৈরি, আপডেট এবং ডিলিট করা। * **Contacts**: কন্টাক্ট তালিকাভুক্ত, পাওয়া, অনুসন্ধান, তৈরি এবং আপডেট করা। * **Planner**: প্ল্যান তালিকাভুক্ত, প্ল্যান তৈরি, বাকিট পরিচালনা এবং টাস্ক পরিচালনা করা। * **Teams**: চ্যানেল তালিকাভুক্ত, চ্যানেল এবং চ্যাটে মেসেজ পাঠানো এবং চ্যানেল মেসেজ সফট-ডিলিট করা। * **SharePoint**: সাইট তালিকা/অনুসন্ধান, সাইট বিবরণী পাওয়া, লিস্ট এবং লিস্ট আইটেম পরিচালনা এবং ফাইল পরিচালনা (তালিকাভুক্ত, পাওয়া, আপলোড)। * **OneDrive**: ফাইল তালিকাভুক্ত, পাওয়া, আপলোড, ডিলিট করা এবং ফোল্ডার তৈরি করা। * **Loop**: ওয়ার্কস্পেস এবং পৃষ্ঠা তালিকাভুক্ত, পৃষ্ঠা ডাউনলোড/এক্সপোর্ট, পৃষ্ঠা ডিলিট, ফাইল আপলোড এবং ফোল্ডার তৈরি করা। গ্লোবাল ফ্ল্যাগসমূহের মধ্যে রয়েছে `--json`, `--plain`, `--profile`, `--dry-run` এবং `--verbose`। টুলটি ফাইল বা স্টডিন থেকে পরোক্ষ মান সমর্থন করার মাধ্যমে প্রসেস আর্গুমেন্টে ব্যবসায়িক বিষয়বস্তু রাখা এড়িয়ে চলার উপর জোর দেয়। নিরাপত্তা নিয়মগুলো হার্ডকোডেড, যা রাইট প্রোটেকশন, ক্যালেন্ডার-নির্দিষ্ট নিয়ম (যেমন, টাইমজোন যাচাইকরণ, ডুপ্লিকেট শনাক্তকরণ, অ্যাটেন্ডি সংখ্যার গার্ড), মেইল নিরাপত্তা (যেমন, পাঠানোর জন্য `--confirm`, প্রাপক সংখ্যার গার্ড) এবং টোকেন নিরাপত্তা (নিরাপদ সংরক্ষণ, আউটপুট এক্সপোজার নেই) অন্তর্ভুক্ত করে। AI এজেন্ট ইন্টিগ্রেশনের জন্য, `--json` আউটপুট কাঠামোগত ডেটা প্রদান করে। এজেন্টদের M365 বিষয়বস্তুকে অবিশ্বস্ত ডেটা হিসেবে গণ্য করতে এবং সাইড ইফেক্টের জন্য কম্যান্ড এবং কনফার্মেশন ফ্ল্যাগের স্পষ্ট অ্যালাউলিস্ট ব্যবহার করার পরামর্শ দেওয়া হয়। এরর হ্যান্ডলিং স্ট্যান্ডার্ড Unix এক্সিট কোড ব্যবহার করে, এররগুলো stderr-এ প্রিন্ট করা হয়।