مستنداتراهنمای مدیران و ویراستارهاراهنمای پنل Medusa

🛒 راهنمای پنل مدیریت Medusa

پنل ادمین Medusa هسته مرکزی فروشگاه شما برای مدیریت محصولات، سفارشات، کدهای تخفیف، مشتریان و قوانین ارسال (Shipping) است.


۱. ورود به پنل مدیریت

برای ورود به پنل مدیریت فروشگاه می‌توانید از مشخصات دسترسی زیر استفاده کنید:

  • آدرس توسعه (Local): http://localhost:7001
  • نام کاربری پیش‌فرض: admin@medusa-test.com (یا ایمیل تنظیم شده در فایل .env سرور شما)
  • رمز عبور پیش‌فرض: supersecret

۲. مدیریت محصولات، دسته‌بندی‌ها و کلکسیون‌ها

🛍️ ایجاد محصول جدید و متغیرها (Variants)

  1. از منوی سمت چپ روی Products کلیک کنید.
  2. در بالا سمت راست روی دکمه Create Product کلیک کنید.
  3. اطلاعات اصلی شامل Title (عنوان)، Description (توضیحات کامل)، Handle (آدرس URL محصول) و تصاویر اصلی را وارد کنید.
  4. تعریف آپشن‌ها و متغیرها: در بخش Options می‌توانید ویژگی‌هایی مانند Size (سایز) یا Color (رنگ) تعریف کنید و برای هر ترکیب قیمت و موجودی انبار جداگانه تعیین نمایید.
    🎨 نحوه نمایش دایره‌های رنگی در فرانت‌اند:
    حالت عادی (نام انگلیسی): اگر نام رنگ به انگلیسی باشد (مثل Red, Blue, Black)، فرانت‌اند مستقیماً از نام رنگ برای نمایش دایره رنگی استفاده می‌کند.
    حالت دقیق (کد هگز / عناوین بومی و غیرانگلیسی): برای دقت بالاتر یا هنگام استفاده از عناوین غیرانگلیسی و بومی‌سازی‌شده به هر زبانی (مانند فارسی، عربی، فرانسوی و...)، حتماً در بخش Metadata کلید color_code را با کد هگز (مثلاً #FF5733) مقداردهی کنید.
نکته درباره نمایش دایره‌های رنگی (Color Swatches)
سیستم فرانت‌اند برای نمایش دایره‌های رنگی محصول به این شکل عمل می‌کند:
  • اگر نام رنگ به انگلیسی استاندارد وارد شده باشد (مانند Red یا Green)، فرانت‌اند به صورت خودکار از همان نام برای نمایش رنگ استفاده می‌کند.
  • برای نمایش کدهای رنگی دقیق‌تر (کدهای هگز مثل #2A9D8F) یا هنگامی که از عناوین بومی‌سازی‌شده به سایر زبان‌ها (مانند فارسی، عربی و...) استفاده می‌کنید، توصیه می‌شود وارد بخش Metadata شوید و فیلد color_code را با کد رنگ هگز مقداردهی نمایید.

📁 تخصیص دسته‌بندی (Categories)

دسته‌بندی‌ها تعیین می‌کنند محصولات در منوی اصلی سایت و صفحات فروشگاه چطور گروه‌بندی شوند.

  1. از منوی سمت چپ وارد Categories شوید و دسته‌بندی‌های درختی (مثلاً مردانه -> پوشاک -> تیشرت) بسازید.
  2. برای افزودن محصول به یک دسته‌بندی، وارد صفحه ویرایش محصول شوید و از بخش Organize دسته‌بندی‌های مربوطه را انتخاب نمایید.

🏷️ کلکسیون‌ها و کمپین‌های فروش (Collections)

کلکسیون‌ها برای گروه‌بندی محصولات خارج از ساختار دسته‌بندی اصلی استفاده می‌شوند (مانند حراج پاییزی یا کالکشن ویژه نوروز).

  1. از منوی چپ روی Collections کلیک کنید و دکمه New Collection را بزنید.
  2. عنوان کمپین را وارد کرده و محصولات دلخواه را به آن اضافه کنید.
  3. می‌توانید از این کلکسیون در سکشن‌های داینامیک Strapi (مثل Section Showcase) استفاده کنید.

۳. مدیریت سفارشات و مرسوله‌ها (Orders)

📦 بررسی و تغییر وضعیت سفارش‌ها

هنگامی که مشتری خریدی ثبت می‌کند، سفارش جدید در بخش Orders ظاهر می‌شود.

  • Pending (در انتظار): سفارش ثبت شده و پرداخت تایید شده است.
  • Processing (در حال پردازش): سفارش توسط انبار در حال بسته‌بندی است.
  • Fulfilled (ارسال شده): مرسوله تحویل پست یا پیک شده است.
  • Completed (تکمیل شده): مرسوله به دست مشتری رسیده است.

🚚 ثبت کد رهگیری پستی (Tracking Number)

  1. وارد سفارش مورد نظر شوید و روی دکمه Create Fulfillment کلیک کنید.
  2. محصولاتی که بسته‌بندی شده‌اند را تیک بزنید.
  3. کد ۲۴ رقمی رهگیری پست ایران را در فیلد Tracking Number وارد نمایید.
  4. با کلیک روی ثبت، سیستم به صورت خودکار ایمیل / پیامک حاوی کد رهگیری را برای مشتری ارسال می‌کند.

📄 صدور فاکتور و رسید سفارش

در جزئیات هر سفارش می‌توانید با کلیک روی گزینه Print Invoice، فاکتور رسمی خرید متناسب با قوانین مالیاتی شامل آدرس ارسال، اقلام فاکتور و مبلغ کل پرداختی را پرینت بگیرید.


۴. مناطق و روش‌های ارسال (تنظیمات پست ایران)

🌐 پیکربندی منطقه ایران (Regions)

سیستم مدوسا بر اساس Regions (مناطق) کار می‌کند. منطقه ایران برای محاسبه تومان/ریال و قوانین مالیاتی کشور تنظیم می‌شود.

  1. به مسیر Settings > Regions بروید.
  2. منطقه Iran را انتخاب نمایید.
  3. ارز اصلی را روی IRR (ریال) قرار دهید.

📮 تعریف روش‌های ارسال (Iran Post & Express)

شما می‌توانید روش‌های مختلف پست را با قیمت ثابت یا متغیر اضافه کنید:

  • پست پیشتاز: ارسال سریع کشوری با هزینه ثابت یا وابسته به وزن.
  • پست سفارشی: ارسال اقتصادی برای خریدهای عادی.
  • پیک شهری / اسنپ‌باکس: مخصوص تحویل داخل شهر.

۵. کدهای تخفیف و پروموشن‌ها (Discounts)

🎟️ ساخت کد تخفیف درصدی و مبلغ ثابت

  1. از منوی چپ به بخش Discounts رفته و روی Add Discount کلیک کنید.
  2. عنوان کد تخفیف را مشخص کنید (مثلاً OFF20 یا NOROOZ).
  3. نوع تخفیف را انتخاب کنید:
    • Percentage: تخفیف درصدی (مثلاً ۲۰٪).
    • Fixed Amount: تخفیف مبلغ ثابت (مثلاً ۱۰۰,۰۰۰ تومان).
  4. می‌توانید تاریخ انقضا و حداکثر تعداد دفعات استفاده از کد را تعیین نمایید.

🎁 ساخت پروموشن ارسال رایگان (Free Shipping)

با انتخاب نوع Free Shipping هنگام ساخت پروموشن، هزینه ارسال برای سفارش‌هایی که شرایط را دارند به‌صورت خودکار صفر می‌شود.

شرط‌هایی که می‌توانید تعریف کنید:

  • Region (منطقه): ارسال رایگان فقط برای ریجن یا کشور خاص فعال باشد.
  • Customer Group (گروه مشتری): ارسال رایگان فقط برای گروه‌های خاص مثل VIP یا عمده‌فروشان.
  • Sales Channel (کانال فروش): ارسال رایگان فقط از طریق یک کانال فروش مشخص اعمال شود.

۶. مدیریت مشتریان و گروه‌بندی (Customers)

👥 مدیریت مشتریان و ساخت گروه (Customer Groups)

در بخش Customers می‌توانید لیست تمام کاربران ثبت‌نامی و تاریخچه خریدهای آن‌ها را مشاهده کنید.

  1. روی Customer Groups کلیک کنید و یک گروه جدید (مثلاً خریداران عمده یا VIP) بسازید.
  2. کاربران خاص را به این گروه اضافه کنید.
  3. حالا می‌توانید هنگام قیمت‌گذاری محصولات، برای این گروه از کاربران قیمت‌های پایین‌تر یا تخفیف‌های ویژه در نظر بگیرید.

۷. مستندات رسمی و تکمیلی Medusa

برای مطالعه آموزش‌های پیشرفته‌تر می‌توانید از مستندات متنی و تصویری رسمی MedusaJS بهره‌مند شوید: