From e6bc8529451e3b21554bcb8779bfb4afce24617b Mon Sep 17 00:00:00 2001 From: anghunk Date: Tue, 20 Jan 2026 13:00:36 +0800 Subject: [PATCH] =?UTF-8?q?feat(admin):=20=E6=B7=BB=E5=8A=A0=E8=AF=84?= =?UTF-8?q?=E8=AE=BA=E6=95=B0=E6=8D=AE=E5=AF=BC=E5=87=BA=E5=8A=9F=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增数据管理页面和导出功能 - 实现后端导出接口返回所有评论数据 - 更新文档添加导出接口说明 --- cwd-comments-admin/src/api/admin.ts | 5 + cwd-comments-admin/src/router/index.ts | 6 + cwd-comments-admin/src/views/DataView.vue | 143 ++++++++++++++++++ cwd-comments-admin/src/views/LayoutView.vue | 11 ++ .../src/api/admin/exportComments.ts | 14 ++ cwd-comments-api/src/index.ts | 2 + docs/api/admin.md | 48 +++++- docs/api/overview.md | 70 ++------- docs/api/public.md | 26 ++-- 9 files changed, 251 insertions(+), 74 deletions(-) create mode 100644 cwd-comments-admin/src/views/DataView.vue create mode 100644 cwd-comments-api/src/api/admin/exportComments.ts diff --git a/cwd-comments-admin/src/api/admin.ts b/cwd-comments-admin/src/api/admin.ts index 7a4ff63..5ea7962 100644 --- a/cwd-comments-admin/src/api/admin.ts +++ b/cwd-comments-admin/src/api/admin.ts @@ -124,3 +124,8 @@ export function saveCommentSettings(data: { }): Promise<{ message: string }> { return put<{ message: string }>('/admin/settings/comments', data); } + +export function exportComments(): Promise { + return get('/admin/comments/export'); +} + diff --git a/cwd-comments-admin/src/router/index.ts b/cwd-comments-admin/src/router/index.ts index 51d5c50..55c5e4b 100644 --- a/cwd-comments-admin/src/router/index.ts +++ b/cwd-comments-admin/src/router/index.ts @@ -3,6 +3,7 @@ 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 DataView from '../views/DataView.vue'; const routes: RouteRecordRaw[] = [ { @@ -27,6 +28,11 @@ const routes: RouteRecordRaw[] = [ path: 'settings', name: 'settings', component: SettingsView + }, + { + path: 'data', + name: 'data', + component: DataView } ] } diff --git a/cwd-comments-admin/src/views/DataView.vue b/cwd-comments-admin/src/views/DataView.vue new file mode 100644 index 0000000..db5811c --- /dev/null +++ b/cwd-comments-admin/src/views/DataView.vue @@ -0,0 +1,143 @@ + + + + + diff --git a/cwd-comments-admin/src/views/LayoutView.vue b/cwd-comments-admin/src/views/LayoutView.vue index a057248..a87126c 100644 --- a/cwd-comments-admin/src/views/LayoutView.vue +++ b/cwd-comments-admin/src/views/LayoutView.vue @@ -30,6 +30,13 @@ > 评论管理 +
  • + 数据管理 +
  • ) => { + try { + const { results } = await c.env.CWD_DB.prepare( + 'SELECT * FROM Comment ORDER BY pub_date DESC' + ).all(); + + return c.json(results); + } catch (e: any) { + return c.json({ message: e.message || '导出失败' }, 500); + } +}; diff --git a/cwd-comments-api/src/index.ts b/cwd-comments-api/src/index.ts index cc064a2..185a45f 100644 --- a/cwd-comments-api/src/index.ts +++ b/cwd-comments-api/src/index.ts @@ -13,6 +13,7 @@ import { postComment } from './api/public/postComment'; import { adminLogin } from './api/admin/login'; import { deleteComment } from './api/admin/deleteComment'; import { listComments } from './api/admin/listComments'; +import { exportComments } from './api/admin/exportComments'; import { updateStatus } from './api/admin/updateStatus'; import { getAdminEmail } from './api/admin/getAdminEmail'; import { setAdminEmail } from './api/admin/setAdminEmail'; @@ -149,6 +150,7 @@ app.post('/admin/login', adminLogin); app.use('/admin/*', adminAuth); app.delete('/admin/comments/delete', deleteComment); app.get('/admin/comments/list', listComments); +app.get('/admin/comments/export', exportComments); app.put('/admin/comments/status', updateStatus); app.get('/admin/settings/email', getAdminEmail); app.put('/admin/settings/email', setAdminEmail); diff --git a/docs/api/admin.md b/docs/api/admin.md index bc7dce9..79c1dd5 100644 --- a/docs/api/admin.md +++ b/docs/api/admin.md @@ -10,8 +10,6 @@ Authorization: Bearer Token 通过登录接口获取，有效期为 24 小时。 -本节按 OpenAPI 风格描述每个接口的请求 / 响应结构，并补充鉴权和错误码说明。 - ## POST /admin/login 管理员登录，获取后续调用其他管理员接口所需的临时 Token。 @@ -251,6 +249,52 @@ Token 通过登录接口获取，有效期为 24 小时。 } ``` +## GET /admin/comments/export + +导出所有评论数据，返回格式为 JSON，字段与数据库结构一致。 + +- 方法：`GET` +- 路径：`/admin/comments/export` +- 鉴权：需要（Bearer Token） + +### 成功响应 + +- 状态码：`200` + +```json +[ + { + "id": 1, + "pub_date": "2026-01-13 10:00:00", + "post_slug": "/blog/hello-world", + "author": "张三", + "email": "zhangsan@example.com", + "url": "https://zhangsan.me", + "ip_address": "127.0.0.1", + "device": "Desktop", + "os": "Windows 10", + "browser": "Chrome 90", + "user_agent": "Mozilla/5.0 ...", + "content_text": "很棒的文章！", + "content_html": "很棒的文章！", + "parent_id": null, + "status": "approved" + } +] +``` + +### 错误响应 + +- 导出失败： + + - 状态码：`500` + + ```json + { + "message": "导出失败" + } + ``` + ## GET /admin/settings/email 获取当前通知邮箱配置。 diff --git a/docs/api/overview.md b/docs/api/overview.md index c3d61ce..f25d789 100644 --- a/docs/api/overview.md +++ b/docs/api/overview.md @@ -2,33 +2,19 @@ ## 基础信息 -- **Base URL**：`https://your-worker.workers.dev` 或你的自定义域名 +- ** **：`https://your-worker-api.workers.dev` 或你的自定义域名 - **数据格式**：JSON - **字符编码**：UTF-8 所有 API 均为 RESTful 风格，无会话 Cookie，认证全部通过 `Authorization` 请求头完成。 ## 版本信息 - -当前后端版本号在根路径返回： - -```http -GET / -``` - -成功时返回 HTML，其中包含类似文案： +部署成功后，直接访问 Base URL，成功时返回 HTML，其中包含类似文案： ```text CWD 评论部署成功，当前版本 v0.0.1 ``` -说明： - -- 当前 API 路径未在 URL 中显式区分版本（如 `/v1`），版本号仅通过根路径展示。 -- 后续若引入不兼容变更，建议通过自定义域名路径前缀或 Worker 路由实现接口版本化，例如： - - `https://comments-api.example.com/v1` - - `https://api.example.com/comments/v1` - ## 鉴权方式 公开接口与管理员接口的鉴权要求不同： @@ -49,53 +35,19 @@ Authorization: Bearer Token 通过登录接口获取，有效期为 24 小时，服务端会在 KV 中存储会话信息并在每次请求时进行校验。 -## 统一字段与约定 - -虽然当前实现没有使用统一的 `success` 包装字段，但存在一些通用约定： - -- 错误响应： - - 始终包含 `message` 字段，描述错误原因。 - - HTTP 状态码用于表达错误类型（例如 400/401/403/429/500）。 -- 列表类响应： - - 使用 `data` + `pagination` 结构： - - ```json - { - "data": [ /* 列表数据 */ ], - "pagination": { - "page": 1, - "limit": 20, - "total": 5, - "totalCount": 100 - } - } - ``` - -- 单项结果或配置类响应： - - 直接返回对象，例如： - - ```json - { - "email": "admin@example.com" - } - ``` - -- 操作类响应（创建、更新、删除）： - - 一般返回 `{ "message": "说明文本" }`。 - ## HTTP 状态码 常见状态码及含义如下： -| 状态码 | 说明 | 典型场景 | -| ------ | -------------------------- | ---------------------------------------------------- | -| 200 | 请求成功 | 正常查询、操作成功 | -| 400 | 请求参数错误 | 缺少必填字段、格式不正确等 | -| 401 | 未授权 | 未携带 Token 或 Token 失效 | -| 403 | 禁止访问 | 登录失败次数过多导致 IP 被暂时封禁 | -| 404 | 资源不存在（当前未显式使用）| 预留给未来可能的资源不存在场景 | -| 429 | 请求过于频繁 | 评论频率超过限制（默认同一 IP 10 秒内只能评论一次） | -| 500 | 服务器内部错误 | 未捕获异常、数据库错误等 | +| 状态码 | 说明 | 典型场景 | +| ------ | ---------------------------- | --------------------------------------------------- | +| 200 | 请求成功 | 正常查询、操作成功 | +| 400 | 请求参数错误 | 缺少必填字段、格式不正确等 | +| 401 | 未授权 | 未携带 Token 或 Token 失效 | +| 403 | 禁止访问 | 登录失败次数过多导致 IP 被暂时封禁 | +| 404 | 资源不存在（当前未显式使用） | 预留给未来可能的资源不存在场景 | +| 429 | 请求过于频繁 | 评论频率超过限制（默认同一 IP 10 秒内只能评论一次） | +| 500 | 服务器内部错误 | 未捕获异常、数据库错误等 | 具体到每个接口的详细请求 / 响应体和错误码，请参考： diff --git a/docs/api/public.md b/docs/api/public.md index 949e0fe..0f051e7 100644 --- a/docs/api/public.md +++ b/docs/api/public.md @@ -1,8 +1,8 @@ # 公开 API -本节描述无需认证即可访问的公开接口，包括评论获取、评论提交以及评论设置获取。 +无需认证即可访问的公开接口，包括评论获取、评论提交以及评论设置获取。 -遵循 OpenAPI 风格进行组织，包含路径、方法、参数、请求体和响应示例。 +包含路径、方法、参数、请求体和响应示例。 ## GET /api/comments @@ -109,7 +109,7 @@ ```json { - "post_slug": "/blog/hello-world", + "post_slug": "https://example.com/blog/hello-world", "post_title": "博客标题，可选", "post_url": "https://example.com/blog/hello-world", "author": "张三", @@ -122,16 +122,16 @@ #### 字段说明 -| 字段名 | 类型 | 必填 | 说明 | -| ------------ | ------ | ---- | ------------------------------------------------------------ | -| `post_slug` | string | 是 | 文章唯一标识符，应与前端组件初始化时的 `postSlug` 值一致 | -| `post_title` | string | 否 | 文章标题，用于邮件通知内容 | -| `post_url` | string | 否 | 文章 URL，用于邮件通知中的跳转链接 | -| `author` | string | 是 | 评论者昵称 | -| `email` | string | 是 | 评论者邮箱，需为合法邮箱格式 | -| `url` | string | 否 | 评论者个人主页或站点地址 | -| `content` | string | 是 | 评论内容，内部会过滤 `` 片段 | -| `parent_id` | number | 否 | 父评论 ID，用于回复功能；缺省或 `null` 表示根评论 | +| 字段名 | 类型 | 必填 | 说明 | +| ------------ | ------ | ---- | ------------------------------------------------------------------------------------------------------------- | +| `post_slug` | string | 是 | 文章唯一标识符，应与前端组件初始化时的 `postSlug` 值一致，`window.location.origin + window.location.pathname` | +| `post_title` | string | 否 | 文章标题，用于邮件通知内容 | +| `post_url` | string | 否 | 文章 URL，用于邮件通知中的跳转链接 | +| `author` | string | 是 | 评论者昵称 | +| `email` | string | 是 | 评论者邮箱，需为合法邮箱格式 | +| `url` | string | 否 | 评论者个人主页或站点地址 | +| `content` | string | 是 | 评论内容，内部会过滤 `` 片段 | +| `parent_id` | number | 否 | 父评论 ID，用于回复功能；缺省或 `null` 表示根评论 | ### 成功响应