feat: add per-org SMS wallet with adm panel and header credit

Bill all platform SMS (including OTP), allow negative balance with manual/auto cutoffs, and support own-panel bypass without wallet debit.

apps/api/src/contacts/contacts.module.ts

@@ -8,7 +8,6 @@ import { CompaniesService } from './companies.service';
 import { PeopleController } from './people.controller';
 import { PeopleService } from './people.service';
 import { ContactsExcelService } from './contacts-excel.service';
-import { SmsService } from '../common/sms.service';
 import { BehaviorModule } from '../behavior/behavior.module';
 
 @Module({
@@ -20,7 +19,7 @@ import { BehaviorModule } from '../behavior/behavior.module';
     BehaviorModule,
   ],
   controllers: [PeopleController, CompaniesController],
-  providers: [PeopleService, CompaniesService, ContactsExcelService, SmsService],
+  providers: [PeopleService, CompaniesService, ContactsExcelService],
   exports: [PeopleService, CompaniesService],
 })
 export class ContactsModule {}

apps/api/src/contacts/people.service.ts

@@ -41,7 +41,7 @@ import { MessageAutomationsService } from '../message-automations/message-automa
 import { WebhooksService } from '../public-api/webhooks.service';
 import { GamificationService } from '../gamification/gamification.service';
 import { parseBirthDate } from '../common/excel';
-import { SmsService } from '../common/sms.service';
+import { SmsGatewayService } from '../sms-billing/sms-gateway.service';
 import { selectMonthBirthdays } from './birthday-month';
 import { renderSmsText } from '../common/sms-text';
 import { normalizeTags } from '../common/tags';
@@ -131,7 +131,7 @@ export class PeopleService implements OnModuleInit {
     private readonly messageAutomations: MessageAutomationsService,
     private readonly webhooks: WebhooksService,
     private readonly game: GamificationService,
-    private readonly sms: SmsService,
+    private readonly sms: SmsGatewayService,
     private readonly outboundSms: OutboundSmsLogService,
     private readonly behaviorAccess: BehaviorAccessService,
   ) {}
@@ -662,7 +662,12 @@ export class PeopleService implements OnModuleInit {
       company: person.company?.name ?? '',
     });
     if (!message) throw new BadRequestException('متن پیامک خالی است.');
-    const result = await this.sms.sendSmsDetailed(mobile, message);
+    const result = await this.sms.send({
+      organizationId: actor.organizationId,
+      phone: mobile,
+      text: message,
+      source: 'manual',
+    });
     await this.outboundSms.record({
       organizationId: actor.organizationId,
       personId: person.id,
@@ -675,9 +680,11 @@ export class PeopleService implements OnModuleInit {
     });
     if (!result.ok) {
       throw new ServiceUnavailableException(
-        result.reason === 'SMS not configured'
-          ? 'ارسال پیامک روی سرور فعال نیست.'
-          : 'پیامک ارسال نشد. کمی بعد دوباره تلاش کنید.',
+        result.blocked
+          ? 'ارسال پیامک به‌خاطر محدودیت اعتبار مسدود است.'
+          : result.reason === 'SMS not configured'
+            ? 'ارسال پیامک روی سرور فعال نیست.'
+            : 'پیامک ارسال نشد. کمی بعد دوباره تلاش کنید.',
       );
     }
     return { ok: true };
@@ -698,7 +705,12 @@ export class PeopleService implements OnModuleInit {
       company: person.company?.name ?? '',
     });
     if (!message) throw new BadRequestException('متن پیامک خالی است.');
-    const result = await this.sms.sendSmsDetailed(mobile, message);
+    const result = await this.sms.send({
+      organizationId: actor.organizationId,
+      phone: mobile,
+      text: message,
+      source: 'manual',
+    });
     await this.outboundSms.record({
       organizationId: actor.organizationId,
       personId: person.id,
@@ -711,9 +723,11 @@ export class PeopleService implements OnModuleInit {
     });
     if (!result.ok) {
       throw new ServiceUnavailableException(
-        result.reason === 'SMS not configured'
-          ? 'ارسال پیامک روی سرور فعال نیست.'
-          : 'پیامک ارسال نشد. کمی بعد دوباره تلاش کنید.',
+        result.blocked
+          ? 'ارسال پیامک به‌خاطر محدودیت اعتبار مسدود است.'
+          : result.reason === 'SMS not configured'
+            ? 'ارسال پیامک روی سرور فعال نیست.'
+            : 'پیامک ارسال نشد. کمی بعد دوباره تلاش کنید.',
       );
     }
     return { ok: true };