搭子 Dazi

帮你 5 分钟找到人一起打麻将、打球、烧烤。 面向悉尼海外华人的即时活动匹配 Web App。

  

---

功能

• 地图发现 — 在 Mapbox 地图上查看附近所有开放活动
• 手机号登录 — 澳大利亚 (+61) 手机号 OTP 登录
• 发布活动 — 地图点选位置、选时间、选人数，一键发布
• 加入活动 — 并发安全的加入逻辑，满员自动关闭
• 约局频道 — 活动成员专属实时聊天（Supabase Realtime）
• 自动过期 — Vercel Cron 每天将到期活动标记为 expired

页面流程

#	页面	说明
①	手机号登录	输入澳大利亚 +61 手机号，发送 OTP
②	验证码	输入 6 位短信验证码，可倒计时重发
③	设置昵称	首次登录设置显示名（仅一次）
④	首页 — 地图	地图显示附近活动 emoji 标记，右下角 recenter 按钮
⑤	活动弹卡	点击标记弹出卡片，显示类型/地址/时间/剩余名额
⑥	首页 — 列表	切换到列表视图，按时间排序
⑦	活动详情	活动信息、加入按钮、成员专属实时聊天频道
⑧	发布活动	选类型、地图点选位置、选时间、设人数

技术栈

层	技术
Frontend	Next.js 14 + TypeScript + Tailwind CSS
Backend	Supabase (PostgreSQL + Auth + Realtime)
地图	Mapbox GL JS (dynamic import)
部署	Vercel + Vercel Cron

本地开发

前置条件：Node.js 18+、Docker（用于本地 Supabase）

# 1. 克隆仓库
git clone https://github.com/Heatescape/Dazi.git
cd Dazi

# 2. 安装依赖
npm install

# 3. 配置环境变量
cp .env.example .env.local
# 编辑 .env.local 填入你的 keys

# 4. 启动本地 Supabase
npx supabase start

# 5. 启动开发服务器
npm run dev

打开 http://localhost:3000

本地测试账号（本地 Supabase）

在 supabase/config.toml 中已配置测试 OTP：

• 手机号：+61412345678，验证码：000000

部署

Supabase Cloud

1. 创建项目：https://supabase.com → New Project → Region: Singapore
2. 在 SQL Editor 执行 supabase/migrations/ 中的建表 SQL
3. Authentication → Providers → Phone：配置 SMS 提供商

Vercel

npx vercel --prod

在 Vercel Dashboard 配置以下环境变量（参考 .env.example）：

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY
• NEXT_PUBLIC_MAPBOX_TOKEN
• CRON_SECRET

Cron Job 已在 vercel.json 中配置，部署后自动生效。

数据库结构

profiles          — 用户资料 (display_name, avatar_url)
activities        — 活动 (type, location, time, spots)
activity_members  — 活动成员关系
channel_messages  — 约局频道消息（7天后软删除）

License

MIT