@extends('partial.layout') @section('content')

راهنمای نصب و اجرا

مراحل زیر را دنبال کنید تا پروژه هم روی محیط محلی و هم روی سرور به درستی بالا بیاید.

راه‌اندازی محلی

  1. پیش‌نیازها را نصب کنید: PHP 8.2، Composer، Node.js و یک سرویس پایگاه داده (MySQL/PostgreSQL).
  2. داخل پوشه backend یک کپی از .env.example بگیرید و تنظیمات پایگاه داده و پیامک را تکمیل کنید.
  3. بسته‌های PHP را نصب کنید: composer install.
  4. کلید برنامه را بسازید: php artisan key:generate.
  5. مهاجرت‌ها را اجرا کنید: php artisan migrate و سپس داده‌های اولیه را بریزید: php artisan db:seed.
  6. سیگنال‌های فرانت و پنل مدیریت را کامپایل کنید: npm install و بعد npm run build (یا npm run dev برای توسعه).
  7. سرور داخلی لاراول را بالا بیاورید: php artisan serve. در صورت نیاز دستور php artisan queue:work را هم در پنجره‌ای جداگانه اجرا کنید.
  8. حالا می‌توانید سایت اصلی را در مرورگر با آدرس http://localhost:8000 مشاهده کنید.

استقرار روی سرور

  1. پیش‌نیازها (PHP، Composer، Node.js، سرویس پایگاه داده، وب‌سرور Nginx/Apache) را روی سرور نصب کنید.
  2. سورس را روی سرور مستقر کنید و دسترسی نوشتن پوشه‌های storage و bootstrap/cache را تنظیم نمایید.
  3. فایل .env را با تنظیمات دامنه، پایگاه داده، کش و درگاه پیامک/پرداخت تکمیل کنید.
  4. دستورات زیر را پشت سر هم اجرا کنید:
    • composer install --no-dev --optimize-autoloader
    • php artisan migrate --force و در صورت نیاز php artisan db:seed --force
    • npm ci و سپس npm run build
    • php artisan config:cache && php artisan route:cache && php artisan view:cache
  5. وب‌سرور را طوری پیکربندی کنید که روت backend/public به عنوان داکیومنت روت باشد و HTTPS فعال شود.
  6. برای تسک‌های زمان‌بندی، کران جاب * * * * * php /path/to/backend/artisan schedule:run >> /dev/null 2>&1 را اضافه کنید.
  7. سرویس صف را با Supervisor یا Systemd فعال کنید تا دستور php artisan queue:work --daemon همیشه در حال اجرا بماند.
  8. پس از استقرار، از طریق پنل ادمین صفحه «تنظیمات سایت» را باز کنید و لوگو، متن‌ها و اطلاعات تماس را مطابق نیاز به‌روزرسانی کنید.
@endsection