feat: Implement SMS sending functionality with KavehNegar and Rangineh providers

- 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.
This commit is contained in:
hamed
2026-06-09 22:00:34 +03:30
commit de1a78a235
222 changed files with 36388 additions and 0 deletions
+44
View File
@@ -0,0 +1,44 @@
# پایگاه داده — تسک ۱۷: ماژول پیامک
## جدول: sms_accounts (حساب پیامک)
_(از Manual بخش ۴.۱ — entity جدید در Symfony)_
| ستون | نوع | توضیح |
|------|-----|-------|
| id | INT AUTO_INCREMENT PK | |
| uuid | CHAR(36) UNIQUE NOT NULL | |
| user_id | INT FK → users.id NOT NULL | کاربر مالک |
| owner_type | VARCHAR(10) NOT NULL | `doctor` یا `clinic` |
| owner_id | INT NOT NULL | FK به doctors.id یا clinics.id |
| balance | INT DEFAULT 0 | تعداد پیامک باقی‌مانده |
| created_at | INT NOT NULL | Unix timestamp |
| updated_at | INT NOT NULL | Unix timestamp |
## جدول: sms_queue (صف پیامک)
_(از Manual بخش ۴.۲)_
| ستون | نوع | توضیح |
|------|-----|-------|
| id | INT AUTO_INCREMENT PK | |
| account_id | INT FK → sms_accounts.id CASCADE | حساب پیامک مالک |
| recipient_mobile | VARCHAR(20) NOT NULL | شماره موبایل گیرنده |
| message | TEXT NOT NULL | متن پیامک |
| scheduled_at | INT NOT NULL | زمان برنامه‌ریزی‌شده (Unix timestamp) — معمولاً یک روز قبل از نوبت |
| sent_at | INT NULL | زمان واقعی ارسال |
| status | VARCHAR(20) DEFAULT 'queued' | `queued`, `sent`, `failed`, `cancelled` |
| created_at | INT NOT NULL | |
| updated_at | INT NOT NULL | |
## ایندکس‌ها
```sql
CREATE UNIQUE INDEX idx_sms_accounts_owner ON sms_accounts(owner_type, owner_id);
CREATE INDEX idx_sms_queue_account ON sms_queue(account_id);
CREATE INDEX idx_sms_queue_status ON sms_queue(status, scheduled_at);
CREATE INDEX idx_sms_queue_scheduled ON sms_queue(scheduled_at);
```
## نکات مهم
- هر دکتر/کلینیک فقط یک حساب پیامک دارد (UNIQUE owner_type, owner_id)
- `scheduled_at` معمولاً یک روز قبل از `appointment.start_time` تنظیم می‌شود
- Tauri (نرم‌افزار لوکال) پیامک‌ها را در صف می‌گذارد، بک‌اند آن‌ها را ارسال می‌کند
- کسر موجودی باید atomic باشد (transaction)