📖 راهنمای جامع کاربری

پلتفرم B2B دیما - نسخه 2.0

🎯 مقدمه

به راهنمای جامع پلتفرم B2B دیما خوش آمدید. این سند شامل تمام اطلاعات لازم برای نصب، راه‌اندازی، استفاده و مدیریت سیستم است.

💡 نکته: این راهنما برای مدیران سیستم، توسعه‌دهندگان و کاربران نهایی طراحی شده است.

درباره سیستم

پلتفرم B2B دیما یک راهکار جامع و حرفه‌ای برای مدیریت تجارت الکترونیک عمده‌فروشی است که با استفاده از تکنولوژی‌های روز دنیا و هوش مصنوعی، تجربه‌ای منحصربه‌فرد ارائه می‌دهد.

⚙️ نصب و راه‌اندازی
پیش‌نیازها
نیازمندی نسخه حداقل نسخه پیشنهادی
PHP 8.0 8.2+
MySQL 5.7 8.0+
Apache/Nginx 2.4 2.4+
RAM 2GB 4GB+
Storage 5GB 20GB+
مراحل نصب
1
آپلود فایل‌ها
فایل‌های پروژه را در مسیر دلخواه روی سرور آپلود کنید (مثلاً: /var/www/html/)
2
ایجاد دیتابیس
یک دیتابیس MySQL جدید ایجاد کنید و فایل database.sql را import کنید:
mysql -u username -p database_name < database.sql
3
تنظیم config.php
فایل config/config.php را ویرایش کرده و اطلاعات دیتابیس را وارد کنید:
define('DB_HOST', 'localhost'); define('DB_NAME', 'dima_b2b'); define('DB_USER', 'root'); define('DB_PASS', 'password');
4
تنظیم دسترسی‌ها
دسترسی نوشتن به پوشه‌های زیر را فعال کنید:
chmod -R 755 public/uploads/ chmod -R 755 storage/ chmod -R 755 storage/cache/ chmod -R 755 storage/logs/
5
ورود به پنل ادمین
به آدرس /admin مراجعه کرده و با اطلاعات پیش‌فرض وارد شوید:
⚠️ مهم: حتماً رمز عبور پیش‌فرض را تغییر دهید!
نام کاربری: admin
رمز عبور: admin123
✅ تبریک! نصب با موفقیت انجام شد. حالا می‌توانید از سیستم استفاده کنید.
👑 پنل مدیریت

پنل مدیریت شامل تمام ابزارهای لازم برای کنترل کامل سیستم است.

📊 داشبورد

داشبورد نمای کلی از وضعیت سیستم را نشان می‌دهد:

📦 مدیریت محصولات
1
افزودن محصول جدید
  1. به محصولات > افزودن محصول بروید
  2. اطلاعات اصلی را وارد کنید (نام، SKU، قیمت)
  3. دسته‌بندی را انتخاب کنید
  4. تصاویر را آپلود کنید
  5. توضیحات را وارد کنید (یا از AI استفاده کنید)
  6. موجودی و حداقل/حداکثر سفارش را تنظیم کنید
  7. روی "ذخیره" کلیک کنید
💡 نکته: می‌توانید از دکمه "تولید با AI" برای تولید خودکار توضیحات، عنوان SEO و تگ‌ها استفاده کنید.
2
مدیریت دسته‌بندی‌ها
از منوی دسته‌بندی‌ها می‌توانید:
  • دسته‌بندی جدید اضافه کنید
  • دسته‌بندی‌های فرعی ایجاد کنید
  • ترتیب نمایش را تغییر دهید
  • تصویر و توضیحات اضافه کنید
🛒 مدیریت سفارشات

تمام سفارشات را مشاهده و مدیریت کنید:

👁️
مشاهده سفارش
جزئیات کامل سفارش، آیتم‌ها، مشتری و وضعیت پرداخت
✏️
ویرایش سفارش
تغییر وضعیت، افزودن یادداشت، ویرایش آیتم‌ها
🧾
چاپ فاکتور
تولید و چاپ فاکتور حرفه‌ای
📧
ارسال اطلاع‌رسانی
ارسال خودکار ایمیل و پیامک به مشتری
✨ قابلیت جدید: سفارشات حالا در Modal باز می‌شوند و نیازی به رفرش صفحه نیست!
👥 مدیریت کاربران

سه نوع کاربر در سیستم وجود دارد:

نوع کاربر دسترسی‌ها محدودیت‌ها
مدیر (Admin) دسترسی کامل به تمام بخش‌ها -
فروشنده (Seller) مدیریت محصولات، سفارشات و آمار خود فقط محصولات و سفارشات خود
خریدار (Buyer) خرید، سبد خرید، پیگیری سفارش بدون دسترسی مدیریتی
🎨 مدیریت ویجت‌ها

سیستم ویجت به شما امکان می‌دهد چیدمان صفحات را به دلخواه تنظیم کنید.

1
افزودن ویجت
  1. به ابزارک‌ها بروید
  2. از لیست، ویجت مورد نظر را انتخاب کنید
  3. صفحه و جایگاه را مشخص کنید (مثلاً: home/main)
  4. پیکربندی را تنظیم کنید (عنوان، تعداد، دسته‌بندی، ...)
  5. روی "افزودن" کلیک کنید
2
مرتب‌سازی ویجت‌ها
ویجت‌ها را با drag & drop جابجا کنید یا عدد ترتیب را تغییر دهید، سپس "ذخیره ترتیب" را بزنید.
📌 ویجت‌های موجود:
Hero Slider Daily Best Hot Deals Featured Products Latest Products Featured Categories Promo Grid Newsletter Blog List Blog Recent Blog Popular Blog Tags
📢 مدیریت تبلیغات

سیستم تبلیغات پویا با قابلیت‌های پیشرفته:

🎯
موقعیت‌های تبلیغاتی
home-slider, home-grid, product-banner, sidebar و موارد دیگر
📊
ردیابی کلیک
آمار دقیق view، click و CTR هر تبلیغ
⚖️
Weighted Rotation
نمایش تبلیغات بر اساس وزن و اولویت
📈
گزارش‌گیری
فیلتر بر اساس تاریخ و موقعیت، خروجی CSV
📱 تنظیمات پیامک

ادغام کامل با سرویس SMS.ir:

1
دریافت API Key
  1. در SMS.ir ثبت‌نام کنید
  2. به پنل کاربری بروید
  3. از بخش تنظیمات، API Key را کپی کنید
2
ایجاد Template ها
در پنل SMS.ir، قالب‌های زیر را ایجاد کنید:
  • کد تایید: کد تایید شما: {{Code}}
  • خوش‌آمدگویی: {{Name}} عزیز، به فروشگاه ما خوش آمدید!
  • تایید سفارش: سفارش {{OrderNumber}} با مبلغ {{Amount}} تومان ثبت شد
  • ارسال سفارش: سفارش {{OrderNumber}} ارسال شد. کد پیگیری: {{TrackingCode}}
3
تنظیم در پنل
به تنظیمات > SMS بروید و API Key و Template ID ها را وارد کنید.
🤖 هوش مصنوعی محلی

استفاده از Ollama برای قابلیت‌های هوش مصنوعی بدون وابستگی:

1
نصب Ollama
curl -fsSL https://ollama.ai/install.sh | sh ollama pull llama3 ollama serve
2
تست قابلیت‌ها
به هوش مصنوعی > دمو AI محلی بروید و قابلیت‌های مختلف را تست کنید:
  • تولید توضیحات محصول
  • تولید عنوان SEO
  • چت‌بات
  • پیشنهاد دسته‌بندی
  • تحلیل احساسات
  • تولید تگ‌ها
💰 صرفه‌جویی: با استفاده از Ollama، سالانه $6,000 تا $60,000 صرفه‌جویی خواهید کرد!
🏪 پنل فروشنده

فروشندگان می‌توانند محصولات خود را مدیریت کنند:

➕
افزودن محصول
افزودن محصولات جدید با تصاویر و توضیحات کامل
📦
مدیریت موجودی
بروزرسانی موجودی و قیمت محصولات
📋
سفارشات من
مشاهده و پردازش سفارشات دریافتی
📊
آمار فروش
نمودارها و گزارش‌های فروش
🛍️ پنل خریدار

خریداران می‌توانند خرید کنند و سفارشات خود را پیگیری کنند:

1
جستجو و انتخاب محصول
از صفحه محصولات یا جستجو، محصول مورد نظر را پیدا کنید
2
افزودن به سبد خرید
تعداد را مشخص کنید (حداقل و حداکثر سفارش رعایت شود) و به سبد اضافه کنید
3
تسویه حساب
آدرس تحویل را وارد کنید، روش پرداخت را انتخاب کنید و سفارش را نهایی کنید
4
پیگیری سفارش
از داشبورد کاربری، وضعیت سفارش را پیگیری کنید و فاکتور را دانلود کنید
🔌 API Documentation

سیستم دارای RESTful API کامل برای ادغام با سیستم‌های دیگر است:

Endpoints اصلی
Method Endpoint توضیحات
GET /api/products لیست محصولات
GET /api/products/{id} جزئیات محصول
GET /api/categories لیست دسته‌بندی‌ها
POST /api/cart/add افزودن به سبد
POST /api/ai/generate تولید محتوا با AI
نمونه درخواست
curl -X POST https://your-domain.com/api/ai/generate \ -H "Content-Type: application/json" \ -d '{ "prompt": "تولید توضیحات برای گوشی موبایل", "type": "product_description" }'
🔧 عیب‌یابی
مشکلات رایج و راه‌حل
❌ خطای 404
بررسی کنید فایل .htaccess در مسیر اصلی وجود داشته باشد و mod_rewrite فعال باشد.
⚠️ خطای دیتابیس
اطلاعات دیتابیس در config/config.php را بررسی کنید و مطمئن شوید دیتابیس import شده است.
💾 مشکل کش
کش مرورگر را پاک کنید یا از Ctrl+F5 استفاده کنید. برای غیرفعال کردن کش، به تنظیمات مراجعه کنید.
📱 پیامک ارسال نمی‌شود
  1. API Key را در /admin/sms بررسی کنید
  2. Template ID ها را چک کنید
  3. موجودی حساب SMS.ir را بررسی کنید
  4. لاگ‌های sms_logs را مشاهده کنید
🤖 AI کار نمی‌کند
  1. مطمئن شوید Ollama نصب و اجرا شده: ollama serve
  2. مدل را دانلود کنید: ollama pull llama3
  3. دسترسی به localhost:11434 را بررسی کنید
  4. از /admin/ai-demo تست کنید
❓ سوالات متداول
چگونه رمز عبور ادمین را تغییر دهم؟

به تنظیمات > پروفایل بروید و رمز عبور جدید را وارد کنید.

چگونه درگاه پرداخت را فعال کنم؟

به تنظیمات > درگاه‌های پرداخت بروید، درگاه مورد نظر را انتخاب کنید و اطلاعات Merchant ID را وارد کنید.

چگونه صفحه اصلی را سفارشی کنم؟

از ابزارک‌ها استفاده کنید. می‌توانید ویجت‌های مختلف را اضافه، حذف یا مرتب کنید.

چگونه بنر تبلیغاتی اضافه کنم؟

به مدیریت تبلیغات بروید، روی "افزودن تبلیغ" کلیک کنید، تصویر را آپلود کرده و موقعیت را انتخاب کنید.

آیا می‌توانم چند فروشنده داشته باشم؟

بله، سیستم از Multi-Vendor پشتیبانی می‌کند. هر فروشنده فقط محصولات و سفارشات خود را می‌بیند.

چگونه از AI برای تولید محتوا استفاده کنم؟

در صفحه افزودن محصول، روی دکمه "تولید با AI" کلیک کنید. سیستم به صورت خودکار توضیحات، عنوان SEO و تگ‌ها را تولید می‌کند.

چگونه پشتیبان بگیرم؟

دیتابیس:

mysqldump -u username -p database_name > backup.sql
فایل‌ها:
tar -czf backup.tar.gz /path/to/project

چگونه نقش‌های کاربری را تنظیم کنم؟

به نقش‌ها و مجوزها بروید و نقش‌های دلخواه را ایجاد کنید. سپس در بخش کاربران، نقش را به کاربر اختصاص دهید.

✨ بهترین شیوه‌ها (Best Practices)
🔒
امنیت
• رمز عبور قوی استفاده کنید
• به‌طور منظم بروزرسانی کنید
• SSL نصب کنید (HTTPS)
• از فایروال استفاده کنید
💾
پشتیبان‌گیری
• روزانه از دیتابیس backup بگیرید
• فایل‌ها را هفتگی backup کنید
• backup ها را خارج از سرور نگه دارید
⚡
عملکرد
• از CDN برای تصاویر استفاده کنید
• کش را فعال کنید
• تصاویر را بهینه کنید
• از Redis استفاده کنید
📊
مانیتورینگ
• لاگ‌ها را بررسی کنید
• آمار را روزانه چک کنید
• از Google Analytics استفاده کنید
• هشدارهای خودکار تنظیم کنید
📚 منابع و لینک‌های مفید
📖
مستندات فنی
• راهنمای توسعه‌دهنده
• پیاده‌سازی AI
• ادغام SMS
🔗
سرویس‌های خارجی
• SMS.ir
• Ollama AI
• Bootstrap
🎥
ویدیوهای آموزشی
• نصب و راه‌اندازی
• مدیریت محصولات
• استفاده از AI
• تنظیمات پیشرفته
💬
پشتیبانی
• تلفن: 021-12345678
• ایمیل: support@dimagroup.ir
• تیکت: پنل پشتیبانی

© 1404 پلتفرم B2B دیما - تمامی حقوق محفوظ است

📋 مشاهده پروپوزال