Node.js Tutorial پروژه عملی پایان دوره پروژه عملی سطح: سخت

پروژه پایانی ۱ — API کامل مدیریت کارها با ذخیره فایل

پروژه پایانی اول: یک REST API کامل برای مدیریت کارها با Express که داده را در فایل JSON ذخیره می‌کند، اعتبارسنجی ورودی دارد، مسیرهای CRUD کامل و مدیریت خطای مرکزی — دقیقاً پایه‌ای که بعداً دیتابیس زیرش می‌نشیند.

راه‌حل قدم‌به‌قدم پروژه

  1. ۱

    هدف پروژه

    ساخت API با CRUD کامل (فهرست، جزئیات، ساخت، ویرایش، حذف) روی مسیر /todos با ذخیره‌سازی فایل و خطاهای استاندارد HTTP.

  2. ۲

    الزامات و موارد موردنیاز

    Node.js و npm نصب؛ پکیج express؛ آشنایی با درس‌های fs و Express؛ تست با curl یا Postman.

  3. ۳

    قدم ۱ — لایه داده بسازید

    فایل store.js با توابع async: listTodos، getTodo، createTodo، updateTodo، deleteTodo که روی فایل data/todos.json با fs/promises کار می‌کنند. هر تابع فایل را می‌خواند، تغییر می‌دهد و می‌نویسد — ساده اما واقعی.

  4. ۴

    قدم ۲ — مدل و id یکتا

    شکل هر Todo: { id, title, done, createdAt }. id با شمارنده یا crypto.randomUUID بسازید. createdAt با new Date().toISOString() ثبت شود تا بعداً مرتب‌سازی ممکن باشد.

  5. ۵

    قدم ۳ — مسیرهای CRUD

    در app.js مسیرها را وصل کنید: GET /todos و GET /todos/:id و POST /todos و PUT /todos/:id و DELETE /todos/:id. POST با express.json بدنه می‌گیرد و عنوان خالی را با 422 رد می‌کند.

  6. ۶

    قدم ۴ — کدهای وضعیت درست

    ساخت موفق 201، یافت‌نشده 404، ورودی نامعتبر 422، خطای سرور 500. پاسخ خطا همیشه { error: 'پیام فارسی' } باشد تا کلاینت ساده نمایش دهد.

  7. ۷

    قدم ۵ — مدیریت خطای مرکزی

    middleware چهار آرگومانی آخر زنجیره بگذارید که خطاها را لاگ و با 500 جواب دهد. store را در try/catch بپیچید تا خرابی فایل، سرور را نیندازد.

نکات مهم

  • ◆ قبل از خواندن راه‌حل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق می‌افتد.
  • ◆ راه‌حل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
  • ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیق‌تر می‌کند.

کد کامل راه‌حل پروژه

// store.js
const fs = require("fs/promises");
const FILE = "data/todos.json";

async function readAll() {
  try {
    return JSON.parse(await fs.readFile(FILE, "utf-8"));
  } catch {
    return [];
  }
}
async function writeAll(items) {
  await fs.mkdir("data", { recursive: true });
  await fs.writeFile(FILE, JSON.stringify(items, null, 2));
}

async function listTodos() { return readAll(); }
async function getTodo(id) {
  return (await readAll()).find((t) => t.id === id) || null;
}
async function createTodo(title) {
  const items = await readAll();
  const todo = { id: Date.now(), title, done: false, createdAt: new Date().toISOString() };
  items.push(todo);
  await writeAll(items);
  return todo;
}
async function updateTodo(id, patch) {
  const items = await readAll();
  const idx = items.findIndex((t) => t.id === id);
  if (idx === -1) return null;
  items[idx] = { ...items[idx], ...patch };
  await writeAll(items);
  return items[idx];
}
async function deleteTodo(id) {
  const items = await readAll();
  const next = items.filter((t) => t.id !== id);
  if (next.length === items.length) return false;
  await writeAll(next);
  return true;
}
module.exports = { listTodos, getTodo, createTodo, updateTodo, deleteTodo };

// app.js
const express = require("express");
const store = require("./store");
const app = express();
app.use(express.json());

app.get("/todos", async (req, res) => res.json(await store.listTodos()));

app.get("/todos/:id", async (req, res) => {
  const todo = await store.getTodo(Number(req.params.id));
  if (!todo) return res.status(404).json({ error: "کار یافت نشد" });
  res.json(todo);
});

app.post("/todos", async (req, res) => {
  const title = String(req.body?.title || "").trim();
  if (title.length < 2) return res.status(422).json({ error: "عنوان حداقل ۲ نویسه است" });
  res.status(201).json(await store.createTodo(title));
});

app.put("/todos/:id", async (req, res) => {
  const todo = await store.updateTodo(Number(req.params.id), {
    ...(req.body.title ? { title: String(req.body.title).trim() } : {}),
    ...(typeof req.body.done === "boolean" ? { done: req.body.done } : {}),
  });
  if (!todo) return res.status(404).json({ error: "کار یافت نشد" });
  res.json(todo);
});

app.delete("/todos/:id", async (req, res) => {
  const ok = await store.deleteTodo(Number(req.params.id));
  if (!ok) return res.status(404).json({ error: "کار یافت نشد" });
  res.status(204).end();
});

app.use((err, req, res, next) => {
  console.error(err);
  res.status(500).json({ error: "خطای داخلی سرور" });
});

app.listen(3000, () => console.log("API آماده روی :3000"));

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

خروجی مورد انتظار

تست با curl:
  curl localhost:3000/todos                          → []
  curl -X POST -H 'Content-Type: application/json' -d '{"title":"خرید نان"}' localhost:3000/todos → کار ساخته‌شده با id و createdAt
  curl localhost:3000/todos                          → لیست با یک کار
  curl -X PUT -d '{"done":true}' .../todos/<id>      → کار با done:true
  curl -X DELETE .../todos/<id>                      → 204
  curl .../todos/999                                 → {"error":"کار یافت نشد"}

چالش اضافه (اختیاری)

فیلتر ?done=true و جستجوی ?q= عنوان را اضافه کنید و داده را در localStorage کلاینت هم آینه کنید.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.