import { z } from "zod"; // 环境变量定义(B2 裁决:gRPC 下游通信;B8 裁决:DownstreamClient 抽象) // 端口分配见 docs/architecture/port-allocation.md §5: // iam 50052 / core-edu 50053 / content 50054 / data-ana 50055 / msg 50056 / ai 50058 // president §2.9:TEACHER_BFF_DEV_MODE 控制越权防御 Guard(P2 放行 / 生产拒绝) const envSchema = z.object({ NODE_ENV: z.string().default("development"), PORT: z.string().default("3003"), LOG_LEVEL: z.string().default("info"), // GraphQL endpoint 路径(B1 裁决:P2 起直接 GraphQL) GRAPHQL_PATH: z.string().default("/graphql"), // 越权防御开关(president §2.9:P2 DEV_MODE 放行 + 日志告警,生产拒绝) // 生产环境必须显式设为 false TEACHER_BFF_DEV_MODE: z .string() .default("true") .transform((v) => v === "true") .pipe(z.boolean()), // Redis(/readyz 探针 + 后续 DataLoader 缓存) REDIS_URL: z.string().default("redis://localhost:6379"), // 下游 gRPC targets(v2 默认值对齐 Docker 服务名 + 端口分配) // 端口分配见 docs/architecture/port-allocation.md §5: // iam 50052 / core-edu 50053 / content 50054 / data-ana 50055 / msg 50056 / ai 50058 // Docker 部署:服务名解析通过 docker network;本地开发:覆盖为 localhost: // 选择策略:TEACHER_BFF_DEV_MODE=true → mock;false → gRPC(targets 默认已配置) IAM_GRPC_TARGET: z.string().default("iam:50052"), CORE_EDU_GRPC_TARGET: z.string().default("core-edu:50053"), CONTENT_GRPC_TARGET: z.string().default("content:50054"), DATA_ANA_GRPC_TARGET: z.string().default("data-ana:50055"), MSG_GRPC_TARGET: z.string().default("msg:50056"), AI_GRPC_TARGET: z.string().default("ai:50058"), // 下游 REST 服务 URL(admin 域 REST 调用 + ARB-008 公告降级 REST only) // iam REST:users/roles/permissions/audit 端点 // msg REST:/announcements 公告端点(ARB-008 裁决) IAM_SERVICE_URL: z.string().default("http://iam:3002"), MSG_SERVICE_URL: z.string().default("http://msg:3007"), // 可观测性(OTEL_EXPORTER_OTLP_ENDPOINT 缺省则不启用 tracer) OTEL_EXPORTER_OTLP_ENDPOINT: z.string().url().optional(), OTEL_SERVICE_NAME: z.string().default("teacher-bff"), }); export type Env = z.infer; export function loadEnv(): Env { const result = envSchema.safeParse(process.env); if (!result.success) { throw new Error("Invalid env: " + JSON.stringify(result.error.flatten())); } return result.data; } export const env = loadEnv();