ডিজিটাল বই বিক্রয় প্ল্যাটফর্ম লারাভেল স্ক্রিপ্ট – Web Push Notification অ্যাডঅন

ডিজিটাল বই বিক্রয় প্ল্যাটফর্ম লারাভেল স্ক্রিপ্ট-এর Web Push Notification অ্যাডঅনটি ওয়েবসাইটের গ্রাহকদের Browser Notification পাঠানোর জন্য তৈরি। গ্রাহক Notification Permission দিলে একটি Firebase Device Token সফটওয়্যারে সংরক্ষণ হয়। এরপর ওয়েবসাইট বন্ধ থাকলেও সমর্থিত Browser ও Device-এ নতুন বই, অফার, Order Update, Payment Confirmation বা গুরুত্বপূর্ণ ঘোষণা পাঠানো যায়। অ্যাডঅন Firebase Cloud Messaging HTTP v1 API ব্যবহার করে। Frontend-এর জন্য Project ID, Web API Key, Auth Domain, Storage Bucket, Messaging Sender ID, App ID ও VAPID Key ব্যবহার করা হয়। Server-side Message পাঠাতে Service Account Client Email ও Private Key প্রয়োজন। Private Key থেকে Signed JWT তৈরি করে Google OAuth Access Token নেওয়া হয় এবং সেই Token দিয়ে FCM API-তে Message পাঠানো হয়। গ্রাহক Subscribe করলে Token-এর Hash, User ID, Browser/User Agent, IP, Enabled Status ও Last Seen Time সংরক্ষণ করা হয়। Login ছাড়া Anonymous Subscriber এবং Login করা Customer Device—দুই ধরনের Subscription রাখা যায়। Unsubscribe করলে Token Delete না করে Disabled করা হয়, যাতে History ও Duplicate Management সহজ থাকে। Invalid/Expired Token-এ FCM 400/404 দিলে Subscription স্বয়ংক্রিয়ভাবে Disabled করা যায়। প্রধান ফিচার ও ফাংশন ১. Web Push System চালু বা বন্ধ করা। ২. Firebase Project ID সংরক্ষণ করা। ৩. Firebase Web API Key সংরক্ষণ করা। ৪. Auth Domain সংরক্ষণ করা। ৫. Storage Bucket সংরক্ষণ করা। ৬. Messaging Sender ID সংরক্ষণ করা। ৭. Firebase App ID সংরক্ষণ করা। ৮. Web Push VAPID Key সংরক্ষণ করা। ৯. Service Account Client Email সংরক্ষণ করা। ১০. Service Account Private Key নিরাপদভাবে সংরক্ষণ করা। ১১. Public Firebase Config JSON প্রদান করা। ১২. Dynamic Firebase Messaging Service Worker প্রদান করা। ১৩. Browser Background Message গ্রহণ করা। ১৪. Notification Click করলে নির্ধারিত URL খোলা। ১৫. Customer Device Token Subscribe করা। ১৬. Token Hash দিয়ে Duplicate Subscription Update করা। ১৭. Login User ID-এর সঙ্গে Device যুক্ত করা। ১৮. Anonymous Subscriber সংরক্ষণ করা। ১৯. Browser ও IP তথ্য সংরক্ষণ করা। ২০. Last Seen Time আপডেট করা। ২১. User Unsubscribe করলে Subscription Disabled করা। ২২. Active Subscriber সংখ্যা দেখানো। ২৩. Registered Customer Device সংখ্যা দেখানো। ২৪. Admin Panel থেকে Broadcast Notification পাঠানো। ২৫. Notification Title নির্ধারণ করা। ২৬. Notification Body নির্ধারণ করা। ২৭. Click URL নির্ধারণ করা। ২৮. নির্দিষ্ট User-এর সব Device-এ Notification পাঠানো। ২৯. সব Active Subscriber-কে Batch করে Notification পাঠানো। ৩০. প্রতি Batch-এ Token ভাগ করে পাঠানো। ৩১. FCM HTTP v1 API ব্যবহার করা। ৩২. Service Account Private Key দিয়ে JWT তৈরি করা। ৩৩. Google OAuth Access Token সংগ্রহ ও Cache করা। ৩৪. Notification Icon ও Badge ব্যবহার করা। ৩৫. Custom Data String হিসেবে পাঠানো। ৩৬. প্রতিটি Token-এর Success/Failure গণনা করা। ৩৭. Push Log-এ Title, Body, URL, Payload ও Response সংরক্ষণ করা। ৩৮. Sent ও Failed Status সংরক্ষণ করা। ৩৯. Invalid/Expired Token স্বয়ংক্রিয়ভাবে Disabled করা। ৪০. নতুন Order তৈরি হলে Auto Notification Switch। ৪১. Payment Paid হলে Auto Notification Switch। ৪২. Order Status পরিবর্তন হলে Auto Notification Switch। ৪৩. Addon Active বা Configured না থাকলে Push Request বন্ধ করা। ৪৪. Firebase Private Key ভুল হলে পরিষ্কার Error প্রদান করা। অ্যাডমিন কী কী পাবেন Firebase-এর Client ও Server Credential Settings, Active Subscriber Statistics, Customer Device Statistics, Auto Notification Switch এবং Manual Broadcast Form পাবেন। Broadcast-এর Sent ও Failed সংখ্যা ফলাফলে দেখা যাবে। গ্রাহক কী সুবিধা পাবেন গ্রাহক Browser থেকে Notification অনুমতি দিতে বা বন্ধ করতে পারবেন। অনুমতি দেওয়া থাকলে Order Update, Payment Confirmation, নতুন বই বা Offer-এর Push Message পাবেন। Notification-এ ক্লিক করলে সংশ্লিষ্ট Order, Book বা Page খুলবে। Automatic Notification ব্যবহারের ক্ষেত্র নতুন Order গ্রহণ, Online Payment সফল, Order Confirmed, Processing, Courier-এ পাঠানো, Out for Delivery, Delivered, Cancelled বা Refunded Status; নতুন বই প্রকাশ; বিশেষ ছাড়; Maintenance Notice; এবং জরুরি Announcement। ডেলিভারি ও নিরাপত্তা Service Account Private Key Browser-এ পাঠানো হয় না। Browser শুধু Public Firebase Config ও VAPID Key পায়। Server Google OAuth Token তৈরি করে Message পাঠায়। Token Hash Duplicate শনাক্ত করতে ব্যবহৃত হয় এবং Push Response Log Audit-এর জন্য সংরক্ষিত থাকে। প্রয়োজনীয় কনফিগারেশন Firebase Project তৈরি করে Web App ও Cloud Messaging চালু করতে হবে। Web Config, VAPID Key এবং Service Account JSON থেকে Client Email ও Private Key নিতে হবে। Website HTTPS-এ চলা প্রয়োজন; Localhost ছাড়া অধিকাংশ Browser HTTP Site-এ Push Permission দেয় না। গুরুত্বপূর্ণ নোট সব Browser বা Device Web Push সমানভাবে সমর্থন করে না। User Permission না দিলে Notification পাঠানো যাবে না। Browser/OS Battery Policy, Notification Setting বা Firebase Delivery Policy-এর কারণে Message দেরিতে পৌঁছাতে পারে। লাইসেন্স তথ্য এই অ্যাডঅনের লাইসেন্স আজীবন। তবে সফটওয়্যারে ব্যবহার করার সময় লাইসেন্স সার্ভার থেকে লাইসেন্সটি সক্রিয় ও বৈধ কি না নিয়মিত যাচাই করা হবে। লাইসেন্স নিষ্ক্রিয়, বাতিল বা ডোমেইনের সঙ্গে মিল না থাকলে অ্যাডঅনের কার্যক্রম বন্ধ থাকবে।