📝 docs: Add documentation

docs/zh/admin/logs/gift.md

@@ -0,0 +1,129 @@
+<div v-pre>
+
+# 赠送日志
+
+查看流量、时长、余额等赠送记录,包含赠送来源和备注。
+
+## 表格列说明
+
+### 用户 (User)
+接收赠送的用户(可点击查看详情)。
+
+### 订阅 (Subscribe)
+赠送关联的订阅ID(可点击查看订阅详情)。
+
+### 订单号 (Order No.)
+关联的订单号(可点击查看订单详情)。
+
+### 金额 (Amount)
+赠送的金额(余额赠送时显示)。
+
+### 余额 (Balance)
+赠送后的用户余额。
+
+### 类型 (Type)
+赠送类型(Badge显示):
+- 流量赠送
+- 时长赠送
+- 余额赠送
+- 活动赠送
+- 管理员赠送
+
+### 备注 (Remark)
+赠送备注说明。
+
+### 时间 (Time)
+赠送时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的赠送记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的赠送记录。
+
+## 使用场景
+
+### 场景一: 查看今日赠送
+
+1. 默认显示今天的赠送记录
+2. 统计赠送数量
+3. 分析赠送成本
+
+### 场景二: 追踪用户赠送
+
+**查看用户获得**:
+1. 输入用户ID筛选
+2. 查看所有赠送记录
+3. 验证赠送是否到账
+4. 查看赠送来源
+
+### 场景三: 核对活动赠送
+
+**验证活动发放**:
+1. 筛选活动时间
+2. 查看赠送记录
+3. 核对发放数量
+4. 验证备注信息
+
+### 场景四: 管理员赠送记录
+
+**查看手动赠送**:
+1. 筛选"管理员赠送"类型
+2. 查看赠送记录
+3. 验证操作是否正确
+4. 查看备注原因
+
+## 赠送类型说明
+
+### 流量赠送
+- 赠送流量包
+- 增加订阅流量
+- 显示在订阅详情
+
+### 时长赠送
+- 延长订阅时间
+- 增加有效天数
+- 显示在订阅详情
+
+### 余额赠送
+- 赠送账户余额
+- 可用于购买套餐
+- 显示金额和余额
+
+### 活动赠送
+- 营销活动奖励
+- 批量发放
+- 带活动备注
+
+### 管理员赠送
+- 手动操作赠送
+- 需要备注原因
+- 用于补偿或奖励
+
+## 成本分析
+
+### 赠送统计
+每日/月统计:
+1. 流量赠送总量
+2. 时长赠送总天数
+3. 余额赠送总额
+4. 分类型统计
+
+### 效果评估
+- 赠送后用户留存
+- 赠送后用户付费
+- 投入产出比
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **订阅关联**: 流量和时长赠送关联订阅
+3. **余额记录**: 余额赠送记录变动金额
+4. **备注重要**: 手动赠送必须填写备注
+5. **类型识别**: 通过类型区分赠送来源
+6. **成本统计**: 定期分析赠送成本
+7. **防止滥用**: 关注异常大量赠送
+
+</div>