环境要求
以下版本以仓库根 package.json 的 engines / packageManager 为准；升级以仓库实际为准。
必需
| 项 | 要求 |
|---|---|
| Node.js | >= 20.0.0 |
| pnpm | >= 10.21.0（仓库锁定 pnpm@10.21.0） |
| PostgreSQL | 可用实例；连接串写入 app 的 DATABASE_URL（建议 14+） |
| Git | 克隆与提交本 monorepo |
本机开发默认端口：nextkity → 3000（见 docs/platform/monorepo/local-ports-and-auth-cookies.md）。
强烈建议
| 项 | 说明 |
|---|---|
| Redis | 可选；限速 / 缓存可走 memory。生产或联调限速时再配 REDIS_URL |
| 足够内存 | nextkity 的 dev 脚本会提高 Node 堆上限；机器内存紧张时注意关闭其他重进程 |
可选（按功能）
- SMTP：邮件验证、系统邮件
- OAuth（Google / GitHub）：第三方登录
- Stripe / 支付宝 / 微信：真实支付；本地可用 Mock（见 env）
- Cloudflare Turnstile：验证码；本地可跳过服务端校验（见
.env.example注释）
账号与权限
- 能访问本仓库代码
- 有权创建 / 使用目标 Postgres 库（及 schema，若使用）
下一步
→ 本地搭建