boursecu_server/database/sql/DEPLOY_CHECKLIST.md

# چک‌لیست Deploy — برنچ ماژولار

> **ایمنی:** `php artisan migrate` دیگر `mysql-schema.sql` را auto-load نمی‌کند (DROP TABLE نمی‌زند).  
> فایل schema فقط دستی: `database/schema/mysql-schema.sql.reference`

## قبل از شروع

- [ ] بکاپ DB
- [ ] کد + SQLهای جدید روی سرور (`baseline_migrations.sql` حتماً نسخه جدید — **۱۱ ردیف**)
- [ ] `database/migrations/` فقط ۸ فایل `2026_*`
- [ ] `php artisan config:clear`

---

## DB موجود — ترتیب

```bash
cd /opt/PROJECT/server

DB_HOST=$(grep ^DB_HOST= .env | cut -d= -f2- | tr -d '\r"')
DB_PORT=$(grep ^DB_PORT= .env | cut -d= -f2- | tr -d '\r"')
DB_DATABASE=$(grep ^DB_DATABASE= .env | cut -d= -f2- | tr -d '\r"')
DB_USERNAME=$(grep ^DB_USERNAME= .env | cut -d= -f2- | tr -d '\r"')
DB_PASSWORD=$(grep ^DB_PASSWORD= .env | cut -d= -f2- | tr -d '\r"')

# ۱ baseline
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" \
  < database/sql/baseline_migrations.sql

# باید ۱۱ ردیف چاپ شود (شامل 2019 و 2021)

# ۲ چک DB — اگر کمتر از ۲ بود baseline قدیمی است
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" -N -e \
  "SELECT COUNT(*) FROM migrations WHERE migration LIKE '2019%' OR migration LIKE '2021%';"

# باید: 2

# ۳ status — ۱۰ تا همه Yes
php artisan migrate:status

# ۴ migrate + ۵ settings (یک دستور)
php artisan deploy:tenant
```

**یا جدا:** `php artisan migrate --force` سپس `php artisan settings:deploy`

**یا:** `bash database/sql/run_deploy_tenant.sh`

### چک بعد از مرحله ۲

| خروجی `migrate:status` | کار |
|------------------------|-----|
| ۱۰ تا همه **Yes** | ادامه مرحله ۴ |
| `2019`/`2021` هنوز **No** | `fake_package_migrations.sql` بزن → دوباره status |

```bash
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USERNAME" -p"$DB_PASSWORD" "$DB_DATABASE" \
  < database/sql/fake_package_migrations.sql
php artisan migrate:status
php artisan migrate
```

---

## soroushgold — الان (بعد از خطا)

```bash
cd /opt/soroushgold/server

mysql -h 127.0.0.1 -P 3030 -u root -p soroushgold \
  < database/sql/fake_package_migrations.sql

php artisan migrate:status
php artisan migrate

php artisan settings:deploy
```

---

## DB خالی

```bash
mysql ... < database/schema/mysql-schema.sql.reference
mysql ... < database/sql/baseline_migrations.sql
php artisan migrate
php artisan settings:deploy
```

---

## خطاها

| خطا | فیکس |
|-----|------|
| `Table already exists` | `fake_package_migrations.sql` → `migrate` |
| `Loading stored database schema` | کد قدیمی — `git pull` (دیگر رخ نمی‌دهد). اگر شد: restore بکاپ |
| `2019`/`2021` No بعد از baseline | baseline قدیمی → `fake_package_migrations.sql` |
| `Unknown host HOST` | از `.env` بخوان نه placeholder |
| `Unknown column 'total_referrals'` | `git pull` + `php artisan migrate` (ensure_total_referrals) |
| `Unknown column 'order_limit_enabled'` / محدودیت سفارش ذخیره نمی‌شود | `git pull` + `php artisan migrate` (ensure_products_baseline_columns) |
| `Unknown column 'product_id'` روی `wallets` / `/customer/me` | `mysql ... < database/sql/gholaktala_upgrade.sql` سپس merge settings |
| upgrade کامل قلک طلا | `bash database/sql/run_gholaktala_upgrade.sh` |
| `Nothing to migrate` ولی ستون نیست | baseline فقط در جدول migrations ثبت کرده — migrationهای `ensure_*` را deploy و `migrate` بزنید |

---

## فایل‌ها

| فایل | کار |
|------|-----|
| `baseline_migrations.sql` | ۱۱ migration یکجا |
| `fake_package_migrations.sql` | فقط 2019 + 2021 |
| `deploy_settings_const.sql` | settings + const |
| `ensure_wallet_module_columns.sql` | `wallets.product_id` + ستون‌های transactions برای DB قدیمی |
| `deploy_safe_schema.sql` | ALTERهای idempotent (شامل wallets.product_id) |
| `fix_migrations_after_failed_migrate.sql` | reset کامل migrations |
| `run_deploy_existing_db.sh` | اجرای خودکار + چک |

---

## فوری — gholaktala /customer/me شکسته

```bash
cd /opt/gholak/server   # یا مسیر واقعی پروژه

# بکاپ
mysqldump -h ... -u ... -p DB_NAME > /tmp/gholak_before_wallet_cols.sql

# فقط ستون‌های گم‌شده (داده موجود دست نخورده؛ product_id=NULL = کیف اصلی قدیم)
mysql -h ... -u ... -p DB_NAME < database/sql/ensure_wallet_module_columns.sql

php artisan migrate   # ثبت مایگریشن ensure_wallet_module_columns
php artisan config:clear
```

چک:

```sql
SHOW COLUMNS FROM wallets LIKE 'product_id';
-- باید یک ردیف برگردد
```