feat(parent-bff): graphql schema 扩展 + extended-resolvers + grpc factory + nextstep 文档

services/parent-bff/Dockerfile

@@ -1,21 +1,40 @@
 # Build stage
+# 构建上下文必须为 repo root，以访问 packages/shared-proto + packages/shared-ts
 FROM node:22-alpine AS builder
 WORKDIR /app
 RUN corepack enable && corepack prepare pnpm@11.13.0 --activate
-COPY package.json pnpm-lock.yaml* ./
-# pnpm 11 默认拒绝 build scripts，独立安装时无法读取 workspace 的 allowBuilds 配置
-# 使用 --ignore-scripts 跳过（@nestjs/core/protobufjs 的 postinstall 非功能必需）
-RUN pnpm install --frozen-lockfile --ignore-scripts
-COPY tsconfig.json nest-cli.json ./
-COPY src ./src
+
+# 先复制所有源码（含 tsconfig.json / nest-cli.json / proto / graphql schema）
+COPY packages/shared-proto ./packages/shared-proto
+COPY packages/shared-ts ./packages/shared-ts
+COPY services/parent-bff ./services/parent-bff
+COPY pnpm-lock.yaml pnpm-workspace.yaml package.json tsconfig.base.json ./
+
+# 安装依赖（含 devDependencies 用于构建，--ignore-scripts 跳过 husky）
+WORKDIR /app/services/parent-bff
+RUN pnpm install --no-frozen-lockfile --ignore-scripts
+
+# 构建
 RUN pnpm build
 
 # Runtime stage
 FROM node:22-alpine
 WORKDIR /app
 RUN corepack enable && corepack prepare pnpm@11.13.0 --activate
-COPY package.json pnpm-lock.yaml* ./
-RUN pnpm install --prod --frozen-lockfile --ignore-scripts
-COPY --from=builder /app/dist ./dist
+
+# 复制 parent-bff package.json（独立安装生产依赖）
+COPY services/parent-bff/package.json ./services/parent-bff/package.json
+WORKDIR /app/services/parent-bff
+RUN pnpm install --prod --no-frozen-lockfile --ignore-workspace --ignore-scripts
+
+# 复制 shared-proto + shared-ts（运行时 proto/schema 加载需要）
+WORKDIR /app
+COPY packages/shared-proto ./packages/shared-proto
+COPY packages/shared-ts ./packages/shared-ts
+
+# 复制构建产物（保持 services/parent-bff/dist 结构）
+COPY --from=builder /app/services/parent-bff/dist ./services/parent-bff/dist
+
+WORKDIR /app/services/parent-bff
 EXPOSE 3010
 CMD ["node", "dist/main.js"]