aiapply/DATABASE_SETUP.md

# PromptForge 数据库设置指南

## 🗄️ 数据库配置

PromptForge 使用 **腾讯云数据库** 作为后端数据存储，支持完整的用户系统、模板管理和社区功能。

### 📋 当前配置

- **数据库类型**: MySQL
- **云服务商**: 腾讯云
- **连接地址**: `gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936`
- **数据库名**: `pronode_db`
- **用户名**: `root`

## 🚀 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 设置环境变量

创建 `.env.local` 文件：

```env
# 数据库配置
DATABASE_URL="mysql://root:!Rjb12191@gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936/pronode_db?charset=utf8mb4"

# Next.js 配置
NEXTAUTH_SECRET="your-secret-key-here"
NEXTAUTH_URL="http://localhost:3000"

# 应用配置
NODE_ENV="development"
```

### 3. 生成 Prisma 客户端

```bash
npm run db:generate
```

### 4. 推送数据库模式

```bash
npm run db:push
```

### 5. 初始化示例数据

```bash
npm run db:seed
```

### 6. 启动开发服务器

```bash
npm run dev
```

## 📊 数据库结构

### 主要数据表

1. **users** - 用户信息
2. **templates** - 提示词模板
3. **favorites** - 用户收藏
4. **comments** - 模板评论
5. **tests** - 测试记录
6. **system_configs** - 系统配置

### 表关系

```
User (1) ←→ (N) Template
User (1) ←→ (N) Favorite
User (1) ←→ (N) Comment
Template (1) ←→ (N) Test
```

## 🛠️ 数据库管理命令

```bash
# 生成 Prisma 客户端
npm run db:generate

# 推送模式到数据库
npm run db:push

# 创建迁移文件
npm run db:migrate

# 打开 Prisma Studio（数据库管理界面）
npm run db:studio

# 初始化示例数据
npm run db:seed
```

## 🔧 开发工具

### Prisma Studio

Prisma Studio 是一个可视化的数据库管理工具：

```bash
npm run db:studio
```

访问 `http://localhost:5555` 查看数据库内容。

### 数据库连接测试

```typescript
import { testDatabaseConnection } from '@/lib/database'

// 测试连接
const isConnected = await testDatabaseConnection()
console.log('数据库连接状态:', isConnected)
```

## 🔒 安全配置

### 环境变量

- 生产环境请使用环境变量存储敏感信息
- 不要在代码中硬编码数据库密码
- 定期更换数据库密码

### 访问控制

- 限制数据库访问IP
- 使用最小权限原则
- 定期备份数据

## 📈 性能优化

### 索引优化

```sql
-- 为常用查询添加索引
CREATE INDEX idx_templates_category ON templates(category);
CREATE INDEX idx_templates_author ON templates(authorId);
CREATE INDEX idx_templates_public ON templates(isPublic);
```

### 连接池配置

```typescript
const prisma = new PrismaClient({
  datasources: {
    db: {
      url: databaseUrl,
    },
  },
  // 连接池配置
  log: ['query', 'error', 'warn'],
})
```

## 🚨 故障排除

### 常见问题

1. **连接超时**
   - 检查网络连接
   - 验证数据库地址和端口
   - 确认防火墙设置

2. **认证失败**
   - 验证用户名和密码
   - 检查用户权限
   - 确认数据库存在

3. **模式同步失败**
   - 检查数据库权限
   - 验证表结构
   - 查看错误日志

### 日志查看

```bash
# 查看 Prisma 日志
npm run db:studio

# 查看应用日志
npm run dev
```

## 📚 相关文档

- [Prisma 官方文档](https://www.prisma.io/docs)
- [腾讯云数据库文档](https://cloud.tencent.com/document/product/236)
- [Next.js 数据库集成](https://nextjs.org/docs/app/building-your-application/data-fetching)

## 🤝 支持

如果遇到数据库相关问题，请：

1. 查看错误日志
2. 检查网络连接
3. 验证配置信息
4. 联系技术支持