feat(analytics): 添加访问统计功能

实现页面访问统计功能,包括:
1. 前端组件挂载时上报访问数据
2. 后端接口记录访问信息并存储
3. 管理后台新增访问统计视图
4. 相关API文档和设计说明更新
This commit is contained in:
anghunk
2026-01-21 21:56:57 +08:00
parent aabf370f65
commit d5a7a15344
12 changed files with 1241 additions and 201 deletions

View File

@@ -18,6 +18,70 @@
开启是否显示博主标签,配置博主邮箱和标签文字,即可在评论中显示博主标签;关闭为不显示。
### 管理员评论密钥
设置管理员评论密钥后,博主在前台发布评论时需要输入此密钥进行身份验证,评论将被直接通过,不受"先审核再显示"设置的影响。
**注意**
- 同一 IP 连续验证失败 3 次后,该 IP 将被锁定 30 分钟
- 失败次数记录有效期为 1 小时
### 评论置顶
在评论管理页面,点击"编辑"按钮可修改评论的置顶权重:
- `1`:不置顶(默认值)
- `2` 或更高:数值越大,该评论在列表中排序越靠前
置顶后的评论会在前台评论列表中优先显示。
### 邮件通知配置
在设置页面可以配置邮件通知功能,包括:
#### 全局开关
控制是否启用邮件通知功能。
#### SMTP 配置
| 字段 | 说明 | 示例 |
| ------- | -------------------------------- | ----------------- |
| 主机 | SMTP 服务器地址 | `smtp.qq.com` |
| 端口 | SMTP 服务器端口 | `465` |
| 用户名 | 发件邮箱 | `noreply@qq.com` |
| 密码 | 邮箱密码或授权码 | `your_password` |
| 安全连接 | 是否使用 SSL/TLS | `true` |
#### 邮件模板
支持自定义 HTML 邮件模板,包含以下变量:
**回复评论模板变量**
| 变量名 | 说明 |
| ----------------- | ------------ |
| `${toEmail}` | 收件人邮箱 |
| `${toName}` | 收件人昵称 |
| `${postTitle}` | 文章标题 |
| `${parentComment}` | 被回复的评论内容 |
| `${replyAuthor}` | 回复者昵称 |
| `${replyContent}` | 回复内容 |
| `${postUrl}` | 文章链接 |
**新评论通知模板变量**
| 变量名 | 说明 |
| ----------------- | ------------ |
| `${postTitle}` | 文章标题 |
| `${postUrl}` | 文章链接 |
| `${commentAuthor}` | 评论者昵称 |
| `${commentContent}` | 评论内容 |
#### 测试邮件
配置完成后,可以使用"测试邮件"功能发送一封测试邮件到指定邮箱,验证配置是否正确。
## 使用官方管理后台
使用官方提供的管理后台最新版本https://cwd.zishu.me