Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/hesabixAPI/docs/BANK_CASH_PETTY_MIGRATION_ANALYSIS.md
2026-04-14 19:34:55 +03:30

246 lines
11 KiB
Markdown
Executable file

# تحلیل انتقال بانک، صندوق و تنخواه
## بررسی جداول
### دیتابیس قدیمی (hesabixOld)
#### 1. جدول `bank_account` (حساب‌های بانکی)
- **تعداد رکوردها**: 2,879
- **ساختار**:
- `id`: int (PK)
- `bid_id`: int (FK به business)
- `name`: varchar(255) - نام حساب (NOT NULL نیست اما همه رکوردها مقدار دارند)
- `card_num`: varchar(255) - شماره کارت
- `shaba`: varchar(255) - شماره شبا
- `account_num`: varchar(255) - شماره حساب
- `owner`: varchar(255) - نام صاحب حساب
- `shobe`: varchar(255) - شعبه
- `pos_num`: varchar(255) - شماره POS
- `des`: varchar(255) - توضیحات
- `mobile_internet_bank`: varchar(25) - موبایل/اینترنت بانک
- `code`: varchar(255) - کد (NOT NULL)
- `balance`: varchar(255) - موجودی (استفاده نمی‌شود)
- `money_id`: int (FK به money) - ارز
#### 2. جدول `cashdesk` (صندوق)
- **تعداد رکوردها**: 1,327
- **ساختار**:
- `id`: int (PK)
- `bid_id`: int (FK به business) - NOT NULL
- `name`: varchar(255) - نام (NOT NULL)
- `des`: longtext - توضیحات
- `code`: varchar(255) - کد (NOT NULL)
- `balance`: varchar(255) - موجودی (استفاده نمی‌شود)
- `money_id`: int (FK به money) - ارز
**نکته مهم**: جدول `cashdesk` شامل صندوق‌ها است:
- همه رکوردها باید به `cash_registers` منتقل شوند
- هیچ موردی از `cashdesk` نباید به `petty_cash` منتقل شود
#### 3. جدول `salary` (تنخواه/تنخواه گردان)
- **تعداد رکوردها**: 395
- **ساختار**:
- `id`: int (PK)
- `bid_id`: int (FK به business) - NOT NULL
- `name`: varchar(255) - نام (NOT NULL)
- `des`: longtext - توضیحات
- `code`: varchar(255) - کد (NOT NULL)
- `balance`: varchar(255) - موجودی (استفاده نمی‌شود)
- `money_id`: int (FK به money) - ارز
**نکته مهم**: جدول `salary` شامل تنخواه/تنخواه گردان‌ها است:
- همه رکوردها باید به `petty_cash` منتقل شوند
- تنخواه و تنخواه گردان یکسان هستند و تفاوتی بین آنها نیست
### دیتابیس جدید (hesabixpy)
#### 1. جدول `bank_accounts` (حساب‌های بانکی)
- `id`: int (PK)
- `business_id`: int (FK)
- `code`: varchar(50) - nullable
- `name`: varchar(255) - NOT NULL
- `description`: varchar(500) - nullable
- `branch`: varchar(255) - nullable (شعبه)
- `account_number`: varchar(50) - nullable
- `sheba_number`: varchar(30) - nullable
- `card_number`: varchar(20) - nullable
- `owner_name`: varchar(255) - nullable
- `pos_number`: varchar(50) - nullable
- `payment_id`: varchar(100) - nullable
- `currency_id`: int (FK) - NOT NULL
- `is_active`: boolean (default: true)
- `is_default`: boolean (default: false)
- `created_at`: datetime
- `updated_at`: datetime
#### 2. جدول `cash_registers` (صندوق)
- `id`: int (PK)
- `business_id`: int (FK)
- `code`: varchar(50) - nullable
- `name`: varchar(255) - NOT NULL
- `description`: varchar(500) - nullable
- `currency_id`: int (FK) - NOT NULL
- `is_active`: boolean (default: true)
- `is_default`: boolean (default: false)
- `payment_switch_number`: varchar(100) - nullable
- `payment_terminal_number`: varchar(100) - nullable
- `merchant_id`: varchar(100) - nullable
- `created_at`: datetime
- `updated_at`: datetime
#### 3. جدول `petty_cash` (تنخواه گردان)
- `id`: int (PK)
- `business_id`: int (FK)
- `code`: varchar(50) - nullable
- `name`: varchar(255) - NOT NULL
- `description`: varchar(500) - nullable
- `currency_id`: int (FK) - NOT NULL
- `is_active`: boolean (default: true)
- `is_default`: boolean (default: false)
- `created_at`: datetime
- `updated_at`: datetime
## نگاشت فیلدها
### 1. انتقال `bank_account` → `bank_accounts`
| فیلد قدیمی | فیلد جدید | تبدیل |
|------------|-----------|-------|
| `bid_id` | `business_id` | نگاشت از business_id قدیمی به جدید |
| `code` | `code` | مستقیم (محدود به 50 کاراکتر) |
| `name` | `name` | مستقیم |
| `des` | `description` | مستقیم (محدود به 500 کاراکتر) |
| `shobe` | `branch` | مستقیم |
| `account_num` | `account_number` | مستقیم (محدود به 50 کاراکتر) |
| `shaba` | `sheba_number` | مستقیم (محدود به 30 کاراکتر) |
| `card_num` | `card_number` | مستقیم (محدود به 20 کاراکتر) |
| `owner` | `owner_name` | مستقیم |
| `pos_num` | `pos_number` | مستقیم (محدود به 50 کاراکتر) |
| `mobile_internet_bank` | `payment_id` | مستقیم (محدود به 100 کاراکتر) |
| `money_id` | `currency_id` | نگاشت از money_id قدیمی به currency_id جدید |
| - | `is_active` | پیش‌فرض: true |
| - | `is_default` | پیش‌فرض: false |
**نکات**:
- فیلد `balance` در دیتابیس قدیمی استفاده نمی‌شود و منتقل نمی‌شود
- همه فیلدهای رشته‌ای باید به طول مجاز محدود شوند
- `code` در دیتابیس قدیمی NOT NULL است اما در جدید nullable است
### 2. انتقال `cashdesk` → `cash_registers`
- همه رکوردهای `cashdesk` باید به `cash_registers` منتقل شوند
- هیچ موردی از `cashdesk` نباید به `petty_cash` منتقل شود
### 3. انتقال `salary` → `petty_cash`
- همه رکوردهای `salary` باید به `petty_cash` منتقل شوند
- تنخواه و تنخواه گردان یکسان هستند و تفاوتی بین آنها نیست
#### نگاشت فیلدها برای `cash_registers`:
| فیلد قدیمی | فیلد جدید | تبدیل |
|------------|-----------|-------|
| `bid_id` | `business_id` | نگاشت از business_id قدیمی به جدید |
| `code` | `code` | مستقیم (محدود به 50 کاراکتر) |
| `name` | `name` | مستقیم |
| `des` | `description` | مستقیم (محدود به 500 کاراکتر) |
| `money_id` | `currency_id` | نگاشت از money_id قدیمی به currency_id جدید |
| - | `is_active` | پیش‌فرض: true |
| - | `is_default` | پیش‌فرض: false |
| - | `payment_switch_number` | NULL |
| - | `payment_terminal_number` | NULL |
| - | `merchant_id` | NULL |
#### نگاشت فیلدها برای `petty_cash` (از `salary`):
| فیلد قدیمی | فیلد جدید | تبدیل |
|------------|-----------|-------|
| `bid_id` | `business_id` | نگاشت از business_id قدیمی به جدید |
| `code` | `code` | مستقیم (محدود به 50 کاراکتر) |
| `name` | `name` | مستقیم |
| `des` | `description` | مستقیم (محدود به 500 کاراکتر) |
| `money_id` | `currency_id` | نگاشت از money_id قدیمی به currency_id جدید |
| - | `is_active` | پیش‌فرض: true |
| - | `is_default` | پیش‌فرض: false |
**نکته**: تنخواه و تنخواه گردان یکسان هستند و هر دو به `petty_cash` منتقل می‌شوند.
## نگاشت ارز (money_id → currency_id)
از تحلیل قبلی می‌دانیم:
- `money_id = 1` → `currency_id = 1` (IRR)
- `money_id = 2` → `currency_id = 2` (USD)
- `money_id = 3` → `currency_id = 20` (AFN)
- `money_id = 4` → `currency_id = 19` (IQD)
**توزیع در bank_account**:
- `money_id = 1`: 2,604 مورد (90.4%)
- `money_id = 2`: 9 مورد (0.3%)
- `money_id = 3`: 4 مورد (0.1%)
- `NULL`: 262 مورد (9.1%)
**توزیع در cashdesk**:
- `money_id = 1`: 1,117 مورد (84.2%)
- `money_id = 2`: 35 مورد (2.6%)
- `money_id = 3`: 8 مورد (0.6%)
- `NULL`: 167 مورد (12.6%)
**توزیع در salary**:
- `money_id = 1`: 342 مورد (86.6%)
- `money_id = 2`: 10 مورد (2.5%)
- `money_id = 3`: 1 مورد (0.3%)
- `NULL`: 42 مورد (10.6%)
**نکته**: برای مواردی که `money_id` NULL است، باید از ارز پیش‌فرض کسب و کار استفاده کنیم.
## چالش‌ها و راه‌حل‌ها
### 1. محدودیت طول فیلدها
- `code`: در قدیمی varchar(255)، در جدید varchar(50) → ✅ حداکثر 4 کاراکتر (مشکلی ندارد)
- `description`: در قدیمی varchar(255) یا longtext، در جدید varchar(500) → باید truncate شود (اگر بیش از 500 کاراکتر باشد)
- `sheba_number`: در قدیمی varchar(255)، در جدید varchar(30) → ⚠️ حداکثر 51 کاراکتر (باید truncate شود)
- `card_number`: در قدیمی varchar(255)، در جدید varchar(20) → ⚠️ حداکثر 53 کاراکتر (باید truncate شود)
- `account_number`: در قدیمی varchar(255)، در جدید varchar(50) → ⚠️ حداکثر 157 کاراکتر (باید truncate شود)
### 2. تشخیص صندوق از تنخواه
- جدول `cashdesk` → `cash_registers` (همه موارد - هیچ موردی به `petty_cash` نمی‌رود)
- جدول `salary` → `petty_cash` (همه موارد)
- **نکته مهم**: تنخواه و تنخواه گردان یکسان هستند و تفاوتی بین آنها نیست
### 3. مدیریت NULL در money_id
- اگر `money_id` NULL باشد، از `default_currency_id` کسب و کار استفاده می‌کنیم
- اگر کسب و کار `default_currency_id` نداشته باشد، از IRR (currency_id = 1) استفاده می‌کنیم
### 4. تکراری بودن code
- در دیتابیس قدیمی، `code` در هر کسب و کار ممکن است تکراری باشد
- در دیتابیس جدید، `(business_id, code)` باید unique باشد
- باید بررسی کنیم که آیا code تکراری وجود دارد یا نه
### 5. bid_id NULL در cashdesk
- ✅ بررسی شده: هیچ رکوردی با `bid_id` NULL وجود ندارد
- همه رکوردها قابل انتقال هستند
### 6. تکراری بودن code در هر کسب و کار
- ✅ بررسی شده: هیچ code تکراری در هر کسب و کار وجود ندارد
- همه رکوردها قابل انتقال هستند
## آمار کلی
- **حساب‌های بانکی**: 2,879 رکورد → `bank_accounts`
- **صندوق (cashdesk)**: 1,327 رکورد → `cash_registers` (همه موارد)
- **تنخواه/تنخواه گردان (salary)**: 395 رکورد → `petty_cash`
**نکته مهم**:
- هیچ موردی از `cashdesk` به `petty_cash` منتقل نمی‌شود
- تنخواه و تنخواه گردان یکسان هستند و هر دو به `petty_cash` منتقل می‌شوند
## مراحل اجرا
1. ایجاد mapping بین `business_id` قدیمی و جدید
2. ایجاد mapping بین `money_id` قدیمی و `currency_id` جدید
3. انتقال `bank_account` → `bank_accounts`
4. انتقال `cashdesk` → `cash_registers` (همه موارد - هیچ موردی به `petty_cash` نمی‌رود)
5. انتقال `salary` → `petty_cash` (همه موارد - تنخواه و تنخواه گردان یکسان هستند)
7. بررسی و مدیریت موارد تکراری
8. بررسی و مدیریت موارد با `bid_id` NULL (✅ همه رکوردها bid_id دارند)