chore: remove legacy specification documents and internal rules file

docs/knowledge-cards/marketing/marketing_message.md

@@ -0,0 +1,74 @@
+---
+card_id: "marketing/marketing_message"
+title: "Mẫu thông báo (Marketing Message)"
+domain: "marketing"
+related_cards:
+  - "campaign/campaign_rule"
+  - "catalogue/item_master"
+tags: ["Message", "SMS", "Email", "Push Notification", "OMR-type"]
+---
+
+# Mẫu thông báo (Marketing Message)
+
+## Mô tả ngắn
+
+Marketing Message là module quản lý và định nghĩa các thông báo gửi đến khách hàng mục tiêu qua nhiều kênh giao tiếp (Channels) khác nhau như SMS, Email, và Push Notification. Hệ thống hỗ trợ tạo thông báo từ nội dung chữ thuần (text) hoặc HTML template, kết hợp các tham số động (message parameters) để cá nhân hoá nội dung.
+
+## Thuật ngữ liên quan
+
+- **Channel**: Kênh giao tiếp, ví dụ: SMS, Email, Push Notification.
+- **Richer Push / Carousel Push**: Các định dạng thông báo Push trên ứng dụng có hỗ trợ đính kèm một ảnh (Richer) hoặc nhiều ảnh vuốt ngang (Carousel).
+- **Message Parameter**: Tham số động có thể kéo/thả vào nội dung (VD: Tên khách hàng, Số dư điểm) để cá nhân hóa khi gửi.
+
+## Cấu trúc dữ liệu (Data Schema)
+
+### 1. SMS Message
+| Field | Description | Type |
+| --- | --- | --- |
+| Message ID / Description | Mã định danh duy nhất và mô tả thông báo. | Character |
+| SMS Type | Loại SMS: Promotion/Marketing hoặc Transaction. | Drop-down |
+| Effective Date (From-To) | Thời gian hiệu lực của mẫu thông báo. | Date |
+| SMS Brand Name | Tên hiển thị người gửi SMS (Sender). | Drop-down |
+| Message | Nội dung Unicode, không hỗ trợ hình ảnh/đính kèm. Cho phép chèn Message Parameters. | Character |
+| Send Sample | Nút test thông báo qua SĐT thực tế. | Button |
+
+### 2. Email Message
+| Field | Description | Type |
+| --- | --- | --- |
+| Email Type | Loại Email: Promotion/Marketing hoặc Transaction. | Drop-down |
+| Use type | Chọn cách tạo: Viết trực tiếp (Use message) hoặc Upload HTML (Upload template). | Checkbox |
+| Sender Name / From email | Tên hiển thị người gửi và Email gốc đã cấu hình. | Character |
+| Subject / Preview Text | Tiêu đề Email và văn bản Preheader (hiển thị tóm tắt trên hộp thư). | Character |
+| Message / Upload file | Nội dung soạn thảo HTML hoặc file HTML được upload. | Character/File |
+
+### 3. Push Notification
+| Field | Description | Type |
+| --- | --- | --- |
+| Notification Type | Loại Push: Promotion/Marketing hoặc Transaction. | Drop-down |
+| Message Title | Tiêu đề chính hiển thị trên thông báo. | Character |
+| Image type | Tùy chọn ảnh: Single (Không ảnh), Richer (1 ảnh), Carousel (Nhiều ảnh). | Drop-down |
+| Upload Image / Link URL | Hình ảnh đính kèm và đường link điều hướng khi click. | File/Character |
+| Send Sample | Nút gửi test bằng cách nhập số CIF để xác định thiết bị nhận. | Button |
+
+## Cách hoạt động (How It Works)
+
+- **Cá nhân hóa nội dung:** Người dùng soạn thông báo có thể kéo thả các Message Parameters (như `{{CustomerName}}`) vào nội dung. Khi gửi, hệ thống thay thế tham số bằng thông tin thật của khách hàng.
+- **Kiểm thử thông báo (Send Sample):** Hỗ trợ test hiển thị trước khi áp dụng:
+  - *SMS*: Nhập số điện thoại.
+  - *Email*: Nhập địa chỉ Email.
+  - *Push*: Nhập CIF Number để hệ thống dò Registration Token của thiết bị.
+- **Upload Template:** Với kênh Email, người dùng có thể upload file thiết kế dạng HTML có sẵn và chỉnh sửa trực tiếp. Với kênh Push, hỗ trợ đính kèm hình ảnh và URL điều hướng.
+
+## Mối quan hệ với modules khác
+
+- **Campaign Rule**: Các rule kịch bản chiến dịch (`campaign/campaign_rule`) sử dụng mẫu thông báo này để gửi tự động cho khách hàng khi họ thoả điều kiện thưởng.
+- **Item Master**: Mẫu thông báo cũng có thể được dùng trong luồng đổi quà (`catalogue/item_master`) để gửi xác nhận đổi quà thành công.
+
+## Ví dụ thực tế
+
+**Tạo mẫu Email thông báo đổi điểm:**
+1. Marketer tạo Message mới chọn kênh **Email**, loại **Transaction**.
+2. Thiết lập Sender là `CSKH Loyalty`, Subject là `Xác nhận đổi quà thành công`.
+3. Trong nội dung, nhập: `Chào {{Customer_Name}}, bạn đã đổi thành công {{Item_Name}}. Số dư hiện tại là {{Pool_Balance}} điểm.`
+4. Chọn **Send Sample**, nhập email của chính mình để test. Hệ thống gửi email preview về hộp thư.
+5. Sau khi lưu, mẫu này được gắn vào Item Master hoặc Campaign Rule để tự động kích hoạt.