chore: remove legacy specification documents and internal rules file

docs/knowledge-cards/campaign/campaign_rule.md

@@ -0,0 +1,93 @@
+---
+card_id: "campaign/campaign_rule"
+title: "Quy tắc Chiến dịch (Campaign Rule)"
+domain: "campaign"
+related_cards:
+  - "campaign/reward_campaign"
+  - "campaign/transaction_codes"
+  - "customer/pool_balance"
+tags: ["rule", "criteria", "award", "redeem", "adjust", "formula"]
+detail_refs:
+  - "campaign/criteria_operators"
+  - "campaign/formula_calculation"
+---
+
+# Quy tắc Chiến dịch (Campaign Rule)
+
+## Mô tả ngắn
+
+Quy tắc Chiến dịch (Campaign Rule) là thực thể trung tâm chứa toàn bộ logic kinh doanh (Business Logic) để xác định xem một giao dịch có hợp lệ để nhận thưởng hay không, và phần thưởng đó được tính toán như thế nào. Một Campaign Rule hoàn chỉnh bao gồm: Điều kiện hiệu lực, Định tuyến giao dịch, Bộ lọc tiêu chí (Criteria), Công thức tính (Formula) và Phân bổ chi phí (Contributor).
+
+## Thuật ngữ liên quan
+
+- **Execution Sequence**: Thứ tự thực thi. Khi một giao dịch (mang một OLS TC) khớp với nhiều Rules, hệ thống sẽ chạy các Rules theo thứ tự này.
+- **Stop if criteria met**: Cờ báo hiệu hệ thống dừng xử lý các Rules tiếp theo (cùng TC) nếu Rule hiện tại đã được khớp (hit) thành công.
+- **Contributor**: Đơn vị (thường là Merchant / Chain) chịu chi phí tài trợ cho phần thưởng được cấp ra từ Rule này.
+- **Absorb Remainder**: Đơn vị chịu trách nhiệm gánh phần số dư lẻ (do làm tròn) sau khi đã chia tỷ lệ % cho các Contributors khác.
+
+## Cấu trúc dữ liệu (Data Schema)
+
+Một Rule được cấu thành từ 5 khối dữ liệu logic chính:
+
+### 1. Thông tin chung & Hiệu lực (General & Effect)
+- **Campaign ID**: Chiến dịch chứa Rule này.
+- **Rule Type**: Loại quy tắc (Award - Tặng thưởng, Redeem - Đổi điểm, Adjust - Điều chỉnh, v.v.).
+- **Effective Period**: Từ ngày - Đến ngày. Có thể đánh giá thời gian này dựa trên *Transaction Date* (Ngày giao dịch gốc) hoặc *System Batch Date* (Ngày hệ thống xử lý).
+- **Pool ID**: Đích đến - Ví điểm sẽ được cộng/trừ kết quả tính toán của Rule này.
+- **Do not update pool**: Nếu BẬT, Rule này chỉ dùng để tính toán và cập nhật vào Bộ đếm (Counter) chứ không thực sự cộng điểm vào Pool Balance.
+
+### 2. Liên kết Giao dịch (Transaction Link)
+- **OLS Transaction Code**: Xác định loại giao dịch nào (Ví dụ: `PURCHASE`) sẽ kích hoạt Rule này.
+- Một Rule có thể link với nhiều TC.
+- Không cho phép gán TC đảo chiều (Reversal TC) cho Rule thuộc loại Adjustment hoặc Rule đánh vào Evoucher Pool.
+
+### 3. Tiêu chí Xét duyệt (Rule Criteria)
+Sử dụng cấu trúc truy vấn động (Query Builder) kết hợp bởi nhiều nhóm điều kiện (AND/OR). Hỗ trợ các tiêu chí từ:
+- **Transaction**: MCC, Quốc gia, Loại tiền tệ...
+- **Customer / Account**: Hạng tài khoản, Tuổi, Phân khúc...
+- **Transaction Category**: Tái sử dụng cụm điều kiện vĩ mô (xem thêm card Transaction Codes).
+- **Counter**: Xét điều kiện dựa trên tổng giá trị tích lũy trong quá khứ (Ví dụ: Tổng chi tiêu tháng trước > 1000$).
+- **Hỗ trợ Exclusion**: Cho phép phủ định một tiêu chí (NOT).
+
+### 4. Công thức và Giới hạn (Formula & Cap Limits)
+- **Amount to Use (A)**: Đầu vào của công thức. Có thể lấy từ Gross Amount, Nett Amount của giao dịch, hoặc lấy từ giá trị của một Bộ đếm (Counter).
+- **Cap Limit cho (A)**: Giới hạn trên của đầu vào (Ví dụ: Giao dịch 10 triệu, nhưng chỉ lấy tối đa 5 triệu để tính điểm).
+- **Result Award Limit**: Giới hạn tổng kết quả đầu ra.
+  - *Give No more than*: Giới hạn tổng số điểm thưởng cấp ra không vượt quá X. Có thể giới hạn trên nội bộ 1 Rule, hoặc giới hạn chung dựa trên một Counter (ví dụ: Tổng quỹ thưởng của Campaign không quá 1 tỷ điểm).
+- **Rounding**: Phương thức làm tròn kết quả (Up / Down / Nearest).
+
+### 5. Phân bổ Chi phí (Contributor Details)
+- Xác định ai sẽ "trả tiền" cho số điểm thưởng vừa cấp.
+- Cho phép cấu hình nhiều đơn vị (Chain) với tỷ lệ phần trăm (Contributor Percentage).
+- Tổng tỷ lệ phải bằng 100%. Bắt buộc phải có đúng 1 đơn vị được gán cờ `Absorb Remainder`.
+- Nếu không cấu hình, mặc định Merchant nơi phát sinh giao dịch sẽ chịu 100% chi phí.
+
+## Cách hoạt động (How It Works)
+
+1. Giao dịch đổ vào Transaction Processing Engine (TP).
+2. Engine tìm các Rules đang Active, còn trong thời hạn (Effective Date) và khớp OLS TC.
+3. Engine sắp xếp các Rules theo `Execution Sequence`.
+4. Engine chạy qua Rule Criteria. Nếu giao dịch thỏa mãn toàn bộ tiêu chí -> Rule Hit.
+5. Engine tính toán phần thưởng dựa trên Formula (A), áp dụng các bộ lọc giới hạn (Caps).
+6. Nếu `Do not update pool = OFF`, kết quả được cộng vào Pool Balance của khách hàng. Phân bổ chi phí được ghi nhận cho Contributors.
+7. Nếu `Stop if criteria met = TRUE`, Engine bỏ qua các Rules còn lại của giao dịch đó.
+
+## Mối quan hệ với modules khác
+
+- **Reward Campaign**: Chứa các Rule này. Một chiến dịch không thể hoạt động nếu không có Rule.
+- **Transaction Codes**: Liên kết trực tiếp để định tuyến. Giao dịch phải có TC khớp với cấu hình của Rule thì mới kích hoạt Rule.
+- **Pool Balance**: Điểm đến cuối cùng của các giao dịch thưởng/trừ do Rule sinh ra.
+
+## Ví dụ thực tế
+
+Tạo Rule thưởng nhân 2 điểm (x2) cho Khách hàng hạng Gold vào cuối tuần:
+- **Campaign**: "Weekend Double Points"
+- **Rule Type**: Award
+- **OLS Transaction Code**: `PURCH_NORMAL`
+- **Criteria**: 
+  - (Account Level = 'Gold') AND 
+  - (Day of Week IN 'Saturday', 'Sunday')
+- **Formula**: `Amount to Use = Gross Amount`. Công thức: `A * 0.02` (Giả sử mặc định là 1%, nhân đôi là 2%).
+- **Contributor**: Merchant A chịu 100% chi phí.
+
+Khi khách hàng Gold mua 1,000,000 VND vào Thứ 7, giao dịch khớp toàn bộ điều kiện. Hệ thống tính: 1,000,000 * 0.02 = 20,000 điểm. 20,000 điểm này được cộng vào Pool của khách hàng và Merchant A chịu ghi nhận nợ 20,000 điểm trên sổ cái.