From 43fe456d060670ccc26cabdf3332790ccc9ecd17 Mon Sep 17 00:00:00 2001 From: anghunk Date: Thu, 22 Jan 2026 22:37:00 +0800 Subject: [PATCH] =?UTF-8?q?refactor(admin):=20=E5=90=88=E5=B9=B6=E5=8A=9F?= =?UTF-8?q?=E8=83=BD=E8=AE=BE=E7=BD=AE=E5=88=B0=E7=BD=91=E7=AB=99=E8=AE=BE?= =?UTF-8?q?=E7=BD=AE=E5=B9=B6=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 将功能开关设置从独立页面合并到网站设置页面，简化导航结构 更新相关API文档和功能说明文档 移除不再使用的FeatureSettingsView组件和相关路由配置 --- cwd-admin/src/router/index.ts | 6 - cwd-admin/src/views/FeatureSettingsView.vue | 262 -------------------- cwd-admin/src/views/LayoutView.vue | 7 - cwd-admin/src/views/SettingsView.vue | 102 ++++++-- docs/.vitepress/configs/sidebar.js | 1 + docs/api/admin.md | 5 + docs/api/admin/feature-settings.md | 96 +++++++ docs/api/overview.md | 16 ++ docs/api/public.md | 4 +- 9 files changed, 200 insertions(+), 299 deletions(-) delete mode 100644 cwd-admin/src/views/FeatureSettingsView.vue create mode 100644 docs/api/admin/feature-settings.md diff --git a/cwd-admin/src/router/index.ts b/cwd-admin/src/router/index.ts index 3814ffe..155a8d1 100644 --- a/cwd-admin/src/router/index.ts +++ b/cwd-admin/src/router/index.ts @@ -3,7 +3,6 @@ import LoginView from '../views/LoginView.vue'; import LayoutView from '../views/LayoutView.vue'; import CommentsView from '../views/CommentsView.vue'; import SettingsView from '../views/SettingsView.vue'; -import FeatureSettingsView from '../views/FeatureSettingsView.vue'; import DataView from '../views/DataView.vue'; import StatsView from '../views/StatsView.vue'; import AnalyticsVisitView from '../views/AnalyticsVisitView.vue'; @@ -42,11 +41,6 @@ const routes: RouteRecordRaw[] = [ name: 'settings', component: SettingsView }, - { - path: 'settings/features', - name: 'feature-settings', - component: FeatureSettingsView - }, { path: 'data', name: 'data', diff --git a/cwd-admin/src/views/FeatureSettingsView.vue b/cwd-admin/src/views/FeatureSettingsView.vue deleted file mode 100644 index 54bf836..0000000 --- a/cwd-admin/src/views/FeatureSettingsView.vue +++ /dev/null @@ -1,262 +0,0 @@ - - - - - diff --git a/cwd-admin/src/views/LayoutView.vue b/cwd-admin/src/views/LayoutView.vue index b2ae561..f5cb116 100644 --- a/cwd-admin/src/views/LayoutView.vue +++ b/cwd-admin/src/views/LayoutView.vue @@ -97,13 +97,6 @@ > 网站设置 -
  • - 功能开关 -
  • +
    +

    功能开关

    +
    + + +
    开启后，评论区顶部会显示文章点赞（喜欢）按钮。
    +
    +
    + + +
    开启后，评论列表中的每条评论都会显示点赞按钮。
    +
    +
    + +
    +
    +

    通知邮箱设置

    @@ -246,6 +272,8 @@ import { fetchEmailNotifySettings, saveEmailNotifySettings, sendTestEmail, + fetchFeatureSettings, + saveFeatureSettings, } from "../api/admin"; const DEFAULT_REPLY_TEMPLATE = `
    @@ -335,12 +363,15 @@ const blockedEmails = ref(""); const commentAdminKey = ref(""); const adminKeySet = ref(false); const requireReview = ref(false); +const enableArticleLike = ref(true); +const enableCommentLike = ref(true); const savingEmail = ref(false); const testingEmail = ref(false); const savingComment = ref(false); +const savingFeature = ref(false); const loading = ref(false); const message = ref(""); -const messageType = ref<"success" | "error">("success"); +const messageType messageType = ref<"success" | "error">("success"); const toastMessage = ref(""); const toastType = ref<"success" | "error">("success"); const toastVisible = ref(false); @@ -379,10 +410,11 @@ function resetTemplatesToDefault() { async function load() { loading.value = true; try { - const [notifyRes, commentRes, emailNotifyRes] = await Promise.all([ + const [notifyRes, commentRes, emailNotifyRes, featureRes] = await Promise.all([ fetchAdminEmail(), fetchCommentSettings(), fetchEmailNotifySettings(), + fetchFeatureSettings(), ]); email.value = notifyRes.email || ""; commentAdminEmail.value = commentRes.adminEmail || ""; @@ -400,6 +432,8 @@ async function load() { adminKeySet.value = !!commentRes.adminKeySet; requireReview.value = !!commentRes.requireReview; emailGlobalEnabled.value = !!emailNotifyRes.globalEnabled; + enableArticleLike.value = featureRes.enableArticleLike; + enableCommentLike.value = featureRes.enableCommentLike; if (emailNotifyRes.templates) { templateAdmin.value = emailNotifyRes.templates.admin || DEFAULT_ADMIN_TEMPLATE; @@ -516,28 +550,30 @@ async function saveComment() { savingComment.value = true; message.value = ""; try { - const res = await saveCommentSettings({ - adminEmail: commentAdminEmail.value, - adminBadge: commentAdminBadge.value, - avatarPrefix: avatarPrefix.value, - adminEnabled: commentAdminEnabled.value, - allowedDomains: allowedDomains.value - .split(/[,，\n]/) - .map((d) => d.trim()) - .filter(Boolean), - adminKey: commentAdminKey.value || undefined, - requireReview: requireReview.value, - blockedIps: blockedIps.value - .split(/[,，\n]/) - .map((d) => d.trim()) - .filter(Boolean), - blockedEmails: blockedEmails.value - .split(/[,，\n]/) - .map((d) => d.trim()) - .filter(Boolean), - }); + const [commentRes] = await Promise.all([ + saveCommentSettings({ + adminEmail: commentAdminEmail.value, + adminBadge: commentAdminBadge.value, + avatarPrefix: avatarPrefix.value, + adminEnabled: commentAdminEnabled.value, + allowedDomains: allowedDomains.value + .split(/[,，\n]/) + .map((d) => d.trim()) + .filter(Boolean), + adminKey: commentAdminKey.value || undefined, + requireReview: requireReview.value, + blockedIps: blockedIps.value + .split(/[,，\n]/) + .map((d) => d.trim()) + .filter(Boolean), + blockedEmails: blockedEmails.value + .split(/[,，\n]/) + .map((d) => d.trim()) + .filter(Boolean), + }), + ]); - showToast(res.message || "保存成功", "success"); + showToast(commentRes.message || "保存成功", "success"); } catch (e: any) { message.value = e.message || "保存失败"; messageType.value = "error"; @@ -546,6 +582,26 @@ async function saveComment() { } } +async function saveFeature() { + savingFeature.value = true; + message.value = ""; + try { + const [featureRes] = await Promise.all([ + saveFeatureSettings({ + enableArticleLike: enableArticleLike.value, + enableCommentLike: enableCommentLike.value, + }), + ]); + + showToast(featureRes.message || "保存成功", "success"); + } catch (e: any) { + message.value = e.message || "保存失败"; + messageType.value = "error"; + } finally { + savingFeature.value = false; + } +} + onMounted(() => { load(); }); diff --git a/docs/.vitepress/configs/sidebar.js b/docs/.vitepress/configs/sidebar.js index 977d703..9b39f22 100644 --- a/docs/.vitepress/configs/sidebar.js +++ b/docs/.vitepress/configs/sidebar.js @@ -37,6 +37,7 @@ export const apiSidebar = [ { text: '邮件通知', link: '/api/admin/email-notify' }, { text: '统计数据', link: '/api/admin/stats' }, { text: '访问统计', link: '/api/admin/analytics' }, + { text: '点赞开关', link: '/api/admin/feature-settings' }, ], }, ], diff --git a/docs/api/admin.md b/docs/api/admin.md index 77e9ab4..f296822 100644 --- a/docs/api/admin.md +++ b/docs/api/admin.md @@ -55,3 +55,8 @@ Token 通过登录接口获取，有效期为 24 小时。 - **获取点赞记录列表** `GET /admin/likes/list` - 获取各页面的点赞记录列表，支持按页面或用户筛选 - **获取点赞统计** `GET /admin/likes/stats` - 获取点赞 Top 页面列表，用于后台展示点赞排行榜 + +### [功能设置相关](./admin/feature-settings.md) + +- **获取功能设置** `GET /admin/settings/feature` - 获取功能开关设置（评论点赞、文章点赞） +- **更新功能设置** `PUT /admin/settings/feature` - 更新功能开关设置 diff --git a/docs/api/admin/feature-settings.md b/docs/api/admin/feature-settings.md new file mode 100644 index 0000000..e083b3f --- /dev/null +++ b/docs/api/admin/feature-settings.md @@ -0,0 +1,96 @@ +# 功能设置相关 + +管理点赞功能开关的接口。 + +## 获取功能设置 + +``` +GET /admin/settings/feature +``` + +获取当前的功能开关配置。 + +- 方法：`GET` +- 路径：`/admin/settings/feature` +- 鉴权：需要 Bearer Token + +**成功响应** + +- 状态码：`200` + +```json +{ + "enableCommentLike": true, + "enableArticleLike": true +} +``` + +字段说明： + +| 字段名 | 类型 | 说明 | +| ------------------ | ------- | ---------------------- | +| `enableCommentLike` | boolean | 是否启用评论点赞功能 | +| `enableArticleLike` | boolean | 是否启用文章点赞功能 | + +## 更新功能设置 + +``` +PUT /admin/settings/feature +``` + +更新功能开关配置。 + +- 方法：`PUT` +- 路径：`/admin/settings/feature` +- 鉴权：需要 Bearer Token + +**请求头** + +| 名称 | 必填 | 示例 | +| -------------- | ---- | ------------------ | +| `Content-Type` | 是 | `application/json` | +| `Authorization` | 是 | `Bearer ` | + +**请求体** + +```json +{ + "enableCommentLike": true, + "enableArticleLike": true +} +``` + +字段说明： + +| 字段名 | 类型 | 必填 | 说明 | +| ------------------ | ------- | ---- | ---------------------- | +| `enableCommentLike` | boolean | 否 | 是否启用评论点赞功能 | +| `enableArticleLike` | boolean | 否 | 是否启用文章点赞功能 | + +**成功响应** + +- 状态码：`200` + +```json +{ + "message": "Saved successfully" +} +``` + +**错误响应** + +- 状态码：`401` + +```json +{ + "message": "Unauthorized" +} +``` + +- 状态码：`500` + +```json +{ + "message": "Failed to save feature settings" +} +``` diff --git a/docs/api/overview.md b/docs/api/overview.md index 4aa987a..4ca14b9 100644 --- a/docs/api/overview.md +++ b/docs/api/overview.md @@ -8,6 +8,22 @@ 所有 API 均为 RESTful 风格，无会话 Cookie，认证全部通过 `Authorization` 请求头完成。 +## 功能特性 + +### 评论点赞 + +- 支持对单条评论进行点赞 +- 每个用户对同一条评论只能点赞一次（通过 localStorage 本地记录用户 ID 和点赞状态） +- 点赞数实时更新 +- 可通过管理员后台功能设置页面开启/关闭评论点赞功能 + +### 文章点赞 + +- 支持对整篇文章进行点赞 +- 每个用户对同一篇文章只能点赞一次 +- 点赞数实时显示 +- 可通过管理员后台功能设置页面开启/关闭文章点赞功能 + ## 版本信息 部署成功后，直接访问 Base URL，成功时返回 HTML，其中包含类似文案： diff --git a/docs/api/public.md b/docs/api/public.md index d0a967d..dd8d00a 100644 --- a/docs/api/public.md +++ b/docs/api/public.md @@ -45,6 +45,7 @@ GET /api/comments "postSlug": "/blog/hello-world", "avatar": "https://gravatar.com/avatar/...", "priority": 2, + "likes": 5, "replies": [ { "id": 2, @@ -58,7 +59,8 @@ GET /api/comments "avatar": "https://gravatar.com/avatar/...", "parentId": 1, "replyToAuthor": "张三", - "priority": 1 + "priority": 1, + "likes": 2 } ] }