FGC-RBAC

标准化

前端权限框架所遵循的开发规范。

框架在开发过程中遵循统一的 UI、UX、命名和编码规范,以确保页面风格一致、交互可预测、逻辑可维护。

UI

  • 页面最小尺寸为 1120 × 592 像素
  • 单元格模度为 32px,间距默认 16px,且按照 50% 的倍数进行缩放
  • 行列仅覆盖必要元素,不增加无意义行列,剩余空间全部由「范围模式」或「自适应」填充
  • 全局默认使用 Element-Plus 组件
  • 所有表单统一使用「表单容器」,采用左右布局
  • 颜色优先从色盘中选取

UX

  • 仅维护当前主表数据的弹窗使用「抽屉」,其余衍生交互弹窗使用「对话框」
  • 所有涉及数据变动的操作均需提示,危险操作需要二次确认
  • 页面优先呈现主数据,辅助数据通过折叠隐藏或二级页面展示

命名

  • 页面名称与服务端命令作为 URL 的一部分,均采用英文命名。页面命名遵循名词在前、动词在后的规则,服务端命令反之
  • 单元格名称后缀为 Cell,表单名称后缀为 Form,相同元素组合后缀为 Group,信息呈现后缀为 Info,数组对象后缀为 Array
  • 表示多个元素组合的字符串统一使用复数形式,例如 idsusers

开发

  • 优先使用页面属性,避免隐藏行列
  • 采用事件驱动模式,将逻辑统一维护在一处,由事件触发器触发
  • 可被外部调用或可复用的功能模块,优先封装在组件中
  • 所有服务端命令均需提供功能描述,以便 MCP Server 调用
  • 调用服务端命令时,避免无意义的页面重新加载与数据校验

本页目录