1. Tổng quan

1.1 Mục đích

Tài liệu này định nghĩa thiết kế cơ sở dữ liệu cho module Dịch vụ SMS (cơ sở dữ liệu: sms_db).

1.2 Yêu cầu được giải quyết

1.3 Sơ đồ ERD

Hình 1: ERD Dịch vụ SMS

2. Thiết kế Schema

2.1 Chiến lược Cơ sở dữ liệu

2.2 Bảng: sms_logs

CREATE TABLE sms_logs (
  id                    UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id               UUID,
  phone                 VARCHAR(20) NOT NULL,
  message               TEXT NOT NULL,
  otp_code              VARCHAR(10),
  status                VARCHAR(20) NOT NULL DEFAULT 'pending'
                        CHECK (status IN ('pending', 'sent', 'delivered', 'failed')),
  provider              VARCHAR(50) NOT NULL DEFAULT 'twilio',
  provider_message_id   VARCHAR(100),
  error_message         TEXT,
  retry_count           INTEGER NOT NULL DEFAULT 0,
  expires_at            TIMESTAMP,
  sent_at               TIMESTAMP,
  delivered_at          TIMESTAMP,
  created_at            TIMESTAMP NOT NULL DEFAULT NOW()
);

3. Chỉ mục

-- sms_logs
CREATE INDEX idx_sms_logs_user_id ON sms_logs(user_id);
CREATE INDEX idx_sms_logs_phone ON sms_logs(phone);
CREATE INDEX idx_sms_logs_status ON sms_logs(status);
CREATE INDEX idx_sms_logs_created_at ON sms_logs(created_at DESC);
CREATE INDEX idx_sms_logs_provider_message_id ON sms_logs(provider_message_id);

4. Di chuyển dữ liệu

4.1 Chiến lược Di chuyển

4.2 Thứ tự Di chuyển

5. Từ điển Dữ liệu