免费开始

快速开始

5 分钟在本地跑起 be-water：安装依赖、起库、跑迁移、开双端。

前置要求

依赖版本
Node.js22+
pnpm11+
Docker用于本地 Postgres 与 Redis

安装并启动

git clone <repo-url> && cd be-water
pnpm install
pnpm setup    # 幂等：生成 .env.local + 起 Postgres/Redis + 跑 migration
pnpm dev

启动后：

  • 前端 http://localhost:7300（Vite HMR）
  • API http://localhost:3700（/api 由 Vite 代理转发）

pnpm setup 可以重复执行，不会重置数据。只想起数据库时用 pnpm db:up。

环境变量

pnpm setup 会从 .env.example 生成 .env.local，其中三项必须有值：

变量说明
DATABASE_URLpostgresql://be-water:...@localhost:5433/be-water
JWT_SECRET不少于 32 字符的随机串
TENANT_SECRET_ENCRYPTION_KEY32 字节 hex，用 openssl rand -hex 32 生成

租户级密钥（例如各租户自己的 LLM API Key）以 AES-GCM 加密存库，主密钥就是 TENANT_SECRET_ENCRYPTION_KEY。换掉它会导致已存密钥无法解密，生产环境请妥善备份。

常用命令

命令说明
pnpm dev同时启动 server 与 client
pnpm checklint + 测试，提交前跑
pnpm db:studio打开 Prisma Studio
pnpm seed灌入种子数据
pnpm build / pnpm start构建 / 以生产模式启动

下一步