قاعدة بيانات للـ API
المهام في الـ API الآن محفوظة في مصفوفة داخل الذاكرة، فتختفي كلما أعدت تشغيل الخادم. حان وقت قاعدة بيانات حقيقية.
اختيار قاعدة البيانات
- PostgreSQL: قاعدة علائقية (جداول وعلاقات)، قوية وموثوقة، وتناسب أغلب المشاريع: متاجر، وأنظمة تسيير، وتطبيقات. يمكنك استعمالها مجانًا عبر Supabase أو Neon، أو تثبيتها على جهازك.
- MongoDB: قاعدة وثائق (كائنات شبيهة بـ JSON)، مرنة في شكل البيانات. لها خطة مجانية على MongoDB Atlas.
في هذا الدليل نستعمل PostgreSQL، لأنها الأكثر طلبًا ولأن لغة SQL مهارة تبقى معك في كل مشروع.
إنشاء الجداول
نفّذ هذا في محرر SQL الخاص بقاعدتك:
create table tasks (
id serial primary key,
title text not null check (length(title) between 3 and 200),
done boolean not null default false,
created_at timestamptz not null default now()
);
القيود (not null و check) تحمي بياناتك حتى لو أخطأ الكود: قاعدة البيانات نفسها ترفض عنوانًا فارغًا.
الإضافة والقراءة والتعديل والحذف (CRUD)
npm install pg
// db.js
import pg from "pg";
export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
import { pool } from "./db.js";
app.get("/api/tasks", async (req, res) => {
const { rows } = await pool.query("select * from tasks order by created_at desc");
res.json(rows);
});
app.post("/api/tasks", async (req, res) => {
const { rows } = await pool.query(
"insert into tasks (title) values ($1) returning *",
[req.body.title],
);
res.status(201).json(rows[0]);
});
app.put("/api/tasks/:id", async (req, res) => {
const { rows } = await pool.query(
"update tasks set done = $1 where id = $2 returning *",
[req.body.done, req.params.id],
);
if (rows.length === 0) return res.status(404).json({ error: "المهمة غير موجودة" });
res.json(rows[0]);
});
app.delete("/api/tasks/:id", async (req, res) => {
await pool.query("delete from tasks where id = $1", [req.params.id]);
res.status(204).end();
});
لاحظ $1 و $2: لا تدمج أبدًا ما يرسله المستخدم داخل نص SQL بنفسك. القيم الممررة منفصلة تحميك من «حقن SQL» (SQL Injection)، وهو من أخطر الثغرات وأكثرها شيوعًا.
التحقق من البيانات قبل الحفظ
مع كثرة الحقول يصبح التحقق اليدوي طويلًا. مكتبة zod تصف شكل البيانات المقبولة:
npm install zod
import { z } from "zod";
const TaskInput = z.object({
title: z.string().trim().min(3).max(200),
done: z.boolean().optional(),
});
app.post("/api/tasks", async (req, res) => {
const result = TaskInput.safeParse(req.body);
if (!result.success) {
return res.status(400).json({ error: "بيانات غير صحيحة", issues: result.error.issues });
}
const { rows } = await pool.query(
"insert into tasks (title) values ($1) returning *",
[result.data.title],
);
res.status(201).json(rows[0]);
});
مهمتك
انقل الـ API إلى PostgreSQL، وأضف جدول clients (اسم، وهاتف، وولاية)، واربط كل مهمة بعميل عبر عمود client_id. أضف مسارًا GET /api/clients/:id/tasks يعيد مهام عميل واحد.