菜单与权限
菜单层级
sys_menu 的一级目录是模块,和「首页」一起显示在顶部导航;模块下可以再建不填路由地址的二级目录作为侧边栏分组,页面地址仍是完整路径。电商的页面地址统一为 /ecom/<页面>,模块只是导航上的归类:
| 模块 | 分组 |
|---|---|
商品管理 /product | 商品资料、刊登定价、产品开发 |
订单管理 /order | 订单处理、售后客服、订单设置 |
运营管理 /ops | 店铺管理、广告管理、运营监控、数据分析、智能运营 |
物流管理 /logistics | 头程物流、FBA、海外仓 |
供应链 /scm | 补货采购、1688 采购、批发销售、往来单位、进销存报表 |
仓库管理 /wms | 库存作业、库存查询、库存控制、基础资料 |
财务管理 /fin | 平台结算、总账、应收应付、资金与费用、资产与成本、预算与分析、期末与设置 |
| 智能、流程中心、系统管理、系统监控 | - |
登录后前端请求 /auth/menus,按菜单的 component(相对 lemon-web/src/views,如 ecom/order/index)动态注册路由。

新增页面的步骤
- 菜单:在
sql/init.sql的sys_menu中登记页面(类型C,父菜单为所在分组,组件路径ecom/foo/index)和按钮(类型F,权限标识如ecom:foo:list/add/edit/remove)。菜单 ID 按所在区段选择不冲突的值。 - 接口权限:Controller 方法加
@PreAuthorize("@ss.hasPerm('ecom:foo:list')"),增删改加@OperLog。 - 按钮权限:前端用
v-perm="'ecom:foo:add'",操作列用TableActions的perm属性。 - 内置角色授权:在
sys_role_menu中给超级管理员以外需要的内置角色(电商运营、总经理、普通用户只读等)勾选页面和按钮;勾选页面会连带所在分组和模块。 - 功能模块:放在已有分组下的页面自动归入对应功能模块;放在新位置时要在
SysFeatureCatalog中登记,TenantTests.industryTemplate会检查每个页面都属于某个模块。 - 英文名称:在
locales/en-US/menu.js中按菜单 ID 补英文。 - 首页待办(可选):实现
framework/todo/TodoProvider,链接带筛选参数(如/ecom/order?localStatus=EXCEPTION),页面在onMounted中按参数筛选。
已有库通过升级脚本插入菜单与授权:按菜单编码 / 权限标识用 NOT EXISTS 保证可重复执行,不依赖自增 ID。
直接改库后要清理权限缓存(Redis 中的 login:perms:*)。
角色与数据权限

- 角色的「菜单权限」决定功能,「数据权限」决定可见部门;电商数据另按店铺授权过滤,见 权限与店铺数据权限。
- 查询需要按部门隔离的单据:表里加
dept_id、create_by,查询方法加@DataPermission(table, deptColumn, userColumn)。新的电商表只要有store_id列就会自动按店铺过滤。