# NextApp 本地启动说明

## 环境要求

- Node.js 18.x 或更高版本
- npm（随 Node.js 一同安装）

---

## 启动步骤

### 1. 安装依赖

```bash
npm install
```

### 2. 配置环境变量

项目已提供 `.env` 文件，内容如下（通常无需修改）：

```
DATABASE_URL="file:./dev.db"
NEXTAUTH_SECRET="nextapp-secret-key-2026"
NEXTAUTH_URL="http://localhost:3000"
```

### 3. 生成 Prisma 客户端

```bash
npx prisma generate
```

### 4. 初始化数据库

```bash
npx prisma migrate dev
```

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

```bash
npm run dev
```

终端出现 `▲ Next.js x.x.x` 及 `Local: http://localhost:3000` 即为启动成功。

### 6. 初始化种子数据（可选）

浏览器访问 **http://localhost:3000/api/seed**，或执行：

```bash
curl http://localhost:3000/api/seed
```

---

## 常用命令

| 命令 | 说明 |
|------|------|
| `npm run dev` | 启动开发服务器（热重载） |
| `npm run build` | 构建生产版本 |
| `npm run start` | 启动生产服务器 |
| `npm run lint` | 代码检查 |
| `npx prisma studio` | 打开数据库可视化工具 |
| `npx prisma migrate dev --name <描述>` | 创建新数据库迁移 |

---

## 访问地址

- 开发环境：**http://localhost:3000**
- 端口被占用时，可指定其他端口：`npm run dev -- -p 3001`

---

## 常见问题

### Prisma 客户端未生成

```bash
npx prisma generate
```

### 数据库迁移未执行

```bash
npx prisma migrate dev
```

### 重置数据库

```bash
npx prisma migrate reset
```

### 清除缓存

```bash
rm -rf .next node_modules/.cache
npm run dev
```