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

پروژه پایانی — فروشگاه SPA کامل با Vue و Router

پروژه پایانی دوره: یک فروشگاه SPA — لیست محصولات با جستجو و فیلتر، صفحه محصول، سبد خرید سراسری با composable، فرم ثبت سفارش با اعتبارسنجی و صفحات با Router — همه در یک پروژه Vite واقعی.

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

  1. ۱

    هدف پروژه

    ساخت SPA فروشگاه با Router، وضعیت سبد سراسری، فرم اعتبارسنجی‌شده و مصرف API محصولات.

  2. ۲

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

    Node و npm؛ API محصولات از jsonplaceholder یا فایل JSON محلی؛ آشنایی با درس‌های دوره.

  3. ۳

    قدم ۱ — پروژه و داده

    npm create vue@latest (بدون Router اول، بعد اضافه). فایل src/data/products.json با ۸ محصول (نام، قیمت تومان، دسته، توضیح). composable useProducts که داده را می‌خواند و loading/error می‌دهد.

  4. ۴

    قدم ۲ — لیست با فیلتر

    صفحه فهرست: جستجو با useDebouncedSearch و فیلتر دسته با select؛ گرید کارت‌ها با ProductCard (props + emit select). حالت‌های loading/empty/error هر سه طراحی‌شده.

  5. ۵

    قدم ۳ — Router و صفحه محصول

    Router با / و /products/:id؛ صفحه تکی با جزئیات و دکمه «افزودن به سبد» که useCart را صدا می‌زند. مسیر ناموجود → پیام و دکمه بازگشت.

  6. ۶

    قدم ۴ — سبد سراسری

    useCart singleton با add/remove/total؛ هدر همیشه badge تعداد نشان می‌دهد. صفحه سبد با ویرایش qty و جمع کل با toLocaleString فارسی.

  7. ۷

    قدم ۵ — فرم ثبت و انتشار

    فرم نام/تلفن/آدرس با اعتبارسنجی inline و ذخیره سفارش در localStorage (تا API نداریم). build و دیپلوی dist با fallback nginx؛ تست رفرش روی /products/3.

نکات مهم

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

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

// composables/useCart.js (singleton)
import { ref, computed } from "vue";
const items = ref([]);
export function useCart() {
  const count = computed(() => items.value.reduce((s, i) => s + i.qty, 0));
  const total = computed(() => items.value.reduce((s, i) => s + i.qty * i.price, 0));
  function add(p) {
    const f = items.value.find((i) => i.id === p.id);
    f ? f.qty++ : items.value.push({ ...p, qty: 1 });
  }
  function remove(id) { items.value = items.value.filter((i) => i.id !== id); }
  function setQty(id, qty) {
    const f = items.value.find((i) => i.id === id);
    if (f) f.qty = Math.max(1, Math.min(10, qty));
  }
  return { items, count, total, add, remove, setQty };
}

// views/Checkout.vue
<template>
  <form @submit.prevent="submit" class="max-w-md mx-auto space-y-4">
    <div>
      <input v-model.trim="form.name" placeholder="نام و نام خانوادگی" class="w-full border rounded-lg p-2">
      <p v-if="errors.name" class="text-xs text-rose-500 mt-1">{{ errors.name }}</p>
    </div>
    <div>
      <input v-model.trim="form.phone" placeholder="موبایل" class="w-full border rounded-lg p-2">
      <p v-if="errors.phone" class="text-xs text-rose-500 mt-1">{{ errors.phone }}</p>
    </div>
    <button class="w-full bg-indigo-600 text-white py-2.5 rounded-lg font-bold">ثبت سفارش</button>
    <p v-if="done" class="text-emerald-600 text-sm">سفارش شما ثبت شد — کد: {{ orderId }}</p>
  </form>
</template>

<script setup>
import { reactive, ref } from "vue";
import { useCart } from "../composables/useCart";
const { items, total } = useCart();
const form = reactive({ name: "", phone: "" });
const errors = reactive({});
const done = ref(false), orderId = ref("");

function submit() {
  errors.name = form.name.length >= 3 ? "" : "نام حداقل ۳ نویسه است";
  errors.phone = /^09\d{9}$/.test(form.phone) ? "" : "موبایل با ۰۹ و ۱۱ رقم";
  if (errors.name || errors.phone || items.value.length === 0) return;
  orderId.value = "ORD-" + Date.now();
  const order = { id: orderId.value, items: items.value, total: total.value, ...form, at: new Date().toISOString() };
  const prev = JSON.parse(localStorage.getItem("orders") || "[]");
  localStorage.setItem("orders", JSON.stringify([...prev, order]));
  done.value = true;
}
</script>

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

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

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

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

نتایج مورد انتظار:
  فهرست محصولات با جستجوی زنده و فیلتر دسته کار می‌کند.
  صفحه /products/3 جزئیات را نشان می‌دهد؛ رفرش هم بدون 404 (با fallback).
  افزودن به سبد، badge هدر را بروز می‌کند؛ سبد جمع فارسی درست دارد.
  فرم با موبایل غلط خطای inline می‌دهد و سفارش معتبر را در localStorage ثبت می‌کند.

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

localStorage را با watch سینک کنید و صفحه «سفارش‌های من» با فهرست سفارش‌های ذخیره‌شده اضافه کنید.

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

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

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

کپچا

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