概览

领域重命名不是文本替换。目标是让代码、公开契约、数据库和消费者只保留一套明确语义，同时保护外部协议兼容性与存量数据。

工作流程

定义语义边界。 写出 old → new 映射，并标记哪些同形词属于通用领域、供应商协议、URL、metadata 或历史数据，不能机械替换。
建立影响清单。 搜索目录、文件、类、变量、DI token、GraphQL、ORM、SQL、RLS、队列、客户端 operation、生成物、配置、测试和文档。
修改源定义。 先改拥有语义的 Entity、enum、Module、Service 和协议模型，再更新直接消费者；使用 git mv 保留文件历史。
重新生成派生工件。 从 Entity/装饰器生成 MikroORM migration，从代码生成 GraphQL schema 与客户端类型；不手工伪造 metadata diff 或生成文件。
保护数据与兼容性。 有存量数据时设计 rename/transform/backfill 和回滚；外部协议不允许改名时保留 wire key 并在边界显式映射。
执行跨层验证。 运行类型、测试、真实 GraphQL operation、数据库 migration 往返和 RLS 探针，最后逐条分类旧名称残留。