🚀 高效代码合并与架构迁移指南 (精炼版)
核心原则： 保持 原子化迁移 与 持续构建 (Continuous Build)。严禁在大规模代码移动后才进行编译。
1. 环境验证层 (Environment Schema)
动作：使用 Zod 定义环境变量 Schema。
逻辑：将 process.env 的松散读取改为强类型校验。
收益：在 Build Time 或 Runtime 初始化阶段立即捕获缺失配置，避免 undefined 导致的静默失败。
2. 依赖一致性校验 (Dependency Alignment)
动作：合并 package.json 后优先保留受体版本，执行 pnpm install。
逻辑：利用包管理器的 Peer Dependencies 检查机制。
收益：通过编译错误驱动，精准定位需要重构的不兼容 API。
3. 命名空间与路径隔离 (Namespace Isolation)
动作：将供体源码的别名（如 @/*）全局替换为唯一的 OLD_SCOPE/*。
逻辑：在 tsconfig.json 中配置临时 paths 映射。
收益：彻底杜绝模块引用歧义，实现物理目录与逻辑引用的解耦。
4. 副作用惰性化 (Lazy Initialization)
动作：对数据库连接、第三方 Client (如 Resend) 使用 Proxy 或 Getter 封装。
逻辑：确保外部服务仅在 Request Time 初始化，而非 Module Evaluation 阶段。
收益：规避 Next.js 在静态生成 (SSG) 阶段因缺少生产环境密钥导致的构建崩溃。
5. 路由属性显式声明 (Route Segment Config)
动作：在所有 API 路由中 export dynamic = "force-dynamic"。
逻辑：强制跳过静态分析阶段的预渲染。
收益：允许构建过程忽略依赖于动态上下文（如 Cookies, DB）的逻辑，确保 CI/CD 流程顺畅。
6. I18n 键值对桥接 (Key-As-Default)
动作：直接将原始文本字符串作为多语言 JSON 的 Key。
逻辑：建立临时 Passthrough 映射。
收益：在不破坏 i18n 架构的前提下，实现业务代码的快速兼容。
