# cf-workers-card

**Repository Path**: bigjump/cf-workers-card

## Basic Information

- **Project Name**: cf-workers-card
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-16
- **Last Updated**: 2025-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CFFK - Cloudflare Workers 发卡平台
部署在Cloudflare Workers上的Nuxt3发卡平台项目。

## 快速开始
> 注意使用npm国内加速源可能导致Cloudflare相关包，比如wrangler安装失败。
```bash
# 克隆项目
git github.com/cffk.git
# 进入项目目录
cd cffk
# 安装依赖
npm install
# 创建数据库，如果没有
wrangler d1 create cffk
```
创建成功后控制台会输出数据库binding、database_name、preview_id信息，配置到[wrangler](./wrangler.jsonc)中d1_databases对应的字段。
```json
{
  "d1_databases": [
    {
      "binding": "DB",
      "database_name": "cffk",
      "preview_id": "00000000-0000-0000-0000-000000000000"
    }
  ]
}
```

### 安全配置
本项目已优化JWT密钥存储方式，使用Cloudflare环境变量进行安全管理。详细配置请参考：
注意：本地环境和Cloudflare环境是分开配置的
- [安全配置指南](./docs/security-guide.md) - 包含JWT密钥配置的详细说明
- `.env.example` - 本地开发环境变量配置示例
- `wrangler secret put JWT_SECRET` - 推荐使用Wrangler CLI设置Cloudflare环境密钥

在部署前，请确保已经按照上面的`[安全配置指南]`配置好以下环境变量：
- `JWT_SECRET`: JWT签名密钥（必须）
- `JWT_EXPIRES_IN`: 令牌过期时间（可选，默认1h）

### 部署
```bash
# 初始化远程数据库
wrangler d1 migrations apply cffk --remote
# 部署，控制台会输出部署好的url地址
npm run deploy
```


### 本地开发
```bash
# 初始化本地数据库
wrangler d1 migrations apply cffk
# 运行开发环境
npm run dev
```

## 其他命令
```bash
# 删除本地数据库
rm -r -fo .wrangler\state\v3\d1
# 清理缓存，运行
npx nuxi cleanup && npm run dev
```