hamed
de1a78a235
- Add SendSmsMessage class for encapsulating SMS message data. - Create KavehNegarProvider and RanginehProvider classes implementing SmsProviderInterface for sending SMS. - Implement SmsLogRepository and SmsTemplateRepository for managing SMS logs and templates. - Develop SendSmsHandler for handling SMS sending messages. - Create SmsService to manage SMS dispatching and logging. - Add UserProfileController for managing user profiles with CRUD operations. - Implement UserProfile entity and repository for user profile data management. - Update symfony.lock and bootstrap.php for project dependencies and environment setup.
71 lines
1.8 KiB
Markdown
71 lines
1.8 KiB
Markdown
# نکات پیادهسازی — تسک ۱۷: ماژول پیامک
|
|
|
|
## API Endpoints
|
|
|
|
### GET /api/v1/sms/balance
|
|
```json
|
|
// Response 200:
|
|
{
|
|
"owner_id": 29,
|
|
"owner_type": "doctor",
|
|
"balance": 850
|
|
}
|
|
|
|
// Error 404: حساب پیامک وجود ندارد
|
|
// Error 401: احراز هویت لازم است
|
|
```
|
|
|
|
### POST /api/v1/sms/queue
|
|
```json
|
|
// Request:
|
|
{
|
|
"recipient_mobile": "09121234567",
|
|
"message": "یادآوری: نوبت شما فردا ساعت ۱۰:۰۰ است",
|
|
"scheduled_at": "2025-06-15T09:00:00+03:30"
|
|
}
|
|
|
|
// Response 201:
|
|
{
|
|
"id": 1,
|
|
"status": "queued",
|
|
"scheduled_at": 1749970200,
|
|
"remaining_balance": 849
|
|
}
|
|
|
|
// Error 402: موجودی ناکافی
|
|
// Error 400: شماره موبایل یا پیام نامعتبر
|
|
```
|
|
|
|
## منطق کسر موجودی (atomic)
|
|
```php
|
|
// در SmsService.php:
|
|
$this->entityManager->beginTransaction();
|
|
$account = $this->smsAccountRepo->findByOwner($ownerType, $ownerId);
|
|
if ($account->getBalance() <= 0) {
|
|
throw new InsufficientBalanceException();
|
|
}
|
|
$account->decrementBalance();
|
|
// add to queue
|
|
$this->entityManager->commit();
|
|
```
|
|
|
|
## تشخیص owner از JWT token
|
|
```php
|
|
// کاربر لاگینشده → چک کن دکتر است یا کلینیک
|
|
$user = $this->getUser();
|
|
if ($user->hasRole('ROLE_DOCTOR')) {
|
|
$doctor = $this->doctorRepo->findByUser($user);
|
|
$ownerType = 'doctor'; $ownerId = $doctor->getId();
|
|
} elseif ($user->hasRole('ROLE_CLINIC')) {
|
|
$clinic = $this->clinicRepo->findByUser($user);
|
|
$ownerType = 'clinic'; $ownerId = $clinic->getId();
|
|
}
|
|
```
|
|
|
|
## نکته: ارسال واقعی پیامک
|
|
پیامکها توسط یک Job/Command ارسال میشوند (نه در همان request):
|
|
```
|
|
php bin/console sms:send-queued
|
|
```
|
|
این command پیامکهایی با `status=queued` و `scheduled_at <= now` را ارسال میکند.
|