本地启动

# 1. 根目录统一安装全部子项目依赖
pnpm install

# 2. 启动全部 / 选定子项目的 dev 任务（交互选择）
nitrogen dev

# 3. 或直接运行顶层任务
turbo run build
turbo run typecheck
turbo run lint

目录约定

• 业务子项目目录均由 nitrogen 脚手架生成，内部单元由各技术栈官方生成器管理（NestJS 项目用 nest generate）。
• 子项目间禁止相对路径直接引用源码；复用一律沉淀到 libs/ 并以 workspace:* 依赖引用。
• 文档位于 docs/，为单一 doc-doc 站点的四个子文档；API 接口约定先写 docs/api_references，再落代码。

验证服务就绪

• api_service 与 apps/openapi 提供 /health 与 /metrics 运维端点（豁免 /api/v1 前缀）。
• 业务服务不暴露 HTTP；通过 NATS subject 的 request-reply 响应验证。