weaver-e10-builder 1.0.11-beta → 1.1.0

package/skill-docs/references/coding/guide-page-code.md

@@ -0,0 +1,224 @@
+# 页面编码指南
+
+> 本文件为 SKILL.md 的子模块，在需要写页面代码时加载。
+> 页面是搭建流程的最后一步，写代码前确保应用、表单、流程都已建好。
+
+---
+
+## 项目结构（从sample拷贝过来）
+
+```
+├── entry.js          ← 路由注册入口
+├── pages/            ← 页面组件
+├── api/
+│   └── formApi.js    ← 表单数据 API
+└── config/           ← 配置文件（不用管）
+```
+
+- entry.js 只完成入口注册，不要写入业务逻辑。
+- formApi.js 默认自带。
+- 该项目只能在泛微云运行，其他环境缺少依赖都会报错。
+- 只能支持 js 编码，**不支持 jsx 或 ts**。
+- 尽量使用原生 React 编码。
+
+---
+
+## entry.js 路由注册模板（严格照抄）
+
+```js
+import React from 'react';
+import { Route } from 'react-router-dom';
+import { regOvProps, appInfo, regReactChildren } from '@weapp/utils';
+import { asyncImport } from '@weapp/ecodesdk';
+
+var { publicUrl } = appInfo('@weapp/ecodesdk');
+
+// 1. 异步引入页面组件 — asyncImport 第一个参数固定为 '${appId}'，不允许留空
+var MyPage = React.lazy(function () {
+  return asyncImport('${appId}', 'pages/MyPage');
+});
+
+// 2. 路由 path 写死字符串，
+var ROUTE_PATH = '/sp/custom/ecode/my-page';
+
+var extract = (
+  <Route path={publicUrl + ROUTE_PATH}>
+    <React.Suspense fallback={<div>Loading...</div>}>
+      <MyPage />
+    </React.Suspense>
+  </Route>
+);
+
+regOvProps('weappEcodesdk', 'Switch', function (props) {
+  regReactChildren(props, extract);
+  return props;
+}, 0);
+```
+
+**铁律**：
+- `asyncImport('${appId}', 'pages/xxx')` — 第一个参数**固定**是 `'${appId}'`，不能写空字符串、不能写别的值
+- `React.Suspense` **只包裹一层**，不要双层嵌套
+- 路由 path 写死字符串（如 `/sp/custom/ecode/my-page`），**不拼接 `${appId}` 变量**
+
+**一个项目可以包含多个页面**，在 entry.js 中按同样模式注册：
+
+```js
+var MeetingList = React.lazy(function () {
+  return asyncImport('${appId}', 'pages/MeetingList');
+});
+
+var MeetingForm = React.lazy(function () {
+  return asyncImport('${appId}', 'pages/MeetingForm');
+});
+
+var extract = (
+  <>
+    <Route path={publicUrl + '/sp/custom/ecode/meeting-list'}>
+      <React.Suspense fallback={<div>Loading...</div>}>
+        <MeetingList />
+      </React.Suspense>
+    </Route>
+    <Route path={publicUrl + '/sp/custom/ecode/meeting-form'}>
+      <React.Suspense fallback={<div>Loading...</div>}>
+        <MeetingForm />
+      </React.Suspense>
+    </Route>
+  </>
+);
+```
+
+> 新页面导出和路由注册详见 `references/coding/guide-page-export.md`
+
+---
+
+## 引用规则
+
+- **前置加载文件（entry.js）**可以直接 import：`import { getSimpleData } from './api/formApi.js'`
+- **非前置加载文件（pages/ 下的所有文件）**只能通过 `React.lazy(() => asyncImport('${appId}', 'pages/xxx'))` 引用
+- entry.js 中只能使用 `React`、`ReactDOM`、`@weapp/utils`、`@weapp/ecodesdk`、`axios`，**不能使用 `@weapp/ui` 组件**
+
+---
+
+## @weapp/ui 可用组件清单
+
+**只能使用以下明确列出的组件**，不要从 `@weapp/ui` 里编造任何不在此列表中的组件名。
+
+| 组件 | import 方式 | 参考文档 |
+|------|-----------|---------|
+| Table | `import { Table } from '@weapp/ui'` | `references/components/display-Table.md` |
+| Avatar | `import { Avatar } from '@weapp/ui'` | `references/components/display-Avatar.md` |
+| List | `import { List } from '@weapp/ui'` | `references/components/display-List.md` |
+| Pagination | `import { Pagination } from '@weapp/ui'` | `references/components/display-Pagination.md` |
+| Icon | `import { Icon } from '@weapp/ui'` | `references/components/display-Icon.md` |
+| Button | `import { Button } from '@weapp/ui'` | `references/components/@weapp-Button.md` |
+| EChart | `import { EChart } from '@weapp/ui'` | `references/components/generic-Echarts.md` |
+| CorsComponent | `import { CorsComponent } from '@weapp/ui'` | `references/components/display-FilePreview.md` |
+| Browser（人员） | `import { Browser } from '@weapp/ui'`<br>`type="resource"` | `references/components/form-EmployeeBrowser-api.md` |
+| Browser（部门） | `import { Browser } from '@weapp/ui'`<br>`type="department"` | `references/components/form-DepartmentBrowser-api.md` |
+| Upload | `import { Upload } from '@weapp/ui'` | `references/components/form-Upload.md` |
+| Badge | `import { Badge } from '@weapp/ui'` | `references/components/base-Badge.md` |
+| Tag | `import { Tag } from '@weapp/ui'` | `references/components/base-Tag.md` |
+
+表单输入控件（文本框、下拉框、日期选择等）用原生 HTML：
+```js
+<input type="text" value={form[F.name]} onChange={...} />
+<input type="date" value={form[F.date]} onChange={...} />
+<select value={form[F.status]} onChange={...}>
+  {options.map(function (opt) {
+    return <option key={opt.valueKey} value={opt.valueKey}>{opt.name}</option>;
+  })}
+</select>
+```
+
+---
+
+## 表单数据操作（核心模式）
+
+**四个 API 各有分工，不要混用：**
+
+| API | 用途 | 返回内容 |
+|-----|------|---------|
+| `getSimpleData(objId, userId)` | 读 ID、写回 formToSave | 所有特殊字段统一返回 `fieldOptionId`（纯数字串） |
+| `getAllData(objId, userId)` | 提取名称、编辑回显 | 含 `fieldOptionName`，mainTable key 是随机哈希 |
+| `withDisplayNames(rows, map)` | 表格展示：ID → 名称 | 把 Select 的 `valueKey` 映射为中文名 |
+| `getFieldOptions(fieldId, objId)` | 拿下拉选项 | `[{valueKey, name}]` |
+
+**不同字段类型，名称来源不同（写在墙上）：**
+
+| 字段类型 | getSimpleData 返回 | 展示时名称来源 |
+|---------|-------------------|--------------|
+| Text / Number / Date | `"值"` / `123` / `"2026-01-01"` | 直接展示 |
+| Select / RadioBox / CheckBox | `"1283421826353889337"`（选项 ID） | `getFieldOptions` → `withDisplayNames` 映射 |
+| **Employee** | `"2765550234448235905"`（用户 ID） | `getAllData` 的 `fieldOptionName`，**不是** getFieldOptions |
+| **Department** | `"2765550234448235905"`（部门 ID） | 同上 |
+| FileComponent | `"fileid1,fileid2"`（文件 ID 串） | 上传组件的 `name` |
+
+**表格页面标准加载模式：**
+
+```js
+var [data, setData] = useState([]);
+
+useEffect(function () {
+  Promise.all([
+    getSimpleData(OBJ_ID, USER_ID),
+    getFieldOptions(F.status, OBJ_ID),   // Select 字段拿选项
+  ]).then(function ([rows, statusOpts]) {
+    // 加载时为每个需要展示名称的 Select/Employee 字段做映射
+    // Employee/Department 的名称要另外从 getAllData 提取！
+    var displayRows = withDisplayNames(rows, {
+      [F.status]: statusOpts,
+    });
+    // Employee 字段需要额外用 getAllData 构建 ID→名称 map
+    setData(displayRows);
+  });
+}, []);
+```
+
+**写入 / 更新：**
+
+```js
+// form 中所有值已经是 ID，直接拼入 formToSave
+var formToSave = {};
+Object.keys(form).forEach(function (key) {
+  if (form[key] !== '' && form[key] !== null && form[key] !== undefined) {
+    formToSave[key] = form[key];
+  }
+});
+// 选择器新值覆盖
+if (selectedPerson.length > 0) formToSave[F.person] = selectedPerson[0].id;
+
+if (editingId) {
+  updateFormData(OBJ_ID, formToSave, editingId, USER_ID);
+} else {
+  saveFormData(OBJ_ID, formToSave, USER_ID);
+}
+```
+
+> 完整的数据读写指南见 `references/coding/guide-form-crud.md`，编辑回显见 `references/coding/guide-edit-backfill.md`（前端代码）。
+
+---
+
+## 编译规则（简要）
+
+- `ecodecmd build {project-dir} --target=e10` 打包（cd 到项目前一级）
+- 所有变量用 `var` 声明
+- 不支持的语法：`catch{}` 无参数 catch、`??`、`import()` 动态导入、`BigInt`
+- 详见 `references/coding/ref-compile-rules.md`（编译配置）、`references/coding/guide-page-export.md`（引用规范）
+
+---
+
+## 代码质量检查清单
+
+生成代码后逐项检查：
+
+1. [ ] 变量用 `var` 声明，非 `const`/`let`
+2. [ ] 非前置加载文件引用使用 `React.lazy(() => asyncImport(...))`
+3. [ ] **表格中没有任何裸 ID 展示**：Employee/Department 用 `fieldOptionName`，Select 用 `withDisplayNames`，用户看到的必须是中文名称
+4. [ ] `getSimpleData` 返回值直接 `item[字段ID]`，没有 `_raw` 层
+5. [ ] Select 字段读写统一用选项 ID（`valueKey`），不是显示名称
+6. [ ] React state 不直接修改，创建新对象 `var newForm = {}; Object.keys(form).forEach(...)`
+7. [ ] entry.js 不引入 `@weapp/ui` 组件
+8. [ ] 没有 `forEach/map/filter(fn, this)` 传 context 的写法，用 `var self = this;` 替代
+9. [ ] 表单数据 key 用字段 ID（纯数字字符串），对照 `form read --out fields.json`
+10. [ ] Employee/Department 字段写入前已转为 ID
+11. [ ] 写完代码后运行 `e10-cli check <项目目录>` 逐条自检

package/skill-docs/references/coding/guide-page-export.md

@@ -0,0 +1,119 @@
+# 页面导出与路由注册指南
+
+## 引用规范
+
+### 前置加载文件（entry.js）
+
+只有前置加载的文件才可以直接 import：
+
+```js
+import { getSimpleData } from './api/formApi.js';  // entry.js 中可以直接引用
+```
+
+- entry.js 中只能使用 `React`、`ReactDOM`、`@weapp/utils`、`@weapp/ecodesdk`、`axios`
+- **不能使用 `@weapp/ui` 组件**
+- entry 只完成入口的注册，不要写入业务逻辑
+
+### 非前置加载文件（pages/ 目录）
+
+**非常关键！！！** 非前置加载的文件（新增的所有文件），只能通过以下方式引用：
+
+```js
+import { asyncImport } from '@weapp/ecodesdk';
+const AgentSxxx = React.lazy(() => asyncImport('${appId}', 'pages/AgentSxxx'));
+// '${appId}' 是固定写法，是内置的ecode应用ID，不用管
+```
+
+引用路径要根据文件相对位置判断：
+- entry.js 中引用 `api/formApi.js`：`'./api/formApi.js'`
+- pages/ 目录下引用 `api/formApi.js`：`'../api/formApi.js'`
+
+---
+
+## 页面导出（路由注册）
+
+在 `entry.js` 中通过 `regOvProps` + `regReactChildren` 注册路由：
+
+```js
+import { regOvProps, appInfo, regReactChildren } from '@weapp/utils';
+const { publicUrl } = appInfo('@weapp/ecodesdk');
+const extract = (
+  <Route path={`${publicUrl}/sp/custom/abc123123/abc123`}> // 导出页面的具体路径
+    <React.Suspense fallback={<div>Loading...</div>}>
+      <Test />  // 导出页面的组件
+    </React.Suspense>
+  </Route>
+);
+regOvProps('weappEcodesdk', 'Switch', (props) => {
+  regReactChildren(props, extract);
+  return props;
+}, 0);
+```
+
+---
+
+## 路由规范
+
+> **核心规则：entry.js 中的路由 path 不要拼接变量，直接写死字符串。**
+
+| 端 | 路由前缀 |
+|----|---------|
+| PC 端 | `/sp/custom/...` |
+| 移动端 | `/mobile/custom/...` |
+
+- path 写固定字符串，如 `/sp/custom/ecode/onboarding`，不拼接 `${appId}`
+- 使用 `appInfo('@weapp/ecodesdk').publicUrl` 处理二级路径兼容（`publicUrl` 本身已包含二级路径前缀）
+- 页面跳转使用 `Link` 或 `withRouter` 的 `history.push`，需拼接 `publicUrl`
+
+---
+
+## ecodInfo.json
+
+项目根目录下的 `ecodInfo.json` 记录项目元信息：
+
+```json
+{
+  "ecodeProjId": "",
+  "ecodeAppId": "",
+  "ebuilderAppId": "",
+  "mainUrl": ""
+}
+```
+
+- 如果文件不存在或内容为空，说明项目还未上传到 Ecode 平台
+- **导入 Ecode 成功后，必须将主页面路径写入 `mainUrl` 字段**，格式如 `/sp/custom/......`，和 entry.js 里必须完全相同
+- **如果当前 Ecode 项目关联了 Ebuilder 应用，必须将 Ebuilder 应用 ID 写入 `ebuilderAppId`**。注意：`ebuilderAppId` 是 Ebuilder 应用的 ID，与 `ecodeAppId`（Ecode 应用文件夹 ID）不同
+
+---
+
+## entry.js 完整模板
+
+```js
+import React from 'react';
+import { regOvProps, appInfo, regReactChildren } from '@weapp/utils';
+import { asyncImport } from '@weapp/ecodesdk';
+
+const { publicUrl } = appInfo('@weapp/ecodesdk');
+const appId = '${appId}';
+
+// 异步引入页面组件
+const MyPage = React.lazy(() => asyncImport('${appId}', 'pages/MyPage'));
+
+// 注册路由 — path 写死固定字符串，和
+var ROUTE_PATH = '/sp/custom/ecode/my-page';
+const myRoute = (
+  <Route path={`${publicUrl}${ROUTE_PATH}`}>
+    <React.Suspense fallback={<div>Loading...</div>}>
+      <MyPage />
+    </React.Suspense>
+  </Route>
+);
+
+regOvProps('weappEcodesdk', 'Switch', (props) => {
+  regReactChildren(props, myRoute);
+  return props;
+}, 0);
+```
+> `ROUTE_PATH` 不要在这里拼接 `appId` 变量，`publicUrl` 已包含二级路径前缀。
+
+> 完成后记得告诉用户哪些页面对应哪些 URL。

package/skill-docs/references/coding/ref-compile-rules.md

@@ -0,0 +1,106 @@
+# 编译规则参考
+
+## 编译命令
+
+```bash
+ecodecmd build {project-dir} --target=e10
+```
+
+- 其中 `{project-dir}` 为代码项目的目录
+- 打包会在项目产生一个 `.target` 文件夹，包含一个 `.zip` 文件
+- **打包得 cd 到项目的前一级**，要不然传的目录里面没有名称
+
+---
+
+## 编译配置
+
+ecodecmd 内部使用 `@babel/standalone` v7.5.5 编译代码，E10 模式下调用 `compileJsE10`。
+
+```
+presets: ['es2015', 'react', ['stage-2', {decoratorsLegacy: true, loose: true}]]
+plugins: ['proposal-object-rest-spread', 'proposal-optional-chaining']
+```
+
+---
+
+## 支持的语法
+
+| 语法 | 示例 |
+|------|------|
+| JSX | `<div className="app">{content}</div>` |
+| 箭头函数 | `(x) => x + 1` |
+| async/await | `const data = await getSimpleData(...)` |
+| 模板字符串 | `` `Hello ${name}` `` |
+| 对象展开 `...` | `{ ...oldObj, newKey: val }` |
+| 可选链 `?.` | `obj?.nested?.value` |
+| Class 组件 | `class MyPage extends React.Component {}` |
+
+---
+
+## Babel 编译陷阱（语法合法但编译后行为异常）
+
+| 陷阱 | 说明 | 解决方案 |
+|------|------|---------|
+| `forEach(fn, this)` 传 context | `this` 在 Babel 编译后丢失，回调内的 `this` 变成 `undefined` | 提前 `var self = this;`，回调内用 `self` |
+| `map/filter/find` 同样受影响 | 所有数组方法只要传了第二个参数 `this`，编译后都失效 | 一律用 `var self = this;` 模式 |
+| 漏写 `var` 直接赋值 | `x = {}` 未经声明直接赋值，Babel 编译后严格模式报 `ReferenceError: x is not defined` | **所有变量必须先 `var x = ...` 再使用** |
+
+```js
+// ❌ Babel 编译后 this 丢失，setState 报错
+data.forEach(function (item) {
+  this.setState({ ... });
+}, this);
+
+// ✅ 提前捕获 this
+var self = this;
+
+// ❌ 漏写 var，Babel 编译后报 ReferenceError
+priorityColorCache = {};
+priorityOpts.forEach(function(opt) { ... });
+
+// ✅ 先声明再赋值
+var priorityColorCache = {};
+priorityOpts.forEach(function(opt) { ... });
+data.forEach(function (item) {
+  self.setState({ ... });
+});
+```
+
+---
+
+## 不支持的语法（会编译报错）
+
+| 语法 | 解决方案 |
+|------|---------|
+| `catch { }` 无参数 catch | 必须写成 `catch(e) {}` |
+| `??` 空值合并运算符 | 用 `||` 或三元表达式替代 |
+| `import()` 动态导入 | 必须用 `asyncImport` |
+| `private class fields #` | 不用 class fields，用普通方法 |
+| `globalThis` | 用 `window` |
+| `BigInt` | 不用 |
+
+---
+
+## 打包 & 上传流程
+
+```bash
+# 1. 编译检查
+e10-cli check <项目目录>
+
+# 2. 打包（cd 到项目前一级）
+cd /path/to/parent && ecodecmd build project-dir --target=e10
+
+# 3. 上传（先删旧应用）
+e10-cli project tree <projectId>              # 找旧应用 folderId
+e10-cli project delete-folder <folderId>
+e10-cli project import <projectId> .target/xxx.zip --main-url /sp/custom/...
+```
+
+---
+
+## 关键注意事项
+
+1. **所有变量用 var 声明**，非前置加载文件引用确保使用 `React.lazy(() => asyncImport...)`
+2. `${appId}` 是占位符，运行时由 ecode SDK 替换
+3. 写完代码后运行 `e10-cli check <项目目录>` 逐条自检，全部确认通过后再 build
+4. 本地修改后一定要及时 `ecodecmd build` + `import` 上传，否则用户无法验证（用户看不到本地代码）

package/skill-docs/references/common/guide-plan-template.md

@@ -0,0 +1,201 @@
+# 搭建计划模板（plan.md 强制格式）
+
+> 这是 `plan.md` 的**强制模板**。写 plan.md 必须照此格式逐项梳理资源与规则，**禁止自创格式、禁止预勾 `[x]`**。
+> `[ ]` = 待办；执行阶段做完一项、验证通过，才改 `[x]` 并填实际 ID。全部 `[x]` 才算完工。
+
+## 使用方法
+
+1. 复制下方「plan.md 骨架」到工作区 `plan.md`
+2. 按需求逐项填实（应用/表单/流程/出口条件清单/菜单/页面/必做项）
+3. 规划阶段全部留 `[ ]`，拿给用户确认（此阶段不调 e10-cli 写命令，可 list/read 查现状）
+4. 用户确认后逐项执行，每做完一项、验证通过，改 `[x]` 并填 ID——完成一条打勾一条
+5. **执行每项前，先按 SKILL.md 决策树读对应 `references` 指南**——命令的完整参数/边界/坑/示例都在指南里，认真阅读再动手，不要凭印象直接调命令
+
+---
+
+## plan.md 骨架
+
+```md
+## 搭建计划
+
+> ⚠️ `[ ]` 是待办，不是"已规划"。规划阶段全部留 `[ ]`；执行阶段做完一项、验证通过，才改 `[x]` 并填 ID。**完成一条打勾一条**，全部 `[x]` 才算完工。**禁止预勾 `[x]`**（=谎报完成）。勿依赖平台默认值——平台默认值≠方案要求。
+> **来源标注**：每张表/每个流程/每个节点用分组头声明（名称+ID 占位），其下 `[ ]` 项的来源即该分组；跨表的项内联标「来源: <表单/流程>」。
+
+### 0. 环境
+- [ ] 鉴权 `e10-cli auth status`（profile 切换 `auth profile use` / 新环境 `auth set --eteamsid --base-url`）
+
+### 1. 应用
+- [ ] <应用名> | `app create` | ID: 待创建
+  > 一份需求只建这一个应用，所有表单/流程/菜单都在它下面。不要按功能点拆应用；确需多应用（分属不同业务系统）先跟用户确认。
+
+### 2. 角色（来源: 全应用）
+- [ ] <角色名> | `role create` + `role add-member <roleId> <keyword>` | 方案要求的每个角色都要建，不会自动有
+
+---
+
+### 3. 表单（每张表一组，逐张复制此分组）
+
+#### ▼ 表单：<表单名A> | objId: 待创建
+
+##### 3.1 字段定义（建表时一次性，`form create --fields` --layout FLOW|EXCEL）
+- [ ] <表单名> | ID: 待创建
+  布局: FLOW（流式）/ EXCEL（表格，缺省）
+  字段:
+    1. 名称(Text, 必填)
+    2. 金额(Money, precision=2, 只读)
+    3. 备注(TextArea, 独占一行)
+    4. 客户名称(Text, group=基本信息, 必填)
+    5. 联系电话(Phone, group=基本信息)
+    6. 明细表(DetailTable, formFields:[...])
+    7. 关联客户(EBuilder, sformId+dataTitle)
+    8. 关联流程(Flow, sformId=<流程绑定的表单objId>)  ← sformId 指向哪个流程表单，浏览时就只选该表单绑定的流程数据，创建时自动绑定
+  - 选项/编号/默认值/精度/百分比/maxLen 建表时写全；单位无独立属性，**写进字段名**如 `工时单价(元)`
+  - **布局与显示属性**：方案文档明确要求的必填(`required`)、只读(`readOnly`)、隐藏(`hidden`)、独占一行(`singleRow`)、分组(`group`)、字段顺序——全部标在字段清单里，建表时 fields.json 一并带上，勿留建后补。方案未提到的用默认（EXCEL 两列、不分组、不必填）
+  - 公式/值带出可 inline：`formula` / `relateFrom`
+  - **Flow 字段**：`sformId` 是流程表单 objId（不是 workflowId），建表时写进 fields.json 即自动绑定——关联到哪个流程表单就只能选该范围的流程数据，无需单独配数据范围
+  > 不要先建空表再 add-field——add-field/edit-field 只是**罕见补救手段**
+
+##### 3.2 表单级配置（来源: 本表单 <表单名A>；建表后逐项配齐，缺一项这张表不算完成）
+- [ ] 复杂编号 | `form serial-mark set <objId> <appId> <fieldId> --segments @json`（纯建模表：fixed/year/serial/field/system/date+代字；⚠ 绑流程表无效→走 `workflow numbering`）
+- [ ] 值带出（关联表） | `form relate <appId> <objId> <目标字段> --from <Employee/Department源字段>`（换申请人→填邮箱/工号/部门；HRM属性带出，简单单源）
+- [ ] 值带出（跨表/多跳） | `form field-linkage add <appId> <objId> --trigger <触发字段> --target <目标字段> --hops "<源表objId:带出字段,源表objId:带出字段,...>"`（跨表查询带出，支持多跳链式中转；Text 字段必须多跳到名称表取名称不能直接赋 ID）
+- [ ] 关联显示列 | `form ebuilder-columns <objId> <appId> <fieldId> [字段名...]`（先不带参数看业务字段候选清单，去系统字段）
+- [ ] 关联数据范围 | `form ebuilder-scope set <objId> <appId> <fieldId> --rules '[...]'`（如客户状态=启用才可选）
+- [ ] 字段公式 | `form formula set --expression "DAYS({主表.开始},{主表.结束})" --target <fieldId>`（或 fields.json inline）
+- [ ] 查重校验 | `form validate add <objId> <appId> <字段名...>`（项目名称重名/工时日期重复）
+- [ ] 显隐联动 | `form linkage add <appId> <objId> <名> --config @json`（prop: hide/show/edit/readonly/required/hideLine）
+- [ ] 字段分组 | `form group <objId> <appId> --groups '{"基本信息":[...]}'`（建表时已用 group 则跳过）
+- [ ] 表单权限 | `form permission add <objId> <appId> --org-type <all/role/dept/...> --right-type <0/1/2/3>`（勿默认所有人）
+- [ ] 表单按钮 | `form button add <objId> <appId> <名> --url <url> --open-type <1/2/3>`
+
+##### 3.3 台账/视图配置（来源: 本表单 <表单名A> 的台账；无需求标「— 无」）
+- [ ] 显示列批量设置 | `form list-columns <objId> <appId> <listId> --set @columns.json`（[指南](../form/guide-list-columns.md)）
+- [ ] 列单位 | `form list-unit <objId> <appId> <listId> <fieldId> "（元）"`
+- [ ] 列格式 | `form list-format <objId> <appId> <listId> <fieldId> [--thousandths] [--decimal <n>]`
+- [ ] 字段事件（列点击跳转） | `form list-click <objId> <appId> <listId> <fieldId> [--target <objId>]`
+- [ ] 搜索条件 | `form list-search <objId> <appId> <listId> [--add <f>] [--quick <f>]`
+- [ ] 排序 | `form list-sort <objId> <appId> <listId> [--field <f>] [--order ASC|DESC]`
+- [ ] 顶部统计（主表/明细） | `form list-stats <objId> <appId> <listId> --add @json`（[指南](../form/guide-list-stats.md)）
+- [ ] 视图数据条件 | `form list-filter <objId> <appId> <listId> --add '{"conditions":[...]}'`
+- [ ] 关联页签及目标视图 | `form association create <objId> <appId> <名> --view <viewId> --permissions @json`（[指南](../form/guide-form-association.md)）
+- [ ] 关联页签布局与终端 | `form association update <objId> <appId> <associationId> --layouts 显示 --terminals PC MOBILE`（[指南](../form/guide-form-association.md)）
+- [ ] 关联页签数据筛选 | `form association set-filter <objId> <appId> <associationId> --mappings @json`（[指南](../form/guide-form-association.md)）
+- [ ] 视图按钮显示位置 | `form button position <objId> <appId> <buttonId> --view <listId> --position 行上`（[指南](../form/guide-form-button.md)）
+- [ ] 行事件（整行点击） | `form list-event <objId> <appId> <listId> --add-page '{...}'`
+- [ ] 视图启用分组 | `form list-group <objId> <appId> <listId> --enable --group-field <fieldId>`（[指南](../form/guide-form-view.md)）
+- [ ] 主表合并行 | `form list-merge <objId> <appId> <listId>`
+- [ ] 台账视图权限 | `form list-permission <objId> <appId> <listId> [--add-all|--add-user <id> --name <n>]`
+- [ ] 分类搜索 | `form list-search-group <objId> <appId> <listId> [--add <选项fieldId>]`
+- [ ] 自定义视图 | `form view create <objId> <appId> <名> --type kanbanView|calendarView|mindMapView|multiView` + `form view populate`
+- [ ] 表格视图 | 默认复用台账，记录实际名称/listId；额外新建才用 `form table-view create <objId> <appId> <名>`（[指南](../form/guide-form-view.md)）
+  > 表单自带台账（搜索/筛选/导出/批量）。本节只列有需求的项；无需求标「— 无」
+
+#### ▼ 表单：<表单名B> | objId: 待创建
+（同上 3.1/3.2/3.3 复制）
+
+---
+
+### 4. 流程（每个流程一组，逐个复制此分组）
+
+#### ▼ 流程：<流程名A> | workflowId: 待创建
+
+##### 4.1 创建
+- [ ] 创建 | `workflow create <appId> <formObjId> <名>`（默认不加菜单；确认需要发起入口时 `--menu` 加）
+  > ⚠️ **流程级必做**：① 流程编号（`workflow numbering`）；② 出口名称（`workflow link-rename`，改业务人话）；③ 出口条件清单（见 4.3，先列全表再逐条创建，勿凭印象跳步）
+
+##### 4.2 节点与连线（来源: 本流程 <流程名A>；每节点一行）
+> ⚠️ 操作者按需求语义用对应 `--type`（role/dept/position/superior/initiator/form/matrix/free/all），**禁止兜底成具体人员顶替**；名称解析不到先停下确认。
+- [ ] 节点1 | 操作者: 创建人
+- [ ] 节点2 | 操作者: 区域经理+部门领导(竞签)  ← 「A或B审批」=一节点多人+竞签/非会签，不拆节点
+- [ ] 节点3 | 条件: <字段>=<值> 才走到，否则跳过/直达<节点>
+- [ ] 节点4 | 操作者: 角色X ｜ 动作流: → <目标表>(add/update/delete, 映射: 源→目标)
+- [ ] 连线 | `workflow add-link/add-links <wf> <from> <to> <label>` [--reject 退回] [--default 默认]
+
+##### 4.3 出口条件清单（来源: 本流程 <流程名A>；必填，动手前逐条列出，防遗漏）
+段② 执行到条件时，先按此表列出所有连线的完整条件，逐条确认后再 `workflow condition add`：
+
+| 来源节点 | 目标节点 | 连线名 | 条件 | 来源 | 操作 | 值/右字段 | 明细量词 | 备注 |
+|---|---|---|---|---|---|---|---|---|
+| 发起 | 初审 | 部门初审 | 所属部门=财务部 | form:所属部门 | 等于 | 财务部 | — | |
+| 发起 | 初审 | 部门初审 | 报销金额5k~10k | form:报销金额 | 范围 | 5000:10000 | — | 数值范围 |
+| 发起 | 初审 | 部门初审 | 发起时间≥报销日期 | system:发起时间 | 大于等于 | field:报销日期 | — | 变量模式 |
+| 发起 | 初审 | 部门初审 | 报销类型∈{差旅,住宿} | form:报销类型 | 属于 | 差旅费,住宿费 | 任一 | 与下行OR |
+| 发起 | 初审 | 部门初审 | 同上OR组 | form:发票编号 | 包含 | FP | 任一 | 接上行OR |
+
+要点：每行一条原子条件，OR 组拆多行备注"与下行OR"；操作列 等于/大于/小于/范围/属于/包含/为空/不为空/field(变量模式)；值列字面值直接写、`field:`前缀引用另一字段；明细量词 任一(任一行)/所有(所有行)/—(主表)；创建完 `workflow condition list <wf>` 回读核对总数一致
+
+- [ ] 出口名 | `workflow link-rename <wf> <linkId> <业务人话>`（分支连线尤其要改）
+
+##### 4.4 节点级配置（每个审批节点一组，逐个复制）
+###### ▶ 节点：<节点名> | nodeId: 待创建
+- [ ] 操作者 | `workflow set-operator <wf> <node> [keyword] --type <user/role/dept/position/all/free/superior/initiator/prev-node/form/matrix> --sign-order <会签/竞签/依次/抄送>`（`--append` 多组叠加）
+- [ ] 提交校验 | `workflow node validate <wf> <node> --rule "字段 操作 值"`（跨表用"明细表名.字段"，如 `行程明细.开始时间 等于 出差开始日期`）
+- [ ] 签字意见必填 | `workflow node sign <wf> <node> --select "退回"`（退回等操作类型必填意见）
+- [ ] 节点菜单 | `workflow node menu <wf> <node> --toggle <menuId>`
+- [ ] 退回设置 | `workflow node reject <wf> <node>`
+- [ ] 超时处理 | `workflow node timeout <wf> <node>`
+- [ ] 字段权限 | `workflow node field-permission set <wf> <node> --hide <字段...>`
+
+##### 4.5 流程级设置（来源: 本流程 <流程名A>）
+- [ ] 流程编号 | `workflow numbering set <wf> --prefix LC --serial 4 --no-year`（REQUEST_NO，绑流程表必走）
+- [ ] 流程标题 | `workflow setting title <wf> --rule "发起人|提交日期|客户名称"`（标题=流程名+系统字段则跳过）
+- [ ] 提交确认 | `workflow setting submit <wf>`
+- [ ] 签字意见 | `workflow setting sign <wf>`
+- [ ] 评论 | `workflow setting comment <wf> --enable`
+- [ ] 批量操作 | `workflow setting batch <wf>`
+- [ ] 自动处理 | `workflow setting auto <wf>`
+- [ ] 其他 | `workflow setting other <wf>`
+- [ ] 存档 | `workflow advanced doc <wf>`
+- [ ] 定时触发 | `workflow advanced schedule <wf>` + `schedule-range <wf>`（人员范围）
+- [ ] 消息提醒 | `workflow message create`（IM 提醒动作流）
+
+##### 4.6 动作流（跨表写入/自动化）
+- [ ] 动作流生成 | `actionflow generate '{"planFile":"@plan.json",...}'`（来源: 本流程触发 → 目标: <目标表单>）
+- [ ] 节点字段赋值 | `workflow save-action @action.json`（来源: 本流程 <节点名>）
+- [ ] 数据来源落点 | 目标台账建 Flow 字段 `form add-field <目标台账objId> <app> "数据来源" Flow --sform-id <本流程表单objId>`（来源: 本流程 → 落点: <目标台账表单名>），add 时 `--sysvar` 写 requestId，**update/delete 也靠它定位**
+
+#### ▼ 流程：<流程名B> | workflowId: 待创建
+（同上 4.1-4.6 复制）
+
+---
+
+### 5. 菜单（来源: 应用）
+- [ ] 台账菜单 | `menu add-table <appId> <objId>`（来源: <表单名>；form create 已自动加，补加用此）
+- [ ] 发起菜单 | `menu add-start <appId> <formObjId>`（来源: <流程名>绑定的表单；workflow create 已自动加）
+- [ ] 自定义菜单 | `menu add <名> <path> <appId>`（LINK，ecode 页面）
+- [ ] 菜单权限 | `menu permission`（岗位/角色/部门/人员可见）
+
+### 6. 页面（定制）
+- [ ] 无定制 | 标「### 页面（无需，表单自带台账）」
+- [ ] 定制页面 | Ecode `project create/import` + 页面编码（图表/跨表聚合/特殊交互）
+
+### 7. 矩阵（HRM，按需）
+- [ ] <矩阵名> | `matrix create` + `config-edit` + `enable` + `data`（来源: 被 <流程名> 的 `set-operator --type matrix` 引用）
+
+## 执行分段（最多三段，每段完成停下来让用户确认，确认后才进下一段）
+- 段① 应用+角色+全部表单（建表 + 3.2 表内项配齐，**缺一项这张表不算完成**）→ 确认字段设计 → 段② 流程（先列出口条件清单→逐条 `condition add`→`condition list` 回读核对）→ 确认流程 → 段③ 菜单+页面
+- 简单单步需求（改字段、查数据）不分段，直接执行
+> **表单是流程的地基**：流程绑定表单、条件/动作流/操作者都引用字段，字段设计错了流程全返工——表单段必须确认后再进流程
+
+## 规则备忘
+- **执行前读指南**：每个命令的完整参数/边界/示例在对应 `references` 文档（SKILL.md 决策树按关键词路由），动手前先读，勿凭印象调命令出错
+- Plan 阶段不调 e10-cli 写命令（可 list/read 查现状）；必须写 plan.md 落地，不要只在对话里列方案
+- 应用数量：默认全需求只建 1 个应用，不按功能点拆；确需多应用先跟用户确认
+- 流程按节点逐行，操作者含签署方式/条件/动作流挂节点；**「A 或 B 审批」= 一节点多人 + 竞签/非会签，不拆节点**
+- 台账页面不用写，表单自带台账（搜索/筛选/导出/批量）
+- 表单字段一次性建好（`form create --fields`），singleRow/group 建表时定，勿留建后补
+```
+
+---
+
+## 来源标注方式
+
+| 配置项类型 | 来源标注方式 |
+|----------|------------|
+| 表单级配置（3.2/3.3） | 分组头 `▼ 表单：<表单名A> | objId: 待创建`，其下项来源=该表单 |
+| 流程级配置（4.2/4.3/4.5） | 分组头 `▼ 流程：<流程名A> | workflowId: 待创建`，其下项来源=该流程 |
+| 节点级配置（4.4） | 子分组头 `▶ 节点：<节点名> | nodeId: 待创建`，其下项来源=该节点 |
+| 跨表项（动作流落点） | 内联标 `来源: 本流程 → 落点: <目标台账表单名>` |
+| 菜单/矩阵 | 内联标 `来源: <表单名>` / `被 <流程名> 引用` |
+
+多张表/多个流程时，复制对应 `▼` 分组（每张表/每个流程一组），来源即分组头声明。每个 `[ ]` 都能看清属于哪个表单/流程/节点，不会把 A 表的配置错配到 B 表。