聚餐分账
建一个饭局，拿到别人猜不到的链接。不注册。
技术栈
后面的功能沿用这一套，不另换。
- Next.js（App Router）与 TypeScript
- SQLite，通过
@libsql/client 连接。本地开发时数据在 data/split-bill.db；线上用 Turso（libSQL）。第一次访问时自动建表
- 不接登录；线上部署见下文「上线部署」
饭局写在表 gatherings（id、name、created_at）。参与人、账目、分摊写在同一库的新表里，用 gathering_id 指向饭局。饭局页地址是 /g/<id>。id 是 16 字节随机数，编码为 base64url。
线框在 docs/wireframes/。
本地运行
需要 Node.js 22。不配置 Turso 环境变量时，会自动使用本地文件 data/split-bill.db。
npm install && npm run dev
打开 http://localhost:3000
上线部署
公开网址：https://split-bill-pi-eight.vercel.app
当前线上配置
- Vercel：团队
jackey-hung 下的项目 split-bill（Hobby 计划），默认 Next.js 构建，无自定义 Server。
- Turso：数据库
split-bill（Starter 免费档，区域 Tokyo），通过 Vercel Marketplace 的 Turso 集成 创建并绑定。集成会为 所有环境 自动写入 TURSO_DATABASE_URL 与 TURSO_AUTH_TOKEN，无需在 Vercel 里手填这两项。
一次性上线（备选：不用 Marketplace 时）
- Turso 数据库
- 安装 Turso CLI 并登录。
- 创建数据库：
turso db create split-bill（名称可自定）。
- 记下连接 URL：
turso db show split-bill --url。
- 创建访问令牌：
turso db tokens create split-bill。
- Vercel 项目
- 在 Vercel 用 GitHub 导入本仓库。
- 在各环境变量中设置
TURSO_DATABASE_URL 与 TURSO_AUTH_TOKEN（若已用 Marketplace 集成可跳过）。
更新线上版本
- 代码 合并进
main 后，Vercel 会自动部署到 Production（公开网址见上文）。
- Pull Request 分支会生成 Preview 部署，用于合并前验收。
- 需要手动重跑时：Vercel 控制台 → 项目 Deployments → 选中某次部署 → Redeploy（例如只改了环境变量、未改代码时）。
饭局与账目保存在 Turso，重新部署不会清空数据。
检查与测试
npm run lint
npm run typecheck
npm test
npx playwright install chromium
npm run test:e2e
npm test 覆盖创建、读取、找不到饭局、链接唯一且不可猜，以及参与人的增删改。npm run test:e2e 用 Playwright，视口 375×667，覆盖建饭局与参与人相关 AC。
AC8（已入账不可删）在单元测试里用 lib/expenses.seedExpense 写入最小账目行；端到端在 E2E_TEST_HELPERS=1 时调用 POST /api/gatherings/<id>/test/expenses（Playwright 的 webServer 已设置该变量）。该路由仅用于测试，生产 dev 默认不可用。
GitHub Actions 在 pull request 和推送到 main 时安装依赖、跑 lint、类型检查、单元测试，并安装 Playwright 浏览器后跑端到端测试。
