১. শুরু করার আগে
Cloud Firestore ও Cloud Functions-এর মতো সার্ভারলেস ব্যাকএন্ড টুল ব্যবহার করা খুব সহজ হলেও, টেস্ট করা কঠিন হতে পারে। Firebase লোকাল ইমুলেটর সুইট আপনাকে ডেভেলপমেন্ট মেশিনে এইসব পরিষেবার লোকাল ভার্সন রান করার অনুমতি দেয় যাতে আপনি দ্রুত ও নিরাপদে অ্যাপ ডেভেলপ করতে পারেন।
পূর্বশর্ত
- Visual Studio Code, Atom বা Sublime Text-এর মতো সাধারণ এডিটর
- Node.js 10.0.0 বা তার পরবর্তী যেকোনও ভার্সন (Node.js ইনস্টল করতে, nvm ব্যবহার করুন, আপনার ভার্সন চেক করতে,
node --versionরান করুন) - Java 7 বা তার পরবর্তী ভার্সন (Java ইনস্টল করতে এই নির্দেশাবলী ব্যবহার করুন, আপনার ভার্সন চেক করতে
java -versionরান করুন)
আপনি কী করবেন
এই কোডল্যাবে, আপনি একটি সাধারণ অনলাইন শপিং অ্যাপ রান ও ডিবাগ করবেন যা একাধিক Firebase পরিষেবা দ্বারা পরিচালিত:
- Cloud Firestore: বিশ্বব্যাপী স্কেলেবল, সার্ভারলেস, রিয়েল-টাইম ক্ষমতা সহ NoSQL ডেটাবেস।
- Cloud Functions: একটি সার্ভারলেস ব্যাকএন্ড কোড যা ইভেন্ট বা HTTP অনুরোধের উত্তরে রান করে।
- Firebase Authentication: একটি ম্যানেজ করা যাচাইকরণ পরিষেবা যা অন্যান্য Firebase প্রোডাক্টের সাথে ইন্টিগ্রেট করে।
- Firebase হোস্টিং: ওয়েব অ্যাপের জন্য দ্রুত ও সুরক্ষিত হোস্টিং।
লোকাল ডেভেলপমেন্ট চালু করতে আপনি অ্যাপটিকে Emulator Suite-এর সাথে কানেক্ট করবেন।

এছাড়াও, আপনি কীভাবে এগুলি করবেন তা জানতে পারবেন:
- কীভাবে আপনার অ্যাপ ইমুলেটর সুইটের সাথে কানেক্ট করবেন এবং বিভিন্ন ইমুলেটর কীভাবে কানেক্ট করা হয়।
- Firebase Security Rules কীভাবে কাজ করে এবং লোকাল এমুলেটরের মাধ্যমে Firestore Security Rules কীভাবে পরীক্ষা করতে হয়।
- Firestore ইভেন্টের মাধ্যমে ট্রিগার করা Firebase ফাংশন কীভাবে লিখতে হয় এবং Emulator Suite-এর সাথে কাজ করে এমন ইন্টিগ্রেশন টেস্ট কীভাবে লিখতে হয়।
২. সেট-আপ করুন
সোর্স কোড পান
এই কোডল্যাবে, আপনি The Fire Store স্যাম্পেলের একটি ভার্সন দিয়ে শুরু করবেন যা প্রায় সম্পূর্ণ, তাই আপনাকে প্রথমে যা করতে হবে তা হল সোর্স কোড ক্লোন করা:
$ git clone https://github.com/firebase/emulators-codelab.git
তারপর কোডল্যাব ডিরেক্টরিতে যান, যেখানে আপনি এই কোডল্যাবের বাকি অংশের জন্য কাজ করবেন:
$ cd emulators-codelab/codelab-initial-state
এখন, ডিপেন্ডেন্সি ইনস্টল করুন যাতে আপনি কোড রান করতে পারেন। আপনার ইন্টারনেট কানেকশন স্লো হলে, এটি করতে এক বা দুই মিনিট সময় লাগতে পারে:
# Move into the functions directory
$ cd functions
# Install dependencies
$ npm install
# Move back into the previous directory
$ cd ../
Firebase CLI পান
ইমুলেটর সুইট হল Firebase CLI (কমান্ড-লাইন ইন্টারফেস)-এর অংশ যা আপনার মেশিনে নিম্নলিখিত কমান্ডের মাধ্যমে ইনস্টল করা যেতে পারে:
$ npm install -g firebase-tools
এরপর, আপনার কাছে CLI-এর লেটেস্ট ভার্সন আছে কিনা তা কনফার্ম করুন। এই কোডল্যাব 9.0.0 বা তার পরের যেকোনও ভার্সনে কাজ করবে, তবে পরবর্তী ভার্সনে আরও বেশি ত্রুটি সমাধান করা হয়েছে।
$ firebase --version 9.6.0
আপনার Firebase প্রোজেক্টের সাথে কানেক্ট করুন
Firebase প্রোজেক্ট তৈরি করা
- আপনার Google অ্যাকাউন্ট ব্যবহার করে Firebase কনসোলে সাইন-ইন করুন।
- নতুন প্রোজেক্ট তৈরি করতে বোতামে ক্লিক করুন এবং তারপর প্রোজেক্টের নাম লিখুন (যেমন,
Emulators Codelab)।
- চালিয়ে যান বিকল্পে ক্লিক করুন।
- প্রম্পট করা হলে, Firebase-এর শর্তাবলী পর্যালোচনা করে সম্মতি জানান এবং তারপরে চালিয়ে যান বিকল্পে ক্লিক করুন।
- (ঐচ্ছিক) Firebase কনসোলে AI অ্যাসিস্ট্যান্স চালু করুন (যাকে "Firebase-এ Gemini" বলা হয়)।
- এই কোডল্যাবের জন্য, আপনার Google Analytics-এর প্রয়োজন নেই, তাই Google Analytics বিকল্পটি টগল করে বন্ধ করুন।
- প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করুন, আপনার প্রোজেক্টের প্রভিশন হওয়ার জন্য অপেক্ষা করুন এবং তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।
আপনার Firebase প্রোজেক্টে কোড কানেক্ট করুন
এখন আপনার Firebase প্রোজেক্টের সাথে এই কোড কানেক্ট করতে হবে। Firebase CLI-তে লগ-ইন করতে প্রথমে নিম্নলিখিত কমান্ড রান করুন:
$ firebase login
এরপর প্রোজেক্টের উপনাম তৈরি করতে এই কমান্ড রান করুন। $YOUR_PROJECT_ID-এর জায়গায় আপনার Firebase প্রোজেক্টের আইডি লিখুন।
$ firebase use $YOUR_PROJECT_ID
এখন আপনি অ্যাপটি চালানোর জন্য প্রস্তুত!
৩. ইমুলেটর রান করুন
এই বিভাগে, আপনি অ্যাপটি লোকালি রান করবেন। এর অর্থ হল, Emulator Suite বুট আপ করার সময় হয়ে গেছে।
ইমুলেটর চালু করুন
কোডল্যাব সোর্স ডিরেক্টরির ভিতর থেকে, এমুলেটর শুরু করতে নিম্নলিখিত কমান্ডটি চালান:
$ firebase emulators:start --import=./seed
আপনি এই ধরনের কিছু আউটপুট দেখতে পাবেন:
$ firebase emulators:start --import=./seed i emulators: Starting emulators: auth, functions, firestore, hosting ⚠ functions: The following emulators are not running, calls to these services from the Functions emulator will affect production: database, pubsub i firestore: Importing data from /Users/samstern/Projects/emulators-codelab/codelab-initial-state/seed/firestore_export/firestore_export.overall_export_metadata i firestore: Firestore Emulator logging to firestore-debug.log i hosting: Serving hosting files from: public ✔ hosting: Local server: http://127.0.0.1:5000 i ui: Emulator UI logging to ui-debug.log i functions: Watching "/Users/samstern/Projects/emulators-codelab/codelab-initial-state/functions" for Cloud Functions... ✔ functions[calculateCart]: firestore function initialized. ┌─────────────────────────────────────────────────────────────┐ │ ✔ All emulators ready! It is now safe to connect your app. │ │ i View Emulator UI at http://127.0.0.1:4000 │ └─────────────────────────────────────────────────────────────┘ ┌────────────────┬────────────────┬─────────────────────────────────┐ │ Emulator │ Host:Port │ View in Emulator UI │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Authentication │ 127.0.0.1:9099 │ http://127.0.0.1:4000/auth │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Functions │ 127.0.0.1:5001 │ http://127.0.0.1:4000/functions │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Firestore │ 127.0.0.1:8080 │ http://127.0.0.1:4000/firestore │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Hosting │ 127.0.0.1:5000 │ n/a │ └────────────────┴────────────────┴─────────────────────────────────┘ Emulator Hub running at 127.0.0.1:4400 Other reserved ports: 4500 Issues? Report them at https://github.com/firebase/firebase-tools/issues and attach the *-debug.log files.
আপনি সব এমুলেটর চালু হয়ে গেছে মেসেজটি দেখতে পেলে, অ্যাপটি ব্যবহার করার জন্য প্রস্তুত।
এমুলেটরের সাথে ওয়েব অ্যাপ কানেক্ট করুন
লগের টেবিল থেকে আমরা দেখতে পাচ্ছি যে Cloud Firestore এমুলেটর পোর্ট 8080-এ এবং Authentication এমুলেটর পোর্ট 9099-এ শুনছে।
┌────────────────┬────────────────┬─────────────────────────────────┐ │ Emulator │ Host:Port │ View in Emulator UI │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Authentication │ 127.0.0.1:9099 │ http://127.0.0.1:4000/auth │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Functions │ 127.0.0.1:5001 │ http://127.0.0.1:4000/functions │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Firestore │ 127.0.0.1:8080 │ http://127.0.0.1:4000/firestore │ ├────────────────┼────────────────┼─────────────────────────────────┤ │ Hosting │ 127.0.0.1:5000 │ n/a │ └────────────────┴────────────────┴─────────────────────────────────┘
প্রোডাকশনের পরিবর্তে আপনার ফ্রন্টএন্ড কোড এমুলেটরের সাথে কানেক্ট করা যাক। public/js/homepage.js ফাইলটি খুলুন এবং onDocumentReady ফাংশনটি খুঁজুন। আমরা দেখতে পাচ্ছি যে কোডটি স্ট্যান্ডার্ড Firestore এবং Auth ইনস্ট্যান্স অ্যাক্সেস করে:
public/js/homepage.js
const auth = firebaseApp.auth();
const db = firebaseApp.firestore();
আসুন, লোকাল এমুলেটর পয়েন্ট করতে db এবং auth অবজেক্ট আপডেট করি:
public/js/homepage.js
const auth = firebaseApp.auth();
const db = firebaseApp.firestore();
// ADD THESE LINES
if (location.hostname === "127.0.0.1") {
console.log("127.0.0.1 detected!");
auth.useEmulator("http://127.0.0.1:9099");
db.useEmulator("127.0.0.1", 8080);
}
এখন আপনার লোকাল মেশিনে অ্যাপটি রান করার সময় (হোস্টিং এমুলেটর দ্বারা পরিবেশিত) Firestore ক্লায়েন্ট প্রোডাকশন ডেটাবেসের পরিবর্তে লোকাল এমুলেটরকে পয়েন্ট করে।
EmulatorUI খুলুন
আপনার ওয়েব ব্রাউজারে, http://127.0.0.1:4000/ লিঙ্কে যান। আপনি Emulator Suite UI দেখতে পাবেন।

Firestore এমুলেটরের UI দেখতে ক্লিক করুন। --import ফ্ল্যাগ সহ ডেটা ইমপোর্ট করার কারণে items সংগ্রহে আগে থেকেই ডেটা রয়েছে।

৪. অ্যাপটি চালান
অ্যাপটি খুলুন
আপনার ওয়েব ব্রাউজারে, http://127.0.0.1:5000 লিঙ্কে যান এবং আপনার মেশিনে Fire Store স্থানীয়ভাবে রান করছে কিনা তা দেখুন!

অ্যাপ ব্যবহার করুন
হোমপেজ থেকে কোনও আইটেম বেছে নিয়ে কার্টে যোগ করুন বিকল্পে ক্লিক করুন। আপনি নিম্নলিখিত সমস্যার সম্মুখীন হবেন:

আসুন, সেই সমস্যার সমাধান করা যাক! যেহেতু এমুলেটরে সবকিছু চলছে, তাই আমরা পরীক্ষা করতে পারি এবং আসল ডেটা প্রভাবিত হওয়ার ব্যাপারে চিন্তা করতে হয় না।
৫. অ্যাপ ডিবাগ করুন
সমস্যাটি খুঁজুন
ঠিক আছে, Chrome ডেভেলপার কনসোলে দেখা যাক। কনসোলে সমস্যা দেখতে Control+Shift+J (Windows, Linux, Chrome OS) বা Command+Option+J (Mac) প্রেস করুন:

মনে হচ্ছে addToCart পদ্ধতিতে কোনও সমস্যা হয়েছে, আসুন সেটি দেখে নেওয়া যাক। আমরা কোথায় সেই পদ্ধতিতে uid নামক কিছু অ্যাক্সেস করার চেষ্টা করি এবং কেন এটি null হবে? বর্তমানে public/js/homepage.js-এ পদ্ধতিটি এরকম দেখায়:
public/js/homepage.js
addToCart(id, itemData) {
console.log("addToCart", id, JSON.stringify(itemData));
return this.db
.collection("carts")
.doc(this.auth.currentUser.uid)
.collection("items")
.doc(id)
.set(itemData);
}
Aha! আমরা অ্যাপে সাইন-ইন করিনি। Firebase Authentication ডকুমেন্ট অনুযায়ী, আমরা সাইন-ইন না করলে, auth.currentUser হল null। আসুন, এর জন্য একটি চেক যোগ করি:
public/js/homepage.js
addToCart(id, itemData) {
// ADD THESE LINES
if (this.auth.currentUser === null) {
this.showError("You must be signed in!");
return;
}
// ...
}
অ্যাপ টেস্ট করুন
এখন, পৃষ্ঠাটি রিফ্রেশ করুন এবং তারপরে কার্টে যোগ করুন বিকল্পে ক্লিক করুন। এবার আপনি আরও ভালভাবে বুঝতে পারবেন এমন একটি সমস্যার মেসেজ দেখতে পাবেন:

কিন্তু আপনি যদি উপরের টুলবারে সাইন-ইন করুন বিকল্পে ক্লিক করেন এবং তারপরে আবার কার্টে যোগ করুন বিকল্পে ক্লিক করেন, তাহলে আপনি দেখতে পাবেন যে কার্ট আপডেট করা হয়েছে।
তবে, নম্বরগুলি একেবারেই সঠিক বলে মনে হচ্ছে না:

চিন্তা করবেন না, আমরা শীঘ্রই এই সমস্যার সমাধান করব। প্রথমে, আপনি কার্টে আইটেম যোগ করার সময় আসলে কী হয়েছে তা বিস্তারিতভাবে জেনে নেওয়া যাক।
৬. স্থানীয় ফাংশন ট্রিগার
কার্টে যোগ করুন বিকল্পে ক্লিক করলে, একাধিক এমুলেটর সহ ইভেন্টের একটি চেইন শুরু হয়। Firebase CLI লগে, আপনার কার্টে কোনও আইটেম যোগ করার পরে আপনি নিম্নলিখিত মেসেজের মতো কিছু দেখতে পাবেন:
i functions: Beginning execution of "calculateCart" i functions: Finished "calculateCart" in ~1s
এই লগ এবং আপনি যে UI আপডেট দেখেছেন তা তৈরি করার জন্য চারটি মূল ইভেন্ট ঘটেছে:

১) Firestore Write - ক্লায়েন্ট
Firestore সংগ্রহ /carts/{cartId}/items/{itemId}/-এ একটি নতুন ডকুমেন্ট যোগ করা হয়েছে। আপনি এই কোডটি public/js/homepage.js-এর মধ্যে addToCart ফাংশনে দেখতে পাবেন:
public/js/homepage.js
addToCart(id, itemData) {
// ...
console.log("addToCart", id, JSON.stringify(itemData));
return this.db
.collection("carts")
.doc(this.auth.currentUser.uid)
.collection("items")
.doc(id)
.set(itemData);
}
২) Cloud ফাংশন ট্রিগার করা হয়েছে
Cloud Function calculateCart, onWrite ট্রিগার ব্যবহার করে কার্ট আইটেমে হওয়া যেকোনও রাইট ইভেন্ট (তৈরি, আপডেট বা মুছে ফেলা) শোনে, যা আপনি functions/index.js-এ দেখতে পাবেন:
functions/index.js
exports.calculateCart = functions.firestore
.document("carts/{cartId}/items/{itemId}")
.onWrite(async (change, context) => {
try {
let totalPrice = 125.98;
let itemCount = 8;
const cartRef = db.collection("carts").doc(context.params.cartId);
await cartRef.update({
totalPrice,
itemCount
});
} catch(err) {
}
}
);
৩) Firestore Write - অ্যাডমিন
calculateCart ফাংশন কার্টের সব আইটেম পড়ে এবং মোট পরিমাণ ও দাম যোগ করে, তারপর এটি নতুন মোট দামের সাথে "কার্ট" ডকুমেন্ট আপডেট করে (উপরে cartRef.update(...) দেখুন)।
৪) Firestore Read - ক্লায়েন্ট
কার্টে হওয়া পরিবর্তন সম্পর্কে আপডেট পেতে ওয়েব ফ্রন্টএন্ড সাবস্ক্রাইব করা হয়েছে। ক্লাউড ফাংশন নতুন মোট সংখ্যা লেখার পরে এবং UI আপডেট করার পরে এটি একটি রিয়েল-টাইম আপডেট পায়, যেমন আপনি public/js/homepage.js-এ দেখতে পাচ্ছেন:
public/js/homepage.js
this.cartUnsub = cartRef.onSnapshot(cart => {
// The cart document was changed, update the UI
// ...
});
রিক্যাপ
অসাধারণ! আপনি এইমাত্র একটি সম্পূর্ণ লোকাল অ্যাপ সেট-আপ করেছেন যা সম্পূর্ণ লোকাল টেস্টিংয়ের জন্য তিনটি ভিন্ন Firebase এমুলেটর ব্যবহার করে।

তবে আরো স্টিকার পেতে পারবেন! পরবর্তী বিভাগে আপনি যা শিখবেন:
- Firebase এমুলেটর ব্যবহার করে এমন ইউনিট টেস্ট কীভাবে লিখতে হয়।
- আপনার নিরাপত্তা সংক্রান্ত নিয়ম ডিবাগ করতে Firebase এমুলেটর কীভাবে ব্যবহার করবেন।
৭. আপনার অ্যাপের জন্য বিশেষভাবে তৈরি করা নিরাপত্তা সংক্রান্ত নিয়ম তৈরি করুন
আমাদের ওয়েব অ্যাপ ডেটা রিড ও রাইট করে, তবে এখনও পর্যন্ত আমরা নিরাপত্তা নিয়ে একেবারেই চিন্তিত নই। ডেটা দেখার ও তৈরি করার অ্যাক্সেস কার আছে তা ঘোষণা করতে Cloud Firestore "নিরাপত্তা সংক্রান্ত নিয়ম" নামক সিস্টেম ব্যবহার করে। ইমুলেটর সুইট হল এই নিয়মগুলির প্রোটোটাইপ করার একটি দুর্দান্ত উপায়।
এডিটরে, emulators-codelab/codelab-initial-state/firestore.rules ফাইলটি খুলুন। আপনি দেখতে পাবেন যে আমাদের নিয়মে তিনটি প্রধান বিভাগ আছে:
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
// User's cart metadata
match /carts/{cartID} {
// TODO: Change these! Anyone can read or write.
allow read, write: if true;
}
// Items inside the user's cart
match /carts/{cartID}/items/{itemID} {
// TODO: Change these! Anyone can read or write.
allow read, write: if true;
}
// All items available in the store. Users can read
// items but never write them.
match /items/{itemID} {
allow read: if true;
}
}
}
বর্তমানে যে কেউ আমাদের ডেটাবেসে ডেটা পড়তে ও লিখতে পারবেন! আমরা নিশ্চিত করতে চাই যে শুধুমাত্র বৈধ অপারেশনগুলিই যেন সম্পন্ন হয় এবং আমরা যেন কোনও সংবেদনশীল তথ্য ফাঁস না করি।
এই কোডল্যাব চলাকালীন, ন্যূনতম বিশেষাধিকারের নীতি অনুসরণ করে, আমরা সমস্ত ডকুমেন্ট লক ডাউন করব এবং ধীরে ধীরে অ্যাক্সেস যোগ করব যতক্ষণ না সমস্ত ব্যবহারকারীর প্রয়োজনীয় সমস্ত অ্যাক্সেস থাকে, তবে তার বেশি নয়। আসুন, প্রথম দুটি নিয়ম আপডেট করে অ্যাক্সেস প্রত্যাখ্যান করি, এর জন্য শর্ত false-এ সেট করতে হবে:
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
// User's cart metadata
match /carts/{cartID} {
// UPDATE THIS LINE
allow read, write: if false;
}
// Items inside the user's cart
match /carts/{cartID}/items/{itemID} {
// UPDATE THIS LINE
allow read, write: if false;
}
// All items available in the store. Users can read
// items but never write them.
match /items/{itemID} {
allow read: if true;
}
}
}
৮. এমুলেটর ও টেস্ট রান করুন
ইমুলেটর চালু করুন
কমান্ড লাইনে, আপনি emulators-codelab/codelab-initial-state/-এ আছেন কিনা তা নিশ্চিত করুন। আগের ধাপ থেকে আপনার কাছে এখনও এমুলেটর রান করার সুবিধা থাকতে পারে। যদি না হয়, তাহলে এমুলেটর আবার চালু করুন:
$ firebase emulators:start --import=./seed
এমুলেটর চালু হয়ে গেলে, আপনি সেগুলির বিরুদ্ধে স্থানীয়ভাবে টেস্ট চালাতে পারবেন।
পরীক্ষা চালান
emulators-codelab/codelab-initial-state/ ডিরেক্টরি থেকে কমান্ড লাইনে নতুন টার্মিনাল ট্যাবে
প্রথমে ফাংশন ডিরেক্টরিতে যান (আমরা কোডল্যাবের বাকি অংশের জন্য এখানেই থাকব):
$ cd functions
এখন ফাংশন ডিরেক্টরিতে mocha টেস্ট রান করুন এবং আউটপুটের একদম উপরে স্ক্রল করুন:
# Run the tests
$ npm test
> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha
shopping carts
1) can be created and updated by the cart owner
2) can be read only by the cart owner
shopping cart items
3) can be read only by the cart owner
4) can be added only by the cart owner
adding an item to the cart recalculates the cart total.
- should sum the cost of their items
0 passing (364ms)
1 pending
4 failing
এই মুহূর্তে আমাদের চারটি ব্যর্থতা আছে। নিয়মের ফাইল তৈরি করার সময়, আরও টেস্ট পাস করার মাধ্যমে আপনি প্রোগ্রেস পরিমাপ করতে পারবেন।
৯. কার্টে সুরক্ষিত অ্যাক্সেস
প্রথম দুটি ব্যর্থতা হল "শপিং কার্ট" টেস্ট যা এগুলি পরীক্ষা করে:
- ব্যবহারকারীরা শুধুমাত্র তাদের নিজস্ব কার্ট তৈরি এবং আপডেট করতে পারবেন
- ব্যবহারকারীরা শুধুমাত্র তাদের নিজস্ব কার্ট পড়তে পারবেন
functions/test.js
it('can be created and updated by the cart owner', async () => {
// Alice can create her own cart
await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart").set({
ownerUID: "alice",
total: 0
}));
// Bob can't create Alice's cart
await firebase.assertFails(bobDb.doc("carts/alicesCart").set({
ownerUID: "alice",
total: 0
}));
// Alice can update her own cart with a new total
await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart").update({
total: 1
}));
// Bob can't update Alice's cart with a new total
await firebase.assertFails(bobDb.doc("carts/alicesCart").update({
total: 1
}));
});
it("can be read only by the cart owner", async () => {
// Setup: Create Alice's cart as admin
await admin.doc("carts/alicesCart").set({
ownerUID: "alice",
total: 0
});
// Alice can read her own cart
await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart").get());
// Bob can't read Alice's cart
await firebase.assertFails(bobDb.doc("carts/alicesCart").get());
});
এইসব টেস্টে পাস করা যাক। এডিটরে, নিরাপত্তা সংক্রান্ত নিয়মের ফাইল, firestore.rules খুলুন এবং match /carts/{cartID}-এর মধ্যে স্টেটমেন্ট আপডেট করুন:
firestore.rules
rules_version = '2';
service cloud.firestore {
// UPDATE THESE LINES
match /carts/{cartID} {
allow create: if request.auth.uid == request.resource.data.ownerUID;
allow read, update, delete: if request.auth.uid == resource.data.ownerUID;
}
// ...
}
}
এইসব নিয়ম এখন শুধুমাত্র কার্টের মালিককে রিড ও রাইট অ্যাক্সেস দেয়।
ইনকামিং ডেটা এবং ব্যবহারকারীর যাচাইকরণ যাচাই করতে, আমরা দুটি অবজেক্ট ব্যবহার করি যা প্রতিটি নিয়মের প্রসঙ্গে উপলভ্য:
-
requestঅবজেক্টে যে অপারেশন করার চেষ্টা করা হচ্ছে তার ডেটা ও মেটাডেটা থাকে। - কোনও Firebase প্রোজেক্ট যদি Firebase Authentication ব্যবহার করে, তাহলে
request.authঅবজেক্ট সেই ব্যবহারকারীর বিবরণ দেয় যিনি অনুরোধ করছেন।
১০. কার্ট অ্যাক্সেস পরীক্ষা করুন
firestore.rules সেভ করা হলে, Emulator Suite অটোমেটিক নিয়ম আপডেট করে। এমুলেটর যে নিয়ম আপডেট করেছে তা আপনি কনফার্ম করতে পারবেন, Rules updated মেসেজের জন্য এমুলেটর রান করছে এমন ট্যাবে দেখে:

টেস্ট আবার রান করুন এবং প্রথম দুটি টেস্ট পাস করেছে কিনা তা চেক করুন:
$ npm test
> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha
shopping carts
✓ can be created and updated by the cart owner (195ms)
✓ can be read only by the cart owner (136ms)
shopping cart items
1) can be read only by the cart owner
2) can be added only by the cart owner
adding an item to the cart recalculates the cart total.
- should sum the cost of their items
2 passing (482ms)
1 pending
2 failing
দারুণ! আপনি এখন শপিং কার্টে সুরক্ষিত অ্যাক্সেস পেয়েছেন। আসুন, পরবর্তী ব্যর্থ টেস্টে যাওয়া যাক।
১১. UI-তে "কার্টে যোগ করুন" ফ্লো চেক করুন
বর্তমানে, কার্টের মালিকরা তাদের কার্ট পড়তে এবং লিখতে পারলেও, তারা তাদের কার্টের পৃথক আইটেম পড়তে বা লিখতে পারেন না। এর কারণ হল, মালিকের কাছে কার্ট ডকুমেন্টের অ্যাক্সেস থাকলেও, কার্টের আইটেম সাবকালেকশন-এর অ্যাক্সেস নেই।
This is a broken state for users.
http://127.0.0.1:5000,-এ চলা ওয়েব UI-তে ফিরে যান এবং আপনার কার্টে কিছু যোগ করার চেষ্টা করুন। আপনি Permission Denied ত্রুটি দেখতে পাবেন, যা ডিবাগ কনসোল থেকে দেখা যাবে, কারণ আমরা এখনও ব্যবহারকারীদের items সাবকালেকশনে তৈরি করা ডকুমেন্ট অ্যাক্সেস করার অনুমতি দিইনি।
১২. কার্ট আইটেম অ্যাক্সেস করার অনুমতি দিন
এই দুটি টেস্ট কনফার্ম করে যে ব্যবহারকারীরা শুধুমাত্র তাদের নিজস্ব কার্টে আইটেম যোগ করতে বা সেখান থেকে আইটেম পড়তে পারবেন:
it("can be read only by the cart owner", async () => {
// Alice can read items in her own cart
await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart/items/milk").get());
// Bob can't read items in alice's cart
await firebase.assertFails(bobDb.doc("carts/alicesCart/items/milk").get())
});
it("can be added only by the cart owner", async () => {
// Alice can add an item to her own cart
await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart/items/lemon").set({
name: "lemon",
price: 0.99
}));
// Bob can't add an item to alice's cart
await firebase.assertFails(bobDb.doc("carts/alicesCart/items/lemon").set({
name: "lemon",
price: 0.99
}));
});
তাই আমরা এমন একটি নিয়ম লিখতে পারি যা বর্তমান ব্যবহারকারীর UID এবং কার্ট ডকুমেন্টের ownerUID একই হলে অ্যাক্সেস করার অনুমতি দেয়। যেহেতু create, update, delete-এর জন্য আলাদা নিয়ম উল্লেখ করার প্রয়োজন নেই, তাই আপনি write নিয়ম ব্যবহার করতে পারেন, যা ডেটা পরিবর্তন করে এমন সব অনুরোধের ক্ষেত্রে প্রযোজ্য হয়।
আইটেম সাবকালেকশনে থাকা ডকুমেন্টের জন্য নিয়ম আপডেট করুন। কন্ডিশনালে get Firestore থেকে একটি ভ্যালু রিড করছে–এই ক্ষেত্রে, কার্ট ডকুমেন্টে ownerUID।
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
// ...
// UPDATE THESE LINES
match /carts/{cartID}/items/{itemID} {
allow read, write: if get(/databases/$(database)/documents/carts/$(cartID)).data.ownerUID == request.auth.uid;
}
// ...
}
}
১৩. কার্ট আইটেম অ্যাক্সেস পরীক্ষা করুন
এখন আমরা আবার টেস্ট রান করাতে পারি। আউটপুটের একদম উপরে স্ক্রল করে যান এবং আরও টেস্ট পাস হয়েছে কিনা তা চেক করুন:
$ npm test
> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha
shopping carts
✓ can be created and updated by the cart owner (195ms)
✓ can be read only by the cart owner (136ms)
shopping cart items
✓ can be read only by the cart owner (111ms)
✓ can be added only by the cart owner
adding an item to the cart recalculates the cart total.
- should sum the cost of their items
4 passing (401ms)
1 pending
চমৎকার! এখন আমাদের সব টেস্ট পাস করে। আমাদের একটি টেস্ট বাকি আছে, তবে আমরা কয়েকটি ধাপের মধ্যেই সেটি করে ফেলব।
১৪. "কার্টে যোগ করুন" ফ্লো আবার চেক করুন
ওয়েব ফ্রন্ট এন্ডে ( http://127.0.0.1:5000) ফিরে যান এবং কার্টে একটি আইটেম যোগ করুন। আমাদের পরীক্ষা ও নিয়ম ক্লায়েন্টের প্রয়োজনীয় কার্যকারিতার সাথে মিলছে কিনা তা কনফার্ম করার জন্য এটি একটি গুরুত্বপূর্ণ ধাপ। (মনে রাখবেন, শেষবার যখন আমরা UI পরীক্ষা করেছিলাম, তখন ব্যবহারকারীরা তাদের কার্টে আইটেম যোগ করতে পারেননি!)

firestore.rules সেভ করা হলে ক্লায়েন্ট অটোমেটিক নিয়ম রিলোড করে। তাই, কার্টে কিছু যোগ করার চেষ্টা করুন।
রিক্যাপ
অসাধারণ! আপনি এইমাত্র আপনার অ্যাপের নিরাপত্তা উন্নত করেছেন, প্রোডাকশনের জন্য এটি প্রস্তুত করার জন্য একটি অপরিহার্য পদক্ষেপ! এটি প্রোডাকশন অ্যাপ হলে, আমরা এই টেস্টগুলি আমাদের কন্টিনিউয়াস ইন্টিগ্রেশন পাইপলাইনে যোগ করতে পারতাম। এটি আমাদের আত্মবিশ্বাস দেবে যে, ভবিষ্যতে আমাদের শপিং কার্ট ডেটাতে এই অ্যাক্সেস কন্ট্রোল থাকবে, এমনকি অন্যরা নিয়মগুলি পরিবর্তন করলেও।

কিন্তু দাঁড়ান, আরও আছে!
আপনি চালিয়ে গেলে, এগুলি সম্পর্কে জানতে পারবেন:
- Firestore ইভেন্টের মাধ্যমে ট্রিগার করা ফাংশন কীভাবে লিখতে হয়
- একাধিক এমুলেটর জুড়ে কাজ করে এমন টেস্ট কীভাবে তৈরি করবেন
১৫. Cloud Functions টেস্ট সেট-আপ করা
এখনও পর্যন্ত আমরা আমাদের ওয়েব অ্যাপের ফ্রন্টএন্ড এবং Firestore নিরাপত্তা নিয়মের উপর ফোকাস করেছি। তবে, এই অ্যাপ ব্যবহারকারীর কার্ট আপ-টু-ডেট রাখতে Cloud Functions ব্যবহার করে, তাই আমরা সেই কোডও টেস্ট করতে চাই।
ইমুলেটর সুইট Cloud Functions-এর পরীক্ষা করা অনেক সহজ করে দেয়, এমনকি Cloud Firestore ও অন্যান্য পরিষেবা ব্যবহার করে এমন ফাংশনও।
এডিটরে emulators-codelab/codelab-initial-state/functions/test.js ফাইলটি খুলুন এবং ফাইলের শেষ টেস্টে স্ক্রল করুন। বর্তমানে, এটি 'বাকি আছে' হিসেবে চিহ্নিত করা আছে:
// REMOVE .skip FROM THIS LINE
describe.skip("adding an item to the cart recalculates the cart total. ", () => {
// ...
it("should sum the cost of their items", async () => {
...
});
});
টেস্ট চালু করতে, .skip সরিয়ে দিন, যাতে এটি এইরকম দেখায়:
describe("adding an item to the cart recalculates the cart total. ", () => {
// ...
it("should sum the cost of their items", async () => {
...
});
});
এরপর, ফাইলের সবচেয়ে উপরে REAL_FIREBASE_PROJECT_ID ভেরিয়েবলটি খুঁজে নিন এবং আপনার আসল Firebase প্রোজেক্ট আইডিতে এটি পরিবর্তন করুন।:
// CHANGE THIS LINE
const REAL_FIREBASE_PROJECT_ID = "changeme";
আপনি প্রোজেক্ট আইডি ভুলে গেলে, Firebase কনসোলের প্রোজেক্ট সেটিংসে আপনার Firebase প্রোজেক্ট আইডি খুঁজে পেতে পারেন:

১৬. ফাংশন টেস্টের মাধ্যমে ওয়াকথ্রু করুন
এই টেস্ট Cloud Firestore ও Cloud Functions-এর মধ্যে ইন্টার্যাকশন যাচাই করে, তাই এতে আগের কোডল্যাবের টেস্টের চেয়ে বেশি সেট-আপ করতে হয়। এই টেস্টটি দেখে নেওয়া যাক এবং এটি থেকে কী আশা করা হচ্ছে সেই সম্পর্কে ধারণা পাওয়া যাক।
কার্ট তৈরি করুন
Cloud Functions বিশ্বস্ত সার্ভার এনভায়রনমেন্টে রান করে এবং Admin SDK-এর মাধ্যমে ব্যবহৃত পরিষেবা অ্যাকাউন্ট যাচাইকরণ ব্যবহার করতে পারে। প্রথমে, আপনি initializeApp-এর পরিবর্তে initializeAdminApp ব্যবহার করে একটি অ্যাপ শুরু করেন। তারপর, আপনি কার্টের জন্য একটি DocumentReference তৈরি করুন যাতে আমরা আইটেম যোগ করব এবং কার্ট শুরু করব:
it("should sum the cost of their items", async () => {
const db = firebase
.initializeAdminApp({ projectId: REAL_FIREBASE_PROJECT_ID })
.firestore();
// Setup: Initialize cart
const aliceCartRef = db.doc("carts/alice")
await aliceCartRef.set({ ownerUID: "alice", totalPrice: 0 });
...
});
ফাংশন ট্রিগার করুন
তারপর, ফাংশনটি ট্রিগার করার জন্য আমাদের কার্ট ডকুমেন্টের items সাবকালেকশনে ডকুমেন্ট যোগ করুন। ফাংশনে যে যোগফল হয় তা আপনি পরীক্ষা করছেন কিনা তা নিশ্চিত করতে দুটি আইটেম যোগ করুন।
it("should sum the cost of their items", async () => {
const db = firebase
.initializeAdminApp({ projectId: REAL_FIREBASE_PROJECT_ID })
.firestore();
// Setup: Initialize cart
const aliceCartRef = db.doc("carts/alice")
await aliceCartRef.set({ ownerUID: "alice", totalPrice: 0 });
// Trigger calculateCart by adding items to the cart
const aliceItemsRef = aliceCartRef.collection("items");
await aliceItemsRef.doc("doc1").set({name: "nectarine", price: 2.99});
await aliceItemsRef.doc("doc2").set({ name: "grapefruit", price: 6.99 });
...
});
});
পরীক্ষা থেকে কী আশা করা যায় তা সেট করা
কার্ট ডকুমেন্টে যেকোনও পরিবর্তনের জন্য লিসেনার রেজিস্টার করতে onSnapshot() ব্যবহার করুন। onSnapshot() এমন একটি ফাংশন রিটার্ন করে যা আপনি লিসেনারকে আনরেজিস্টার করার জন্য কল করতে পারেন।
এই পরীক্ষার জন্য, এমন দুটি আইটেম যোগ করুন যেগুলির মোট দাম $৯.৯৮। তারপর, কার্টে প্রত্যাশিত itemCount এবং totalPrice আছে কিনা তা চেক করুন। যদি তাই হয়, তাহলে ফাংশনটি তার কাজ করেছে।
it("should sum the cost of their items", (done) => {
const db = firebase
.initializeAdminApp({ projectId: REAL_FIREBASE_PROJECT_ID })
.firestore();
// Setup: Initialize cart
const aliceCartRef = db.doc("carts/alice")
aliceCartRef.set({ ownerUID: "alice", totalPrice: 0 });
// Trigger calculateCart by adding items to the cart
const aliceItemsRef = aliceCartRef.collection("items");
aliceItemsRef.doc("doc1").set({name: "nectarine", price: 2.99});
aliceItemsRef.doc("doc2").set({ name: "grapefruit", price: 6.99 });
// Listen for every update to the cart. Every time an item is added to
// the cart's subcollection of items, the function updates `totalPrice`
// and `itemCount` attributes on the cart.
// Returns a function that can be called to unsubscribe the listener.
await new Promise((resolve) => {
const unsubscribe = aliceCartRef.onSnapshot(snap => {
// If the function worked, these will be cart's final attributes.
const expectedCount = 2;
const expectedTotal = 9.98;
// When the `itemCount`and `totalPrice` match the expectations for the
// two items added, the promise resolves, and the test passes.
if (snap.data().itemCount === expectedCount && snap.data().totalPrice == expectedTotal) {
// Call the function returned by `onSnapshot` to unsubscribe from updates
unsubscribe();
resolve();
};
});
});
});
});
১৭. পরীক্ষাগুলি চালান
আগের টেস্ট থেকে আপনার কাছে এখনও এমুলেটর রান করার সুবিধা থাকতে পারে। না হলে, এমুলেটর চালু করুন। কমান্ড লাইন থেকে, রান করুন
$ firebase emulators:start --import=./seed
নতুন টার্মিনাল ট্যাব খুলুন (এমুলেটর চালু রাখুন) এবং ফাংশন ডিরেক্টরিতে যান। নিরাপত্তা সংক্রান্ত নিয়মের পরীক্ষা থেকে এটি এখনও খোলা থাকতে পারে।
$ cd functions
এখন ইউনিট টেস্ট রান করুন, আপনি মোট ৫টি টেস্ট দেখতে পাবেন:
$ npm test
> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha
shopping cart creation
✓ can be created by the cart owner (82ms)
shopping cart reads, updates, and deletes
✓ cart can be read by the cart owner (42ms)
shopping cart items
✓ items can be read by the cart owner (40ms)
✓ items can be added by the cart owner
adding an item to the cart recalculates the cart total.
1) should sum the cost of their items
4 passing (2s)
1 failing
আপনি যদি নির্দিষ্ট ব্যর্থতাটি দেখেন, তাহলে এটি একটি টাইমআউট ত্রুটি বলে মনে হয়। এর কারণ হল, ফাংশনটি সঠিকভাবে আপডেট হওয়ার জন্য টেস্টটি অপেক্ষা করছে, কিন্তু এটি কখনই হয় না। এখন, আমরা টেস্টের শর্ত পূরণ করার জন্য ফাংশন লিখতে প্রস্তুত।
১৮. একটি ফাংশন লেখো
এই টেস্ট ঠিক করতে, আপনাকে functions/index.js-এ ফাংশন আপডেট করতে হবে। এই ফাংশনের কিছু অংশ লেখা হলেও, এটি সম্পূর্ণ নয়। ফাংশনটি বর্তমানে এইরকম দেখতে:
// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
.firestore.document("carts/{cartId}/items/{itemId}")
.onWrite(async (change, context) => {
console.log(`onWrite: ${change.after.ref.path}`);
if (!change.after.exists) {
// Ignore deletes
return;
}
let totalPrice = 125.98;
let itemCount = 8;
try {
const cartRef = db.collection("carts").doc(context.params.cartId);
await cartRef.update({
totalPrice,
itemCount
});
} catch(err) {
}
});
ফাংশনটি কার্ট রেফারেন্স সঠিকভাবে সেট করছে, কিন্তু তারপর totalPrice এবং itemCount-এর মান গণনা করার পরিবর্তে, এটি তাদের হার্ডকোড করা মানে আপডেট করে।
-এর মাধ্যমে নিয়ে আসুন ও ইটারেট করুন
items সাব-কালেকশন
items সাবকালেকশন হওয়ার জন্য, নতুন কনস্ট্যান্ট, itemsSnap, ইনিশিয়ালাইজ করুন। তারপর, সংগ্রহের সবকটি ডকুমেন্টের মাধ্যমে ইটারেট করুন।
// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
.firestore.document("carts/{cartId}/items/{itemId}")
.onWrite(async (change, context) => {
console.log(`onWrite: ${change.after.ref.path}`);
if (!change.after.exists) {
// Ignore deletes
return;
}
try {
let totalPrice = 125.98;
let itemCount = 8;
const cartRef = db.collection("carts").doc(context.params.cartId);
// ADD LINES FROM HERE
const itemsSnap = await cartRef.collection("items").get();
itemsSnap.docs.forEach(item => {
const itemData = item.data();
})
// TO HERE
return cartRef.update({
totalPrice,
itemCount
});
} catch(err) {
}
});
মোট দাম এবং আইটেমের সংখ্যা গণনা করুন
প্রথমে, totalPrice এবং itemCount-এর ভ্যালু শূন্যতে ইনিশিয়ালাইজ করা যাক।
তারপর, আমাদের ইটারেশন ব্লকে লজিক যোগ করুন। প্রথমে, আইটেমের দাম উল্লেখ করা আছে কিনা তা চেক করুন। আইটেমের পরিমাণ উল্লেখ করা না থাকলে, ডিফল্ট হিসেবে 1 সেট করো। তারপর, itemCount-এর রানিং টোটালে পরিমাণ যোগ করুন। শেষে, আইটেমের দামকে তার সংখ্যা দিয়ে গুণ করে totalPrice-এর রানিং টোটালে যোগ করুন:
// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
.firestore.document("carts/{cartId}/items/{itemId}")
.onWrite(async (change, context) => {
console.log(`onWrite: ${change.after.ref.path}`);
if (!change.after.exists) {
// Ignore deletes
return;
}
try {
// CHANGE THESE LINES
let totalPrice = 0;
let itemCount = 0;
const cartRef = db.collection("carts").doc(context.params.cartId);
const itemsSnap = await cartRef.collection("items").get();
itemsSnap.docs.forEach(item => {
const itemData = item.data();
// ADD LINES FROM HERE
if (itemData.price) {
// If not specified, the quantity is 1
const quantity = itemData.quantity ? itemData.quantity : 1;
itemCount += quantity;
totalPrice += (itemData.price * quantity);
}
// TO HERE
})
await cartRef.update({
totalPrice,
itemCount
});
} catch(err) {
}
});
এছাড়াও, আপনি লগিং যোগ করতে পারেন যা সাফল্য এবং ত্রুটির অবস্থা ডিবাগ করতে সাহায্য করে:
// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
.firestore.document("carts/{cartId}/items/{itemId}")
.onWrite(async (change, context) => {
console.log(`onWrite: ${change.after.ref.path}`);
if (!change.after.exists) {
// Ignore deletes
return;
}
let totalPrice = 0;
let itemCount = 0;
try {
const cartRef = db.collection("carts").doc(context.params.cartId);
const itemsSnap = await cartRef.collection("items").get();
itemsSnap.docs.forEach(item => {
const itemData = item.data();
if (itemData.price) {
// If not specified, the quantity is 1
const quantity = (itemData.quantity) ? itemData.quantity : 1;
itemCount += quantity;
totalPrice += (itemData.price * quantity);
}
});
await cartRef.update({
totalPrice,
itemCount
});
// OPTIONAL LOGGING HERE
console.log("Cart total successfully recalculated: ", totalPrice);
} catch(err) {
// OPTIONAL LOGGING HERE
console.warn("update error", err);
}
});
১৯. টেস্ট আবার চালান
কমান্ড লাইনে, এমুলেটর এখনও চলছে কিনা তা নিশ্চিত করুন এবং পরীক্ষাটি আবার চালান। আপনাকে এমুলেটর রিস্টার্ট করতে হবে না কারণ এটি ফাংশনে করা পরিবর্তন অটোমেটিক গ্রহণ করে। আপনি সব টেস্ট পাস করার স্ট্যাটাস দেখতে পাবেন:
$ npm test
> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha
shopping cart creation
✓ can be created by the cart owner (306ms)
shopping cart reads, updates, and deletes
✓ cart can be read by the cart owner (59ms)
shopping cart items
✓ items can be read by the cart owner
✓ items can be added by the cart owner
adding an item to the cart recalculates the cart total.
✓ should sum the cost of their items (800ms)
5 passing (1s)
দারুণ!
২০. Storefront UI ব্যবহার করে এটি দেখুন
চূড়ান্ত পরীক্ষার জন্য, ওয়েব অ্যাপে ( http://127.0.0.1:5000/) ফিরে যান এবং কার্টে একটি আইটেম যোগ করুন।

কার্ট সঠিক মোট দামের সাথে আপডেট হয়েছে কিনা তা কনফার্ম করুন। অসাধারণ!
রিক্যাপ
আপনি Cloud Functions for Firebase এবং Cloud Firestore-এর মধ্যে একটি জটিল টেস্ট কেস দেখেছেন। টেস্ট পাস করার জন্য আপনি একটি Cloud Function লিখেছেন। আপনিও কনফার্ম করেছেন যে UI-তে নতুন কার্যকারিতা কাজ করছে! আপনি নিজের মেশিনে এমুলেটর রান করে লোকালি এই সব কিছু করেছেন।
এছাড়াও, আপনি একটি ওয়েব ক্লায়েন্ট তৈরি করেছেন যা লোকাল এমুলেটরের সাথে কাজ করছে, ডেটা সুরক্ষিত করার জন্য নিরাপত্তা সংক্রান্ত নিয়ম কাস্টমাইজ করেছেন এবং লোকাল এমুলেটর ব্যবহার করে নিরাপত্তা সংক্রান্ত নিয়ম পরীক্ষা করেছেন।
