Refactor SMS sending to use KavehNegar VerifyLookup templates

- Removed SmsTextResolver dependency from multiple services and controllers.
- Introduced dispatchTemplate method in SmsService to handle SMS sending with templates.
- Updated existing SMS sending logic across various services (OtpService, PreRegistrationController, ClinicInvitationService, PaymentManager, SecretaryController, RepresentationActionController) to utilize the new dispatchTemplate method.
- Enhanced SmsMessageTemplate entity to include kavenegar_template and token_map fields.
- Created migration to add new fields to the sms_message_templates table and populate them with existing data.
- Updated SeedSmsMessageTemplatesCommand to handle new template structure.
- Added documentation for the new SMS template structure and usage.

src/Sms/Service/SmsService.php

@@ -3,11 +3,13 @@
 namespace App\Sms\Service;
 
 use App\Sms\Entity\SmsLog;
+use App\Sms\Entity\SmsMessageTemplate;
 use App\Sms\Message\SendSmsMessage;
 use App\Sms\Provider\KavehNegarProvider;
 use App\Sms\Provider\RanginehProvider;
 use App\Sms\Provider\SmsProviderInterface;
 use App\Sms\Repository\SmsLogRepository;
+use App\Sms\Repository\SmsMessageTemplateRepository;
 use Symfony\Component\Messenger\MessageBusInterface;
 
 class SmsService
@@ -15,10 +17,12 @@ class SmsService
     private array $providers;
 
     public function __construct(
-        private readonly KavehNegarProvider  $kavenegar,
-        private readonly RanginehProvider    $rangineh,
-        private readonly SmsLogRepository    $logRepo,
-        private readonly MessageBusInterface $bus,
+        private readonly KavehNegarProvider           $kavenegar,
+        private readonly RanginehProvider             $rangineh,
+        private readonly SmsLogRepository             $logRepo,
+        private readonly MessageBusInterface          $bus,
+        private readonly SmsMessageTemplateRepository $messageTemplateRepo,
+        private readonly SmsTextResolver              $textResolver,
     ) {
         $this->providers = [
             'kavenegar' => $kavenegar,
@@ -26,6 +30,37 @@ class SmsService
         ];
     }
 
+    /**
+     * ارسال یک پیامک سیستمی از طریق تمپلت VerifyLookup کاوه‌نگار.
+     * فقط تگ + متغیرهای منطقی می‌گیرد؛ نام تمپلت و نگاشت token از SmsMessageTemplate (یا DEFAULTS) خوانده می‌شود.
+     *
+     * @param array<string,string|int> $vars متغیرهای منطقی (کلیدهای {...} بدنه)
+     */
+    public function dispatchTemplate(string $tag, string $mobile, array $vars = [], string $provider = 'kavenegar'): void
+    {
+        $tpl = $this->messageTemplateRepo->findByTag($tag);
+        $kaveTemplate = $tpl?->getKavenegarTemplate()
+            ?? (SmsMessageTemplate::DEFAULTS[$tag]['kavenegar_template'] ?? null);
+        $tokenMap = $tpl?->getTokenMap()
+            ?: (SmsMessageTemplate::DEFAULTS[$tag]['token_map'] ?? []);
+
+        $message = $this->textResolver->resolve($tag, $vars);
+
+        if ($kaveTemplate === null || $tokenMap === []) {
+            $this->dispatchAsync($mobile, $message, $provider, tag: $tag);
+            return;
+        }
+
+        $slotVars = [];
+        foreach ($tokenMap as $logicalKey => $slot) {
+            if (array_key_exists($logicalKey, $vars)) {
+                $slotVars[$slot] = (string) $vars[$logicalKey];
+            }
+        }
+
+        $this->dispatchAsync($mobile, $message, $provider, templateVars: $slotVars, templateCode: $kaveTemplate, tag: $tag);
+    }
+
     public function dispatchAsync(
         string $mobile,
         string $message,