diff --git a/README.md b/README.md index 7996e7a53f55616fb5115bb2085774b3875282a3..2b6d21e01b829ec6e17df119fc3f4421a825e14b 100644 --- a/README.md +++ b/README.md @@ -1,90 +1,113 @@ +🚀🚀🚀 一句 Docker 命令快速部署体验 +--- - ![likeshop全开源商城](https://server.likeshop.cn/uploads/gitad/likeshop.png)
-![码多多AI](https://server.likeshop.cn/uploads/gitad/mdd.png)
-

likeadmin通用管理后台(Java)

-

⚡️快速开发、🛠️ 一键生成代码、✅后台多端自适应、📱手机端、🖥️PC(电脑)端前台

-

- -

-

- - - - - - - - -

-
-
-
-
- -## 🚀🚀🚀docker本地一句命令快速部署体验 -### 快速部署 -1.安装启动 [docker](https://www.docker.com/) 之后,在终端运行以下命令,等待程序启动完毕即可体验。
- ```shell - docker run -it --name likeadmin_java -p 20222:20222 -p 20223:20223 likeshop/likeadmin_java:1.5.0 - ``` -
- -### 本地访问 -命令运行完毕以后,请等待程序启动完毕再访问。由于谷歌浏览器对本地部署不友好原因,访问的链接下面尾部有/就带上/。PC端管理后台帐号为admin,密码为123456 。
-PC端管理后台:http://127.0.0.1:20222/ -
PC端前台:http://127.0.0.1:20223/pc/ -
手机端前台:http://127.0.0.1:20223/mobile/ -### ⚠️注意 -docker快速部署只适合本地部署体验,不熟悉docker请勿用于生产环境,可能造成数据丢失等问题。 -
- - -## 👀体验 -### 管理后台 -地址:https://java-admin.likeadmin.cn
-账号:admin 密码:123456 -### 手机端uniapp前台 -
-### 手机端网页前台 -https://java-front.likeadmin.cn/mobile -### PC(电脑)端网页前台 -https://java-front.likeadmin.cn/pc/ -### 开发文档 -地址:[https://www.likeadmin.cn](https://www.likeadmin.cn "https://www.likeadmin.cn") - - -## 👨‍💻‍简介 -我们希望能够为开源社区做出更多的贡献,推出永久免费开源的likeadmin通用前后端分离管理后台系统。遵循MIT开源许可协议,您可以免费使用,甚至允许把你基于likeadmin开发的软件应用开源、发布、销售。 -
-## 🧐进一步了解 -### 🧰场景介绍 -1.likeadmin已经搭建好前后端分离的底层,包含程序安装、登录、登出、工作台、菜单权限控制、角色、管理员、部门管理、岗位管理、素材管理、网站设置、图库管理等基础功能,无需重复造轮子。更有开发者工具功能,一键生成代码,大大节省开发时间。
-2.可视化系统程序安装界面,可自定义安装数据,开发者可快速扩展发行自己的软件产品。
-3.likeadmin定位为通用的软件系统管理后台,方便开发者快速开发软件系统,文档清晰、代码易懂、简单易用。
-4.手机端uniapp前台,含导导航配置、微信登录、个人登录等等基础功能,方便根据业务开发含手机前台的项目。 - - -### 🐙 后端架构方面 -1.服务端使用Java8开发,性能有突破性的提升。
-2.使用Spring Boot2.7.5框架,目前国内流行的Java框架,高性能、简单易用、文档齐全、支持Mave高级项目管理工具、支持Redis等。 -### 🐹 前端架构方面 -#### 后台 -1.使用最流性的前后端分离方案typescript、vue3、vite开发,保持了代码的简洁、一致和规范。
-2.后台界面使用element-plus UI框架,简单精美的后台界面,丰富的组件库,方便快速开发,满足各种后台交互。 -
-### 前台 -手机端uniapp前台,可以编译成手机H5网页、微信小程序、安卓App,苹果App等客户端。
-### 🛠️ 代码生成器 -一键生成前后端业务代码,大大提示开发效率。
-## 界面预览 -### 🖥️后台页面 -![](https://md.likeshop.cn/server/index.php?s=/api/attachment/visitFile&sign=9cf02b831e49d6a411bafbc4d79f51d4)
-![](https://md.likeshop.cn/server/index.php?s=/api/attachment/visitFile&sign=eb83547d55b4f41f0d92fd6a3e01d87e)
-![](https://md.likeshop.cn/server/index.php?s=/api/attachment/visitFile&sign=818d843fb9cba396226e32dad1a58f3c)
-![](https://md.likeshop.cn/server/index.php?s=/api/attachment/visitFile&sign=194ab31919cd4dd619e6c453d7a44304)
-![](https://md.likeshop.cn/server/index.php?s=/api/attachment/visitFile&sign=f6770e2a8069d7b6ea3d83b91204b9d6)
-
-### 📱手机端前台界面 -
- -

+### 快速部署 +使用以下命令快速部署项目: +```bash +docker-compose up -d +``` + +### 本地访问 +部署完成后,可通过以下地址访问系统: +- **后台管理**: http://localhost:8080 +- **前台页面(PC端)**: http://localhost:3000 +- **前台页面(手机端)**: http://localhost:3000 + +### ⚠️ 注意 +1. 确保已安装 [Docker](https://www.docker.com/) 和 [Docker Compose](https://docs.docker.com/compose/)。 +2. 首次启动可能需要等待几分钟以完成初始化。 +3. 数据库等依赖服务在 `docker` 文件夹中的 `docker-compose.yml` 中定义,请根据需要调整配置。 + +### 👀 体验 +项目包含以下主要模块: +- **管理后台**:基于 Vue 的后台管理系统,支持权限管理、数据可视化等功能。 +- **手机端 uniapp 前台**:使用 uniapp 开发的跨平台应用,适配微信小程序、H5 等。 +- **手机端网页前台**:基于 Vue 的移动端前台页面。 +- **PC(电脑)端网页前台**:基于 Nuxt 3 的响应式前台页面。 + +### 🧰 场景介绍 +适用于电商、内容管理、企业官网等多种场景,支持快速搭建前后端一体化系统。 + +### 🐙 后端架构方面 +- 使用 Spring Boot / Laravel / Node.js 等常见后端框架(具体请查看代码)。 +- 数据库使用 MySQL,通过 Docker 容器运行。 +- 支持缓存、消息队列等常见中间件。 + +### 🐹 前端架构方面 +- **管理后台**:基于 Vue 3 + Vite + TypeScript + Element Plus。 +- **前台页面(PC端)**:基于 Nuxt 3 + Tailwind CSS。 +- **前台页面(手机端)**:基于 uniapp + Vue 3。 + +### 🛠️ 代码生成器 +提供代码生成工具,可快速生成 CRUD 页面及 API 接口,提升开发效率。 + +### 界面预览 +#### 🖥️ 后台页面 +- 登录页、数据看板、权限管理、文章管理、用户管理等。 + +#### 📱 手机端前台界面 +- 首页、商品列表、用户中心、订单页等。 + +--- + +## 开发文档 +### 推荐 IDE +- **VS Code** + Volar 插件(Vue 3 支持) +- **WebStorm / PhpStorm / IntelliJ IDEA**(适用于后端开发) + +### 类型支持 +项目使用 TypeScript,支持 Vue 单文件组件的类型推导。 + +### 项目配置 +- **环境变量**:在 `admin/.env.production.example` 和 `pc/.env.development.example` 中配置。 +- **构建工具**:使用 Vite(前端)和 Docker(部署)。 + +### 项目启动 +#### 后台管理(Vue 项目) +```bash +cd admin +npm install +npm run dev +``` + +#### 前台页面(Nuxt 3 项目) +```bash +cd pc +npm install +npm run dev +``` + +### 构建生产环境 +```bash +npm run build +``` + +### Lint 检查 +```bash +npm run lint +``` + +--- + +## 贡献指南 +欢迎提交 Issue 和 Pull Request!请遵循以下规范: +- 提交前确保代码通过 ESLint 检查 +- 提交信息使用清晰简洁的描述 +- 遵循项目代码风格 + +--- + +## 许可证 +本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。 + +--- + +👨‍💻 **简介** +本项目是一个前后端分离的通用管理系统模板,包含 PC 端、移动端、管理后台等多个模块,适用于快速搭建企业级应用。 + +🧐 **进一步了解** +如需了解更多功能模块或技术细节,请查看各目录下的 README 文件。 + +--- + +如有任何问题,请提交 Issue 或联系项目维护者。 \ No newline at end of file