🛡️ অ্যাডমিন প্যানেল — Firebase সেটআপ

প্রজেক্ট: gao-ghor · অ্যাডমিন প্যানেলের জন্য Auth, Firestore রুল ও হোস্টিংয়ের ধাপে ধাপে গাইড

এক নজরে

অ্যাডমিন প্যানেল চলতে তিনটি জিনিস লাগে: Email/Password লগইন, admins কালেকশনে আপনার UID, এবং সঠিক Firestore রুল। ছবির জন্য Storage লাগে না, কারণ ছবি লিংক হিসেবে দেওয়া হয়। কোনো কম্পোজিট ইনডেক্সও লাগে না।

কীকোথায়কেন
Email/Password লগইনAuthentication → Sign-in methodঅ্যাডমিন সাইন-ইন
অ্যাডমিন ইউজারAuthentication → Usersইমেইল ও পাসওয়ার্ড
admins/{UID} ডকুমেন্টFirestore Databaseপ্যানেল ও রুল এটা দেখে অ্যাডমিন চেনে
Firestore রুলFirestore → Rulesডেটা কে পড়বে ও লিখবে
প্যানেল হোস্টিংFirebase Hosting বা যেকোনো HTTPSfile:// থেকে লগইন ভরসাযোগ্য নয়

সেটআপ চেকলিস্ট

প্রতিটি ধাপ শেষ হলে টিক দিন। অগ্রগতি এই ব্রাউজারে সেভ থাকবে।

০
স্টোরফ্রন্টের রুলের সাথে মেলান
Firebase প্রজেক্টে একটাই রুল চলে। স্টোরফ্রন্টের (থিমের) firestore.rules থেকে সাইনআপ, অর্ডার ও চ্যাটের অংশ নিয়ে নিচের রুলে যোগ করুন। তারপর প্রকাশ করুন।
১
Email/Password লগইন চালু করুন
Authentication → Sign-in method → Email/Password → Enable।
২
অ্যাডমিন ইউজার তৈরি করুন
Authentication → Users → Add user। অ্যাডমিনের ইমেইল ও পাসওয়ার্ড দিন। তৈরি হওয়া ইউজারের User UID কপি করে রাখুন।
৩
Firestore Database তৈরি করুন
না থাকলে তৈরি করুন (Production mode)। লোকেশন একবার সেট হলে বদলানো যায় না। ঢাকার কাছের asia-southeast1 (Singapore) বা asia-south1 (Mumbai) বেছে নিন।
৪
admins কালেকশনে আপনার UID যোগ করুন
Firestore → Start collection → Collection ID: admins → Document ID হিসেবে নিচের UID বসান। কোনো ফিল্ড লাগবে না। চাইলে email ফিল্ড রাখতে পারেন।
admins/ + UID
৫
রুল প্রকাশ করুন
Firestore → Rules-এ বর্তমান রুল (বিশেষ করে allow read, write: if true বা টেস্ট মোড) মুছে স্টোরফ্রন্টের সাথে মেলানো রুল বসিয়ে Publish করুন। নিচের ২ নম্বর সেকশনে রুল আছে।
৬
প্যানেল HTTPS-এ হোস্ট করুন
Firebase Hosting বা যেকোনো HTTPS হোস্ট। ফাইল সরাসরি ডাবল-ক্লিক করে (file://) খুলবেন না।
৭
অ্যাডমিন হিসেবে লগইন ও টেস্ট
নিচের "টেস্ট করুন" সেকশনের সব ধাপ যাচাই করুন।

১. firestore.rules

Firestore → Rules-এ এই পুরো লেখা বসান (স্টোরফ্রন্টের অংশ মেলানোর পর)।

এটি খসড়া। "অনুমান" লেখা অংশগুলো স্টোরফ্রন্টের কোডের সাথে মিলিয়ে নিন। আমি এটি Firebase Emulator বা কনসোলে চালিয়ে যাচাই করিনি। Publish করার সময় কনসোল সিনট্যাক্স এরর দেখাবে।

২. firebase.json

শুধু Firebase CLI দিয়ে ডিপ্লয় করলে লাগবে। নির্দিষ্ট ফোল্ডারের ভেতরে রাখুন।

CLI দিয়ে ডিপ্লয়

৩. firestore.indexes.json

প্যানেলের কোনো কুয়েরিতে কম্পোজিট ইনডেক্স লাগে না। স্টোরফ্রন্টের "আমার অর্ডার" কুয়েরি যদি where uid ও orderBy createdAt একসাথে ব্যবহার করে, তাহলে ইনডেক্স লাগতে পারে। সেক্ষেত্রে এরর মেসেজের লিংকে ক্লিক করলেই ইনডেক্স তৈরি হবে।

৪. ফায়ারবেস কনফিগ (প্যানেলে আগে থেকেই আছে)

এই কনফিগ প্যানেলের HTML-এ বসানো আছে। Firebase web config গোপন রাখার জিনিস নয়। আসল সুরক্ষা আসে রুল থেকে।

৫. রুলের অনুমানগুলো যাচাই করুন

এগুলো স্টোরফ্রন্টের কোডের সাথে না মিললে রুল বদলাতে হবে।

অনুমানকী ভাঙতে পারে
চ্যাটের ডকুমেন্ট আইডি = কাস্টমারের UIDকাস্টমার নিজের চ্যাট পড়তে/লিখতে না পারলে
অর্ডার তৈরিতে status: 'pending' ও uid থাকেচেকআউট "permission denied" দিলে
চেকআউটে কাস্টমার নিজের পয়েন্ট শুধু কমায়পয়েন্ট ব্যবহারের অর্ডার ব্যর্থ হলে
সাইনআপে পয়েন্ট ১০-এর বেশি নয়, ওয়ালেট ও মোট কেনা শূন্যসাইনআপ ব্যর্থ হলে বা বোনাসের মান বদলালে
কাস্টমার রেফারারের ওয়ালেট বা পয়েন্ট বাড়ায় নারেফারাল বোনাস কাস্টমার-সাইড থেকে লিখলে

৬. টেস্ট করুন

প্রতিটি লাইন ডিপ্লয়ের পর যাচাই করুন।

অ্যাডমিন ইমেইলে লগইন হয় এবং ড্যাশবোর্ড ওঠে।
অ্যাডমিন নয় এমন অ্যাকাউন্টে লগইন করলে প্যানেল UID দেখায় এবং ডেটা আসে না।
নতুন প্রডাক্ট সেভ হয় এবং সাইটে দেখা যায়।
অর্ডারের স্ট্যাটাস "ডেলিভারড" করলে কাস্টমারের পয়েন্ট বাড়ে।
লগইন ছাড়া (incognito উইন্ডোতে) users ও orders পড়া যায় না।
কাস্টমার মেসেজ দিলে অ্যাডমিন প্যানেলের চ্যাটে আসে, এবং অ্যাডমিনের উত্তর কাস্টমার পায়।
কাস্টমার নিজের ওয়ালেট বা মোট কেনা বাড়াতে পারে না (ব্রাউজার কনসোল থেকে চেষ্টা করে দেখুন)।

৭. সমস্যা হলে

এররসম্ভাব্য কারণ ও সমাধান
Missing or insufficient permissionsadmins-এ UID ভুল বা নেই। অথবা রুল ঠিকভাবে প্রকাশ হয়নি। Rules Playground-এ টেস্ট করুন।
auth/unauthorized-domainAuthentication → Settings → Authorized domains-এ হোস্টের ডোমেইন যোগ করুন।
auth/invalid-credentialইমেইল বা পাসওয়ার্ড ভুল। Users তালিকায় ইউজার আছে কি না দেখুন।
The query requires an indexএরর মেসেজের লিংকে ক্লিক করে ইনডেক্স তৈরি করুন।
প্যানেল খালি বা লগইন কাজ করছে নাফাইল সরাসরি খুলে থাকলে HTTPS-এ হোস্ট করুন।