Seyyed_arc/hesabixAPI/scripts/MIGRATION_SCRIPTS_ANALYSIS.md

گزارش بررسی کامل اسکریپت‌های Migration

خلاصه

✅ بله، می‌توانیم یک migration کامل انجام دهیم!

اسکریپت‌های migration موجود قابلیت انتقال کامل کسب‌وکارها و تمام موارد مرتبط را دارند.

---

اسکریپت‌های موجود

1. ✅ migrate_users_from_old_db.py

• نوع: کاربران
• وظیفه: انتقال کاربران از hesabixOld به hesabixpy
• وضعیت: موجود

2. ✅ migrate_businesses_complete.py

• نوع: کسب‌وکارها
• وظیفه:
  • انتقال کسب‌وکارها
  • انتقال سال‌های مالی
  • انتقال واحدهای ارزی
• وضعیت: موجود و کامل

3. ✅ migrate_persons_complete.py

• نوع: اشخاص
• وظیفه:
  • انتقال اشخاص
  • تبدیل person_types به JSON
  • تقسیم name به first_name و last_name
• وضعیت: موجود و کامل

4. ✅ migrate_products_complete.py

• نوع: کالاها و خدمات
• وظیفه:
  • انتقال دسته‌بندی‌ها
  • انتقال کالا/خدمات
  • نگاشت واحدها
• وضعیت: موجود و کامل

5. ✅ migrate_bank_cash_petty_complete.py

• نوع: حساب‌های بانکی، صندوق‌ها، تنخواه‌ها
• وظیفه:
  • انتقال حساب‌های بانکی
  • انتقال صندوق‌ها (cash registers)
  • انتقال تنخواه گردان‌ها (petty cash)
• وضعیت: موجود و کامل

6. ✅ migrate_checks_complete.py

• نوع: چک‌ها
• وظیفه:
  • انتقال چک‌ها
  • نگاشت انواع چک
  • نگاشت وضعیت چک‌ها
• وضعیت: موجود و کامل

7. ✅ migrate_warehouses_complete.py

• نوع: انبارها و اسناد انبار
• وظیفه:
  • انتقال انبارها (warehouses)
  • انتقال اسناد انبار (warehouse documents)
  • انتقال خطوط سند انبار (warehouse document lines)
• وضعیت: موجود و کامل

8. ✅ migrate_business_users_complete.py

• نوع: کاربران عضو کسب‌وکار
• وظیفه:
  • انتقال کاربران عضو کسب‌وکار
  • تبدیل permissions به JSON
• وضعیت: موجود و کامل

9. ✅ migrate_invoices_complete.py

• نوع: فاکتورها
• وظیفه:
  • انتقال فاکتورهای فروش/خرید
  • انتقال برگشت از فروش/خرید
  • استفاده از invoice_service برای ایجاد فاکتورها
• وضعیت: موجود و کامل (با بهینه‌سازی)

10. ⭐ migrate_remaining_businesses_complete.py

• نوع: جامع - تمام موارد مرتبط
• وظیفه:
  • انتقال کسب‌وکارهای منتقل نشده
  • برای هر کسب‌وکار به طور خودکار انتقال می‌دهد:
    1. ✅ سال‌های مالی
    2. ✅ اشخاص
    3. ✅ حساب‌های بانکی
    4. ✅ صندوق‌ها
    5. ✅ تنخواه‌ها
    6. ✅ کالاها/خدمات
    7. ✅ چک‌ها
    8. ✅ کاربران عضو
  • نکته: این اسکریپت انبارها را منتقل نمی‌کند
• وضعیت: موجود و کامل

---

موارد قابل انتقال

✅ موارد موجود در اسکریپت‌ها:

1. ✅ کاربران (users)

   • اسکریپت: migrate_users_from_old_db.py

2. ✅ کسب‌وکارها (businesses)

   • اسکریپت: migrate_businesses_complete.py یا migrate_remaining_businesses_complete.py

3. ✅ سال‌های مالی (fiscal_years)

   • در: migrate_businesses_complete.py یا migrate_remaining_businesses_complete.py

4. ✅ واحدهای ارزی (business_currencies)

   • در: migrate_businesses_complete.py یا migrate_remaining_businesses_complete.py

5. ✅ اشخاص (persons)

   • اسکریپت: migrate_persons_complete.py یا در migrate_remaining_businesses_complete.py

6. ✅ کالاها/خدمات (products)

   • اسکریپت: migrate_products_complete.py یا در migrate_remaining_businesses_complete.py

7. ✅ حساب‌های بانکی (bank_accounts)

   • اسکریپت: migrate_bank_cash_petty_complete.py یا در migrate_remaining_businesses_complete.py

8. ✅ صندوق‌ها (cash_registers)

   • اسکریپت: migrate_bank_cash_petty_complete.py یا در migrate_remaining_businesses_complete.py

9. ✅ تنخواه گردان‌ها (petty_cash)

   • اسکریپت: migrate_bank_cash_petty_complete.py یا در migrate_remaining_businesses_complete.py

10. ✅ چک‌ها (checks)

    • اسکریپت: migrate_checks_complete.py یا در migrate_remaining_businesses_complete.py

11. ✅ انبارها (warehouses)

    • اسکریپت: migrate_warehouses_complete.py
    • نکته: در migrate_remaining_businesses_complete.py موجود نیست

12. ✅ اسناد انبار (warehouse_documents)

    • اسکریپت: migrate_warehouses_complete.py
    • نکته: در migrate_remaining_businesses_complete.py موجود نیست

13. ✅ خطوط سند انبار (warehouse_document_lines)

    • اسکریپت: migrate_warehouses_complete.py
    • نکته: در migrate_remaining_businesses_complete.py موجود نیست

14. ✅ کاربران عضو کسب‌وکار (business_permissions)

    • اسکریپت: migrate_business_users_complete.py یا در migrate_remaining_businesses_complete.py

15. ✅ فاکتورها (documents - invoice types)

    • اسکریپت: migrate_invoices_complete.py

---

ترتیب پیشنهادی Migration

مرحله 1: زیرساخت پایه

1. migrate_users_from_old_db.py          → کاربران
2. migrate_businesses_complete.py        → کسب‌وکارها + سال‌های مالی + واحدهای ارزی

مرحله 2: داده‌های اصلی کسب‌وکار

3. migrate_persons_complete.py           → اشخاص
4. migrate_products_complete.py          → کالاها/خدمات
5. migrate_bank_cash_petty_complete.py   → بانک + صندوق + تنخواه
6. migrate_checks_complete.py            → چک‌ها
7. migrate_warehouses_complete.py        → انبارها + اسناد انبار
8. migrate_business_users_complete.py    → کاربران عضو

مرحله 3: اسناد حسابداری

9. migrate_invoices_complete.py          → فاکتورها (sell, buy, rfsell, rfbuy)

یا استفاده از اسکریپت جامع:

روش جامع (برای کسب‌وکارهای باقی‌مانده):

1. migrate_users_from_old_db.py          → کاربران (اگر لازم باشد)
2. migrate_remaining_businesses_complete.py  → کسب‌وکار + تمام موارد مرتبط (بدون انبار)
3. migrate_warehouses_complete.py        → انبارها + اسناد انبار (جداگانه)
4. migrate_invoices_complete.py          → فاکتورها

---

تحلیل migrate_remaining_businesses_complete.py

✅ مواردی که انتقال می‌دهد:

1. ✅ کسب‌وکار
2. ✅ سال‌های مالی
3. ✅ اشخاص
4. ✅ حساب‌های بانکی
5. ✅ صندوق‌ها
6. ✅ تنخواه‌ها
7. ✅ کالاها/خدمات
8. ✅ چک‌ها
9. ✅ کاربران عضو

❌ مواردی که انتقال نمی‌دهد:

1. ❌ انبارها
2. ❌ اسناد انبار
3. ❌ فاکتورها

---

پیشنهاد برای انتقال کامل

سناریو 1: انتقال کسب‌وکارهای باقی‌مانده (250 کسب‌وکار)

گام 1: انتقال کسب‌وکارها و موارد مرتبط

python scripts/migrate_remaining_businesses_complete.py

این اسکریپت برای هر کسب‌وکار منتقل نشده:

• کسب‌وکار را ایجاد می‌کند
• سال‌های مالی را منتقل می‌کند
• اشخاص را منتقل می‌کند
• حساب‌های بانکی را منتقل می‌کند
• صندوق‌ها را منتقل می‌کند
• تنخواه‌ها را منتقل می‌کند
• کالاها را منتقل می‌کند
• چک‌ها را منتقل می‌کند
• کاربران عضو را منتقل می‌کند

گام 2: انتقال انبارها (اختیاری)

python scripts/migrate_warehouses_complete.py

گام 3: انتقال فاکتورها

python scripts/migrate_invoices_complete.py

---

مزایای استفاده از migrate_remaining_businesses_complete.py

1. ✅ جامع: تمام موارد مرتبط را یکجا منتقل می‌کند
2. ✅ خودکار: نیاز به اجرای چند اسکریپت جداگانه نیست
3. ✅ بهینه: فقط کسب‌وکارهای منتقل نشده را پردازش می‌کند
4. ✅ مستقل: برای هر کسب‌وکار به صورت کامل عمل می‌کند
5. ✅ Mapping هوشمند: از case-insensitive mapping برای کاربران استفاده می‌کند

---

نکات مهم

1. وابستگی‌ها

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

2. Mapping

• Mapping بر اساس:
  • کاربران: email یا mobile (case-insensitive)
  • کسب‌وکارها: نام کسب‌وکار + owner_id
  • اشخاص: code + business_id
  • کالاها: code + business_id
  • بانک/صندوق/تنخواه: code + business_id
  • چک‌ها: number + business_id

3. انبارها

• نکته مهم: migrate_remaining_businesses_complete.py انبارها را منتقل نمی‌کند
• باید جداگانه با migrate_warehouses_complete.py اجرا شود

4. فاکتورها

• فاکتورها باید بعد از انتقال تمام موارد دیگر منتقل شوند
• از migrate_invoices_complete.py استفاده می‌شود که از invoice_service استفاده می‌کند

---

نتیجه‌گیری

✅ بله، امکان انتقال کامل وجود دارد!

راه‌حل پیشنهادی:

1. برای کسب‌وکارهای باقی‌مانده (250 کسب‌وکار):

   migrate_remaining_businesses_complete.py  → کسب‌وکار + موارد مرتبط (بدون انبار)
   migrate_warehouses_complete.py           → انبارها (اختیاری)
   migrate_invoices_complete.py             → فاکتورها
   

2. این روش:

   • ✅ تمام کسب‌وکارها را منتقل می‌کند
   • ✅ تمام داده‌های مرتبط را منتقل می‌کند
   • ✅ فاکتورهای باقی‌مانده را قابل انتقال می‌کند
   • ✅ نیاز به mapping دستی ندارد

3. بعد از اجرا:

   • تمام 3,651 فاکتور باقی‌مانده قابل انتقال خواهند بود
   • فقط 114 فاکتور بدون row/product/person قابل انتقال نیستند

---

اقدامات پیشنهادی

1. ✅ اجرای migrate_remaining_businesses_complete.py برای انتقال کسب‌وکارها
2. ✅ (اختیاری) اجرای migrate_warehouses_complete.py برای انبارها
3. ✅ اجرای مجدد migrate_invoices_complete.py برای انتقال فاکتورهای باقی‌مانده

---

وضعیت کلی: ✅ آماده برای انتقال کامل