GoMate 地点组队平台 - Monorepo 架构
一个极简的「地点组队」平台，支持多城市徒步场景，帮助户外爱好者通过结构化组队找到志同道合的徒步伙伴。
gomate/
├── api/ # 后端 API（Hono + Cloudflare Workers）
├── frontend/ # Web 前端（Astro 6 + React + Cloudflare Pages）
├── mobile/ # 移动端（Flutter iOS/Android）
├── packages/
│ ├── types/ # 共享类型定义
│ └── config/ # 共享配置（tsconfig 等）
├── .github/
│ └── workflows/ # CI/CD 工作流
├── package.json # pnpm workspace 根配置
└── pnpm-workspace.yaml # workspace 包路径定义
- Node.js >= 20
- pnpm >= 9
- Flutter >= 3.24（移动端开发）
pnpm install后端 API：
pnpm --filter @gomate/api devWeb 前端：
pnpm --filter @gomate/frontend dev移动端：
cd mobile && flutter run- Worker:
gomate-api - 生产地址: https://api.gomate.live
- 部署命令:
cd api && wrangler deploy --env production
- 项目:
gomate-frontend - 生产地址: https://gomate.live
- 部署命令:
pnpm web:build && cd frontend && wrangler pages deploy dist --project-name=gomate-frontend --branch=main
- App Store / Google Play
共享类型定义，供 api、frontend、mobile 各子包共享使用：
- 枚举类型：
Difficulty、TeamStatus、TeamMemberStatus等 - 数据模型：
Location、Route、Team、TeamMember、UserPublicProfile等 - API 通用格式：
ApiResponse、PaginatedResponse
共享 TypeScript 配置：
tsconfig/base.json- 通用基础配置tsconfig/cloudflare.json- Cloudflare Workers 专用配置
| 工作流 | 触发条件 | 说明 |
|---|---|---|
api-deploy.yml |
api/** 变更推送到 main |
部署后端到 Cloudflare Workers |
frontend-deploy.yml |
frontend/** 或 packages/** 变更推送到 main |
部署前端到 Cloudflare Pages |
mobile-build.yml |
mobile/** 变更推送到 main |
构建 Android APK 和 iOS IPA |
| 表名 | 说明 |
|---|---|
users |
用户账号（Better Auth 扩展：bio、level） |
sessions / accounts / verifications |
Better Auth 认证表 |
locations |
徒步地点（含标签、坐标、难度等） |
routes |
徒步路线（关联 location） |
teams |
徒步队伍（状态：recruiting / full / ongoing / completed / cancelled） |
team_members |
队伍成员（角色：leader / member，状态：pending / approved / rejected） |
tags / entityToTags |
标签系统 |
cities |
城市管理 |
pois / entityToPois |
兴趣点系统 |
userFavorites |
用户收藏 |
password_resets |
密码重置令牌 |
feat: 新功能
fix: 修复
docs: 文档
style: 格式调整
refactor: 重构
test: 测试
chore: 构建/工具
MIT