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

پروژه پایانی ۲ — وب‌سایت خبری کوچک با Express و قالب HTML

پروژه پایانی دوم: یک وب‌سایت چندصفحه‌ای با Express که اخبار را از فایل JSON می‌خواند، صفحه اصلی با لیست، صفحه خبر با slug و فرم تماس با ذخیره پیام‌ها — بدون دیتابیس، قابل دیپلوی روی هر VPS.

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

  1. ۱

    هدف پروژه

    ساخت سایت سه‌صفحه‌ای: خانه (لیست خبر)، خبر تک (بر اساس slug) و تماس (فرم + ذخیره پیام)، با قالب‌بندی سمت سرور.

  2. ۲

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

    Express نصب؛ فایل data/news.json با ۳ خبر نمونه؛ آشنایی با req.params و req.body.

  3. ۳

    قدم ۱ — داده و بارگذاری

    فایل data/news.json با آرایه‌ای از اخبار: { slug, title, body, date }. در start، یک بار بخوانید و در حافظه نگه دارید؛ برای فرم تماس نوشتن به فایل کافی است.

  4. ۴

    قدم ۲ — صفحه اصلی

    مسیر GET / لیست خبرها را رندر می‌کند: عنوان، تاریخ فارسی‌شده و لینک به /news/:slug. با template literal و map بسازید و XSS را در ذهن داشته باشید (ورودی کاربر مستقیم در HTML نمی‌رود).

  5. ۵

    قدم ۳ — صفحه خبر تکی

    مسیر /news/:slug خبر را با find پیدا می‌کند؛ نبودش 404 با صفحه خطای فارسی. عنوان در <h1> و body در پاراگراف‌ها (split روی \n).

  6. ۶

    قدم ۴ — فرم تماس

    صفحه /contact فرم با نام، ایمیل و پیام دارد؛ POST /contact را express.urlencoded پارس می‌کند، اعتبارسنجی می‌کند و پیام را به messages.json اضافه می‌کند. پاسخ: صفحه تشکر یا redirect با پرچم موفقیت.

  7. ۷

    قدم ۵ — استایل و دیپلوی

    یک فایل public/style.css با express.static سرو کنید. برای دیپلوی روی VPS: npm install --omit=dev، اجرا با pm2 و پشت nginx (درس استقرار دوره Docker این را کامل می‌کند).

نکات مهم

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

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

const express = require("express");
const fs = require("fs/promises");
const path = require("path");
const app = express();

app.use(express.urlencoded({ extended: true }));
app.use(express.static("public"));

async function readJson(file, fallback) {
  try { return JSON.parse(await fs.readFile(file, "utf-8")); } catch { return fallback; }
}

function page(title, content) {
  return `<!doctype html><html lang="fa" dir="rtl"><head><meta charset="utf-8">
  <title>${title}</title><link rel="stylesheet" href="/style.css"></head>
  <body><header><a href="/">خانه</a> | <a href="/contact">تماس</a></header>
  <main>${content}</main></body></html>`;
}

app.get("/", async (req, res) => {
  const news = await readJson("data/news.json", []);
  const items = news.map((n) =>
    `<li><a href="/news/${encodeURIComponent(n.slug)}">${n.title}</a> <small>${n.date}</small></li>`
  ).join("");
  res.send(page("خانه", `<h1>اخبار</h1><ul>${items}</ul>`));
});

app.get("/news/:slug", async (req, res) => {
  const news = await readJson("data/news.json", []);
  const item = news.find((n) => n.slug === req.params.slug);
  if (!item) return res.status(404).send(page("یافت نشد", "<p>خبر پیدا نشد.</p>"));
  const paras = item.body.split("\n").map((p) => `<p>${p}</p>`).join("");
  res.send(page(item.title, `<h1>${item.title}</h1>${paras}`));
});

app.get("/contact", (req, res) => {
  res.send(page("تماس", `<form method="post" action="/contact">
    <input name="name" placeholder="نام" required>
    <input name="email" type="email" placeholder="ایمیل" required>
    <textarea name="message" placeholder="پیام" required></textarea>
    <button>ارسال</button></form>`));
});

app.post("/contact", async (req, res) => {
  const { name, email, message } = req.body;
  if (!name || !email || !message) return res.status(422).send(page("خطا", "<p>همه فیلدها الزامی است.</p>"));
  const msgs = await readJson("data/messages.json", []);
  msgs.push({ name, email, message, at: new Date().toISOString() });
  await fs.writeFile("data/messages.json", JSON.stringify(msgs, null, 2));
  res.send(page("تشکر", "<p>پیام شما ثبت شد. ممنون!</p>"));
});

app.listen(3000, () => console.log("سایت روی :3000"));

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

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

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

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

بازکردن / لیست خبرها را می‌بیند؛ کلیک روی هر خبر صفحه تکی را می‌آورد؛ فرم تماس پیام را در data/messages.json ذخیره می‌کند و صفحه تشکر نشان می‌دهد. فایل ناموجود slug خطای 404 فارسی می‌دهد.

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

RSS feed از همان داده خبر بسازید و paginate لیست خبر را با ?page=2 اضافه کنید.

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

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

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

کپچا

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