# 菜单注册: {{moduleName}}

> 模块: {{module}} | 实体: {{Entity}} | 基础路径: `/{{module}}/{{entity}}`

---

## 1. 菜单配置

| 配置项 | 值 | 说明 |
|--------|-----|------|
| 菜单名称 | {{moduleName}} | 显示在侧边栏的名称 |
| 父级菜单 | 根目录 / 按实际选择 | 菜单层级 |
| 排序 | 100 | 同级菜单排序，数字越小越靠前 |
| 图标 | el-icon-document | Element UI 图标名称 |
| 路由路径 | /{{module}}/{{entity}} | 前端路由 |
| 组件路径 | {{module}}/{{entity}}/index | Vue 组件路径 |

---

## 2. 路由配置

```javascript
// src/router/modules/{{module}}.js
export default {
  path: '/{{module}}',
  component: Layout,
  children: [
    {
      path: '{{entity}}',
      name: '{{Entity}}',
      component: () => import('@/views/{{module}}/{{entity}}/index.vue'),
      meta: {
        title: '{{moduleName}}',
        icon: 'document',
        keepAlive: true,
      },
    },
  ],
};
```

---

## 3. 权限标识

| 权限标识 | 描述 | 对应操作 |
|---------|------|---------|
| `{{module}}:{{entity}}:view` | 查看 | 列表页 + 详情 |
| `{{module}}:{{entity}}:add` | 新增 | 新增按钮 |
| `{{module}}:{{entity}}:edit` | 修改 | 编辑按钮 |
| `{{module}}:{{entity}}:delete` | 删除 | 删除按钮 |

---

## 4. SQL 插入语句

```sql
-- 菜单数据
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('{{moduleName}}', 0, 100, '/{{module}}/{{entity}}', '{{module}}/{{entity}}/index', 'C', '0', '0', '{{module}}:{{entity}}:view', 'document', 'admin', NOW(), '{{moduleName}}菜单');

-- 按钮权限
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES
-- 查看（@parentId 替换为上面插入的菜单 ID）
('{{moduleName}}查询', @parentId, 1, '#', '', 'F', '0', '0', '{{module}}:{{entity}}:view', '#', 'admin', NOW(), ''),
('{{moduleName}}新增', @parentId, 2, '#', '', 'F', '0', '0', '{{module}}:{{entity}}:add', '#', 'admin', NOW(), ''),
('{{moduleName}}修改', @parentId, 3, '#', '', 'F', '0', '0', '{{module}}:{{entity}}:edit', '#', 'admin', NOW(), ''),
('{{moduleName}}删除', @parentId, 4, '#', '', 'F', '0', '0', '{{module}}:{{entity}}:delete', '#', 'admin', NOW(), '');
```

> **注意**: 执行 SQL 前请先确认 `parent_id` 的值（根据实际父级菜单调整）。