SaaS 后台的 DSL 改造（四）：一套代码服务 N 个券商——DSL 继承与合并算法

// 基线 model 的一个菜单项 精简过
{
  key: 'productManagement',
  name: '商品管理',
  menuType: MenuType.MODULE,
  moduleType: ModuleType.SCHEMA,
  schemaConfig: {
    api: PRODUCT_MAIN,              // 页面数据走哪个 BFF 接口
    tableConfig: {
      headerButtons: [{ key: 'create', name: '新增', /* ... */ }],
      rowButtons: [{ key: 'edit', name: '编辑', /* ... */ }],
    },
    searchConfig: { /* 搜索栏配置 */ },
    componentConfig: { /* 新增/编辑表单、详情面板的配置 */ },
    schema: {
      type: 'object',
      properties: {
        id:    { type: 'string', label: '商品ID', tableOption: { hidden: true } },
        name:  { type: 'string', label: '商品名称' },
        price: { type: 'number', label: '价格' },
      },
    },
  },
}

app/model/
└── business/
    ├── model.ts          # 基线: 通用后台的完整描述
    └── project/
        ├── brokerA.ts    # 券商 A: 只写和基线不一样的部分
        └── brokerB.ts    # 券商 B: 同上

// project/brokerA.ts 精简示意
export default {
  key: 'brokerA',
  name: '券商 A 管理后台',
  headerMenu: [
    {
      key: 'productManagement',      // 同 key: 和基线的这个菜单合并
      schemaConfig: {
        schema: {
          properties: {
            channel: { type: 'string', label: '渠道' },  // 新 key: 追加一列
          },
        },
      },
    },
  ],
} satisfies Partial<Dashboard>

function extendModel(target, source) {
  return mergeWith(target, source, (targetValue, sourceValue) => {
    // 只特殊处理"两边都是数组"的情况 其余交给 mergeWith 默认行为
    if (Array.isArray(targetValue) && Array.isArray(sourceValue)) {
      const ret = []

      // 基线有的: 差异里有同 key 就递归合并 没有就原样保留
      targetValue.forEach((item) => {
        const sourceItem = sourceValue.find((s) => s.key === item.key)
        ret.push(sourceItem ? extendModel(item, sourceItem) : item)
      })

      // 差异新增的 key: 追加
      sourceValue.forEach((item) => {
        if (!targetValue.find((t) => t.key === item.key))
          ret.push(item)
      })

      return ret
    }
  })
}

// model.ts 里的一个菜单项
{
  key: 'productManagement',
  name: '商品管理',
  schemaConfig: {
    tableConfig: {
      rowButtons: [
        { key: 'edit', name: '编辑' },
        { key: 'detail', name: '详情' },
      ],
    },
    schema: {
      properties: {
        name:  { type: 'string', label: '商品名称' },
        price: { type: 'number', label: '价格' },
      },
    },
  },
}

// project/brokerA.ts
{
  key: 'productManagement',                    // 同 key -> 和这个菜单合并
  schemaConfig: {
    tableConfig: {
      rowButtons: [
        { key: 'edit', name: '修改' },          // 同 key -> 改
        { key: 'copy', name: '复制' },          // 新 key -> 加
      ],
    },
    schema: {
      properties: {
        name:    { label: '产品名' },           // 同字段 -> 只改 label
        channel: { type: 'string', label: '渠道' },  // 新字段 -> 加
      },
    },
  },
}

{
  key: 'productManagement',
  name: '商品管理',                             // 差异没提 -> 基线原样保留
  schemaConfig: {
    tableConfig: {
      rowButtons: [
        { key: 'edit', name: '修改' },          // 递归合并: key 保留 name 被覆盖
        { key: 'detail', name: '详情' },        // 差异没提 -> 保留
        { key: 'copy', name: '复制' },          // 新 key -> 追加在末尾
      ],
    },
    schema: {
      properties: {
        name:    { type: 'string', label: '产品名' },  // 深合并: type 来自基线 label 来自差异
        price:   { type: 'number', label: '价格' },    // 差异没提 -> 保留
        channel: { type: 'string', label: '渠道' },    // 新字段 -> 追加
      },
    },
  },
}

Object.entries(project).forEach(([projectKey, projectModel]) => {
  project[projectKey] = extendModel(cloneDeep(model), projectModel)
})

// /api/proj/ 开头的接口必须带券商标识
const { proj_key: projKey } = ctx.request.headers
if (!projKey) {
  return Object.assign(ctx, getErrorResponse('参数错误', ResponseCode.PARAM_ERROR))
}
ctx.projKey = projKey