73 lines
4.8 KiB
Markdown
73 lines
4.8 KiB
Markdown
# 發送簡訊
|
||
|
||
## 架構
|
||
* 從 Global.asax 的 Application_Start 事件啟動一個 Timer（預設每 1 分鐘觸發），定時啟動 SMSSendingService
|
||
* 發送服務（Services/SMSSendingService.cs）
|
||
* 是單例類（Singleton），有 IsBusy 狀態可以顯示是否正在忙碌
|
||
* 每次啟動就把待發送簡訊全部發完
|
||
* 啟動時（Start 方法）
|
||
* 若 _busy == true 則直接返回，避免重複執行
|
||
* 設定 _busy = true
|
||
* 查詢 MessageQueue 表 Status 是 PENDING 或 SENDING 的
|
||
* 依課程 ProjectID 查詢對應的簡訊帳號密碼（DAC_ProjectMMSAccount），若無設定則使用系統預設帳號密碼
|
||
* 逐一發送（SendMessage 方法）
|
||
* 每一個發送開始時改狀態為 SENDING
|
||
* 呼叫 EVERY8DSMSProvider.SendMMS 發送
|
||
* 成功或失敗結果寫入 MessageLog 表
|
||
* 刪除 MessageQueue 紀錄
|
||
* 每一個發送做一個 DB transaction
|
||
* 最後重置 _busy = false（在 finally 確保執行）
|
||
* 錯誤寫入 ~/Log/SMSError_yyyyMMdd.txt
|
||
|
||
## 預約發送（加入佇列）
|
||
* Services/SignUpService.asmx
|
||
* METHOD SendSmsBatch(int courseID, List<int> signupIds)
|
||
* 驗證課程的 NotificationTitle 和 NotificationTemplate 已設定
|
||
* 對每位參加人員
|
||
* 若無 QRCode 則自動產生（DAC_SignUp.GenQRCodeText）並更新回資料表
|
||
* 以 ZXing 產生 QRCode 圖片，轉成 Base64
|
||
* 將訊息寫入 MessageQueue 表，Status = "PENDING"
|
||
* NotificationTemplate 支援替換字串：{課程日期}/{活動日期}、{課程名稱}/{活動名稱}、{課程地點}/{活動地點}、{學員姓名}、{開始時間}、{結束時間}、{講師}
|
||
* 回傳：BaseResponse（Success, Message, Data: { SuccessCount, FailedCount, SuccessRecords, Errors, TotalRequested }）
|
||
|
||
## 資料表
|
||
|
||
### 待發送簡訊 MessageQueue
|
||
* 資料存取類別 DAC_MessageQueue
|
||
* 資料表結構
|
||
| No | Field Name | Data Type | Length | Not Null | PK | Identity | Description |
|
||
|----|-------------|-----------|--------|----------|----|----------|-----------------------------|
|
||
| 1 | ID | INT | | V | V | V | 流水號 |
|
||
| 2 | CourseID | INT | | V | | | 課程ID |
|
||
| 3 | Status | NVARCHAR | 10 | | | | 發送狀態 PENDING = 等候發送 |
|
||
| | | | | | | | SENDING = 發送中 |
|
||
| | | | | | | | SENT = 已發送 |
|
||
| | | | | | | | FAILED = 發送失敗 |
|
||
| 4 | Mobile | NVARCHAR | 20 | | | | 手機號 |
|
||
| 5 | Subject | NVARCHAR | 100 | | | | 簡訊標題 |
|
||
| 6 | Content | NVARCHAR | 500 | | | | 發送內容 |
|
||
| 7 | QRCode | TEXT | | | | | QRCode 圖片的 BASE64 |
|
||
| 8 | Name | NVARCHAR | 100 | | | | 學員姓名 |
|
||
| 9 | FailMessage | NVARCHAR | 200 | | | | 發送失敗訊息 |
|
||
|
||
|
||
### 發送紀錄 MessageLog
|
||
* 資料存取類別 DAC_MessageLog
|
||
* 資料表結構
|
||
| No | Field Name | Data Type | Length | Not Null | PK | Identity | Description |
|
||
|----|-------------|-----------|--------|----------|----|----------|------------------------|
|
||
| 1 | ID | INT | | V | V | V | 流水號 |
|
||
| 2 | CourseID | INT | | V | | | 課程ID |
|
||
| 3 | Status | NVARCHAR | 10 | | | | 發送狀態 SENT = 已發送 |
|
||
| | | | | | | | FAILED = 發送失敗 |
|
||
| 4 | Mobile | NVARCHAR | 20 | | | | 手機號 |
|
||
| 5 | Subject | NVARCHAR | 100 | | | | 簡訊標題 |
|
||
| 6 | Content | NVARCHAR | 500 | | | | 發送內容 |
|
||
| 7 | Name | NVARCHAR | 100 | | | | 學員姓名 |
|
||
| 8 | FailMessage | NVARCHAR | 200 | | | | 發送失敗訊息 |
|
||
|
||
## 簡訊服務商
|
||
服務商：EVERY8D
|
||
具體的簡訊發送實作在 Services/EVERY8DSMSProvider.cs
|
||
帳號密碼設定在 PublicVariable（系統預設）或各計畫的 ProjectMMSAccount 資料表（計畫特定）
|