235 lines
7.6 KiB
Markdown
235 lines
7.6 KiB
Markdown
# چک‌لیست Deploy — برنچ ماژولار
|
||
|
||
بر اساس تجربه deploy روی **abshode_rahimi** (و الگوی مشابه برای groosy، abaeigold، bazre_tala، ...).
|
||
|
||
---
|
||
|
||
## قبل از deploy
|
||
|
||
- [ ] **بکاپ کامل DB** (mysqldump) — اجباری روی production
|
||
- [ ] کد جدید روی سرور (git pull / rsync) و `composer install` در صورت نیاز
|
||
- [ ] `.env` سرور درست است (`DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD`)
|
||
- [ ] `php artisan config:clear` بعد از تغییر `.env`
|
||
|
||
---
|
||
|
||
## بررسی پوشه migrations (خیلی مهم)
|
||
|
||
روی سرور فقط این **۸ فایل** باید در `database/migrations/` باشد:
|
||
|
||
```
|
||
2026_05_25_163201_add_provider_fields_to_orders_table.php
|
||
2026_06_02_000001_add_price_offset_percent_to_products_table.php
|
||
2026_06_06_000001_add_total_referrals_to_customers_table.php
|
||
2026_06_06_000002_alter_logs_data_to_longtext.php
|
||
2026_06_06_000003_add_order_limit_columns_to_products_table.php
|
||
2026_06_09_000001_add_show_in_assets_to_products_table.php
|
||
2026_06_10_000001_add_use_last_price_if_zero_to_products_table.php
|
||
2026_06_10_000002_add_type_column_to_settings_table.php
|
||
```
|
||
|
||
- [ ] فایل‌های قدیمی **حذف** شده‌اند (`2014_*`, `2019_*`, `2021_*`, `2023_*` create_*)
|
||
- [ ] اگر migration legacy مخصوص همان سرور مانده (مثلاً `wallet_moudle`) → در بخش «legacy» پایین چک‌لیست
|
||
|
||
```bash
|
||
ls database/migrations/*.php
|
||
```
|
||
|
||
---
|
||
|
||
## سناریو A — DB موجود (production با داده)
|
||
|
||
> ⚠️ اگر جدول `migrations` خالی باشد و مستقیم `php artisan migrate` بزنید، Laravel کل
|
||
> `database/schema/mysql-schema.sql` را load می‌کند (**DROP TABLE + CREATE**) و داده‌ها از بین می‌رود.
|
||
|
||
### ترتیب اجرا
|
||
|
||
```bash
|
||
cd /path/to/server
|
||
|
||
# ۱) baseline — حتماً قبل از migrate
|
||
mysql -h DB_HOST -P DB_PORT -u DB_USER -p DB_NAME \
|
||
< database/sql/baseline_migrations.sql
|
||
|
||
# ۲) schema incremental
|
||
php artisan migrate:status
|
||
php artisan migrate
|
||
|
||
# ۳) settings + const
|
||
mysql -h DB_HOST -P DB_PORT -u DB_USER -p DB_NAME \
|
||
< database/sql/deploy_settings_const.sql
|
||
```
|
||
|
||
- [ ] `baseline_migrations.sql` اجرا شد **قبل از** `migrate`
|
||
- [ ] `migrate:status` — همه migrationها **Ran** (یا فقط موارد جدید **Pending**)
|
||
- [ ] `deploy_settings_const.sql` اجرا شد
|
||
|
||
### مقادیر mysql
|
||
|
||
`HOST`, `PORT`, `USER`, `DATABASE` placeholder نیستند — از `.env` بخوانید:
|
||
|
||
```bash
|
||
grep ^DB_ .env
|
||
```
|
||
|
||
مثال:
|
||
|
||
```bash
|
||
mysql -h 91.212.174.137 -P 3030 -u root -p abshode_rahimi < database/sql/baseline_migrations.sql
|
||
```
|
||
|
||
پسورد = همان `DB_PASSWORD` در `.env`.
|
||
|
||
---
|
||
|
||
## سناریو B — DB خالی (نصب از صفر)
|
||
|
||
```bash
|
||
php artisan migrate # schema dump + ۸ migration
|
||
mysql ... < database/sql/deploy_settings_const.sql
|
||
```
|
||
|
||
- [ ] بعد از migrate جدول‌ها ساخته شدند
|
||
- [ ] settings/const با SQL پر شدند
|
||
- [ ] مقادیر tenant (نام، URL، توکن، main_product، ...) دستی در پنل یا UPDATE تنظیم شدند
|
||
|
||
---
|
||
|
||
## migrationهای legacy سرور
|
||
|
||
بعضی سرورها فایل PHP قدیمی دارند که در repo ماژولار نیست:
|
||
|
||
| migration | جدول |
|
||
|-----------|------|
|
||
| `2019_12_14_000001_create_personal_access_tokens_table` | `personal_access_tokens` |
|
||
| `2021_12_02_065938_create_wallet_moudle_table` | `wallet_moudle` (اختیاری) |
|
||
|
||
اگر جدول **از قبل هست** و فایل PHP هنوز روی سرور است:
|
||
|
||
- [ ] یا فایل PHP را حذف کنید
|
||
- [ ] یا در جدول `migrations` ثبت کنید (fake):
|
||
|
||
```sql
|
||
INSERT INTO migrations (migration, batch) VALUES
|
||
('2019_12_14_000001_create_personal_access_tokens_table', 1),
|
||
('2021_12_02_065938_create_wallet_moudle_table', 1);
|
||
```
|
||
|
||
یا یک‌جا:
|
||
|
||
```bash
|
||
mysql -u root -p DB_NAME < database/sql/fix_migrations_after_failed_migrate.sql
|
||
```
|
||
|
||
(این اسکریپت legacy بالا را هم شامل می‌شود — migrationهای اضافی سرور را در انتهای فایل اضافه کنید.)
|
||
|
||
---
|
||
|
||
## بعد از deploy — تأیید
|
||
|
||
```bash
|
||
php artisan migrate:status # همه Ran یا Nothing to migrate
|
||
php artisan migrate # Nothing to migrate
|
||
|
||
# داده
|
||
mysql -e "SELECT COUNT(*) FROM customers;" DB_NAME
|
||
mysql -e "SELECT COUNT(*) FROM settings;" DB_NAME
|
||
|
||
# کلیدهای مهم
|
||
mysql -e "SELECT \`key\`, LEFT(value,40) FROM settings WHERE \`key\` IN ('price_provider','main_product','name_fa');" DB_NAME
|
||
```
|
||
|
||
- [ ] سایت / API بالا می‌آید
|
||
- [ ] پنل ادمین settings را نشان می‌دهد
|
||
- [ ] `value`های قبلی tenant حفظ شده (مثلاً `price_provider`, توکن‌ها, `main_product`)
|
||
|
||
---
|
||
|
||
## deploy_settings_const — رفتار روی value
|
||
|
||
| وضعیت | نتیجه |
|
||
|--------|--------|
|
||
| کلید از قبل هست | `value` **حفظ** — فقط title/type/description آپدیت |
|
||
| کلید جدید | INSERT با مقدار پیش‌فرض اسکریپت |
|
||
| کلید legacy/test | **DELETE** (`test*`, `goldir*`, `is_requaire_referral`, ...) |
|
||
|
||
- [ ] قبل از SQL، لیست DELETE را در `deploy_settings_const.sql` مرور کردید
|
||
- [ ] اگر tenant به کلید legacy وابسته است، DELETE را comment کنید
|
||
|
||
---
|
||
|
||
## اگر اشتباه شد — بازیابی
|
||
|
||
### خطا: `Table 'personal_access_tokens' already exists`
|
||
|
||
علت: `migrations` خالی بود یا migration قدیمی Pending مانده.
|
||
|
||
```bash
|
||
# ۱) migrate نزنید
|
||
# ۲) فیکس migrations
|
||
mysql ... < database/sql/fix_migrations_after_failed_migrate.sql
|
||
# ۳) migrationهای قدیمی را از پوشه حذف یا fake کنید
|
||
php artisan migrate:status
|
||
```
|
||
|
||
### داده‌ها پاک شد (schema dump اجرا شد)
|
||
|
||
```bash
|
||
# restore بکاپ — fix_migrations داده برنمی‌گرداند
|
||
mysql ... < backup.sql
|
||
# سپس از اول با baseline_migrations.sql
|
||
```
|
||
|
||
### خطا: `Unknown MySQL server host 'HOST'`
|
||
|
||
مقادیر واقعی `.env` را جایگزین placeholder کنید.
|
||
|
||
### خطا: `3030\r` هنگام source .env
|
||
|
||
فایل `.env` خط Windows (`\r\n`) دارد — دستی mysql بزنید یا:
|
||
|
||
```bash
|
||
DB_PORT=$(grep ^DB_PORT= .env | cut -d= -f2- | tr -d '\r"')
|
||
```
|
||
|
||
---
|
||
|
||
## tenantهای خاص (اختیاری)
|
||
|
||
بعد از `deploy_settings_const.sql`، در صورت نیاز اسکریپت مخصوص همان مشتری:
|
||
|
||
| پروژه | فایل اضافی |
|
||
|--------|------------|
|
||
| groosi | `garoosi_gold_settings_finish.sql` |
|
||
| bazre_tala | `bazre_tala_settings_update.sql` |
|
||
| goldali | `goldali_post_merge_settings.sql` |
|
||
| abshode_rahimi | `abshode_rahimi_merge_goldali_catalog.sql` |
|
||
|
||
- [ ] فقط اسکریپت **همان tenant** اجرا شد (نه همه SQLها روی همه DBها)
|
||
|
||
---
|
||
|
||
## خلاصه یک‌خطی (DB موجود)
|
||
|
||
```
|
||
بکاپ → baseline_migrations.sql → migrate → deploy_settings_const.sql → تست
|
||
```
|
||
|
||
**هرگز:** `php artisan migrate` روی DB پر بدون `baseline_migrations.sql` وقتی `migrations` خالی است.
|
||
|
||
---
|
||
|
||
## فایل‌های مرجع
|
||
|
||
| فایل | کار |
|
||
|------|-----|
|
||
| `database/schema/mysql-schema.sql` | baseline schema (نصب از صفر) |
|
||
| `database/sql/baseline_migrations.sql` | قبل از migrate روی DB موجود |
|
||
| `database/sql/fix_migrations_after_failed_migrate.sql` | بعد از خطای migrate |
|
||
| `database/sql/deploy_settings_const.sql` | settings + const |
|
||
| `database/sql/deploy_safe_schema.sql` | جایگزین قدیمی schema-only (بدون settings) |
|
||
|
||
---
|
||
|
||
*آخرین به‌روزرسانی: بر اساس deploy abshode_rahimi — ژوئن ۲۰۲۶*
|