标准化
前端权限框架所遵循的开发规范。
框架在开发过程中遵循统一的 UI、UX、命名和编码规范,以确保页面风格一致、交互可预测、逻辑可维护。
UI
- 页面最小尺寸为 1120 × 592 像素
- 单元格模度为 32px,间距默认 16px,且按照 50% 的倍数进行缩放
- 行列仅覆盖必要元素,不增加无意义行列,剩余空间全部由「范围模式」或「自适应」填充
- 全局默认使用 Element-Plus 组件
- 所有表单统一使用「表单容器」,采用左右布局
- 颜色优先从色盘中选取
UX
- 仅维护当前主表数据的弹窗使用「抽屉」,其余衍生交互弹窗使用「对话框」
- 所有涉及数据变动的操作均需提示,危险操作需要二次确认
- 页面优先呈现主数据,辅助数据通过折叠隐藏或二级页面展示
命名
- 页面名称与服务端命令作为 URL 的一部分,均采用英文命名。页面命名遵循名词在前、动词在后的规则,服务端命令反之
- 单元格名称后缀为
Cell,表单名称后缀为Form,相同元素组合后缀为Group,信息呈现后缀为Info,数组对象后缀为Array - 表示多个元素组合的字符串统一使用复数形式,例如
ids、users
开发
- 优先使用页面属性,避免隐藏行列
- 采用事件驱动模式,将逻辑统一维护在一处,由事件触发器触发
- 可被外部调用或可复用的功能模块,优先封装在组件中
- 所有服务端命令均需提供功能描述,以便 MCP Server 调用
- 调用服务端命令时,避免无意义的页面重新加载与数据校验