PupuAA · 猫爪分账

旅行聚餐，轻松分账

移动端优先的多人 AA 记账应用。基于 Next.js 16、Hono、Cloudflare Pages 构建。

技术栈

• 前端: Next.js 16 (App Router) + Tailwind CSS v4 + shadcn/ui + Zustand
• 后端: Cloudflare Pages Functions + Hono
• 存储: Cloudflare D1 (SQLite) + Durable Objects (WebSocket)
• 类型: TypeScript + Shared Types (frontend/functions/shared monorepo)

本地开发

npm install
npm run build    # 首次运行需先构建前端静态资源
npm run dev      # 前端 localhost:3000 + 后端 localhost:8080

本地开发 D1 数据库自动建表，WebSocket 实时同步需要生产环境配置 DO 绑定。

生产部署

1. Cloudflare Dashboard 创建 Pages 项目，构建命令 npm run build，输出目录 frontend/out
2. 创建 D1 数据库并绑定（binding: PUPU_DB）
3. 可选：创建 Durable Object 并绑定（binding: PUPU_ROOM_SYNC, class: RoomSync）以启用实时同步
4. 本地运行迁移或通过 Dashboard SQL 编辑器导入 migrations/ 下的 SQL 文件

项目结构

• frontend/ — Next.js 前端
• functions/ — Hono API 后端 (Cloudflare Pages Functions)
• shared/ — 前后端共享类型与工具函数
• migrations/ — D1 数据库迁移文件

TODO

• 更名升级为猫爪分账（Pawzy Split），定制主题及配色。