Start with docs/index.md for the project map. Product/API/MCP contracts live in docs/contracts/.
bun install --frozen-lockfile
docker compose -f docker-compose.dev.yml up -d
bun run dev本地数据库/存储由 Docker Compose 管理;需要数据库时先启动本地 infra,再运行应用。生产应用由 Cloudflare Git integration 发布,Docker 只保留静态数据加载环境。
开发期建议节奏:
- 默认提交门禁:
bun --silent run verify - 认证、数据流、浏览器流程或共享工具:
bun --silent run verify:full - 本地应用固定监听
127.0.0.1:3000
- 开发/测试/构建工作流以 AGENTS.md 为唯一准则
- 文档导航见 docs/index.md
- 产品/API/MCP 契约见 docs/contracts/
- 代码组织从
src/routes/、src/features/、src/lib/开始阅读