# 菜单配置规范

## 配置目录

```
~/rui/rui-framework/data/menus/
```

## 文件命名

- `{模块编码}.json`
- 示例：`cashier.json`, `system.json`, `user.json`

## 文件格式

```json
{
  "name": "模块编码（与文件名一致）",
  "menus": [
    {
      "code": "菜单编码",
      "name": "菜单名称",
      "type": 1,
      "icon": "tabler:图标名",
      "sortNo": 0,
      "children": [
        {
          "code": "子菜单编码",
          "name": "子菜单名称",
          "type": 2,
          "icon": "tabler:图标名",
          "path": "/路由路径",
          "permission": "权限标识",
          "sortNo": 1,
          "buttons": [
            {
              "code": "btn:add",
              "name": "新增",
              "permission": "模块:功能:add"
            }
          ]
        }
      ]
    }
  ]
}
```

## 字段说明

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `code` | string | ✅ | 菜单编码，唯一标识 |
| `name` | string | ✅ | 菜单显示名称 |
| `type` | int | ✅ | 1=目录, 2=菜单, 3=按钮 |
| `icon` | string | ✅ | 图标（tabler: 前缀） |
| `path` | string | 菜单必填 | 路由路径 |
| `permission` | string | ✅ | 权限标识 |
| `sortNo` | int | ✅ | 排序号，越小越靠前 |
| `children` | array | 可选 | 子菜单列表 |
| `buttons` | array | 可选 | 按钮权限列表 |

## 初始化方式

- 由**超级租户**读取 JSON 配置并初始化到数据库
- 不需要编写 SQL 脚本或 Java 初始化代码
- 修改 JSON 后提交到 rui-framework 仓库即可