多客户端边界

先确认边界是否已经漏水

多客户端项目常见的问题是 core 和 client 没有稳定分界：src/ 里混入 if (client === 'acme')，配置文件整份替换默认值，迁移序号跨域冲突，新增客户端必须改共享代码。这类问题在第二个客户端出现前往往不明显，但会持续提高维护成本。

技能如何审计和修复

• 判定项目类型：根据 clients/、tenants/、按客户名命名的配置、packages/ 结构、CLIENT_NAME / TENANT_ID 等信号区分显式多客户端、配置驱动、Monorepo、运行时多客户端或单客户端。
• 绘制边界地图：把代码归入 CORE、CLIENT、BLURRED 三层；CORE 是 API 路由、中间件、auth、共享 schema 与核心迁移，CLIENT 是每部署配置覆盖、知识库、种子数据、客户端 schema 扩展和自定义迁移。
• 发现违规：排查共享代码中的客户名、整体替换配置、散落的客户端代码、缺失扩展点、迁移序号冲突，并给出严重度。
• 选择产出模式：默认 audit 输出边界地图与违规报告；document 写 FORK.md；refactor 给重构计划和迁移步骤。

使用注意

适合增加第二、第三个客户端前、边界自然变模糊后、共享代码渗入客户端判断时、大重构前、新人理解架构和周期性健康检查。真正永远单客户端的项目不需要；计划多客户端的单客户端项目只适合做就绪度审计。