chore: initial commit with CI pipeline, review and tasks docs

docs/data-model.md

@@ -0,0 +1,93 @@
+# 数据模型设计
+
+本文档描述了项目核心领域的数据模型和数据库表结构。
+
+## 1. 领域模型 (Domain Models)
+
+### 1.1 Activity.java
+
+代表一个营销活动。这是活动管理功能的核心实体。
+
+- `id` (Long): 活动的唯一标识符，主键。
+- `name` (String): 活动的名称。
+- `startTime` (ZonedDateTime): 活动的开始时间。
+- `endTime` (ZonedDateTime): 活动的结束时间。
+- `targetUserIds` (Set<Long>): 允许参加活动的用户ID集合。如果为空，则表示对所有用户开放。
+- `rewardTiers` (List<RewardTier>): 奖励规则的层级列表。
+- `rewardMode` (RewardMode): 奖励模式（`CUMULATIVE` - 叠加, `DIFFERENTIAL` - 补差）。
+- `multiLevelRewardRules` (List<MultiLevelRewardRule>): 多级邀请奖励规则。
+
+### 1.2 ApiKey.java
+
+代表一个API密钥，用于授权外部系统访问特定活动的API。
+
+- `id` (Long): 密钥的唯一标识符，主键。
+- `activityId` (Long): 关联的活动ID。
+- `name` (String): 方便用户识别的密钥名称。
+- `keyHash` (String): 经过哈希加盐处理的API密钥值。
+- `salt` (String): 用于哈希计算的盐值，Base64编码存储。
+
+## 2. 数据库表设计 (Database Schema)
+
+### 2.1 activities 表
+
+由 `V1__Create_activities_table.sql` 创建。
+
+```sql
+CREATE TABLE activities (
+    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    start_time TIMESTAMP WITH TIME ZONE NOT NULL,
+    end_time TIMESTAMP WITH TIME ZONE NOT NULL,
+    -- 其他字段将根据需求添加
+);
+```
+
+### 2.2 activity_rewards 表
+
+由 `V2__Create_activity_rewards_table.sql` 创建。
+
+```sql
+CREATE TABLE activity_rewards (
+    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    activity_id BIGINT NOT NULL,
+    threshold INT NOT NULL,
+    reward_type VARCHAR(50) NOT NULL,
+    points INT,
+    coupon_batch_id VARCHAR(255),
+    FOREIGN KEY (activity_id) REFERENCES activities(id)
+);
+```
+
+### 2.3 multi_level_reward_rules 表
+
+由 `V3__Create_multi_level_reward_rules_table.sql` 创建。
+
+```sql
+CREATE TABLE multi_level_reward_rules (
+    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    activity_id BIGINT NOT NULL,
+    level INT NOT NULL,
+    decay_coefficient DECIMAL(5, 4) NOT NULL,
+    FOREIGN KEY (activity_id) REFERENCES activities(id),
+    UNIQUE (activity_id, level)
+);
+```
+
+### 2.4 api_keys 表
+
+由 `V4__Create_api_keys_table.sql` 创建。
+
+```sql
+CREATE TABLE api_keys (
+    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    key_hash VARCHAR(255) NOT NULL UNIQUE,
+    salt VARCHAR(255) NOT NULL,
+    created_at TIMESTAMP NOT NULL,
+    revoked_at TIMESTAMP NULL,
+    last_used_at TIMESTAMP NULL
+);
+
+CREATE INDEX idx_api_keys_key_hash ON api_keys(key_hash);
+```