SlateCourt 羽毛球场馆与约球应用

技术栈

• Next.js 16
• ·TypeScript
• ·FastAPI
• ·Python
• ·PostgreSQL
• ·Redis
• ·Better-Auth
• ·Cloudflare Workers
• ·Docker

分类

Full-stack

SlateCourt 是为我自己的球友圈构建的个人非商业演示项目 —— 注册必须使用邀请码。空位功能只读取场馆自己公开发布、无需登录的预订页面，读取频率低且带缓存，每条结果都链接回场馆自己的预订网站。不转载、不出售任何场馆数据，本项目与任何场馆或订场平台均无关联。

FE
前端

PWA 与界面

• Next.js 16
• ·TypeScript
• ·TanStack Query v5
• ·openapi-fetch 类型
• ·Tailwind + shadcn/ui
• ·PWA · 离线

BE
后端

类型化 API

• FastAPI
• ·Python 3.14
• ·SQLAlchemy 2.0 async
• ·Pydantic v2
• ·91 个端点

DB
数据

持久化与缓存

• PostgreSQL 18
• ·Alembic · 26 次迁移
• ·Redis 7
• ·UUIDv7 + 审计列

ID
认证

邀请制

• Better-Auth
• ·通行密钥 + 魔法链接
• ·邮箱 + 密码
• ·FastAPI 校验 JWT

LV
实时空位

抓取管线

• Cloudflare Worker
• ·2 个平台适配器
• ·APScheduler 冷热分层
• ·Redis 时段网格

QA
测试

质量关卡

• pytest · 84 个文件
• ·mypy + ruff
• ·Playwright E2E
• ·Alembic 漂移检查

OPS
DevOps

把一切发布出去的那一层

• Docker
• ·Dokploy
• ·Traefik
• ·Postgres 18
• ·Redis 7

GitHub Actions

• ruff
• →mypy
• →pytest
• →typecheck
• →build
• →deploy

大多数场馆没有公开 API，但它们的公开预订页面会渲染按日期参数化的 HTML，任何访客都能直接打开。新增场馆只是加一条配置，不用写代码。