feat: update purge commands documentation for clarity on production usage

2026-07-20 11:17:39 +03:30
parent 46d7253ad9
commit 28725792d7
2 changed files with 16 additions and 2 deletions
@@ -285,6 +285,10 @@ php bin/console app:doctors:purge-unclaimed --all-sources   # هر منبعِ غ
 > فقط وقتی حذف می‌شود که غیرفعال (`status=0`) و با موبایلِ `imp_` باشد — تا کاربر واقعی
 > به‌اشتباه پاک نشود.

+> ✅ **این کامند روی پروداکشن قابل اجراست** — با `--i-know-this-is-prod`. برای همین هم
+> ساخته شده: پاک‌کردن دستهٔ اشتباهِ خزنده از روی سایت زنده، بدون دست‌زدن به پزشکان واقعی.
+> با `app:doctors:purge` اشتباه نگیر (پایین) که هرگز روی prod اجرا نمی‌شود.
+
 ### پاک‌سازی کامل برای دیتابیس تست

 حذف **همهٔ** پزشکان + داده‌های وابسته (FK-safe) برای شروع تمیز:
@@ -296,4 +300,13 @@ php bin/console app:doctors:purge --force    # حذف واقعی + کاربرا

 > ⚠️ مخرب — `appointments`/`comments`/`rates` را هم پاک می‌کند. **فقط در محیط
 > `dev`/`test` اجرا می‌شود**؛ روی هر `APP_ENV` دیگری (از جمله `prod`) بدون هیچ راه
-> فراری با خطا متوقف می‌شود.
+> فراری با خطا متوقف می‌شود. سوییچ `--i-know-this-is-prod` اینجا **وجود ندارد** —
+> تنها کامند این خانواده است که هیچ راهی برای اجرا روی prod ندارد.
+
+### خلاصهٔ تفاوت دو کامند حذف
+
+| | `purge-unclaimed` | `purge` |
+|---|---|---|
+| چه چیزی حذف می‌شود | فقط پزشکان خزنده‌ای که claim نشده‌اند | **همهٔ** پزشکان، حتی دستی و claim‌شده |
+| اجرا روی prod | ✅ با `--i-know-this-is-prod` | ❌ هرگز |
+| کاربرد | پاک‌کردن دستهٔ اشتباهِ ایمپورت از سایت زنده | ساخت دیتابیس تمیز برای تست |
@@ -14,7 +14,8 @@ use Symfony\Component\Console\Style\SymfonyStyle;
 * پاک‌سازی کامل همهٔ پزشکان و داده‌های وابسته — برای ساختِ یک دیتابیس تمیزِ تست.
 *
 * مخرب است: بدون --force فقط تعداد رکوردهای هر جدول را گزارش می‌دهد (dry-run).
- * روی prod نیازمند --i-know-this-is-prod است.
+ * فقط در dev/test اجرا می‌شود و برای prod هیچ راه فراری ندارد — برخلاف
+ * app:doctors:purge-unclaimed که با --i-know-this-is-prod روی prod هم اجرا می‌شود.
 *
 *   php bin/console app:doctors:purge            # فقط گزارش
 *   php bin/console app:doctors:purge --force     # پاک‌سازی