用途：这是一份面向 Bun.js 后端服务与 Docker 交付的工程实践手册，目标不是基准测试上的快，而是让服务在生产中易于调试、安全运行。
主要能力与规范：默认标准要求 src/index.ts 仅作引导，应用装配放 src/app.ts，业务逻辑放 services/use-cases；在边界校验环境变量与请求负载；使用显式错误类型与统一错误映射；保持 TypeScript 严格模式，避免 any 与隐式运行时契约；对可能重试的副作用端点使用幂等处理器；把数据库、缓存、外部 HTTP 视为易失败依赖，定义超时与降级行为。
运行时与 API 护栏：统一请求 ID/追踪 ID 策略并写入日志与错误响应；为公开端点设置请求体限制、超时与限流；不向客户端泄露堆栈、密钥或数据库错误；密码哈希优先用 Bun.password；显式关闭流程，停止接收流量、排空在途工作、关闭 DB/Redis 客户端。
Docker 与部署默认值：多阶段构建、非 root 运行、固定 Bun 基础镜像版本、提供 /health 与 /ready 端点、保持镜像最小且确定。
测试默认值：纯逻辑与服务策略用单元测试，数据库仓库与路由行为用集成测试，仅关键用户流程用 E2E，mock 保持小而贴近消费边界。
使用方式：验证命令包括 bun install --frozen-lockfile、bun run test、bunx tsc --noEmit、bunx @biomejs/biome check .、bun run build，以及交付含 Docker 时的生产镜像构建验证。脚本与资产包括 scripts/init-project.sh、scripts/healthcheck.ts 与 assets/project-template/。
适用场景：Bun.js 后端 API 开发、Docker 化交付、生产可靠性、可观测性与测试策略落地。
限制：资料未提供具体版本号、性能数据、收费信息与完整代码示例；参考文档以 references/ 下文件形式列出，具体内容暂未提供。