73bbe44fbc
feat(email): 提取邮箱验证逻辑到共享模块并增强验证 docs: 更新文档移除不再使用的ALLOW_ORIGIN配置 style(admin): 为设置页面添加加载状态和样式优化 fix(comments): 在邮件发送前增加邮箱格式验证
77 lines
2.5 KiB
Markdown
77 lines
2.5 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
## 项目概述
|
||
|
||
这是一个基于 Cloudflare Workers 的轻量级评论系统后端（Momo Backend Worker），使用 Hono 框架构建，数据存储使用 Cloudflare D1（SQLite）和 KV。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 开发
|
||
npm run dev # 本地开发服务器
|
||
npm run deploy # 部署到 Cloudflare Workers
|
||
|
||
# 测试
|
||
npm run test # 运行 Vitest 测试
|
||
|
||
# 类型生成
|
||
npm run cf-typegen # 生成 Cloudflare Workers 类型定义
|
||
|
||
# 数据库操作
|
||
npm wrangler d1 execute CWD_DB --remote --file=./schemas/comment.sql # 初始化数据库表
|
||
```
|
||
|
||
## 架构概览
|
||
|
||
```
|
||
src/
|
||
├── index.ts # 应用入口，路由定义
|
||
├── bindings.ts # TypeScript 类型定义（Env 绑定）
|
||
├── api/
|
||
│ ├── admin/ # 管理员 API（需认证）
|
||
│ │ ├── login.ts, listComments.ts, deleteComment.ts, updateStatus.ts
|
||
│ └── public/ # 公开 API
|
||
│ ├── getComments.ts, postComment.ts
|
||
├── utils/
|
||
│ ├── auth.ts # 管理员认证中间件
|
||
│ ├── cors.ts # CORS 配置
|
||
│ ├── email.ts # Resend 邮件通知
|
||
│ └── getAvatar.ts # Gravatar 头像生成
|
||
└── views/
|
||
└── html.ts # 管理后台 HTML 页面（内嵌 Vue 3）
|
||
```
|
||
|
||
## API 路由
|
||
|
||
| 方法 | 路径 | 功能 | 认证 |
|
||
|------|------|------|------|
|
||
| GET | `/` | 管理后台页面 | 否 |
|
||
| GET | `/api/comments` | 获取评论列表 | 否 |
|
||
| POST | `/api/comments` | 提交评论 | 否 |
|
||
| POST | `/admin/login` | 管理员登录 | 否 |
|
||
| GET | `/admin/comments/list` | 评论管理列表 | Bearer Token |
|
||
| PUT | `/admin/comments/status` | 更新评论状态 | Bearer Token |
|
||
| DELETE | `/admin/comments/delete` | 删除评论 | Bearer Token |
|
||
|
||
## 关键绑定
|
||
|
||
- `CWD_DB`: D1 数据库绑定
|
||
- `CWD_AUTH_KV`: KV 存储（用于认证 Token）
|
||
|
||
## 环境变量
|
||
|
||
| 变量名 | 说明 | 必填 |
|
||
| ------------------- | --------------- | ---- |
|
||
| `ADMIN_NAME` | 管理员用户名 | 是 |
|
||
| `ADMIN_PASSWORD` | 管理员密码 | 是 |
|
||
| `RESEND_API_KEY` | Resend API 密钥 | 否 |
|
||
| `RESEND_FROM_EMAIL` | 发件邮箱 | 否 |
|
||
| `EMAIL_ADDRESS` | 站长接收邮箱 | 否 |
|
||
|
||
## 本地开发
|
||
|
||
1. 复制 `.dev.vars.example` 为 `.dev.vars` 并配置环境变量
|
||
2. 运行 `npm run dev` 启动本地开发服务器
|