Skip to content

TEST_COMPLETE_GUIDE.md

Latest commit

 

History

History
248 lines (189 loc) · 6.72 KB

TEST_COMPLETE_GUIDE.md

File metadata and controls

248 lines (189 loc) · 6.72 KB
Raw

راهنمای کامل تست سیستم

این راهنما مراحل کامل تست سیستم Task و Mission را توضیح می‌دهد.

مرحله 1: اجرای Seeder

# اجرای migrations (اگر هنوز اجرا نشده)
php artisan migrate

# اجرای seeders پایه
php artisan db:seed --class=TenantSeeder
php artisan db:seed --class=PersonnelSeeder

# اجرای seeder کامل تست
php artisan db:seed --class=CompleteTestSeeder

بعد از اجرای CompleteTestSeeder، شما خواهید داشت:

  • ✅ یک Task با Prompt و Content
  • ✅ یک Mission با Prompt و Content
  • ✅ همه به یک پرسنل assign شده‌اند

مرحله 2: بررسی نتایج Seeder

بعد از اجرای Seeder، اطلاعات زیر نمایش داده می‌شود:

📋 Task:
   Task ID: 1
   Task Name: تسک تست - 2025-12-25 15:00
   Task Prompt ID: 1
   Task Content ID: 1
   Assigned to Personnel: 1 (علی احمدی)

🎯 Mission:
   Mission ID: 1
   Mission Title: ماموریت تست - 2025-12-25 15:00
   Mission Prompt ID: 2
   Mission Content ID: 2
   Assigned to Personnel: 1 (علی احمدی)

مرحله 3: تست Task

3.1 مشاهده Task در ربات

  1. پرسنل در ربات ماموریت دستور /status را ارسال می‌کند
  2. باید Task خود را ببیند

3.2 ارسال لینک نتیجه

  1. پرسنل در ربات ماموریت لینک نتیجه را ارسال می‌کند: 
    https://example.com/task-result/12345
  2. سیستم به صورت خودکار:
    • لینک را در جدول tasks ذخیره می‌کند
    • وضعیت را به pending_approval تغییر می‌دهد
    • پیام را در گروه تایید ارسال می‌کند

3.3 تایید Task

  1. در گروه تایید، به پیام reply کنید
  2. کلمه "تایید" را ارسال کنید
  3. سیستم:
    • وضعیت را به approved تغییر می‌دهد
    • approved_by_chat_id را ثبت می‌کند
    • امتیاز به پرسنل اضافه می‌شود

مرحله 4: تست Mission

4.1 آپلود آموزش‌ها با ربات مدیا

  1. به ربات مدیا بروید
  2. دستور زیر را ارسال کنید: 
    /upload_mission_1
  3. سپس فایل‌های آموزشی را ارسال کنید:
    • عکس
    • ویدیو
    • صوت
    • PDF
  4. برای پایان آپلود: 
    /done

4.2 ارسال آموزش‌ها به پرسنل

در ربات مدیا دستور زیر را ارسال کنید:

/send_training_1_to_1

(ماموریت 1 به پرسنل 1)

یا پرسنل در ربات ماموریت:

/get_training

4.3 ارسال لینک نتیجه

  1. پرسنل در ربات ماموریت لینک نتیجه را ارسال می‌کند: 
    https://example.com/mission-result/12345
  2. سیستم به صورت خودکار:
    • لینک را در جدول mission_personnel ذخیره می‌کند
    • وضعیت را به pending_approval تغییر می‌دهد
    • پیام را در گروه تایید ارسال می‌کند

4.4 تایید Mission

  1. در گروه تایید، به پیام reply کنید
  2. کلمه "تایید" را ارسال کنید
  3. سیستم:
    • وضعیت را به approved تغییر می‌دهد
    • approved_by_chat_id را ثبت می‌کند
    • امتیاز به پرسنل اضافه می‌شود

مرحله 5: بررسی در دیتابیس

بررسی Task

-- مشاهده Task
SELECT * FROM tasks WHERE id = 1;

-- مشاهده Prompt مربوط به Task
SELECT * FROM prompts WHERE task_id = 1;

-- مشاهده Content مربوط به Task (اگر وجود دارد)
SELECT * FROM contents WHERE id IN (
    SELECT content_id FROM task_contents WHERE task_id = 1
);

بررسی Mission

-- مشاهده Mission
SELECT * FROM missions WHERE id = 1;

-- مشاهده Prompt مربوط به Mission
SELECT * FROM prompts WHERE mission_id = 1;

-- مشاهده Content مربوط به Mission
SELECT c.*, mc.sort_order
FROM contents c
JOIN mission_contents mc ON c.id = mc.content_id
WHERE mc.mission_id = 1
ORDER BY mc.sort_order;

-- مشاهده پرسنل assign شده
SELECT mp.*, p.first_name, p.last_name
FROM mission_personnel mp
JOIN personnel p ON mp.personnel_id = p.id
WHERE mp.mission_id = 1;

بررسی تاییدکننده

-- برای Task
SELECT approved_by_chat_id, approved_at, status
FROM tasks
WHERE id = 1 AND status = 'approved';

-- برای Mission
SELECT approved_by_chat_id, approved_at, status
FROM mission_personnel
WHERE mission_id = 1 AND personnel_id = 1 AND status = 'approved';

مرحله 6: بررسی امتیازات

-- مشاهده امتیاز کل پرسنل
SELECT 
    p.id,
    p.first_name,
    p.last_name,
    (
        SELECT COALESCE(SUM(points), 0)
        FROM tasks
        WHERE assigned_user_id = p.id AND task_status = 'approved'
    ) +
    (
        SELECT COALESCE(SUM(m.points), 0)
        FROM missions m
        JOIN mission_personnel mp ON m.id = mp.mission_id
        WHERE mp.personnel_id = p.id AND mp.status = 'approved'
    ) as total_points
FROM personnel p
WHERE p.id = 1;

نکات مهم

  1. Queue Worker: برای ارسال ترتیبی محتواها، باید Queue Worker در حال اجرا باشد:

    php artisan queue:work

  2. Webhook: مطمئن شوید که webhook‌های ربات‌ها به درستی تنظیم شده‌اند

  3. گروه تایید: ربات باید در گروه عضو باشد و دسترسی ارسال پیام داشته باشد

  4. Environment Variables: تمام متغیرهای محیطی باید به درستی تنظیم شوند

عیب‌یابی

مشکل: Seeder اجرا نمی‌شود

  • مطمئن شوید که migrations اجرا شده‌اند
  • چک کنید که Tenant و Personnel وجود دارند

مشکل: Task یا Mission assign نمی‌شود

  • چک کنید که پرسنل وجود دارد
  • بررسی کنید که foreign key constraints درست هستند

مشکل: آموزش‌ها ارسال نمی‌شود

  • Queue Worker را اجرا کنید
  • چک کنید که personnel_id در bot_users.settings ذخیره شده باشد

دستورات مفید

# مشاهده لاگ‌ها
tail -f storage/logs/laravel.log

# اجرای Queue Worker
php artisan queue:work

# پاک کردن Cache
php artisan cache:clear
php artisan config:clear
php artisan route:clear

# مشاهده Routes
php artisan route:list | grep mission
php artisan route:list | grep task

موفق باشید! 🚀