আর্কিটেকচার

একটি পাইথন প্রসেস FastAPI প্যানেল এবং যেকোনো সংখ্যক বিচ্ছিন্ন ওয়ার্কস্পেস হোস্ট করে, প্রতিটি একটি Telethon ব্যবহারকারী-অ্যাকাউন্ট ক্লায়েন্টসহ। SQLite একটি শুধুমাত্র সংযোজনযোগ্য স্বাক্ষরিত ইভেন্ট জার্নাল এবং পরিবর্তনযোগ্য অপারেশনাল সেটিংস ধারণ করে। একটি এনক্রিপ্ট করা ভল্টে API ক্রেডেনশিয়াল, StringSession, এবং স্বাক্ষর কী সংরক্ষিত থাকে। ফ্রন্টএন্ডটি হল সাধারণভাবে বান্ডেল করা HTML/CSS/JavaScript: কোনো Node বিল্ড, CDN, বা রানিটাইম ফ্রন্টএন্ড ডাউনলোডের প্রয়োজন নেই।

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

প্রতিটি ওয়ার্কস্পেস একটি একাউন্ট গ্রহণ করে এবং এর নিজস্ব ডিরেক্টরি ও স্বাক্ষর পরিচয় থাকে। সামঞ্জস্যতার জন্য প্রধান ওয়ার্কস্পেস রুটে থাকে; অতিরিক্ত ওয়ার্কস্পেস profiles/<id>/ এ থাকে। একটি বেয়ারার টোকেন পুরো ইনস্টলেশন নিয়ন্ত্রণ করে; ওয়ার্কস্পেসগুলো আলাদা অনুমোদন টেন্যান্ট নয়। প্রক্রিয়া লক ডিরেক্টরিগুলোকে সুরক্ষিত রাখে; ডাটাবেস লক ইভেন্ট প্রবেশকে সিরিয়াল করে। প্রতিটি এপেন্ড FULL সিঙ্ক্রোনাস মোডে SQLite WAL-এ সিঙ্ক্রোনিকভাবে কমিট করে। ইভেন্ট আপডেট/ডিলিট ট্রিগার সাধারণ অ্যাপ্লিকেশন সম্পাদনা প্রতিরোধ করে; ফাইলসিস্টেম প্রশাসকরা ট্রাস্ট সীমানার মধ্যেই থাকে।

API অনুমোদন একটি বহনকারী টোকেন। লগইন অপারেশনগুলো সিরিয়ালাইজড এবং সময়-সীমাবদ্ধ। অ্যাকাউন্ট আপলোডগুলো একটি নিবেদিত 12 MiB এনকোড-বডি সীমা এবং 8 MiB ডিকোড-ফাইল সীমা ব্যবহার করে; সাধারণ API অনুরোধগুলো 16 KiB সীমা বজায় রাখে। রূপান্তর একটি কর্মী থ্রেডে চলে, আপলোডগুলো মেমরিতে রাখে, এবং যাচাইকৃত ব্রাউজারে স্বাভাবিকীকৃত ইনপুট ফেরত দেয়। QR লগইনের জন্য প্রতিটি ওয়ার্কস্পেসে একটি প্রার্থী, স্বল্পস্থায়ী শনাক্তকারী, অপেক্ষমাণ টাস্ক এবং স্পষ্ট বাতিলকরণ থাকে। শুধুমাত্র গৃহীত অনুমোদনই সক্রিয় ক্লায়েন্ট হয়। Telegram FloodWait একটি Retry-After মানের সাথে ফেরত আসে; API ত্রুটিতে ক্রেডেনশিয়াল এবং কাঁচা RPC ত্রুটির বার্তাগুলো প্রকাশ করা হয় না। এক্সপোর্টগুলো অ্যাসিঙ্ক ইভেন্ট লুপের বাইরে চলে এবং প্রতিটি ওয়ার্কস্পেস অনুযায়ী সিরিয়ালাইজ করা হয়। এগুলো একটি স্থিতিশীল রিড স্ন্যাপশট স্ট্রিম করে, এবং চলমান WAL লেখার সাথে সহাবস্থান করতে পারে। ওয়ার্কস্পেস কালেক্টররা প্রসেস/ইভেন্ট লুপ শেয়ার করে।

বর্তমান ইতিহাসের স্ন্যাপশট এবং লাইভ আপডেট একসঙ্গে থাকতে পারে। উভয়ই পৃথক পর্যবেক্ষণ, যেগুলো উৎস অনুযায়ী লেবেল করা হয়েছে; ডুপ্লিকেটগুলো নীরবে একত্রিত করা হয় না। অনুপস্থিত আইডি, মনগড়া মুছে ফেলা টেক্সট, জোরপূর্বক সদস্য তালিকাভুক্তি, বা স্বয়ংক্রিয় গ্রুপ যোগ করার ভিত্তিতে কোনো অনুমান প্রয়োগ করা হয়নি।

অপারেটর-সংক্রান্ত ব্যাখ্যার জন্য দেখুন সংগ্রহ কীভাবে কাজ করে এবং অ্যাকাউন্ট ও সেশন ফরম্যাটসমূহ।

নেটওয়ার্ক কনফিগারেশন এনক্রিপ্টেড ভল্টে সংরক্ষিত থাকে। একটি রুট প্রয়োগ করলে পুরনো ক্লায়েন্ট বন্ধ হয়ে যায় এবং অসম্পূর্ণ লগইন বাতিল হয়ে যায়; পরবর্তী সংযোগগুলো সরাসরি কোনো ফ্যালব্যাক ছাড়াই সেই রুট ব্যবহার করে। একটি নতুন বাহ্যিক-কী ইনস্টলেশন প্রতিটি ওয়ার্কস্পেসের ফারনেট কী HKDF-SHA256 ব্যবহার করে একটি মাস্টার কী ফাইল এবং সংরক্ষিত র‍্যান্ডম সল্ট থেকে তৈরি করে। এটি গোপনীয়তাকে ডেটা ডিরেক্টরি থেকে আলাদাভাবে সুরক্ষিত রাখে, প্লেনটেক্সট জার্নাল/মিডিয়া বিষয়বস্তু নয়।

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