كل ما تحتاج إلى معرفته حول واجهة برمجة تطبيقات Firestore الخاصة بـ Google Cloud

ما هو متجر Firestore؟

Firestore هي قاعدة بيانات سحابية NoSQL قائمة على المستندات/المجموعات، وتتميز بالميزات التالية:

• تخزين منظم ومرن
• إمكانية المزامنة في الوقت الحقيقي
• أمان عالي المستوى مع قواعد أمان Firebase
• قابلية التوسع التلقائي
• زمن استجابة منخفض للغاية على مستوى العالم
• القدرة على تنفيذ استعلامات معقدة
• مناسب للمشاريع الصغيرة والمتوسطة والكبيرة

متجر Firestore في وضعين الوضع الأصلي (خاص بقاعدة بيانات Firebase) و وضع تخزين البيانات (مقدمة لخدمات GCP Enterprise).

بنية البيانات في Firestore

يستخدم Firestore بنية بسيطة ولكنها قوية:

• مجموعة → مجموعة من الوثائق

• وثيقة → بنية شبيهة بـ JSON

• مجموعة فرعية → مجموعة داخل كل مستند

• مجال → حقول كل مستند

نموذج الهيكل:

users (collection)
   └── userId123 (document)
    ├── name: "Ali"
    ├── age: 28
    └── posts (subcollection)
      └── postId981 (document)
        ├── title: "My First Post"
        └── likes: 52

أمثلة على نماذج التعليمات البرمجية باستخدام واجهة برمجة تطبيقات Firestore

1. استخدمه مع جافا سكريبت (تطبيق ويب / نود.جي إس)

تثبيت

npm install firebase

الاتصال بـ Firestore

import { initializeApp } from "firebase/app";
import { getFirestore, doc, setDoc, getDoc } from "firebase/firestore";
const firebaseConfig = {
apiKey: "...",
authDomain: "...",
projectId: "...",
};
const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

إضافة مستند

await setDoc(doc(db, "users", "user1"), {
name: "Ali",
age: 28,
job: "Developer"
});

وثيقة القراءة

const docRef = doc(db, "users", "user1");
const snap = await getDoc(docRef);
if (snap.exists()) {
console.log("Data:", snap.data());
}

2. واجهة برمجة تطبيقات Firestore REST

أرسل طلب POST لإنشاء مستند

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-d '{
"fields": {
"title": {"stringValue": "New Article"},
"views": {"integerValue": "102"}
}
}' \
"https://firestore.googleapis.com/v1/projects/YOUR_PROJECT/databases/(default)/documents/posts"

المشاريع التي يمكن إنشاؤها باستخدام Firestore

1. تطبيقات الدردشة والمراسلة (تطبيق الدردشة الفورية)

بفضل قدرتها على المزامنة الفورية، تُعد Firestore واحدة من أفضل الخيارات لإنشاء برامج الدردشة.

2. أنظمة إدارة المحتوى (المدونة، نظام إدارة المحتوى)

خاصة بالنسبة للفرق الصغيرة أو الشركات الناشئة التي لا ترغب في التعامل مع الخوادم.

3. تطبيقات الجوال (iOS / Android / Flutter)

بسبب:

• زمن انتقال منخفض

• مزامنة متزامنة

• وضع عدم الاتصال الداخلي

4. لوحات معلومات الإدارة في الوقت الفعلي (لوحات التحكم الإدارية)

مثل لوحة تحكم المتجر الإلكتروني، وإحصائيات المستخدمين، وإدارة الطلبات.

5. متجر إلكتروني صغير ومتوسط الحجم

أضف المنتجات، والفئات، وسلال التسوق، والطلبات، وما إلى ذلك.

6. تطبيقات إنترنت الأشياء

تخزين سريع لبيانات المستشعرات.

أمثلة على مشاريع ناجحة باستخدام Firestore

• Alibaba Cloud Mobile – استخدام Firestore لإدارة البيانات في الوقت الفعلي

• كلمات متقاطعة من صحيفة نيويورك تايمز – يُستخدم للعب الجماعي عبر الإنترنت

• تودويست - مزامنة مهام المستخدم عبر أجهزة متعددة

• شازام - إدارة بعض البيانات السحابية

• هوت ستار – حفظ بيانات المستخدم وإعدادات الملف الشخصي

(تستخدم العديد من الخدمات Firestore في الخفاء دون الإعلان عن ذلك رسميًا)

فوائد متجر فايرستور

قابلية التوسع التلقائي

لا حاجة لإدارة الخادم.

سرعة قراءة عالية

بالنظر إلى بنية الحافة العالمية.

الأمن مع قواعد أمان Firestore

مثال على قاعدة تنص على أن مالك الحساب فقط هو من يملك صلاحية القراءة/الكتابة:

service cloud.firestore {
match /databases/{database}/documents {
match /users/{uid} {
allow read, write: if request.auth.uid == uid;
}
}
}

على الهاتف المحمول والويب.

استعلامات قوية

التصفية، والفرز، والاستعلام عن النطاق، والفهرسة.

التحديات والقيود (والتي من الأفضل معرفتها قبل الاستخدام)

❌ لا يوجد ربط (إنها قاعدة بيانات NoSQL)
❌ تتطلب الاستعلامات المعقدة فهارس.
❌ يتم حساب التكلفة بناءً على عدد عمليات القراءة/الكتابة/التخزين
❌ غير مناسب لمجموعات البيانات الكبيرة جدًا (تيرابايت فأكثر)
❌ المعاملات محدودة.

مقارنة بين Firestore وقاعدة البيانات في الوقت الفعلي

Firestore هو إصدار أحدث وأكثر كفاءة من Realtime DB.

أفضل ممارسات Firestore للإنتاج الاحترافي

1. اختر بنية البيانات المناسبة

من الأفضل عدم إنشاء مستندات كبيرة الحجم.

2. استخدم المجموعة الفرعية لتقسيم البيانات

مثال: المنشورات ← التعليقات ← الإعجابات

3. تخزين الاستعلامات التي تتطلب ذاكرة تخزين مؤقتة

لتقليل تكلفة القراءة.

4. استخدم وظائف السحابة لمعالجة البيانات في الواجهة الخلفية

مثل إرسال الإشعارات، وإنشاء الفهارس، وتلخيص البيانات.

5. تسجيل الدخول إلى نظام تسجيل الدخول في Firestore

لتجنب التكاليف غير المرغوب فيها.

مثال على نظام مدونة متكامل باستخدام Firestore

الهيكل المقترح:

posts (collection)
  └── postId
    ├── title
    ├── content
    ├── authorId
    ├── createdAt
    └── comments (subcollection)
      └── commentId
        ├── userId
        └── message

مثال على إضافة منشور:

import { collection, addDoc, serverTimestamp } from "firebase/firestore";
await addDoc(collection(db, "posts"), {
title: "First Blog Post",
content: "This is the content...",
authorId: "u123",
createdAt: serverTimestamp()
});

خاتمة

Firestore عبارة عن قاعدة بيانات سحابية قوية تعمل في الوقت الفعلي، وهي مناسبة لبناء خدمات سريعة وقابلة للتوسع وبدون خوادم.
هذه الخدمة مناسبة لـ:

✅ موقع إلكتروني
✅ تطبيق جوال
✅ نظام إدارة المحتوى
✅ تطبيقات الدردشة
✅ لوحات معلومات فورية
✅ مشاريع إنترنت الأشياء
✅ المتاجر الإلكترونية

إذا كنت تقوم ببناء منتج يتطلب مزامنة فورية، وسرعة عالية، وتكلفة معقولة نعم، يُعدّ Firestore أحد أفضل الخيارات.