1 Star 0 Fork 1.1K

yanpj / youlai-mall

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0


有来商城官方文档 | 有来技术团队博客

在线预览 | 移动H5在线预览

Github | Gitee | GitCode

🈶 项目介绍

🗁 项目简介

youlai-mall 是基于Spring Boot 2.7、Spring Cloud 2021 & Alibaba 2021、Vue3、Element-Plus、uni-app等主流技术栈构建的一整套全栈开源商城项目, 涉及 后端微服务前端管理微信小程序APP应用 等多端的开发。

🗁 项目特色

  • 项目使用皆是当前主流前后端技术栈(持续更新...),无过度自定义封装,易理解学习和二次扩展;
  • 极速启动,在IDEA和Java环境OK的情况下1分钟之内可正常启动微服务,可以快速拥有微服务环境和上手微服务;
  • SpringBoot 2.6、SpringCloud 2021 & Alibaba 2021 一站式微服务开箱即用的解决方案;
  • Spring Security OAuth2 、 Spring Cloud Gateway 、 JWT 统一认证鉴权和常用 OAuth2 授权模式扩展;
  • 移动端采用终极跨平台解决方案 uni-app, 一套代码编译iOS、Android、H5和小程序等多个平台;
  • Jenkins、K8s、Docker实现微服务持续集成与交付(CI/CD)。

🗁 项目预览

「App」Spring Security OAuth2 手机短信验证码模式 「小程序」Spring Security OAuth2 微信授权模式
「管理前端」Spring Security OAuth2 密码模式 「管理前端」Spring Security OAuth2 验证码模式

🏠️ 源码地址

Gitee Github
微服务后端 youlai-mall youlai-mall
管理前端 mall-admin-web mall-admin-web
小程序/H5/移动端 mall-app mall-app
vue3-element-admin vue3-element-admin vue3-element-admin

🏘️ 开源社区

Gitee Github GitCode
开源组织 有来开源组织 有来开源组织 有来开源组织
技术团队 有来技术团队 有来技术团队 -

🚤 项目启动

🗁 后端启动

极速启动 是方便快速启动查看效果的启动方式,其中的数据库和Redis等中间件使用的是有来提供的云环境,切勿修改数据,有时间条件建议本地启动

1️⃣ 极速启动

  1. 启动 Nacos
  • IDEA 打开命令行终端 Terminal,输入 cd middleware/nacos/bin 切换到 Nacos 的 bin 目录,执行 startup -m standalone 启动 Nacos 服务。
  1. 服务启动

    • youlai-gateway 模块的启动类 GatewayApplication 启动网关;

    • youlai-auth 模块的启动类 AuthApplication 启动认证中心;

    • youlai-adminadmin-boot 模块的启动类 AdminApplication 启动系统服务;

    • 至此完成基础服务的启动,商城服务按需启动,启动方式和 youlai-admin 一致;

    • 访问接口文档地址测试: http://localhost:9999/doc.html

2️⃣ 本地启动

  1. 中间件安装

    为了避免数据和线上环境冲突,MySQL 和 Redis 必装,其他不安装可默认使用有来线上环境(🔴必装 ⚪可选)

  2. 数据库创建和数据初始化

    • 系统数据库

      进入 docs/sql 目录 , 根据 MySQL 版本选择对应的脚本;

      先执行 database.sql 完成数据库的创建;

      再执行 youlai.sqlmall_*.sql 完成数据表的创建和数据初始化。

    • Nacos 数据库

      创建名为 nacos 的数据库,执行 middleware/nacos/conf/nacos-mysql.sql 脚本完成 Nacos 数据库初始化。

  3. Nacos 配置持久化至 MySQL

    进入项目的 middleware/nacos/conf/application.properties 文件修改 Nacos 配置的数据连接,需要修改配置如下:

    spring.datasource.platform=mysql
    db.num=1
    db.url.0=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
    db.user.0=root
    db.password.0=123456
  4. 导入Nacos配置

    IDEA 打开命令行终端 Terminal,输入 cd middleware/nacos/bin 切换到 Nacos 的 bin 目录,执行 startup -m standalone 启动 Nacos 服务。

    打开浏览器,地址栏输入 Nacos 控制台的地址 http://localhost:8848/nacos

    输入用户名/密码:nacos/nacos ;

    进入控制台,点击左侧菜单 配置管理配置列表 进入列表页面,点击 导入配置 选择项目中的 docs/nacos/DEFAULT_GROUP.zip 文件。

  5. 修改Nacos配置

    在 Nacos 控制台配置列表选择共享配置 youlai-common.yaml 进行编辑,修改 MySQL、Redis、RabbitMQ等中间件信息为您自己本地环境,默认「有来」线上环境。

  6. 修改Nacos配置中心地址

    批量替换应用的 bootstrap-dev.yml 文件的配置中心地址 http://c.youlai.tech:8848http://localhost:8848 ,默认「有来」线上的配置中心地址。

  7. 服务启动

    • 进入 youlai-gateway 模块的启动类 GatewayApplication 启动网关;

    • 进入 youlai-auth 模块的启动类 AuthApplication 启动认证授权中心;

    • 进入 youlai-adminadmin-boot 模块的启动类 AdminApplication 启动系统服务;

    • 至此完成基础服务的启动,商城服务按需启动,启动方式和 youlai-admin 一致;

    • 访问接口文档地址测试: http://localhost:9999/doc.html

🗁 管理前端启动

  1. 本机安装 Node 环境
  2. npm install
  3. npm run dev
  4. 访问 http://localhost:9527

🗁 微信小程序启动

  1. 下载 HBuilder X微信开发者工具 ;
  2. 导入 mall-app 源码至 HBuilder X ;
  3. 微信公众平台申请小程序,获得小程序的AppID ;
  4. 微信开发者工具 微信扫码登录,开启服务端口,点击工具栏 设置 -> 安全设置 -> 安全 -> 服务端口选择打开 ;
  5. Hbuilder X 替换项目AppID成自己的,点击 manifest.json 文件->微信小程序配置 ;
  6. Nacos控制台替换 youlai-auth 配置中的微信小程序 AppID 和 AppSecret 为自己申请的小程序 ;
  7. Hbuilder X 工具栏点击 运行 -> 运行到小程序模拟器 -> 微信开发者工具

🗁 H5/移动端启动

  1. 下载 HBuilder X ;
  2. 导入 mall-app 源码至 HBuilder X;
  3. Hbuilder X 工具栏点击 运行 -> 运行到内置浏览器

✅ Git 贡献提交规范

IDEA 安装 Git Commit Template 插件

  • feat 增加新功能
  • fix 修复BUG
  • docs 文档/注释
  • style 代码风格改变但不影响运行结果(代码格式化、空格和空行调整等)
  • refactor 代码重构
  • test 测试
  • chore 依赖更新或配置修改
  • ci 持续集成

💹 趋势统计

🧑‍💻 贡献者

有来项目的存在离不开你们一直以来的贡献,真心感谢! 贴出人主页希望对你们有些许帮助,同样也希望更多的学习爱好者加入到开源学习平台。

💬 联系信息

欢迎添加开发者微信,备注「有来」进群

开发 开发 DevOps
Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided aInteger with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, aIntegerside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [2020-2022] [name of copyright 有来技术团队] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

youlai-mall是基于Spring Boot 2.7、Spring Cloud & Alibaba 、vue3、element-plus、uni-app构建的开源全栈微服务商城项目。 展开 收起
Java
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/ggxggx/youlai-mall.git
git@gitee.com:ggxggx/youlai-mall.git
ggxggx
youlai-mall
youlai-mall
master

搜索帮助