车库

快速开始

一次启动覆盖 Go API + 运营后台；消费端 H5 / 文档站按需另起。

前置

  • Docker（本地 Postgres / Redis）
  • 版本按仓库根 mise.toml：Go、Node、pnpm。建议 mise install

一键起后端与后台

./tools/scripts/dev-up.sh --install start

脚本会：拉 compose → 跑迁移 → 起 platform/server（默认 28081）→ 起 platform/admin（默认 5175）。端口占用会自动后移。

./tools/scripts/dev-up.sh status
./tools/scripts/dev-up.sh stop

默认管理员以本地环境配置为准（见仓库 docs/local-setup.md）。

起 Web / H5

心跳榜：

cd products/beatrank/h5 && pnpm install && pnpm dev

上头短剧的 Web（products/dramahook/web）和 App（products/dramahook/app）还在开发，现在没有可当作产品跑起来的消费端。v1 旧 H5 已删除（需要对照时看 git 历史）。进度见 上头短剧。

心跳榜打 Android 壳走该目录里的 Capacitor 脚本（以工程 README 为准），仍指向同一套 BaaS。

起文档站

cd website && corepack pnpm install && corepack pnpm dev
# http://localhost:3000

读什么、验什么

  1. 读文档站：价值 → 架构 → 闭环 → BaaS 鉴权。
  2. 读 OpenAPI：仓库 docs/openapi/openapi.yaml（Admin）与 docs/openapi/baas-app-v1.yaml（消费端）。
  3. 跑契约测试：改路由后在 platform/server 执行 go test ./internal/contracttest/...。

常用命令

根目录 Makefile：make dev / make test / make lint / make build。

cd platform/server && go test ./...
cd platform/admin && pnpm typecheck && pnpm test
cd products/beatrank/h5 && pnpm test
cd website && pnpm build

常见坑

  • pnpm 引擎不符：admin / H5 要求 pnpm ≥ 10，用 mise 锁定版本，不要下调 engines。
  • 后端连不上库：docker compose -p motorpool -f infra/docker/docker-compose.yml ps 确认 postgres / redis 在跑。
  • 更细的本地说明：仓库 docs/local-setup.md。