模块引擎

模块引擎用于维护系统导航菜单配置数据。

新增模块

操作步骤

1. 进入 系统引擎 → 模块引擎（路由 /system-engine/module-engine）。

   

2. 点击【新增】按钮打开表单,填写中文标题、选择图标、按需填英文标题、父级、路由等，为后续对模块进行设计和访问请开启激活开关。

   

   字段说明：

   字段	说明
   中文标题	模块展示中文名称
   英文标题	多语言英文模式下展示的英文名称
   父级菜单	关联的上级菜单
   图标	导航栏、页签展示的图标
   路由	页面的路由
   模板类型	控制页面属性，支持类型：页面视图、数据视图、内嵌框架、表单模式
   打开方式	控制页面打开方式
   外链	打开外部链接的地址
   匿名访问	页面白名单，未登录也可访问
   是否激活	【否】状态只做模块数据存储，无法使用、访问该模块；【是】模块激活，可对模块设计、访问
   是否显示	是否显示到导航菜单
   代码	自定义页面代码

   模版类型：

   选项标签	值	运行效果
   页面视图	0	打开 PageView，按菜单加载整页 Vue
   数据视图	1	打开 DataView 标准列表；需再配列、按钮、搜索等
   内嵌框架	2	打开 IframeView，在 iframe 中加载外链
   表单模式	8	打开 FormView，以整页方式进入关联表单

   打开方式:

   选项标签	值	运行效果
   空	0	当前窗口打开，不经外层主框架
   框架	1	当前窗口打开，经主框架嵌套（默认常用）
   新窗口	2	浏览器新窗口打开，布局语义同「空」
   新窗口框架	3	浏览器新窗口打开，布局语义同「框架」
   命令行	4	不跳转路由，执行表单底部的 命令 前端脚本

3. 填写完成表单信息后点击【确定】按钮，新增成功后刷新页面显示新增模块。

模块设计

详见 模块设计

模块排序

侧栏与模块引擎树均按升序排列。

方式	操作	说明
拖拽排序（推荐）	在模块引擎列表中拖动行	已启用拖拽排序，排序字段为 order（f_order）
改父级	编辑表单中的「父级菜单」	节点挂到新父级下；同级顺序仍由 f_order 决定
MCP / 接口	patch_menu 传 order	适合批量或脚本调整

注意：同级比较order；跨父级时先改父级，再在该父级下拖拽调整。

编辑模块

1. 在模块引擎树/列表中选中一行，单击操作列【编辑】按钮。
2. 在 模块引擎 表单中修改标题、父级、路由、模版类型、打开方式等。
3. 保存后刷新侧栏确认。
4. 若改了模版类型或路由，需同步检查列表模板、页面或外链是否仍匹配；权限按菜单 id 授权，一般不必重授。

删除模块

1. 选中要删除的菜单节点，单击操作列【删除】按钮，按提示确认。
2. 有子菜单时，须先处理子节点（移走或删除），否则删除会失败或留下孤儿节点（以运行态校验为准）。
3. 删除菜单不会自动删除关联的列表模板、页面代码或表单定义；删除前确认无业务入口仍依赖该菜单。
4. 删除后在角色权限中清理对应该菜单的授权。

常见问题

侧栏看不到新菜单

检查「是否显示」「是否激活」、父级是否正确，以及当前角色是否已授权该菜单。

点击无反应或打开空白

核对模版类型与打开方式：数据视图需有模板；页面视图需有 t_page；内嵌框架需外链可用；命令行需填写命令脚本。

拖拽后顺序不对

确认拖的是同级节点；跨父级应先改「父级菜单」再拖拽。