Add referral_show setting and keep existing setting values intact.

Allow hiding the referral field on user registration via settings SQL and ConfigService, and document SQL-only Cursor rules that never overwrite live values.

Co-authored-by: Cursor <cursoragent@cursor.com>

database/sql/add_referral_show_setting.sql

@@ -0,0 +1,42 @@
+-- =============================================================================
+-- add_referral_show_setting.sql
+-- کلید نمایش/عدم‌نمایش فیلد «کد معرف» در ثبت‌نام اپ کاربر
+-- کنار referral_id (کد معرف اجباری) در گروه «معرف و پاداش» پنل ادمین
+--
+-- اجرا (DB موجود):
+--   mysql ... < database/sql/add_referral_show_setting.sql
+-- یا با deploy کامل:
+--   mysql ... < database/sql/deploy_settings_const.sql
+-- =============================================================================
+
+START TRANSACTION;
+
+SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci;
+
+INSERT INTO `settings` (`key`, `value`, `title_fa`, `can_edit`, `is_active`, `description`, `type`)
+SELECT
+  'referral_show',
+  'true',
+  'نمایش فیلد کد معرف',
+  1,
+  1,
+  'روشن: فیلد کد معرف در صفحه ثبت‌نام اپ کاربر نمایش داده می‌شود. خاموش: فیلد مخفی است (لینک دعوت با ?id= همچنان اعمال می‌شود). اگر خاموش است، «کد معرف اجباری» را هم خاموش کنید مگر بخواهید فقط از لینک دعوت ثبت‌نام شود.',
+  'switch'
+WHERE NOT EXISTS (SELECT 1 FROM `settings` WHERE `key` = 'referral_show' LIMIT 1);
+
+UPDATE `settings`
+SET
+  `type` = 'switch',
+  `title_fa` = 'نمایش فیلد کد معرف',
+  `can_edit` = 1,
+  `description` = 'روشن: فیلد کد معرف در صفحه ثبت‌نام اپ کاربر نمایش داده می‌شود. خاموش: فیلد مخفی است (لینک دعوت با ?id= همچنان اعمال می‌شود). اگر خاموش است، «کد معرف اجباری» را هم خاموش کنید مگر بخواهید فقط از لینک دعوت ثبت‌نام شود.'
+WHERE `key` = 'referral_show';
+
+UPDATE `settings`
+SET
+  `description` = 'روشن: وارد کردن کد معرف در ثبت‌نام اجباری است. خاموش: کد معرف اختیاری است. اگر «نمایش فیلد کد معرف» خاموش باشد، اجباری بودن اعمال نمی‌شود.'
+WHERE `key` = 'referral_id';
+
+COMMIT;
+
+SELECT 'add_referral_show_setting.sql finished' AS status;