Skip to content

高阶:接入旧系统页面、API 和代码逻辑

本页用于 CRM 数据库已经接入、运行态已经可用之后。

什么时候进入高阶接入

现象接入方式
旧系统页面还要继续使用接入旧页面或微前端
旧系统已有稳定接口接入旧 API
旧系统有复杂业务规则封装为 Backend Function 或 BFF
旧系统靠人工操作接入 RPA
外部 SaaS 有标准能力接入 MCP 或 SaaS Connector

接入旧页面

  1. 确认旧页面 URL。
  2. 确认登录方式。
  3. 确认页面能接收哪些参数,例如客户 ID、销售机会 ID。
  4. 在 CRM 详情页增加入口。
  5. 从客户详情点击旧页面入口。
  6. 检查是否能打开对应客户或销售机会。

截图指引:App Management 入口如下。旧页面、旧 API 和代码逻辑接入后,从这里回到应用验证。

App Management 入口

接入旧 API

  1. 列出旧 API。
  2. 记录每个 API 的入参、出参和权限。
  3. 选一个低风险 API 先接入,例如查询客户合同。
  4. 封装为 BFF 或 Backend Function。
  5. 在 Skill 中写明调用名称。
  6. 用运行态 CLI 验证。
bash
lovrabet bff exec --name legacy_contract_lookup --params '{"customerId":"demo"}'

接入旧代码逻辑

  1. 找出旧代码里真正影响业务结果的规则。

  2. 把规则写成输入、处理、输出。

  3. 判断放到哪里:

    • 查询和聚合放 SQL。
    • 多步骤编排放 BFF。
    • 写回、审批、状态流转放 Backend Function。
  4. 发布后进入 Skill。

  5. 用一条 CRM 样例数据验证结果。

接入 RPA、MCP、外部 SaaS

  1. 记录外部系统名称。
  2. 记录认证方式。
  3. 记录可执行动作。
  4. 记录输入和输出。
  5. 放入 Skill 的固定步骤。
  6. 涉及写回时增加预览和确认。

完成检查

  • 旧页面能从 CRM 场景打开。
  • 旧 API 能返回固定结构。
  • 旧代码规则已经封装为稳定能力。
  • Skill 中能看到调用顺序。
  • 写回动作有权限、预览和日志。

Claude Code 操作 prompt

text
请使用 rabetbase 为目标应用做旧系统接入盘点。
先执行:
1. rabetbase dataset list --appcode <你的应用 appCode> --format compress
2. rabetbase dataset links --appcode <你的应用 appCode> --format compress
3. rabetbase sql list --appcode <你的应用 appCode> --format compress
4. rabetbase bff list --appcode <你的应用 appCode> --format compress
输出旧页面、旧 API、旧 SQL、旧代码规则分别适合落到页面入口、SQL、BFF、Backend Function 还是 Skill。
涉及写回或状态流转的能力,列为 Backend Function。
本轮只读,只输出接入清单。

基于飞书知识库同步生成,内容以飞书源文档为准