# 1) 克隆并安装
git clone https://github.com/providcc/ipaas-ai-automation.git
cd ipaas-ai-automation
npm install

# 2) 配置平台地址与账号
cp .env.example .env
$EDITOR .env            # 至少填 RC_BASE_URL / RC_USER / RC_PASS

# 3) 验证连通性（会打印平台返回的用户信息）
set -a && . ./.env && set +a
npm run cli -- auth status

# 4) 看看平台有哪些接口（内置核心样例目录）
npm run cli -- catalog search esb/process

# 5) 干跑一次写操作（不落库，只打印将要发送的请求）
npm run cli -- api import --app <appId> --file ./my-api.yaml

git clone https://github.com/providcc/ipaas-ai-automation.git
cd ipaas-ai-automation
npm install

cp .env.example .env
# 编辑 .env：
#   RC_BASE_URL=https://<你的平台地址>/<应用路径前缀>
#   RC_USER=<账号>
#   RC_PASS=<密码>

cp rc.targets.example.json rc.targets.json
# 编辑 rc.targets.json，填写各 target 的 baseUrl；把 default 标在常用目标上

set -a && . ./.env && set +a
npm run cli -- auth login --target <targetName>   # 省略 --target 则用默认目标
npm run cli -- auth status

# 方式 A：有平台前端源码 → 解析全部 URI 常量
npm run catalog:extract -- /path/to/platform-frontend-source

# 方式 B：只有运行中的平台 → 合并平台代码内出现的路径
npm run catalog:merge -- /path/to/platform-frontend-source

# 生成组件目录（需要平台可访问；会登录并读取节点面板）
npm run catalog:components
npm run catalog:etl

# 5.1 列出应用与 API
npm run cli -- api list --app <appId> --enrich 5

# 5.2 导出契约基线
npm run cli -- api export --app <appId> -o baseline.json

# 5.3 改动后对比（返回非 0 表示有删除/破坏性变更）
npm run cli -- api diff --from baseline.json --to new.json --breaking

# 5.4 先预览（只解析，不落库）
npm run cli -- api analyze --app <appId> --file spec.yaml

# 5.5 流程图：规格 → JSON → 校验 → 干跑 → 落库
cat > spec.json <<'JSON'
{
  "nodes": [
    { "nodeType": "start", "text": "开始" },
    { "nodeType": "apiNode", "text": "调用上游" },
    { "nodeType": "dataMapNode", "text": "字段映射" },
    { "nodeType": "returnDataNode", "text": "返回结果" },
    { "nodeType": "end", "text": "结束" }
  ],
  "edges": [
    { "from": "E00001", "to": "T00001" },
    { "from": "T00001", "to": "T00002" },
    { "from": "T00002", "to": "T00003" },
    { "from": "T00003", "to": "E00002" }
  ]
}
JSON
npm run cli -- flow build --file spec.json --out model.json
npm run cli -- flow validate --file model.json
npm run cli -- flow save --file model.json --app <appId> --process-id <pid>          # 干跑
npm run cli -- flow save --file model.json --app <appId> --process-id <pid> --apply  # 落库

npm test          # 单元测试
npm run typecheck # 类型检查
npm run templates # 流程模板自检

export RC_USER=... RC_PASS=... RC_BASE_URL=... RC_TEST_APP=test
npm run test:authz    # 授权回路（7 轮：授权→校验→幂等→撤销→复原）
npm run test:import   # OpenAPI 导入回路（分析→落库→详情→删除→清理）
npm run test:flow     # 流程落库回路（创建→属性→图→checkerror→回读→幂等→清理→删除）
npm run test:contract # 上述三组串跑
npm run cleanup:test  # 清理测试期间创建的临时流程

认证
  rc auth login [--target t] [--token <t>] [--user u --pass p]   登录并存会话
  rc auth status | refresh                                         会话状态 / 刷新令牌

目录
  rc catalog search <keyword> [--module m] [--json]               检索接口目录
  rc catalog sync --source <dir>                                  重新生成目录

资产
  rc api list --app <appId> [--enrich N]                          API 列表（列表接口只给 id/status）
  rc api get <id>                                                 API 详情
  rc api analyze --app <appId> --file spec.yaml                   只解析不落库（预览待导入列表）
  rc api import --app <appId> --file spec.yaml [--apply]          批量注册（OpenAPI 3，两阶段）
  rc api export --app <appId> -o baseline.json                    导出契约基线
  rc api diff --from a.json --to b.json [--breaking]              契约 diff（--breaking 列破坏性变更）
  rc api impact --id <apiId> [--kind esb|etl]                     反查引用该 API 的流程

流程（生命周期 + JSON 生成）
  rc flow create --application <业务应用 id> --name <流程名> [--config-id <编码>]
  rc flow list [--keyword k] | rc flow get <processId> | rc flow versions <processId>
  rc flow clone <processId> [--name 新名] | rc flow delete <processId> | rc flow publish <processId>
  rc flow build --file spec.json [--kind esb|etl] [--out model.json]
  rc flow validate --file model.json [--allow-mock] [--props props.json]
  rc flow check --file model.json --process-id <pid>          调平台 checkerror
  rc flow props get --process-id <pid> --node-id <nodeKey>
  rc flow props save --process-id <pid> --file props.json     幂等 upsert（自动带 id）
  rc flow save --file model.json --process-id <pid> [--props props.json] [--kind etl] [--apply]
      # 完整闭环：属性 upsert → 图保存 → 清理图外旧属性 → 平台 checkerror → 回读校验

ETL / 运营 / 监控
  rc etl list | get <id> | run <pid> [--mode test|full] [--limit 100] | compensate <pid>
  rc ops summary
  rc monitor summary [--hours 24] | monitor logs <serviceId>

授权
  rc authz perms                                                   权限项列表
  rc authz service <serviceId>                                     某服务已有权限
  rc authz grant --service <id> --permission <pid> [--app <app>]  授权（默认干跑）
  rc authz revoke --service <id> --permission <pid>               撤销
  rc authz plan --service <id> --file desired.json                生成 grant/revoke/skip 计划
  rc authz sync --file plan.json [--apply]                        执行计划

工具
  rc snapshot <api|esb|etl> <id>      写前快照
  rc restore <snapshot.json> [--apply] 回滚
  rc upload <path> --file <local>     multipart 上传（WSDL/Excel/证书）
  rc call <path> [-X GET] [-d @file]  调用任意接口（逃生通道）

{
  "mcpServers": {
    "ipaas": {
      "command": "node",
      "args": ["/absolute/path/ipaas-ai-automation/packages/mcp/src/server.ts"],
      "env": {
        "RC_BASE_URL": "https://<your-host>/<app-path>",
        "RC_USER": "<account>",
        "RC_PASS": "<password>",
        "RC_PROFILE": "uat"
      }
    }
  }
}

POST /rest/esb/process/model/save
{
  "appId": "<app-id>",
  "processId": "<process-id>",
  "processModel": "{\"nodeDataArray\":[...],\"linkDataArray\":[...],\"transform\":1}"
}

// ① 分析（预览）：body = OpenAPI 文档原文，Content-Type: application/json
POST /rest/core/v2/openapi/analysis?appId=<appId>
→ 返回待导入条目数组（含 mapUrl / methodType / summary）

// ② 导入（落库）：body = 条目数组的 JSON 字符串
POST /rest/core/v2/openapi/import
   每项需补：categoryId / authType / authTypeStr / approveAuthType / approveAuthTypeStr

POST /rest/core/permissions/resources/saveServiceMap
{ "serviceIds": "<service-id>", "permissionId": "<permission-id>",
  "permissionName": "<权限名>", "appId": "<app-id>" }

// 撤销
POST /rest/core/permissions/resources/delete
{ "ids": "<资源映射 id，多个用逗号分隔>" }

packages/core/src/   SDK：client / errors / idempotency / audit / catalog / auth / targets
                     upload / snapshot / api / etl / monitor / authz / operations
                     flow-build / flow-validate / flow-props
packages/cli/src/    rc CLI（零依赖参数解析）
packages/mcp/src/    MCP Server（20 工具）
catalog/             接口与组件目录（可再生成）
scripts/             目录生成、平台数据采集、只读探查、授权回路测试
skills/              领域 SOP（给 Agent 加载）
tests/unit/          单元测试
docs/                方案 / 实施计划 / JSON 契约 / 组件上下文 / 部署拓扑

① 节点属性：POST /rest/esb/process/node/save   （带既有 id = 更新；不带 id = 插入 → 重复记录）
② 图模型：  POST /rest/esb/process/model/save  （body.processModel 为字符串）
③ 平台校验：POST /rest/esb/process/model/checkerror

npm test && npm run typecheck     # 提交前必过
npm run templates                 # 流程模板自检