weaver-work-cli 0.1.24 → 0.1.25

package/skills/weaver-e10-builder/references/common/map.md

@@ -0,0 +1,153 @@
+# E10 智能搭建规划能力地图
+
+本页用于把完整实施方案转成项目 `plan.md`：识别资源归属、配置项、依赖、待确认问题与关键验收结果。规划时先读本页和[计划模板](guide-plan-template.md)，执行某项配置前再读取对应专题指南。本页不提供命令参数或字段码表。
+
+## 使用方法与状态
+
+1. 逐段阅读正文、表格和图片，将每条业务要求映射到资源与配置项，记录原文来源、所属应用/表单/视图/流程、前置依赖及可观察结果。已有资源先只读盘点，再决定复用、修改或新建。
+2. 需求含完整布局样表时，按[布局规划](../form/guide-form-layout-planning.md)保留标题、分组、同排、空白与字段顺序，并同时写入字段清单和布局蓝图。每张表单创建前确认 FLOW 或 EXCEL。
+3. 规划状态区分：**待业务确认**（语义或取值有歧义）、**待环境核查**（资源、权限或环境行为未证实）、**需其他方式补充**（现有 CLI 只能完成一部分）、**已确认无法实现**（核实无可行路径）。只有最后一种写入 plan 的“无法实现的项”，原需求项保持未完成。
+4. 按资源依赖组织 plan；关键配置写明读回点和最小业务验收点。接口保存、配置读回与页面实际生效是不同层次，按风险选择必要的检查。
+
+## 一、资源地图：创建、复用或修改什么
+
+| 资源 | 使用场景与解决的问题 | 依赖与 plan 要点 | 能力边界与简要验收 | 详见 |
+|---|---|---|---|---|
+| 环境与组织身份 | 确定搭建目标和资源所属机构 | 写目标地址、profile、机构及跨环境引用 | 远程操作前确认鉴权；验收当前环境和组织对象 | [鉴权](../auth/guide-auth.md) |
+| 应用 | 承载表单、流程、菜单及页面 | 写新建/复用、主应用和跨应用归属；交付时要走**启用 → 发布到前台** | 搭建期可先不发布；默认一个主应用；验收真实 appId 与名称 | [发布](../app/guide-app-publish.md)、[计划模板](guide-plan-template.md)、[命令](ref-cli-commands.md) |
+| 角色 | 表达授权主体和流程操作者 | 写角色、所属机构及成员来源 | 角色创建与成员配置分别验收 | [命令](ref-cli-commands.md) |
+| EB 表单 | 持久化业务记录和默认台账 | 写应用、字段、类型、布局及关联对象 | 验收 objId/formId、字段及默认台账 | [创建表单](../form/guide-create-form.md) |
+| 明细表 | 承载一对多业务行 | 写所属主表、明细字段和层级 | 二级明细另写父子行标识；验收结构及挂载 | [二级明细](../form/guide-form-sub-detail.md) |
+| 虚拟表 | 展示已有来源的组合数据 | 写数据来源、主键、来源字段和展示类型映射 | 先验证稳定主键和字段兼容；验收数据展示 | [虚拟表](../form/guide-virtual-form.md) |
+| 表单布局 | 控制新建/显示页面的字段排布 | 写 FLOW/EXCEL、字段顺序、分组和布局样表 | 建表前确定类型；验收实际字段与位置 | [布局规划](../form/guide-form-layout-planning.md) |
+| 表单视图与台账 | 按业务场景展示、检索记录 | 写默认视图复用/改名及额外视图类型 | PC/MOBILE 分别核对；视图不等于菜单入口 | [视图](../form/guide-form-view.md) |
+| EB 流程 | 应用内审批，默认流程路径 | 先有 EB 表单；写节点、出口及操作者 | 验收完整拓扑和关键条件 | [流程](../workflow/guide-workflow.md) |
+| 原生工作流程 | 流程中心或明确要求原生表单的审批 | 写自建/绑定表单、固定/自由模式和 formId | 与 EB 资源 ID 分开；验收流程与绑定表单 | [流程](../workflow/guide-workflow.md) |
+| 公文流程 | 原生工作流程中的公文业务 | 写公文类型及专属设置要求 | 按当前支持状态逐项核对设置 | [公文](../workflow/guide-workflow-odoc.md) |
+| 权责表 | 按分支场景矩阵维护或复用审批路径 | 写随流程新建/独立复用、节点路径和变量映射 | 验收场景条件、路径与映射 | [权责表](../workflow/guide-workflow-auth-resp.md) |
+| 动作流 | 跨表写入或事件自动化 | 写触发点、源/目标字段及记录定位 | 验收动作绑定与目标记录变化 | [动作流](../workflow/guide-workflow-action.md) |
+| HRM 矩阵 | 按组织条件决定流程操作者 | 写条件、输出列、数据行及引用节点 | 结构和数据都需有效；验收命中结果 | [矩阵](../hrm/guide-matrix.md) |
+| 报表数据集 | 汇集报表所需数据来源 | 写来源表/字段、关联关系和查询范围 | 字段需精确匹配；验收数据集字段 | [报表创建](../report/guide-report-build.md) |
+| 报表 | 统计、分组和报表布局 | 写单元格、查询、共享和交付效果 | 保存与实际展示分别核对 | [报表创建](../report/guide-report-build.md) |
+| 菜单 | 提供台账、流程或页面入口 | 目标资源先存在；写层级、名称与可见主体 | 验收点击目标与菜单权限 | [菜单](../menu/system-menus.md) |
+| 配置式页面 | 用设计器组件搭建页面 | 写数据源、组件、布局和 PC/MOBILE 要求 | 验收两端布局与数据绑定 | [设计器](../ebuilder-designer/guide-designer.md) |
+| 定制页面 | 实现标准配置之外的交互 | 写目标页面、作用范围、发布与入口 | 验收实际加载和业务交互 | [页面编码](../coding/guide-page-code.md) |
+| ESB 系统接口 | 从接口文档创建对外接口定义 | 写系统池、接口清单和文档来源 | 区分接口定义与动作流 HTTP 调用；验收创建结果 | [接口导入](../esb-interface/guide-import.md) |
+| 组织数据 | 维护部门、人员等基础数据 | 写机构归属、人员来源和导入范围 | 批量导入先预检；验收数据和归属 | [组织](../hrm/guide-org-employee.md) |
+
+## 二、功能配置地图：资源建成后还要做什么
+
+下表用于识别应写入 plan 的配置，不表示每个项目都要启用。具体取值和命令由专题指南确定。
+
+### 表单、字段与布局
+
+| 功能配置项 | 需求场景与解决的问题 | 依赖；计划写明 | 能力边界；简要验收 | 详见 |
+|---|---|---|---|---|
+| 字段类型 | 选择文本、金额、日期、组织、关联等录入组件 | 表单；逐字段写主/明细位置、类型与来源 | 按对象类型选原生字段；验收读回类型 | [字段码表](../form/ref-form-fields.md) |
+| 选项与默认值 | 限定可选值或预置新记录内容 | 字段；写选项、默认值及触发时机 | 选项模板与字段内选项分别记录；验收新建页面 | [字段码表](../form/ref-form-fields.md) |
+| 字段多语言 | 同一字段显示中英文名称 | 字段；写中文、英文及目标 fieldId | 建字段后配置；验收两种语言读回 | [创建表单](../form/guide-create-form.md) |
+| 字段显示属性 | 控制必填、只读、隐藏及独占一行 | 布局；逐字段写目标状态 | 字段定义与布局呈现分别核对 | [布局规划](../form/guide-form-layout-planning.md) |
+| 布局样表 | 从完整表格提取空间排布 | 写 FLOW/EXCEL、标题、行列、同排、空白和合并 | 字段清单与布局蓝图同时保留；验收实际位置 | [布局规划](../form/guide-form-layout-planning.md) |
+| 字段分组 | 将业务字段归入折叠分段 | 写分组名称、顺序及成员字段 | 需求明确时配置；验收字段归属 | [布局规划](../form/guide-form-layout-planning.md) |
+| 关联字段 | 选择客户、合同、流程等原生业务对象 | 写字段子类、目标对象、单/多选 | 关联对象与通用浏览来源分别选型；验收选择范围 | [字段码表](../form/ref-form-fields.md) |
+| 关联数据范围 | 限定关联字段可选记录 | 关联字段；写过滤条件与字段映射 | 区分弹窗显示列；验收可选数据 | [关联范围](../form/guide-ebuilder-scope.md) |
+| 二级明细 | 父级每行挂载子级明细记录 | 主/子明细表；写父子行标识与层级 | 子表归属需按行核对 | [二级明细](../form/guide-form-sub-detail.md) |
+| 字段公式 | 根据其他字段计算目标值 | 写表达式、目标字段和精度 | 验收公式读回与样例计算 | [公式](../form/guide-form-formula-functions.md) |
+| 函数联动 | 字段变动或载入时赋值计算 | 写触发字段、目标字段、事件和表达式 | 与静态字段公式分开；验收触发结果 | [函数联动](../form/guide-formula-linkage.md) |
+| 跨表字段带出 | 选择关联记录后回填其他字段 | 来源表、匹配字段、目标字段及映射 | 验收选记录后的实际回填 | [字段带出](../form/guide-field-linkage.md) |
+| 属性显隐联动 | 条件变化时改变字段显示、只读或必填 | 写条件、目标字段及状态 | 改的是属性而非字段值；验收条件切换 | [显隐联动](../form/guide-form-linkage.md) |
+| 编号规则 | 生成带日期、代字或流水的业务编号 | 写编号字段、组成段、位数与作用范围 | 表单编号与流程编号分开；验收生成值 | [编号](../form/guide-form-serial-mark.md) |
+| 查重校验 | 阻止或提示重复业务数据 | 写比较字段及期望行为 | 验收重复样例的提示/阻断 | [创建表单](../form/guide-create-form.md) |
+| 消息提醒 | 表单数据新建 / 修改 / 删除时通知相关人 | 写触发时机、推送渠道、标题内容、落地页与提醒对象 | 提醒对象按名单/角色/组织解析；验收规则读回与启停状态 | [消息提醒](../form/guide-form-message.md) |
+| 表单权限 | 控制新建、查看、编辑和删除 | 写主体、范围和权限类型 | 授权与视图筛选分开；验收实际授权 | [命令](ref-cli-commands.md) |
+| 查看布局权限 | 给不同主体分配查看布局 | 写主体及 PC 查看布局 | 验收授权与布局绑定 | [视图权限](../form/guide-form-view-permission.md) |
+
+### 视图、台账与交互
+
+| 功能配置项 | 需求场景与解决的问题 | 依赖；计划写明 | 能力边界；简要验收 | 详见 |
+|---|---|---|---|---|
+| 默认视图名称 | 使自动生成的台账名称符合需求 | 表单；写原名称与目标名称 | 视图名称与菜单名称分别核对 | [视图](../form/guide-form-view.md) |
+| 新增视图 | 建额外表格、看板、日历或其他视图 | 表单；写类型、用途和目标终端 | 新视图字段与布局需填充；验收可打开 | [视图](../form/guide-form-view.md) |
+| 显示列 | 控制 PC/MOBILE 列、顺序与宽度 | 视图及字段；写终端和字段清单 | 两端分别核对 | [显示列](../form/guide-list-columns.md) |
+| 列格式与单位 | 控制金额小数、千分位和单位 | 视图列；写格式与单位 | 格式与单位属于不同配置；验收展示值 | [视图](../form/guide-form-view.md) |
+| 搜索与排序 | 提供普通/快捷搜索和默认顺序 | 视图字段；写搜索入口和排序优先级 | 验收列表查询与顺序 | [视图](../form/guide-form-view.md) |
+| 顶部统计 | 展示总数、求和或条件统计 | 视图及数值字段；写统计函数、条件和终端 | 验收统计值与显示位置 | [统计](../form/guide-list-stats.md) |
+| 视图数据条件 | 只展示符合业务条件的记录 | 视图及过滤字段；写条件与适用范围 | 筛选不代替权限；验收不同记录的展示 | [视图](../form/guide-form-view.md) |
+| 普通分组 | 按字段归类台账数据 | 视图；写分组字段与展开方式 | 与上下级树形展示分开；验收分组结果 | [视图](../form/guide-form-view.md) |
+| 上下级展示 | 按自关联字段显示层级 | 视图；写父级字段与展开层数 | 验收真实父子关系 | [视图](../form/guide-form-view.md) |
+| 表单或视图按钮 | 打开目标视图、流程或页面 | 写位置、目标、当前行过滤与预填映射 | 行上与右上角分别规划；验收点击效果 | [按钮](../form/guide-form-button.md) |
+| 行点击事件 | 点击整行后打开目标布局/页面 | 视图；写目标和打开方式 | 与按钮事件分开；验收点击行 | [视图](../form/guide-form-view.md) |
+| 字段点击事件 | 点击指定列打开记录 | 列及视图；写目标、宽度和打开方式 | 与整行事件分开；验收点击列 | [视图](../form/guide-form-view.md) |
+| 关联页签 | 在表单侧展示相关视图数据 | 写目标视图、布局/终端、筛选映射和权限 | 验收目标与关联过滤 | [关联页签](../form/guide-form-association.md) |
+
+### 流程与自动化
+
+| 功能配置项 | 需求场景与解决的问题 | 依赖；计划写明 | 能力边界；简要验收 | 详见 |
+|---|---|---|---|---|
+| 节点与连线 | 表达审批顺序、分支及汇合 | 写全部节点、出口和默认路径 | 结构改完排版；验收真实拓扑 | [流程](../workflow/guide-workflow.md) |
+| 节点操作者 | 确定审批人、角色、字段或矩阵来源 | 逐节点写来源与会签/竞签方式 | 节点名称不决定操作者；验收实际命中 | [流程](../workflow/guide-workflow.md) |
+| 出口条件 | 根据表单或系统字段选择路径 | 写字段来源、操作符、值、AND/OR 与明细量词 | 逐条读回并核对路由 | [条件](../workflow/guide-workflow-condition.md) |
+| 节点字段权限 | 不同审批节点显示或编辑不同字段 | 节点和字段；写隐藏、只读、必填等 | 验收节点布局状态 | [节点布局](../workflow/guide-workflow-node-layout.md) |
+| 节点校验 | 提交时判断字段合规 | 节点和字段；写条件及提示 | 验收提交场景 | [流程](../workflow/guide-workflow.md) |
+| 流程编号 | 为流程生成业务编号 | 流程；写前缀、年份、流水位数 | 与表单复杂编号分开；验收生成值 | [流程](../workflow/guide-workflow.md) |
+| 权责表场景 | 将分支说明、条件与审批路径集中维护 | 权责表；逐场景写条件和节点顺序 | 验收每条场景路径 | [权责表](../workflow/guide-workflow-auth-resp.md) |
+| 权责表变量映射 | 复用独立权责表时接入实际表单 | 变量及主/明细字段；逐项写对应关系 | 随流程新建直接用表单字段；复用时验收映射 | [权责表](../workflow/guide-workflow-auth-resp.md) |
+| 公文设置 | 配置正文、痕迹、编号、附件和归档等要求 | 公文流程；按实际要求逐项列出 | 按各项支持状态读回核对 | [公文设置](../workflow/guide-workflow-odoc-setting.md) |
+| 节点字段赋值 | 提交节点时更新本表字段 | 节点及目标字段；写赋值来源 | 与跨表动作流分开；验收字段结果 | [动作流](../workflow/guide-workflow-action.md) |
+| 跨表动作流 | 新增、更新或删除其他表数据 | 写触发、源/目标映射及更新定位 | 验收目标记录变化 | [动作流](../workflow/guide-workflow-action.md) |
+
+### 报表、菜单与页面
+
+| 功能配置项 | 需求场景与解决的问题 | 依赖；计划写明 | 能力边界；简要验收 | 详见 |
+|---|---|---|---|---|
+| 报表设计 | 根据数据集搭建报表布局和汇总 | 写字段映射、单元格及聚合方式 | 验收报表实际展示 | [报表创建](../report/guide-report-build.md) |
+| 报表查询 | 提供搜索与筛选 | 报表字段；写查询条件与默认值 | 验收筛选结果 | [报表查询](../report/guide-report-query.md) |
+| 报表权限 | 限定共享与查看范围 | 报表；写授权主体 | 验收权限读回及实际访问 | [报表权限](../report/report-permission-guide.md) |
+| 菜单绑定 | 将视图、流程或页面加入导航 | 目标资源；写层级、名称和目标 | 菜单不创建目标资源；验收点击去向 | [菜单](../menu/system-menus.md) |
+| 菜单权限 | 限定导航入口可见人群 | 菜单；写角色/部门/人员 | 与目标资源权限分别验收 | [命令](ref-cli-commands.md) |
+| 配置式页面 | 使用设计器组件组织展示与交互 | 写数据源、组件、布局和终端 | 验收 PC/MOBILE 布局与数据 | [设计器](../ebuilder-designer/guide-designer.md) |
+| 定制页面 | 实现标准配置之外的交互 | 写目标范围、页面代码和发布入口 | 验收实际加载与交互 | [页面编码](../coding/guide-page-code.md)、[导出发布](../coding/guide-page-export.md) |
+
+## 三、易混能力选择
+
+| 需求要改变的结果 | 规划选择 |
+|---|---|
+| 有一张持久化的业务表 | EB 表单；以已有来源组合展示时评估虚拟表 |
+| 新建业务审批 | 默认 EB 表单与应用内流程；明确要求原生工作流程或流程中心时选择原生路径；公文再加专属设置 |
+| 审批路线由多组条件决定 | 普通流程用节点与出口条件；要求矩阵式分支维护或复用时规划权责表 |
+| 选择其他业务对象并带出字段 | 对应原生关联字段负责选择；字段带出/函数联动负责赋值；关联页签负责侧面展示相关记录 |
+| 控制记录可见范围 | 表单/视图权限；列表数据条件负责视图展示筛选 |
+| 展示表单数据给用户 | 默认台账或新增视图；菜单负责导航入口；报表用于多源统计与专门报表布局 |
+| 点击按钮打开关联任务或发起流程 | 视图按钮或表单按钮，逐项写目标、当前行过滤与预填映射 |
+| 复杂自动写入其他表 | 动作流，写清触发、字段映射及目标记录定位；单纯本表计算选公式/联动 |
+| 标准配置无法表达的页面交互 | 明确目标范围后规划配置式页面或定制页面，并单列发布和交互验收 |
+
+## 四、常见依赖与计划顺序
+
+这些是依赖关系，不替代 [计划模板](guide-plan-template.md)的三段执行规则。已有且符合要求的资源可复用，按真实 ID 解除依赖。
+
+```text
+环境/机构 → 主应用与角色 → 表单/字段/明细 → 布局与默认台账 → 视图/权限/按钮
+数据源与目标表单 → 关联字段/虚拟表 → 联动、筛选与关联页签
+表单字段 → 流程/节点/连线 → 操作者/条件/节点配置 → 动作流
+独立权责表变量 + 流程表单字段 → 变量映射；随流程新建权责表则直接使用表单字段
+数据集与精确字段 → 报表设计 → 查询与共享
+目标视图/流程/页面 → 菜单绑定 → 页面入口验收
+```
+
+流程创建后产生的 ID 若被表单或视图按钮依赖，先在 plan 标明依赖，再在流程段回填。跨表循环引用可先建立独立骨架，待两侧资源存在后补关联。流程拓扑调整后按[流程指南](../workflow/guide-workflow.md)处理布局。
+
+## 五、规划预检
+
+| 检查点 | 在 plan 中如何处理 |
+|---|---|
+| 业务含义不清 | 写出不同解释会改变的字段、权限或路由，提出具体确认问题 |
+| 文档内容冲突 | 标出原文位置和受影响配置，待用户确认后定稿 |
+| 资源新建/复用不明 | 只读盘点同名资源、归属和 ID；不能唯一确定时标“待环境核查”或请用户选择 |
+| 布局或字段来源缺失 | 确认 FLOW/EXCEL、样表结构、目标字段和关联来源；保留可确认内容 |
+| 环境能力尚未核实 | 列最小查询/验证动作，保持“待环境核查”，不直接判为无法实现 |
+| 仅能部分配置 | 分别列可完成部分与需页面/其他系统补充部分，注明责任和验收方式 |
+| 已确认无法实现 | 原需求项保持 `[ ]`，在 plan 第 8 节记录原因、影响及待用户决定的处理 |
+| 验收标准不足 | 给关键配置写读回字段与一个典型页面/业务结果，避免只凭保存成功销号 |
+
+规划结果应能回答：要建或复用哪些资源、每条需求落在哪个配置项、依赖顺序是什么、哪些信息须确认、哪些需环境核查、哪些只能部分实现，以及如何判断关键结果生效。最终清单与逐项销号使用[计划模板](guide-plan-template.md)。