diff --git a/README.md b/README.md deleted file mode 100644 index b6a6066..0000000 --- a/README.md +++ /dev/null @@ -1,244 +0,0 @@ -
- -

SoybeanAdmin

- 中文 | English -
- ---- - -[![license](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE) -[![github stars](https://img.shields.io/github/stars/honghuangdc/soybean-admin)](https://github.com/soybeanjs/soybean-admin) -[![github forks](https://img.shields.io/github/forks/honghuangdc/soybean-admin)](https://github.com/soybeanjs/soybean-admin) -[![gitee stars](https://gitee.com/honghuangdc/soybean-admin/badge/star.svg)](https://gitee.com/honghuangdc/soybean-admin) -[![gitcode star](https://gitcode.com/soybeanjs/soybean-admin/star/badge.svg)](https://gitcode.com/soybeanjs/soybean-admin) - -
- soybeanjs%2Fsoybean-admin | Trendshift - Featured｜HelloGitHub -
- -> [!NOTE] -> 如果您觉得 `SoybeanAdmin`对您有所帮助，或者您喜欢我们的项目，请在 GitHub 上给我们一个 ⭐️。您的支持是我们持续改进和增加新功能的动力！感谢您的支持！ - -> [!NOTE] -> `SoybeanAdmin` 快速上手系列视频已在 [Bilibili](https://www.bilibili.com/video/BV1YKdRYXELC) 上线 [点击这里](https://www.bilibili.com/video/BV1YKdRYXELC) 前往查看 - -> [!WARNING] -> `SoybeanAdmin` 正在计划开发 `V2` 版本，详情见[计划清单](https://github.com/soybeanjs/soybean-admin/issues/767) - -## 简介 - -[`SoybeanAdmin`](https://github.com/soybeanjs/soybean-admin) 是一个清新优雅、高颜值且功能强大的后台管理模板，基于最新的前端技术栈，包括 Vue3, Vite7, TypeScript, Pinia 和 UnoCSS。它内置了丰富的主题配置和组件，代码规范严谨，实现了自动化的文件路由系统。此外，它还采用了基于 ApiFox 的在线Mock数据方案。`SoybeanAdmin` 为您提供了一站式的后台管理解决方案，无需额外配置，开箱即用。同样是一个快速学习前沿技术的最佳实践。 - -## 特性 - -- **前沿技术应用**：采用 Vue3, Vite7, TypeScript, Pinia 和 UnoCSS 等最新流行的技术栈。 -- **清晰的项目架构**：采用 pnpm monorepo 架构，结构清晰，优雅易懂。 -- **严格的代码规范**：遵循 [SoybeanJS 规范](https://docs.soybeanjs.cn/zh/standard)，集成了eslint, prettier 和 simple-git-hooks，保证代码的规范性。 -- **TypeScript**： 支持严格的类型检查，提高代码的可维护性。 -- **丰富的主题配置**：内置多样的主题配置，与 UnoCSS 完美结合。 -- **内置国际化方案**：轻松实现多语言支持。 -- **自动化文件路由系统**：自动生成路由导入、声明和类型。更多细节请查看 [Elegant Router](https://github.com/soybeanjs/elegant-router)。 -- **灵活的权限路由**：同时支持前端静态路由和后端动态路由。 -- **丰富的页面组件**：内置多样页面和组件，包括403、404、500页面，以及布局组件、标签组件、主题配置组件等。 -- **命令行工具**：内置高效的命令行工具，git提交、删除文件、发布等。 -- **移动端适配**：完美支持移动端，实现自适应布局。 - - -## 版本 - -- **NaiveUI 版本:** - - [预览地址](https://naive.soybeanjs.cn/) - - [Github 仓库](https://github.com/soybeanjs/soybean-admin) - - [Gitee 仓库](https://gitee.com/honghuangdc/soybean-admin) - - [Gitcode 仓库](https://gitcode.com/soybeanjs/soybean-admin) -- **AntDesignVue 版本:** - - [预览地址](https://antd.soybeanjs.cn/) - - [Github 仓库](https://github.com/soybeanjs/soybean-admin-antd) - - [Gitee 仓库](https://gitee.com/honghuangdc/soybean-admin-antd) - - [Gitcode 仓库](https://gitcode.com/soybeanjs/soybean-admin-antd) -- **ElementPlus 版本:** - - [预览地址](https://elp.soybeanjs.cn/) - - [Github 仓库](https://github.com/soybeanjs/soybean-admin-element-plus) - - [Gitee 仓库](https://gitee.com/honghuangdc/soybean-admin-element-plus) - - [Gitcode 仓库](https://gitcode.com/soybeanjs/soybean-admin-element-plus) -- **旧版:** - - [预览地址](https://legacy.soybeanjs.cn/) - - [Github 仓库](https://github.com/soybeanjs/soybean-admin/tree/legacy) - - [Gitee 仓库](https://gitee.com/honghuangdc/soybean-admin/tree/legacy) - - [Gitcode 仓库](https://gitcode.com/soybeanjs/soybean-admin/tree/legacy) - - -## 文档 - -- [地址](https://docs.soybeanjs.cn) -- [旧版文档](https://legacy-docs.soybeanjs.cn) - - -## 合作事项 - -我们非常感谢大家对 [`SoybeanAdmin`](https://github.com/soybeanjs/soybean-admin) 的支持！为了进一步回馈社区，并助力企业和开发者实现个性化需求，我们现提供多种合作服务，期待与您携手共赢。 - -##### 1、定制化管理后台开发 - -针对企业和开发者的特定业务需求，我们提供基于 [`SoybeanAdmin`](https://github.com/soybeanjs/soybean-admin) 的定制化管理后台开发服务。我们的团队具备丰富的行业经验，能够迅速理解并实现您的需求，打造高效、灵活且安全的定制化解决方案。 - -- **定制开发**：我们将根据您的具体需求，提供从需求分析、UI设计到功能实现的全方位服务，确保项目高效交付。 -- **功能扩展**：在 [`SoybeanAdmin`](https://github.com/soybeanjs/soybean-admin) 基础上，扩展您所需的特定功能模块，提升管理后台的功能和用户体验。 - -##### 2、企业外包服务 - -我们承接各类企业级外包项目，特别是在管理后台系统的开发、集成与运维方面。我们以精益求精的态度，确保项目的质量和进度，为您的业务提供强有力的技术支持。 - -- **项目开发**：无论是全新的项目，还是现有系统的优化与集成，我们都将为您量身打造高效可靠的解决方案。 -- **系统集成与维护**：我们也提供基于 [`SoybeanAdmin`](https://github.com/soybeanjs/soybean-admin) 的系统集成与长期维护服务，确保您的系统稳定、安全地运行。 - -##### 3、联系方式 - -如有合作意向或项目咨询，请通过以下方式与我们联系： - -- **Email**: [soybeanjs@outlook.com](mailto:soybeanjs@outlook.com) -- **GitHub Issues**: 欢迎通过 [GitHub Issues](https://github.com/soybeanjs/soybean-admin/issues/new) 联系我们，进行初步的合作洽谈。 -- **商务合作微信**: honghuangdc - -期待与您开展深入合作，共同推动 SoybeanAdmin 项目及其在更多领域的成功应用！ - - -## 示例图片 - -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-01.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-02.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-03.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-04.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-05.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-06.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-07.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-08.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-09.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-10.png) -![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-mobile.png) - - -## 使用 - -**环境准备** - -确保你的环境满足以下要求： - -- **git**: 你需要git来克隆和管理项目版本。 -- **NodeJS**: >=20.19.0，推荐 20.19.0 或更高。 -- **pnpm**: >= 10.5.0，推荐 10.5.0 或更高。 - -**克隆项目** - -```bash -# github -git clone https://github.com/soybeanjs/soybean-admin.git -# gitee -git clone https://gitee.com/honghuangdc/soybean-admin.git -# gitcode -git clone https://gitcode.com/soybeanjs/soybean-admin.git -``` - -**安装依赖** - -```bash -pnpm i -``` -> 由于本项目采用了 pnpm monorepo 的管理方式，因此请不要使用 npm 或 yarn 来安装依赖。 - -**启动项目** - -```bash -pnpm dev -``` - -**构建项目** - -```bash -pnpm build -``` - -**代码同步** - -参考 [代码同步](https://docs.soybeanjs.cn/zh/guide/sync) 文档。 - -## 周边生态 - -- [skyroc-admin](https://github.com/Ohh-889/skyroc-admin): SoybeanAdmin的React版本实现. -- [electron-mock-admin](https://github.com/lixin59/electron-mock-api): 一个 Mock Api 管理系统，帮助前端开发伙伴快速实现接口的 mock。 -- [T-Shell](https://github.com/TheBlindM/T-Shell): 是一个可配置命令提示的终端模拟器和 SSH 客户端。 -- [pea](https://github.com/haitang1894/pea) : 采用SpringBoot3.2 + JDK21、MyBatis-Plus、SpringSecurity安全框架等，适配 [soybean-admin](https://gitee.com/honghuangdc/soybean-admin) 开发的简单权限系统。 -- [MalusAdmin](https://github.com/pridejoy/MalusAdmin): 基于 Vue3/TypeScript/NaiveUI 和 NET7 & Sqlsugar 开发的后台管理框架。采用最原生最简洁的方式来实现, 前端清新优雅高颜值，后端 结构清晰，优雅易懂，功能强大。 -- [PanisAdmin](https://github.com/paynezhuang/panis-admin): 采用SpringBoot3、SaToken、MySQL等框架开发，二次修改 [soybean-admin](https://github.com/soybeanjs/soybean-admin)，适配动态菜单/按钮级别的鉴权，保留原汁原味、清新优雅、高颜值的后台管理系统脚手架。 -- [snail-job](https://github.com/aizuda/snail-job): 一款兼具 “高性能、高颜值、高活跃” 的分布式任务重试和分布式任务调度平台。 -- [SuperApi](https://github.com/TmmTop/SuperApi): 快速将你的 idea 变成线上稳定运行的产品！ 无实体建库建表，对无实体库表进行增删改查，支持 15 种条件查询，以及分页，列表，无限级树形列表 等功能的 API 部署！ 拥有接口文档，Auth 授权，接口限流，获取客户端真实 IP，先进的服务器缓存组件，动态 API 等功能，期待您的体验！ -- [FastSoyAdmin](https://github.com/sleep1223/fast-soy-admin): 基于 FastAPI+Vue3+Naive UI 的现代化轻量管理平台. -- [ba](https://github.com/xiatianYa/Ba-Server): 基于goFrame框架开发的后端服务对接soybean-admin,适配动态路由,接口鉴权限。 -- [soybean-admin-go](https://github.com/WgoW/soybean-admin-go):基于gin+gorm框架开发的go语言后端服务对接soybean-admin的example分支,适配动态路由,接口鉴权限。 - -更多周边生态请翻阅 [周边生态](https://docs.soybeanjs.cn/zh/awesome) 文档。 - - -## 如何贡献 - -我们热烈欢迎并感谢所有形式的贡献。如果您有任何想法或建议，欢迎通过提交 [pull requests](https://github.com/soybeanjs/soybean-admin/pulls) 或创建 GitHub [issue](https://github.com/soybeanjs/soybean-admin/issues/new) 来分享。 - -## Git 提交规范 - -本项目已内置 `commit` 命令，您可以通过执行 `pnpm commit` 来生成符合 [Conventional Commits]([conventionalcommits](https://www.conventionalcommits.org/)) 规范的提交信息。在提交PR时，请务必使用 `commit` 命令来创建提交信息，以确保信息的规范性。 - - -## 浏览器支持 - -推荐使用最新版的 Chrome 浏览器进行开发，以获得更好的体验。 - -| [IE](http://godban.github.io/browsers-support-badges/) | [ Edge](http://godban.github.io/browsers-support-badges/) | [Firefox](http://godban.github.io/browsers-support-badges/) | [Chrome](http://godban.github.io/browsers-support-badges/) | [Safari](http://godban.github.io/browsers-support-badges/) | -| --- | --- | --- | --- | --- | -| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions | - -## 开源作者 - -[Soybean](https://github.com/honghuangdc) - - -## 贡献者 - -感谢以下贡献者的贡献。如果您想为本项目做出贡献，请参考 [如何贡献](#如何贡献)。 - - - - - ---- - -以下是近一年中活跃度较高的贡献者，感谢各位的支持，让项目得以持续发展。 - - - Contribution Leaderboard - - -## 交流 - -`SoybeanAdmin` 是完全开源免费的项目，在帮助开发者更方便地进行中大型管理系统开发，同时也提供微信和 QQ 交流群，使用问题欢迎在群内提问。 - -
-

QQ交流群

- -
- -
-

添加下面微信邀请进微信群

- -
- -## Star 趋势 - -[![Star History Chart](https://api.star-history.com/svg?repos=soybeanjs/soybean-admin&type=Date)](https://star-history.com/#soybeanjs/soybean-admin&Date) - -## 开源协议 - -项目基于 [MIT © 2021 Soybean](./LICENSE) 协议，仅供学习参考，商业使用请保留作者版权信息，作者不保证也不承担任何软件的使用风险。