lan-low-code-cli 2.6.0 → 2.7.0

package/README.md

@@ -6,6 +6,7 @@
 - **创建表单**：覆盖 6 种表单类型（普通 / 审批意见 / 全局配置项 / 弹窗 / 通用 / 引用者）
 - **自动获取可用字段**：表单数据模型字段、外部映射表字段、字段库
 - **自动完善表单字段**：依据数据模型自动生成完整表单配置（`fdConfig`：字段控件 + 场景 viewModel + 权限 + 多语言 + 全局规则）并保存
+- **动作流建模**：用声明式 Flow Spec 从零编译出 `fdDesign`（含符合平台编排习惯的节点布局），支持草稿/发布/启停/删除、Schema 上下文注入、golden 模板抽取与按钮脚本生成
 
 ## 一、安装与构建
 
@@ -309,6 +310,65 @@ new Function('context', fdJavaScript)({
   [skills/lan-low-code-cli/references/operation-script-context.md](skills/lan-low-code-cli/references/operation-script-context.md)
 
 
+### 动作流（`llc flow`）
+
+动作流是**应用级**对象（`--app-code` 即 `fdAppCode`），不是表单级。用声明式 JSON（Flow Spec）描述节点与连线，
+CLI 负责补齐开始/结束节点、生成符合 IDE 编排习惯的坐标、按节点类型白名单裁剪字段，最后编译成
+`fdDesign`（JSON 字符串）与平台 `addPublish` / `addDraft` 所需的扁平 VO。
+
+```bash
+# 1. 纯离线：生成模板 → 校验 → 编译（不联网）
+llc flow spec --app-code cli-test --name 示例流程 --code flow_demo --out flow.json
+llc flow validate --spec @flow.json --json
+llc flow compile --spec @flow.json --json
+
+# 2. 只读查询
+llc flow list --app-code cli-test --json
+llc flow get --id <flowId> --with-design
+llc flow templates --from @compile-result.json --out templates.json   # 抽取 golden 骨架（剥离坐标）
+llc flow schema --kind jsonSchema --entity-id <fdId>
+
+# 3. 写入（默认预览；必须 --yes + 显式 --app-code）
+llc flow apply --spec @flow.json --app-code cli-test --resolve-schema       # 预览 payload
+llc flow apply --spec @flow.json --app-code cli-test --resolve-schema --yes --enable --json
+llc flow diff --id <flowId> --spec @flow.json --resolve-schema              # 回读比对（默认忽略坐标）
+llc flow script --id <flowId> --out call-flow.js                            # 生成 MKXFORM.flow_<code> 脚本
+llc flow disable --id <flowId> --yes
+llc flow delete  --id <flowId> --yes
+```
+
+**Flow Spec 关键字段**：`appCode` / `name` / `code`（`^[a-zA-Z0-9_]{1,30}$`）/ `startWay` /
+`trigger`（`fdRunType`、`inParam`…）/ `nodes`（`id`、`type`、`config`、`context`、`subProcess`）/ `edges`
+（`from`、`to`、`name`、`default`、`formula`）。节点 `id` 需匹配 `^[0-9a-zA-Z_]{2,32}$`。
+
+**布局**由编译器生成，不要手写 `drawAttr.bounds`：
+
+- `--layout ide`（默认）：主链以 `--center-x`（默认 679）居中；`BranchNode` 为 56×56，其余节点 180×38；
+  分支后继与分支节点同层、泳道 ±1 左右对称；汇聚下移一层；层距 = 该层最高节点 + 52。
+  这与平台 mxGraph 编辑器「向下插入 / 左右插入」累积出的编排一致。
+- `--layout layered`：分支后继放到下一层，可读性更强但与平台手工习惯略有差异。
+- `--layout passthrough`：沿用 spec 里的 `bounds`（用于回写平台导出的流程）。
+- `passthrough` 之外的模式下，`relative:false`、节点尺寸、连线 `sourceRef/targetRef` 与
+  `formulaConfig.branchFormulas`（引用真实连线 ID）、分支线 `exitX=0/1` 锚点均自动生成。
+
+**Schema 注入**：`--resolve-schema` 会为引用数据模型的节点调 `getSourceJsonSchema` /
+`getProcessDataOutJsonSchema` 补齐 `extraAttr.context_outputParam` / `context_bindFormId`。
+这两个端点要求 `entityId` 带 `sys-modeling#` 前缀（CLI 自动补），裸 id 会返回 500。
+失败默认只告警，`--strict-schema` 升级为错误。
+
+**边界与已知限制**：
+
+- `AddDataNode` / `AddOrUpdateNode` 的 `fields` 是平台真实结构
+  （`{field:{...},value:{format,valueJson}}`，公式引用形如 `${data.node.N1.xxx}`）；
+  CLI **原样透传并只校验字段名，不臆造公式**。请用 `flow templates` / `flow get` 取 golden 骨架。
+- 发布时后端从 `startNodeDef` 派生 `fdProcessActive`；`fdStatus=1` 即已启用。
+- 运行日志端点因部署而异：源码声明 `ModelingProcessLog/findAll`，新版页面用
+  `sysModelingLog/findAllWithAppId`；`flow logs` 已内置候选回退，可用 `--endpoint` 指定抓包结果。
+- 运行时触发端点 `executeFlowForAjax` 位于 `sys-xform` 运行时包（无文档化 REST 路径）；
+  CLI 生成的按钮脚本走 `MKXFORM.flow_<fdCode>`，用 `operation create --type script` + `operation attach` 挂载。
+- 完整命令与 Flow Spec 语法见
+  [skills/lan-low-code-cli/references/cli-contract.md](skills/lan-low-code-cli/references/cli-contract.md) 第 10 节。
+
 ### 控件类型
 
 **先查环境再选控件**：
@@ -945,6 +1005,16 @@ llc config show | set | clear
 | 外部表字段 | `POST sys-xform/sysXFormDataModelField/loadFieldMeta` |
 | 字段库 | `POST sys-xform/sysXFormWordsField/list` |
 | 字段编码生成 | `POST sys-xform/sysXFormWordsField/generateFdKey` |
+| 动作流定义 CRUD / 列表 / 详情 | `POST sys-modeling/process/define/{list,get,add,update,delete,checkCodeUniqueness}` |
+| 动作流草稿与发布 | `POST sys-modeling/process/define/{addDraft,updateDraft,addPublish,updatePublish,saveDraft,publish}` |
+| 动作流启停 | `POST sys-modeling/process/define/{startup,stop}` |
+| 动作流引用关系 | `POST sys-modeling/modelingProcessDefineReferList/listByRefer` |
+| 动作流 Schema / 元数据 | `POST sys-modeling/process/define/{getSourceFields,getConditionFields,getSourceJsonSchema,getProcessDataOutJsonSchema,loadDataModel,businessNodes,nextN,…}`、`POST sys-modeling/processNode/define/*` |
+| 动作流分类 | `POST sys-modeling/sysModelingProcessCategory/{list,get,add,update,delete}` |
+| 动作流运行日志 | `POST sys-modeling/ModelingProcessLog/{findAll,get,relation}`（环境差异时可用 `--endpoint` 覆盖） |
+
+> `getSourceJsonSchema` / `getProcessDataOutJsonSchema` 的 `entityId` 必须带 `sys-modeling#` 前缀；
+> `getSourceFields` / `getConditionFields` / `loadDataModel` 用裸 id。详见动作流章节。
 
 ## 五、生成的表单配置结构（`fdConfig`，**持久化格式**）
 

package/dist/api/flow.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowApi = exports.FLOW_LIST_COLUMNS = exports.FLOW_LOG_ENDPOINTS = void 0;
+exports.qualifyEntityId = qualifyEntityId;
+/**
+ * 动作流（sysModelingActionFlow）接口
+ *
+ * 前端 `src/utils/http.ts:3` 使用 `Http.build({ modulePrefixName: 'sys-modeling' })`，
+ * `src/api/sysModelingActionFlow.ts:5-69` 以 `Api.build('process/define/xxx', http)` 声明端点。
+ * CLI 的 LcodeClient 拼接 `${baseUrl}/${relativePath}`（baseUrl 含 /data），
+ * 因此完整地址为 `http://<host>/data/sys-modeling/process/define/list`。
+ * 同构证据：`Api.build('sysModelingApplication/list', http)` 对应已验证的
+ * `sys-modeling/sysModelingApplication/list`。
+ *
+ * 所有接口均为 POST + JSON。
+ */
+const DEFINE_BASE = 'sys-modeling/process/define';
+const NODE_DEFINE_BASE = 'sys-modeling/processNode/define';
+const CATEGORY_BASE = 'sys-modeling/sysModelingProcessCategory';
+const LOG_BASE = 'sys-modeling/ModelingProcessLog';
+const REFER_BASE = 'sys-modeling/modelingProcessDefineReferList';
+/**
+ * 真实环境实测：getSourceJsonSchema / getProcessDataOutJsonSchema 要求 entityId
+ * 带模块前缀 `sys-modeling#`，裸 id 会返回 HTTP 500；而 getSourceFields /
+ * getConditionFields / loadDataModel 用裸 id 正常。与真实数据里的
+ * extraAttr.context_bindFormId = "sys-modeling#<fdId>" 一致。
+ */
+function qualifyEntityId(entityId) {
+    return entityId.includes('#') ? entityId : `sys-modeling#${entityId}`;
+}
+/** 日志列表端点候选（按优先级）；可用 --endpoint 覆盖 */
+exports.FLOW_LOG_ENDPOINTS = [
+    `${LOG_BASE}/findAll`,
+    'sys-modeling/sysModelingLog/findAllWithAppId',
+    'sys-modeling/sysModelingLog/findAll',
+];
+exports.FLOW_LIST_COLUMNS = [
+    'fdId', 'fdName', 'fdDesc', 'fdCode', 'fdCreator', 'fdCreateTime',
+    'fdStatus', 'fdStartWay', 'fdProcessData', 'fdProcessActive', 'fdAppCode', 'fdCategory',
+];
+exports.flowApi = {
+    // ---- 定义 CRUD ----
+    list: (client, request = {}) => client.post(`${DEFINE_BASE}/list`, {
+        columns: exports.FLOW_LIST_COLUMNS,
+        pageNo: 1,
+        pageSize: 1000,
+        sorts: { fdCreateTime: 'desc' },
+        ...request,
+    }),
+    get: (client, fdId) => client.post(`${DEFINE_BASE}/get`, { fdId }),
+    add: (client, vo) => client.post(`${DEFINE_BASE}/add`, vo),
+    update: (client, vo) => client.post(`${DEFINE_BASE}/update`, vo),
+    remove: (client, fdId) => client.post(`${DEFINE_BASE}/delete`, { fdId }),
+    checkCodeUniqueness: (client, fdCode, fdAppCode) => client.post(`${DEFINE_BASE}/checkCodeUniqueness`, { fdCode, fdAppCode }),
+    // ---- 草稿 / 发布 / 状态机（UI 保存与发布走的是这四个端点） ----
+    addDraft: (client, vo) => client.post(`${DEFINE_BASE}/addDraft`, vo),
+    updateDraft: (client, vo) => client.post(`${DEFINE_BASE}/updateDraft`, vo),
+    addPublish: (client, vo) => client.post(`${DEFINE_BASE}/addPublish`, vo),
+    updatePublish: (client, vo) => client.post(`${DEFINE_BASE}/updatePublish`, vo),
+    saveDraft: (client, vo) => client.post(`${DEFINE_BASE}/saveDraft`, vo),
+    publish: (client, vo) => client.post(`${DEFINE_BASE}/publish`, vo),
+    startup: (client, fdId) => client.post(`${DEFINE_BASE}/startup`, { fdId }),
+    stop: (client, fdId) => client.post(`${DEFINE_BASE}/stop`, { fdId }),
+    // ---- 引用关系（删除前检查） ----
+    listByRefer: (client, fdId) => client.post(`${REFER_BASE}/listByRefer`, {
+        conditions: { fdReferId: fdId },
+        pageNo: 1,
+        pageSize: 1000,
+    }),
+    // ---- Schema / 元数据（只读，SchemaResolver 使用） ----
+    businessNodes: (client) => client.post(`${DEFINE_BASE}/businessNodes`, {}),
+    getSourceFields: (client, entityId) => client.post(`${DEFINE_BASE}/getSourceFields`, { entityId, usingTableNameAlias: true }),
+    getConditionFields: (client, request) => client.post(`${DEFINE_BASE}/getConditionFields`, request),
+    getJsonSchema: (client, entityId) => client.post(`${DEFINE_BASE}/getSourceJsonSchema`, {
+        entityId: qualifyEntityId(entityId), usingTableNameAlias: true,
+    }),
+    getDataOutJsonSchema: (client, entityId) => client.post(`${DEFINE_BASE}/getProcessDataOutJsonSchema`, {
+        entityId: qualifyEntityId(entityId), usingTableNameAlias: true,
+    }),
+    getActionFlowSchema: (client, code, appCode) => client.post(`${NODE_DEFINE_BASE}/getActiveTriggerParamSchema`, { code, appCode }),
+    getEventSchema: (client, code) => client.post(`${NODE_DEFINE_BASE}/getEventSchema`, { code }),
+    getInterfaceSchema: (client, code) => client.post(`${NODE_DEFINE_BASE}/getInterfaceSchema`, { code }),
+    getApiMethodSchema: (client, request) => client.post(`${NODE_DEFINE_BASE}/getApiMethodSchema`, request),
+    getFlowBotsSchema: (client, code) => client.post(`${NODE_DEFINE_BASE}/getFlowBotsSchema`, { code }),
+    getProcessEntityDetail: (client, request) => client.post(`${DEFINE_BASE}/getProcessEntityDetail`, request),
+    getQueryStatisticsSchema: (client, request) => client.post(`${DEFINE_BASE}/getQueryStatisticsSchema`, request),
+    getMetaJsonSchema: (client, request) => client.post(`${DEFINE_BASE}/getMetaJsonSchema`, request),
+    loadDataModel: (client, request) => client.post(`${DEFINE_BASE}/loadDataModel`, request),
+    getProcessDataEventInfo: (client) => client.post(`${DEFINE_BASE}/getProcessDataEventInfo`, {}),
+    getRecycleState: (client, entityId) => client.post('sys-modeling/sysModelingMechConfig/findByEntityId', { entityId }),
+    previewScheduled: (client, request) => client.post(`${DEFINE_BASE}/nextN`, request),
+    // ---- 分类 ----
+    categoryList: (client, request = {}) => client.post(`${CATEGORY_BASE}/list`, request),
+    categoryGet: (client, fdId) => client.post(`${CATEGORY_BASE}/get`, { fdId }),
+    categoryAdd: (client, vo) => client.post(`${CATEGORY_BASE}/add`, vo),
+    categoryUpdate: (client, vo) => client.post(`${CATEGORY_BASE}/update`, vo),
+    categoryDelete: (client, fdId) => client.post(`${CATEGORY_BASE}/delete`, { fdId }),
+    // ---- 运行日志 ----
+    /**
+     * 源码 `sysModelingActionFlowLog.ts:7` 声明 ModelingProcessLog/findAll，
+     * 但实测环境返回 404；日志页另有 LogQuery 的 `/sysModelingLog/findAllWithAppId`。
+     * 因此按候选顺序回退，并允许 --endpoint 指定抓包得到的真实路径。
+     */
+    logFindAll: async (client, request, endpoint) => {
+        const paths = endpoint ? [endpoint] : exports.FLOW_LOG_ENDPOINTS;
+        const failures = [];
+        for (const path of paths) {
+            try {
+                return await client.post(path, request);
+            }
+            catch (err) {
+                failures.push(`${path} → ${err.message.split('\n')[0]}`);
+            }
+        }
+        throw new Error(`动作流日志端点均不可用（环境版本可能与源码不同）；可用 --endpoint 指定：\n  ${failures.join('\n  ')}`);
+    },
+    logGet: (client, request) => client.post(`${LOG_BASE}/get`, request),
+    logRelation: (client, request) => client.post(`${LOG_BASE}/relation`, request),
+};