Files
clinicpro/docs/tasks/task-17-sms/database.md
T
hamed de1a78a235 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.
2026-06-09 22:00:34 +03:30

2.1 KiB
Raw Blame History

پایگاه داده — تسک ۱۷: ماژول پیامک

جدول: 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

ایندکس‌ها

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)