Yi.Admin/Yi.Vben5.Vue3/README.md

简介

基于 ruoyi-plus-vben & vben5 & ant-design-vue 的 Yi 框架前端项目

完全兼容意框架Yi.Admin rbac模块

组件/框架	版本
vben	5.5.6
ant-design-vue	4.2.6
vue	3.5.13

提示

该仓库使用vben5开发，采用分包目录结构, 实际开发路径为: 根目录/apps/web-antd

前端已同时兼容 Furion 规范化 API 响应 和 ABP 风格响应，可通过 apps/web-antd/.env 中的 VITE_GLOB_API_STYLE 配置响应风格：auto(默认)、furion、abp。

如果使用 Furion 规范化响应，可在 Yi.Abp.Net8/src/Yi.Abp.Web/YiAbpWebModule.cs 中开启相关配置。

Furion风格示例

{
    "statusCode": 200,
    "data": {"name": "du白","age": 20},
    "succeeded": true,
    "errors": null,
    "extras": null,
    "timestamp": 1770825190
}

ABP风格示例

// 成功响应
{ "name": "du白","age": 20}

// 异常响应
{
  "error": {
    "code": "string",
    "message": "string",
    "details": "string",
    "data": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "validationErrors": [
      {
        "message": "string",
        "members": [
          "string"
        ]
      }
    ]
  }
}

文档

ruoyi-vben 框架文档

VbenAdmin V5 文档地址

安装使用

前置准备环境(只能用pnpm)

"packageManager": "pnpm",
"engines": {
  "node": ">=20.15.0",
  "pnpm": "latest"
},

安装依赖

cd Yi.Vben5.Vue3

pnpm install

运行

pnpm dev:antd

打包

pnpm build:antd

这是一个特性 而不是一个bug!

1. 菜单管理可分配 但只有admin/superadmin角色能访问 其他角色访问会到403页面
2. 租户相关菜单可分配 但只有superadmin角色能访问 其他角色访问会到403页面
3. 分配的租户管理员无法修改自己的角色的菜单(即管理员角色的菜单) 防止自己把自己权限弄没了

Git 贡献提交规范

参考 vue 规范 (Angular)

• feat 增加新功能
• fix 修复问题/BUG
• style 代码风格相关无影响运行结果的
• perf 优化/性能提升
• refactor 重构
• revert 撤销修改
• test 测试相关
• docs 文档/注释
• chore 依赖更新/脚手架配置修改等
• workflow 工作流改进
• ci 持续集成
• types 类型定义文件更改
• wip 开发中

浏览器支持

最低适配应该为Chrome 88+以上浏览器 详见 css - where

本地开发推荐使用Chrome 最新版本浏览器

支持现代浏览器，不支持 IE

IE	Edge	Firefox	Chrome	Safari
not support	last 2 versions	last 2 versions	last 2 versions	last 2 versions