Spartacus 3.3 扩展NgRx store实现订阅订单功能的正确方式咨询

目前多个 Spartacus 生产落地项目都通过以下路径实现过订阅订单、权益订单等定制化订单场景的扩展，经过验证不会破坏原有OOTB功能，也兼容后续版本升级。

核心扩展逻辑 #

所有扩展都遵循 Spartacus 分层设计规范，通过依赖注入覆盖、TypeScript 声明合并的方式实现增量扩展，无需修改OOTB原生源码。

分步实现步骤 #

• 扩展数据模型层：通过 TypeScript 模块扩充（Module Augmentation）的声明合并能力，直接扩展原生OrderEntry类型，新增订阅相关的自定义字段，不会破坏原有类型校验。示例如下：

declare module '@spartacus/order/root' {
  interface OrderEntry {
    // 自定义订阅字段
    subscriptionInfo?: {
      cycle: 'month' | 'year';
      autoRenew: boolean;
      nextBillingTime: number;
    };
  }
}

• 扩展Adapter层：继承原生OrderAdapter，重写对应订单查询、创建的适配方法，把后端返回的订阅字段映射到上一步扩展的模型字段中。如果后端新增了订阅订单专属接口，直接在自定义Adapter中实现新接口调用逻辑即可，最终通过provideAdapter方法覆盖原生OrderAdapter的DI提供者。
• 扩展Connector层：如果仅新增字段没有新增接口，可直接复用原生OrderConnector无需额外调整；如果有专属的订阅业务接口，新增自定义Connector封装调用逻辑即可。
• 扩展NgRx Store层：仅加字段无需新建独立State切片，通过增量扩展原生逻辑实现：
  • 新增自定义Action，用于触发订阅订单的查询、写入操作
  • 新增MetaReducer扩展原生Order Reducer，监听订单操作成功的Action，将订阅字段合并到原有OrderEntry的State节点中，无需重写原生Reducer全量逻辑
  • 如有专属接口调用，新增自定义Effect处理请求逻辑即可
• 扩展Facade层：继承原生OrderFacade，新增订阅订单专属的查询、操作方法，内部调用自定义的Store选择器获取数据，最终通过DI覆盖原生Facade提供者，业务组件直接注入即可调用扩展后的方法，无需调整原有组件的注入逻辑。

注意事项 #

• 不要直接修改Spartacus OOTB的源码文件，所有扩展都通过DI覆盖、声明合并实现，避免后续版本升级出现冲突
• 字段映射逻辑统一放在Adapter层处理，不要在Effect、Reducer中直接处理后端原始返回数据，保持分层职责清晰
• 自定义MetaReducer处理State更新时，要返回全量State对象，不要覆盖原有OOTB已存储的订单相关字段

内容的提问来源于stack exchange，提问作者Madison B.