98 lines
3.7 KiB
Markdown
98 lines
3.7 KiB
Markdown
# پایگاه داده — تسک ۱۴: پنل پیامکی
|
|
|
|
## جدول: sms_wallets
|
|
|
|
| ستون | نوع | توضیح |
|
|
|------|-----|-------|
|
|
| id | INT UNSIGNED AUTO_INCREMENT PK | |
|
|
| entity_type | VARCHAR(10) NOT NULL | `'doctor'` \| `'clinic'` |
|
|
| entity_id | INT NOT NULL | |
|
|
| balance_rials | INT NOT NULL DEFAULT 0 | موجودی فعلی |
|
|
| created_at | INT NOT NULL | |
|
|
| updated_at | INT NOT NULL | |
|
|
| UNIQUE | (entity_type, entity_id) | یک wallet به ازای هر entity |
|
|
|
|
## جدول: sms_wallet_transactions
|
|
|
|
| ستون | نوع | توضیح |
|
|
|------|-----|-------|
|
|
| id | INT UNSIGNED AUTO_INCREMENT PK | |
|
|
| uuid | CHAR(36) UNIQUE NOT NULL | |
|
|
| sms_wallet_id | INT NOT NULL FK→sms_wallets.id ON DELETE CASCADE | |
|
|
| type | VARCHAR(10) NOT NULL | `'credit'` \| `'debit'` |
|
|
| amount_rials | INT NOT NULL | مبلغ (همیشه مثبت) |
|
|
| description | VARCHAR(255) NULL | توضیح |
|
|
| payment_id | INT NULL FK→payments.id ON DELETE SET NULL | برای شارژ |
|
|
| created_at | INT NOT NULL | |
|
|
|
|
ایندکس:
|
|
```sql
|
|
INDEX idx_sms_wallet_tx ON sms_wallet_transactions(sms_wallet_id, created_at)
|
|
```
|
|
|
|
## جدول: sms_settings
|
|
|
|
| ستون | نوع | توضیح |
|
|
|------|-----|-------|
|
|
| id | INT UNSIGNED AUTO_INCREMENT PK | |
|
|
| entity_type | VARCHAR(10) NOT NULL | |
|
|
| entity_id | INT NOT NULL | |
|
|
| reminder_enabled | TINYINT(1) NOT NULL DEFAULT 0 | |
|
|
| reminder_hours_before | TINYINT NOT NULL DEFAULT 2 | چند ساعت قبل از نوبت |
|
|
| post_visit_enabled | TINYINT(1) NOT NULL DEFAULT 0 | |
|
|
| post_visit_text | TEXT NULL | متن پیامک بعد از ویزیت |
|
|
| updated_at | INT NOT NULL | |
|
|
| UNIQUE | (entity_type, entity_id) | |
|
|
|
|
## SiteConfig key جدید
|
|
|
|
| کلید | نوع | مقدار پیشفرض | توضیح |
|
|
|------|-----|--------------|-------|
|
|
| `sms_price_rials` | string | `'250'` | قیمت هر پیامک — ادمین تنظیم میکند |
|
|
|
|
## Migration نمونه
|
|
|
|
```sql
|
|
CREATE TABLE sms_wallets (
|
|
id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
|
|
entity_type VARCHAR(10) NOT NULL,
|
|
entity_id INT NOT NULL,
|
|
balance_rials INT NOT NULL DEFAULT 0,
|
|
created_at INT NOT NULL,
|
|
updated_at INT NOT NULL,
|
|
UNIQUE KEY uniq_sms_wallet_entity (entity_type, entity_id)
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
|
|
|
CREATE TABLE sms_wallet_transactions (
|
|
id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
|
|
uuid CHAR(36) NOT NULL UNIQUE,
|
|
sms_wallet_id INT NOT NULL,
|
|
type VARCHAR(10) NOT NULL,
|
|
amount_rials INT NOT NULL,
|
|
description VARCHAR(255) NULL,
|
|
payment_id INT NULL,
|
|
created_at INT NOT NULL,
|
|
FOREIGN KEY (sms_wallet_id) REFERENCES sms_wallets(id) ON DELETE CASCADE,
|
|
FOREIGN KEY (payment_id) REFERENCES payments(id) ON DELETE SET NULL,
|
|
INDEX idx_sms_wallet_tx (sms_wallet_id, created_at)
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
|
|
|
CREATE TABLE sms_settings (
|
|
id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
|
|
entity_type VARCHAR(10) NOT NULL,
|
|
entity_id INT NOT NULL,
|
|
reminder_enabled TINYINT(1) NOT NULL DEFAULT 0,
|
|
reminder_hours_before TINYINT NOT NULL DEFAULT 2,
|
|
post_visit_enabled TINYINT(1) NOT NULL DEFAULT 0,
|
|
post_visit_text TEXT NULL,
|
|
updated_at INT NOT NULL,
|
|
UNIQUE KEY uniq_sms_settings_entity (entity_type, entity_id)
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
|
```
|
|
|
|
## نکات مهم
|
|
|
|
- `balance_rials` هرگز منفی نمیشود — در `SmsWalletService::deduct()` چک میشود
|
|
- `sms_wallet_transactions` لاگ کامل تمام تراکنشها است — حذف نمیشود
|
|
- `sms_settings` با UPSERT ذخیره میشود (اگر وجود نداشت INSERT، وگرنه UPDATE)
|