📝 docs: Add documentation

docs/zh/admin/logs/balance.md

@@ -0,0 +1,136 @@
+<div v-pre>
+
+# 余额日志
+
+查看用户余额变动记录,包含充值、消费、奖励等所有余额操作。
+
+## 表格列说明
+
+### 用户 (User)
+余额变动的用户(可点击查看详情)。
+
+### 金额 (Amount)
+余额变动金额:
+- 正数表示增加
+- 负数表示减少
+
+### 订单号 (Order No.)
+关联的订单号(可点击查看订单详情)。
+
+### 余额 (Balance)
+变动后的用户余额。
+
+### 类型 (Type)
+余额变动类型(Badge显示):
+
+**流量重置类(23x)**:
+- 自动重置 (231)
+- 提前重置 (232)
+- 付费重置 (233)
+
+**充值提现类(32x)**:
+- 充值 (321)
+- 提现 (322)
+- 付款 (323)
+- 退款 (324)
+- 奖励 (325)
+- 管理员调整 (326)
+
+**购买类(33x)**:
+- 购买 (331)
+- 续费 (332)
+- 退款 (333)
+- 提现 (334)
+- 管理员调整 (335)
+
+**调整类(34x)**:
+- 增加 (341)
+- 减少 (342)
+
+### 时间 (Time)
+余额变动时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的余额记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的余额变动。
+
+## 使用场景
+
+### 场景一: 查看今日充值
+
+1. 默认显示今天的余额记录
+2. 筛选类型"充值"
+3. 统计充值金额
+4. 分析充值用户
+
+### 场景二: 追踪用户余额
+
+**查看用户消费**:
+1. 输入用户ID筛选
+2. 查看所有余额变动
+3. 分析消费习惯
+4. 验证账单正确性
+
+### 场景三: 排查异常交易
+
+**检查大额变动**:
+1. 浏览余额记录
+2. 关注大额充值/消费
+3. 点击订单号查看详情
+4. 验证交易合法性
+
+### 场景四: 管理员调整余额
+
+**手动调整后验证**:
+1. 筛选"管理员调整"类型
+2. 查看调整记录
+3. 验证调整是否正确
+4. 通知用户(如需要)
+
+## 余额类型说明
+
+### 充值相关
+- **充值**: 用户通过支付渠道充值
+- **奖励**: 推广奖励、活动奖励
+- **退款**: 订单退款到余额
+
+### 消费相关
+- **购买**: 购买新套餐
+- **续费**: 续费现有套餐
+- **付款**: 其他付款操作
+
+### 调整相关
+- **管理员调整**: 手动增加或减少余额
+- **提现**: 用户申请提现(扣除余额)
+
+## 财务对账
+
+### 日常对账
+每日检查:
+1. 充值总额与支付平台一致
+2. 消费总额与订单总额一致
+3. 无异常大额变动
+4. 退款记录完整
+
+### 月度对账
+每月汇总:
+1. 总充值额
+2. 总消费额
+3. 总余额变化
+4. 手续费支出
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留时间
+2. **金额正负**: 注意金额的正负号含义
+3. **订单关联**: 有订单号的可追溯来源
+4. **类型识别**: 通过类型码快速识别操作
+5. **余额快照**: 记录变动后的余额值
+6. **管理员操作**: 管理员调整会有记录
+7. **定期对账**: 建议每日核对财务数据
+
+</div>

docs/zh/admin/logs/commission.md

@@ -0,0 +1,80 @@
+<div v-pre>
+
+# 佣金日志
+
+查看用户推广佣金记录,包含佣金来源和金额。
+
+## 表格列说明
+
+### 用户 (User)
+获得佣金的用户(可点击查看详情)。
+
+### 金额 (Amount)
+佣金金额。
+
+### 订单号 (Order No.)
+产生佣金的订单号(可点击查看订单详情)。
+
+### 类型 (Type)
+佣金类型(Badge显示):
+- 推广佣金
+- 返现佣金
+- 奖励佣金
+- 其他类型
+
+### 时间 (Time)
+佣金发放时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的佣金记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的佣金记录。
+
+## 使用场景
+
+### 场景一: 查看今日佣金
+
+1. 默认显示今天的佣金记录
+2. 统计佣金总额
+3. 分析推广效果
+
+### 场景二: 追踪用户佣金
+
+**查看推广收益**:
+1. 输入用户ID筛选
+2. 查看所有佣金记录
+3. 统计累计收益
+4. 验证佣金正确性
+
+### 场景三: 分析推广效果
+
+**统计推广数据**:
+1. 选择时间范围
+2. 查看佣金记录
+3. 识别优质推广者
+4. 优化推广策略
+
+## 佣金规则
+
+### 佣金来源
+- **推广佣金**: 推荐用户消费产生
+- **返现佣金**: 自己消费返现
+- **奖励佣金**: 活动奖励
+
+### 佣金计算
+- 按订单金额的百分比
+- 实时到账或定期结算
+- 关联原始订单
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **订单关联**: 可追溯佣金来源
+3. **类型识别**: 通过类型快速分类
+4. **实时统计**: 查看推广效果
+5. **定期对账**: 验证佣金发放正确性
+
+</div>

docs/zh/admin/logs/email.md

@@ -0,0 +1,149 @@
+<div v-pre>
+
+# 邮件日志
+
+查看系统发送的所有邮件记录,包含发送状态和内容。
+
+## 表格列说明
+
+### 平台 (Platform)
+邮件发送平台(Badge显示):
+- SMTP
+- SendGrid
+- Mailgun
+- AWS SES
+- 其他邮件服务商
+
+### 收件人 (To)
+接收邮件的邮箱地址。
+
+### 主题 (Subject)
+邮件主题。
+
+### 内容 (Content)
+邮件内容(JSON格式显示):
+- 纯文本内容
+- HTML内容
+- 模板变量
+- 最大显示480px宽度
+
+### 状态 (Status)
+邮件发送状态(Badge显示):
+- **已发送** (绿色) - 成功发送
+- **发送失败** (红色) - 发送失败
+- **未知** (灰色) - 状态未知
+
+### 时间 (Time)
+邮件发送时间。
+
+## 筛选功能
+
+### 关键词搜索
+搜索收件人地址或邮件主题。
+
+### 日期筛选
+选择查看指定日期的邮件记录,默认今天。
+
+## 使用场景
+
+### 场景一: 查看今日邮件
+
+1. 默认显示今天的邮件记录
+2. 查看发送数量
+3. 检查发送状态
+4. 统计成功率
+
+### 场景二: 排查发送失败
+
+**检查失败邮件**:
+1. 筛选"发送失败"状态
+2. 查看收件人地址
+3. 检查邮件内容
+4. 分析失败原因
+5. 重新发送或修复配置
+
+### 场景三: 验证邮件内容
+
+**检查邮件模板**:
+1. 搜索特定主题
+2. 查看邮件内容
+3. 验证变量替换
+4. 确认格式正确
+
+### 场景四: 追踪用户邮件
+
+**查看用户收信**:
+1. 搜索用户邮箱
+2. 查看所有邮件
+3. 确认是否送达
+4. 验证邮件类型
+
+## 邮件类型
+
+### 系统邮件
+- 注册验证邮件
+- 密码重置邮件
+- 登录验证码
+- 账户通知
+
+### 营销邮件
+- 推广邮件
+- 活动通知
+- 优惠信息
+- 产品更新
+
+### 交易邮件
+- 订单确认
+- 支付成功
+- 发票通知
+- 到期提醒
+
+## 发送监控
+
+### 成功率监控
+关注指标:
+- 每日发送总量
+- 发送成功率
+- 失败率趋势
+- 不同平台表现
+
+### 异常处理
+发现问题时:
+1. 检查SMTP配置
+2. 验证邮件服务商状态
+3. 检查发送频率限制
+4. 查看错误日志
+
+## 邮件内容说明
+
+### JSON格式
+内容字段包含:
+```json
+{
+  "text": "纯文本内容",
+  "html": "<p>HTML内容</p>",
+  "variables": {
+    "username": "用户名",
+    "code": "验证码"
+  }
+}
+```
+
+### 变量替换
+- {{username}}: 用户名
+- {{code}}: 验证码
+- {{link}}: 链接地址
+- {{expire}}: 过期时间
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **内容截断**: 过长内容会被截断显示
+3. **JSON显示**: 内容以JSON格式展示
+4. **平台识别**: 通过平台字段识别发送渠道
+5. **状态监控**: 关注发送失败记录
+6. **隐私保护**: 邮件内容可能包含敏感信息
+7. **定期检查**: 每日检查发送状态
+8. **配额管理**: 注意邮件服务商配额限制
+
+</div>

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>

docs/zh/admin/logs/login.md

@@ -0,0 +1,93 @@
+<div v-pre>
+
+# 登录日志
+
+查看用户登录记录,包含登录方式、IP地址和设备信息。
+
+## 表格列说明
+
+### 用户 (User)
+登录的用户,显示:
+- 登录方式Badge(邮箱/手机/Google等)
+- 用户ID(可点击查看详情)
+
+### IP地址 (IP)
+登录IP地址(可点击查看IP信息)。
+
+### User Agent
+用户设备和浏览器信息:
+- 鼠标悬停显示完整内容
+- 截断显示避免过长
+
+### 成功状态 (Success)
+登录是否成功:
+- **成功** (绿色Badge)
+- **失败** (红色Badge)
+
+### 时间 (Time)
+登录时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的登录记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的登录记录。
+
+## 使用场景
+
+### 场景一: 查看今日登录
+
+1. 默认显示今天的登录记录
+2. 查看登录频率
+3. 分析活跃用户
+
+### 场景二: 排查异常登录
+
+**检查失败登录**:
+1. 筛选登录失败记录
+2. 查看IP地址
+3. 分析失败原因
+4. 必要时封禁IP
+
+**检查异地登录**:
+1. 查看用户登录IP
+2. 点击IP查看地理位置
+3. 对比历史登录位置
+4. 发现异常通知用户
+
+### 场景三: 追踪用户登录
+
+**查看特定用户**:
+1. 输入用户ID筛选
+2. 查看登录历史
+3. 分析登录设备
+4. 验证账号安全
+
+## 安全监控
+
+### 异常模式
+关注以下异常:
+- 短时间大量失败登录
+- 同一IP多账号登录
+- 异常国家/地区登录
+- 罕见设备类型登录
+
+### 防护措施
+发现异常时:
+1. 临时封禁IP
+2. 强制用户重置密码
+3. 发送安全通知
+4. 启用二次验证
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置自动清理
+2. **IP查询**: 点击IP可查看地理位置
+3. **User Agent**: 包含操作系统和浏览器信息
+4. **隐私保护**: 敏感信息仅管理员可见
+5. **失败记录**: 重点关注失败登录异常
+6. **定期检查**: 建议每日检查登录情况
+
+</div>

docs/zh/admin/logs/mobile.md

@@ -0,0 +1,165 @@
+<div v-pre>
+
+# 短信日志
+
+查看系统发送的所有短信记录,包含发送状态和内容。
+
+## 表格列说明
+
+### 平台 (Platform)
+短信发送平台(Badge显示):
+- 阿里云短信
+- 腾讯云短信
+- Twilio
+- AWS SNS
+- 其他短信服务商
+
+### 收件人 (To)
+接收短信的手机号码。
+
+### 主题 (Subject)
+短信主题/类型。
+
+### 内容 (Content)
+短信内容(JSON格式显示):
+- 短信文本
+- 模板变量
+- 签名信息
+- 最大显示480px宽度
+
+### 状态 (Status)
+短信发送状态(Badge显示):
+- **已发送** (绿色) - 成功发送
+- **发送失败** (红色) - 发送失败
+- **未知** (灰色) - 状态未知
+
+### 时间 (Time)
+短信发送时间。
+
+## 筛选功能
+
+### 关键词搜索
+搜索收件人手机号或短信主题。
+
+### 日期筛选
+选择查看指定日期的短信记录,默认今天。
+
+## 使用场景
+
+### 场景一: 查看今日短信
+
+1. 默认显示今天的短信记录
+2. 查看发送数量
+3. 检查发送状态
+4. 统计成功率
+
+### 场景二: 排查发送失败
+
+**检查失败短信**:
+1. 筛选"发送失败"状态
+2. 查看收件人号码
+3. 检查短信内容
+4. 分析失败原因(号码无效/余额不足/服务商问题)
+5. 重新发送或修复配置
+
+### 场景三: 验证短信内容
+
+**检查短信模板**:
+1. 搜索特定主题
+2. 查看短信内容
+3. 验证变量替换
+4. 确认签名正确
+
+### 场景四: 追踪用户短信
+
+**查看用户收信**:
+1. 搜索用户手机号
+2. 查看所有短信
+3. 确认是否送达
+4. 验证短信类型
+
+## 短信类型
+
+### 验证码短信
+- 注册验证码
+- 登录验证码
+- 重置密码验证码
+- 绑定手机验证码
+
+### 通知短信
+- 订单通知
+- 支付成功通知
+- 到期提醒
+- 系统公告
+
+### 营销短信
+- 推广短信
+- 活动通知
+- 优惠信息
+
+## 发送监控
+
+### 成功率监控
+关注指标:
+- 每日发送总量
+- 发送成功率
+- 失败率趋势
+- 不同平台表现
+
+### 异常处理
+发现问题时:
+1. 检查短信服务商配置
+2. 验证API密钥有效性
+3. 检查余额和配额
+4. 查看错误日志
+5. 联系服务商技术支持
+
+## 短信内容说明
+
+### JSON格式
+内容字段包含:
+```json
+{
+  "template_id": "SMS_123456",
+  "sign_name": "品牌名",
+  "params": {
+    "code": "123456",
+    "minutes": "5"
+  }
+}
+```
+
+### 模板变量
+- {{code}}: 验证码
+- {{minutes}}: 有效时间
+- {{product}}: 产品名称
+- {{amount}}: 金额
+
+## 成本管理
+
+### 费用统计
+- 每日短信数量
+- 单价计算
+- 月度费用
+- 不同类型占比
+
+### 成本优化
+- 控制验证码发送频率
+- 优化短信模板
+- 选择性价比高的服务商
+- 避免无效发送
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **内容截断**: 过长内容会被截断显示
+3. **JSON显示**: 内容以JSON格式展示
+4. **平台识别**: 通过平台字段识别发送渠道
+5. **状态监控**: 关注发送失败记录
+6. **号码隐私**: 手机号敏感信息需保护
+7. **定期检查**: 每日检查发送状态
+8. **配额管理**: 注意短信服务商配额和余额
+9. **频率限制**: 防止短信轰炸
+10. **合规要求**: 遵守短信发送法律法规
+
+</div>

docs/zh/admin/logs/register.md

@@ -0,0 +1,152 @@
+<div v-pre>
+
+# 注册日志
+
+查看用户注册记录,包含注册方式、IP地址和设备信息。
+
+## 表格列说明
+
+### 用户 (User)
+注册的用户(可点击查看详情)。
+
+### 标识符 (Identifier)
+注册使用的账号标识:
+- 注册方式Badge(邮箱/手机/Google等)
+- 具体账号(邮箱地址/手机号等)
+
+### IP地址 (IP)
+注册IP地址(可点击查看IP信息)。
+
+### User Agent
+注册设备和浏览器信息:
+- 鼠标悬停显示完整内容
+- 截断显示避免过长
+
+### 时间 (Time)
+注册时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的注册记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的注册信息。
+
+## 使用场景
+
+### 场景一: 查看今日注册
+
+1. 默认显示今天的注册记录
+2. 统计注册数量
+3. 分析注册来源
+4. 识别注册方式分布
+
+### 场景二: 追踪用户来源
+
+**查看注册信息**:
+1. 查看用户注册记录
+2. 确认注册时间
+3. 查看注册IP位置
+4. 分析注册渠道
+
+### 场景三: 排查异常注册
+
+**检查可疑注册**:
+1. 查看注册日志
+2. 关注同一IP多次注册
+3. 检查异常国家/地区
+4. 识别批量注册行为
+5. 必要时限制注册
+
+### 场景四: 分析注册趋势
+
+**统计注册数据**:
+1. 选择时间范围
+2. 统计注册总量
+3. 分析注册高峰
+4. 评估推广效果
+
+## 注册方式
+
+### 邮箱注册
+- 显示邮箱地址
+- 需要邮箱验证
+- 最常用方式
+
+### 手机注册
+- 显示手机号
+- 需要短信验证
+- 国内常用
+
+### 社交账号注册
+- **Google**: Google账号
+- **GitHub**: GitHub账号
+- **Facebook**: Facebook账号
+- **Apple**: Apple ID
+- **Telegram**: Telegram账号
+
+## 安全监控
+
+### 异常模式
+关注以下异常:
+- 短时间大量注册
+- 同一IP多次注册
+- 异常国家/地区注册
+- 批量邮箱/手机号注册
+- 临时邮箱注册
+
+### 防护措施
+发现异常时:
+1. 启用注册验证码
+2. 限制单IP注册频率
+3. 封禁可疑IP
+4. 启用邮箱/手机验证
+5. 启用邀请码机制
+
+## 注册来源分析
+
+### 地理分布
+- 国家/地区统计
+- 城市分布
+- 识别主要市场
+
+### 设备分析
+从User Agent获取:
+- 操作系统分布
+- 浏览器类型
+- 设备类型(PC/Mobile)
+- 识别用户习惯
+
+### 注册渠道
+- 直接访问
+- 搜索引擎
+- 推广链接
+- 社交媒体
+
+## 数据统计
+
+### 日常统计
+- 每日新增注册
+- 注册转化率
+- 注册方式占比
+- 地域分布
+
+### 推广评估
+- 推广活动期间注册量
+- 不同渠道效果
+- 注册后留存率
+- 注册后付费率
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **IP追踪**: 可查看IP地理位置
+3. **设备识别**: User Agent包含设备信息
+4. **隐私保护**: 注册信息敏感,需保密
+5. **异常监控**: 关注批量和异地注册
+6. **方式分布**: 了解用户偏好注册方式
+7. **定期分析**: 每周分析注册趋势
+8. **反作弊**: 防止恶意批量注册
+
+</div>

docs/zh/admin/logs/reset-subscribe.md

@@ -0,0 +1,145 @@
+<div v-pre>
+
+# 流量重置日志
+
+查看订阅流量重置记录,包含重置类型和关联订单。
+
+## 表格列说明
+
+### 用户 (User)
+订阅所属用户(可点击查看详情)。
+
+### 订阅ID (Subscribe ID)
+被重置的订阅ID(可点击查看订阅详情,悬停显示卡片)。
+
+### 类型 (Type)
+重置类型(Badge显示):
+- **自动重置** - 按周期自动重置
+- **提前重置** - 用户主动提前重置
+- **付费重置** - 购买流量重置服务
+
+### 订单号 (Order No.)
+关联的订单号(付费重置时显示,可点击查看订单详情)。
+
+### 时间 (Time)
+重置时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的重置记录,默认今天。
+
+### 订阅ID筛选
+输入订阅ID查看该订阅的重置记录。
+
+## 使用场景
+
+### 场景一: 查看今日重置
+
+1. 默认显示今天的重置记录
+2. 统计重置数量
+3. 分析重置类型分布
+4. 识别高频重置用户
+
+### 场景二: 追踪订阅重置
+
+**查看订阅历史**:
+1. 输入订阅ID筛选
+2. 查看所有重置记录
+3. 分析重置频率
+4. 验证重置是否正常
+
+### 场景三: 分析付费重置
+
+**统计付费数据**:
+1. 筛选"付费重置"类型
+2. 统计付费重置数量
+3. 计算付费重置收入
+4. 分析用户需求
+
+### 场景四: 排查异常重置
+
+**检查可疑重置**:
+1. 查看重置日志
+2. 关注高频提前重置
+3. 识别异常重置行为
+4. 验证订单关联
+
+## 重置类型说明
+
+### 自动重置 (Auto Reset)
+- 按订阅周期自动重置
+- 每月/每周/每日重置
+- 系统定时任务执行
+- 最常见的重置方式
+
+### 提前重置 (Advance Reset)
+- 用户主动提前重置
+- 需要消耗重置次数
+- 或者付费购买重置
+- 适合流量用尽场景
+
+### 付费重置 (Paid Reset)
+- 用户购买流量重置服务
+- 生成订单记录
+- 支付后立即重置
+- 有订单号关联
+
+## 重置规则
+
+### 自动重置时间
+- **月重置**: 每月1号0点
+- **周重置**: 每周一0点
+- **日重置**: 每天0点
+
+### 重置次数限制
+- 套餐包含重置次数
+- 超出次数需付费
+- 次数每周期重置
+
+### 付费重置价格
+- 按套餐流量配置
+- 一般为套餐价格20-30%
+- 可在产品管理配置
+
+## 流量管理
+
+### 重置策略
+- 设置合理重置周期
+- 配置重置次数限制
+- 定价付费重置服务
+- 通知用户重置规则
+
+### 用户提醒
+- 流量即将用尽提醒
+- 重置时间提醒
+- 付费重置推荐
+- 升级套餐建议
+
+## 数据统计
+
+### 重置分析
+每日/月统计:
+- 自动重置数量
+- 提前重置数量
+- 付费重置数量
+- 付费重置收入
+
+### 用户行为
+- 高频重置用户
+- 付费重置转化率
+- 重置后流量使用
+- 升级套餐转化
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **订阅关联**: 每条记录关联订阅ID
+3. **类型识别**: 通过类型区分重置方式
+4. **订单关联**: 付费重置有订单号
+5. **时间准确**: 记录精确重置时间
+6. **次数管理**: 跟踪用户重置次数
+7. **定期分析**: 每周分析重置数据
+8. **策略优化**: 根据数据优化重置规则
+
+</div>

docs/zh/admin/logs/server-traffic.md

@@ -0,0 +1,149 @@
+<div v-pre>
+
+# 服务器流量日志
+
+查看各服务器的每日流量统计,支持查看详细流量消费明细。
+
+## 表格列说明
+
+### 服务器 (Server)
+服务器信息显示:
+- 服务器ID(Badge显示)
+- 服务器名称
+
+### 上传 (Upload)
+当日上传流量,自动转换单位(B/KB/MB/GB/TB)。
+
+### 下载 (Download)
+当日下载流量,自动转换单位。
+
+### 总计 (Total)
+当日总流量(上传+下载)。
+
+### 日期 (Date)
+流量统计日期。
+
+## 表格操作
+
+### 查看详情 (Detail)
+点击"详情"按钮跳转到流量详细记录页面:
+- 查看该日期该服务器的详细流量
+- 按用户分组显示
+- 按订阅统计
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的流量记录,默认今天。
+
+### 服务器ID筛选
+输入服务器ID查看该服务器的流量记录。
+
+## 使用场景
+
+### 场景一: 查看今日流量
+
+1. 默认显示今天的流量记录
+2. 查看各服务器流量消耗
+3. 识别高流量服务器
+4. 分析流量分布
+
+### 场景二: 追踪服务器负载
+
+**查看服务器使用**:
+1. 输入服务器ID筛选
+2. 查看历史流量记录
+3. 分析流量趋势
+4. 评估服务器负载
+
+### 场景三: 排查流量异常
+
+**检查异常消耗**:
+1. 浏览流量记录
+2. 关注异常高流量服务器
+3. 点击"详情"查看明细
+4. 按用户分析流量分布
+5. 检查是否存在滥用
+
+### 场景四: 流量统计分析
+
+**生成报表**:
+1. 选择日期范围
+2. 导出流量数据
+3. 分析流量高峰时段
+4. 优化服务器资源分配
+5. 制定扩容计划
+
+## 流量详情页
+
+点击"详情"后显示:
+
+### 用户流量明细
+- 每个用户的流量消耗
+- 订阅流量统计
+- 连接时长记录
+
+### 节点流量统计
+- 每个节点的流量总计
+- 流量占比分析
+- 用户分布情况
+
+## 流量监控
+
+### 正常模式
+- 流量均匀分布
+- 符合用户数量
+- 波峰波谷规律
+
+### 异常模式
+关注以下异常:
+- 单服务器流量突然激增
+- 流量分布严重不均
+- 异常时间段高流量
+- 单用户流量过高
+
+## 服务器管理
+
+### 负载均衡
+根据流量数据:
+- 识别高负载服务器
+- 分配用户到其他服务器
+- 调整服务器权重
+- 优化节点配置
+
+### 容量规划
+根据流量趋势:
+- 预测流量增长
+- 规划服务器扩容
+- 优化带宽配置
+- 控制运营成本
+
+## 数据分析
+
+### 流量统计
+每日/月统计:
+- 总流量消耗
+- 各服务器占比
+- 流量增长趋势
+- 带宽使用率
+
+### 成本分析
+- 流量成本计算
+- 服务器ROI分析
+- 优化空间识别
+- 成本控制建议
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **单位换算**: 自动转换为易读单位
+3. **服务器关联**: 可查看单个服务器历史
+4. **详情跳转**: 点击详情查看用户级明细
+5. **实时性**: 流量数据可能有延迟
+6. **总计准确**: 总计包含上传和下载
+7. **定期分析**: 建议每周分析流量趋势
+8. **负载监控**: 关注服务器负载情况
+9. **扩容预警**: 流量接近上限时扩容
+10. **成本优化**: 根据流量数据优化配置
+
+</div>

docs/zh/admin/logs/subscribe-traffic.md

@@ -0,0 +1,120 @@
+<div v-pre>
+
+# 订阅流量日志
+
+查看用户订阅的每日流量使用统计,支持查看详细流量消费明细。
+
+## 表格列说明
+
+### 用户 (User)
+使用流量的用户(可点击查看详情)。
+
+### 订阅 (Subscribe)
+关联的订阅ID(可点击查看订阅详情,悬停显示卡片)。
+
+### 上传 (Upload)
+当日上传流量,自动转换单位(B/KB/MB/GB/TB)。
+
+### 下载 (Download)
+当日下载流量,自动转换单位。
+
+### 总计 (Total)
+当日总流量(上传+下载)。
+
+### 日期 (Date)
+流量统计日期。
+
+## 表格操作
+
+### 查看详情 (Detail)
+点击"详情"按钮跳转到流量详细记录页面:
+- 查看该日期该订阅的详细流量
+- 按节点分组显示
+- 按服务器统计
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的流量记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的流量记录。
+
+### 订阅ID筛选
+输入订阅ID查看该订阅的流量记录。
+
+## 使用场景
+
+### 场景一: 查看今日流量
+
+1. 默认显示今天的流量记录
+2. 查看总流量消耗
+3. 识别高流量用户
+4. 分析流量趋势
+
+### 场景二: 追踪用户流量
+
+**查看用户使用**:
+1. 输入用户ID筛选
+2. 查看所有订阅流量
+3. 分析使用习惯
+4. 预测流量需求
+
+### 场景三: 排查流量异常
+
+**检查异常消耗**:
+1. 浏览流量记录
+2. 关注异常高流量
+3. 点击"详情"查看明细
+4. 按节点分析流量分布
+5. 检查是否存在滥用
+
+### 场景四: 流量统计分析
+
+**生成报表**:
+1. 选择日期范围
+2. 导出流量数据
+3. 分析流量高峰时段
+4. 优化节点资源分配
+
+## 流量详情页
+
+点击"详情"后显示:
+
+### 节点流量明细
+- 每个节点的流量消耗
+- 上传/下载分开统计
+- 连接时长记录
+
+### 服务器流量统计
+- 每台服务器的流量总计
+- 流量占比分析
+- 负载情况评估
+
+## 流量监控
+
+### 异常模式
+关注以下异常:
+- 单日流量突然激增
+- 流量远超套餐限制
+- 异常时间段高流量
+- 单节点流量过高
+
+### 处理措施
+发现异常时:
+1. 查看流量详情
+2. 确认是否滥用
+3. 限速或暂停订阅
+4. 通知用户核实
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留时间
+2. **单位换算**: 自动转换为易读单位
+3. **订阅关联**: 可跨查用户的多个订阅
+4. **详情跳转**: 点击详情查看节点级明细
+5. **实时性**: 流量数据可能有延迟
+6. **总计准确**: 总计包含上传和下载
+7. **定期分析**: 建议每周分析流量趋势
+
+</div>

docs/zh/admin/logs/subscribe.md

@@ -0,0 +1,127 @@
+<div v-pre>
+
+# 订阅日志
+
+查看用户订阅链接的请求记录,包含IP、设备和时间信息。
+
+## 表格列说明
+
+### 用户 (User)
+请求订阅的用户(可点击查看详情)。
+
+### 订阅ID (Subscribe)
+请求的订阅ID(可点击查看订阅详情,悬停显示卡片)。
+
+### IP地址 (IP)
+请求IP地址(可点击查看IP信息)。
+
+### User Agent
+客户端设备和系统信息:
+- 鼠标悬停显示完整内容
+- 截断显示避免过长
+
+### 时间 (Time)
+请求时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的订阅记录,默认今天。
+
+### 用户ID筛选
+输入用户ID查看该用户的订阅请求。
+
+### 订阅ID筛选
+输入订阅ID查看该订阅的请求记录。
+
+## 使用场景
+
+### 场景一: 查看今日请求
+
+1. 默认显示今天的订阅记录
+2. 查看请求频率
+3. 分析活跃订阅
+4. 识别异常请求
+
+### 场景二: 追踪用户请求
+
+**查看用户活动**:
+1. 输入用户ID筛选
+2. 查看所有订阅请求
+3. 分析使用频率
+4. 验证设备类型
+
+### 场景三: 排查订阅异常
+
+**检查异常请求**:
+1. 查看订阅日志
+2. 关注IP地址变化
+3. 检查User Agent
+4. 识别可疑设备
+5. 必要时封禁订阅
+
+### 场景四: 分析客户端分布
+
+**统计客户端类型**:
+1. 查看User Agent信息
+2. 统计客户端分布
+3. 了解用户使用习惯
+4. 优化客户端支持
+
+## 订阅请求监控
+
+### 正常模式
+- 定期请求订阅链接
+- 更新节点信息
+- 同步配置变更
+
+### 异常模式
+关注以下异常:
+- 短时间高频请求
+- 同一IP多订阅请求
+- 异常国家/地区访问
+- 陌生客户端类型
+
+## 安全防护
+
+### 检测措施
+- 请求频率限制
+- IP黑白名单
+- 订阅Token验证
+- 设备数量限制
+
+### 处理措施
+发现滥用时:
+1. 限制请求频率
+2. 临时封禁IP
+3. 重置订阅Token
+4. 通知用户确认
+
+## User Agent分析
+
+### 常见客户端
+- **Clash**: Clash for Windows/Mac/Android
+- **Shadowrocket**: iOS客户端
+- **V2rayN**: Windows客户端
+- **Quantumult**: iOS客户端
+- **Surfboard**: Android客户端
+
+### 识别信息
+从User Agent获取:
+- 客户端名称和版本
+- 操作系统类型
+- 设备型号
+- 系统版本
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **IP追踪**: 可查看IP地理位置
+3. **设备识别**: User Agent包含客户端信息
+4. **请求频率**: 正常客户端定期请求
+5. **异常监控**: 关注高频和异地请求
+6. **隐私保护**: IP和设备信息敏感
+7. **定期分析**: 每周分析订阅请求趋势
+8. **防止泄露**: 订阅链接不应公开分享
+
+</div>

docs/zh/admin/logs/traffic-details.md

@@ -0,0 +1,172 @@
+<div v-pre>
+
+# 流量详情日志
+
+查看流量消费的详细记录,支持按服务器、用户、订阅多维度筛选。
+
+## 表格列说明
+
+### 服务器 (Server)
+产生流量的服务器:
+- 服务器名称
+- 服务器ID
+
+### 用户 (User)
+使用流量的用户(可点击查看详情)。
+
+### 订阅 (Subscribe)
+关联的订阅ID(可点击查看订阅详情,悬停显示卡片)。
+
+### 上传 (Upload)
+上传流量,自动转换单位(B/KB/MB/GB/TB)。
+
+### 下载 (Download)
+下载流量,自动转换单位。
+
+### 时间 (Time)
+流量产生时间。
+
+## 筛选功能
+
+### 日期筛选
+选择查看指定日期的流量详情,默认今天。
+
+### 服务器ID筛选
+输入服务器ID查看该服务器的流量详情。
+
+### 用户ID筛选
+输入用户ID查看该用户的流量详情。
+
+### 订阅ID筛选
+输入订阅ID查看该订阅的流量详情。
+
+## 使用场景
+
+### 场景一: 查看服务器流量明细
+
+从服务器流量日志点击"详情"进入:
+1. 自动带入日期和服务器ID
+2. 查看该服务器所有用户流量
+3. 按用户排序查看
+4. 识别高流量用户
+
+### 场景二: 查看用户流量详情
+
+从订阅流量日志点击"详情"进入:
+1. 自动带入日期、用户ID和订阅ID
+2. 查看该用户该订阅流量
+3. 按服务器查看分布
+4. 分析使用习惯
+
+### 场景三: 排查流量异常
+
+**详细排查**:
+1. 选择异常日期
+2. 输入相关筛选条件
+3. 查看详细流量记录
+4. 按时间排序分析
+5. 识别异常流量来源
+
+### 场景四: 流量统计分析
+
+**多维度分析**:
+1. 选择时间范围
+2. 组合不同筛选条件
+3. 导出详细数据
+4. 生成流量报表
+5. 制定优化策略
+
+## 数据关联
+
+### 从服务器流量跳转
+- 带入服务器ID和日期
+- 查看该服务器所有流量
+- 可进一步筛选用户
+
+### 从订阅流量跳转
+- 带入用户ID、订阅ID和日期
+- 查看该订阅所有流量
+- 可查看不同服务器
+
+## 流量分析
+
+### 时间分布
+- 查看流量时间分布
+- 识别使用高峰时段
+- 分析用户活跃时间
+- 优化服务器调度
+
+### 服务器分布
+- 统计各服务器流量占比
+- 分析负载分布
+- 识别热门服务器
+- 优化负载均衡
+
+### 用户分布
+- 识别高流量用户
+- 分析用户使用习惯
+- 检查是否存在滥用
+- 优化套餐配置
+
+## 流量监控
+
+### 正常模式
+- 流量均匀分布
+- 时间规律性
+- 符合用户数量
+- 无异常峰值
+
+### 异常模式
+关注以下异常:
+- 单次流量异常大
+- 异常时间段流量
+- 单用户高频请求
+- 流量分布不合理
+
+## 排查步骤
+
+### 发现异常
+1. 从统计日志发现异常
+2. 点击详情进入
+3. 查看详细记录
+
+### 定位问题
+1. 按时间排序
+2. 识别异常记录
+3. 查看用户信息
+4. 确认订阅状态
+
+### 处理措施
+1. 验证是否正常使用
+2. 检查是否滥用
+3. 限速或暂停订阅
+4. 通知用户确认
+
+## 数据导出
+
+### 导出用途
+- 生成流量报表
+- 财务对账
+- 用户分析
+- 容量规划
+
+### 导出内容
+- 所有列数据
+- 筛选后的数据
+- CSV或Excel格式
+- 支持批量导出
+
+## 重要提示
+
+1. **日志保留**: 根据系统配置保留
+2. **单位换算**: 自动转换为易读单位
+3. **多维筛选**: 支持多个条件组合
+4. **跳转带参**: 从统计日志跳转自动带入参数
+5. **实时性**: 流量数据可能有延迟
+6. **详细程度**: 最详细的流量记录
+7. **性能考虑**: 大量数据时注意筛选
+8. **定期清理**: 详情日志占用空间较大
+9. **导出限制**: 单次导出可能有数量限制
+10. **隐私保护**: 详细记录包含用户行为信息
+
+</div>