## 文档

- [nuxt4目录结构](https://nuxt.com/docs/4.x/directory-structure/app/layouts)
- [nuxt4 API](https://nuxt.com/docs/4.x/api/nuxt-config#modulesdir)
- [nitro 文档](https://nitro.build/docs/plugins)
- [drizzle 文档](https://orm.drizzle.org.cn/docs/select)


## 开发与部署

用 Linux 开发与部署，包管理器采用 bun@1.3.11。数据库为 **postgres**（通过 `DATABASE_URL` 连接；本地可参考 `.env.example` 复制为 `.env.local`）。部署时可直接打包 `.output` 目录，在服务器环境执行迁移命令，省时省力。

会话与限流依赖 **Redis**（`REDIS_URL`，见 `.env.example`）。认证相关设计见 `docs/superpowers/specs/2026-04-12-auth-user-design.md`，实现任务见 `docs/superpowers/plans/2026-04-12-auth-user.md`。

- 迁移：`bun run db:migrate`（需可用 `DATABASE_URL`）。
- 生成迁移：在仓库根执行 `bun run db:generate -- --name <tag>`（`--` 之后参数传给 `drizzle-kit generate`）。
- 单元测试：`bun run test`。
- 可选 HTTP 集成：终端 A `bun run dev`（需 `DATABASE_URL`、`REDIS_URL`），终端 B `TEST_INTEGRATION=1 NODE_ENV=test bun run test:integration`。