diff --git a/README.md b/README.md index c0bfcd39..e7591727 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # 启航电商OMS订单处理系统 -## 介绍 +## 一、介绍 启航电商OMS订单处理系统是一套为中小电商企业构建的一套简单实用的第三方平台订单处理系统,本项目后端采用SpringCloudAlibaba 微服务架构,前端采用Vue3开发。 支持多平台店铺,目前支持:淘宝、京东、拼多多、抖店。后续计划支持快手、小红书等。 @@ -9,7 +9,31 @@ 后续计划推出订单打单(电子面单打印)功能。 -## 主体功能 + +## 二、软件架构 +### 1、后端 ++ jdk:17 ++ SpringBoot:3.0.2 + + spring-boot-starter-security ++ SpringCloudAlibaba:2022.0.0.0 + + Nacos + + SpringCloud Gateway + + spring-cloud-starter-loadbalancer + +### 2、前端 ++ vue3 + element + +### 3、存储 ++ MySQL8 + +### 4、中间件 ++ Redis:7.x(缓存:在线用户、字典、系统配置) ++ Nacos:2.2.0(配置中心、注册中心) ++ Sentinel(分布式流量治理组件) + + `java -Dserver.port=8888 -Dcsp.sentinel.dashboard.server=localhost:8888 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard.jar` + +## 三、主体功能 ### 1、订单管理 + 从平台同步订单 @@ -36,81 +60,54 @@ + 发货地址库 + 发货物流公司库 - - -## 软件架构 -### 1、后端 -+ jdk:17 -+ SpringBoot:3.0.2 - + spring-boot-starter-security -+ SpringCloudAlibaba:2022.0.0.0 - + Nacos - + SpringCloud Gateway - + spring-cloud-starter-loadbalancer - -### 2、前端 -+ vue3 + element - -### 3、存储 -+ MySQL8 - -### 4、中间件 -+ Redis:7.x(缓存:在线用户、字典、系统配置) -+ Nacos:2.2.0(配置中心、注册中心) -+ Sentinel(分布式流量治理组件) - - `java -Dserver.port=8888 -Dcsp.sentinel.dashboard.server=localhost:8888 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard.jar` - -## 项目说明 -### core +## 四、项目说明 +### 1、项目结构 +#### 1.1 core 项目公共模块包括: -#### common -公共类型 -#### security -公共权限验证模块 ++ `common`:公共类型 -### api ++ `security`:公共权限验证模块 + +#### 1.2 api 网关项目,负责微服务接口转发,前端统一通过网关调用其他微服务接口; -### sys-api +采用`gateway`进行api分发,引入Sentinel进行流量治理。 + +#### 1.3 sys-api oms项目系统微服务,主要功能包括: + + 用户 + 授权 + 菜单 + 公共配置 -### tao-api +#### 1.4 tao-api 淘宝开放平台接口api - - -### jd-api +#### 1.5 jd-api 京东开放平台接口api -### dou-api +#### 1.6 dou-api 抖店开放平台接口api -### pdd-api +#### 1.7 pdd-api 拼多多开放平台接口api +### 2、运行环境 +#### 2.1、配置环境 +1. 启动MySQL8 +2. 启动Redis7 +3. 启动Sentinel1.8.7控制台 +4. 启动Nacos2.2.0 -## 运行教程 -### 1、运行环境所需 - - -1. 启动MySQL -2. 启动Redis -3. 启动Sentinel控制台 -4. 启动Nacos - -### 2、启动服务(项目) +#### 2.2、启动服务(项目) 1. 启动业务微服务(tao-api、jd-api等平台接口api微服务) 2. 启动sys-api(系统api) 3. 启动微服务网关(api) -### 3、运行前端 +#### 2.3、运行前端 + Nodejs版本:v20.11.0 + 进入`vue3`文件夹 + 安装pnpm:`npm install pnpm -g` @@ -118,9 +115,9 @@ oms项目系统微服务,主要功能包括: + 运行`pnpm run dev` + 浏览网页`http://localhost:3000` -## 项目部署 +### 3、项目部署 -### 打包 +#### 3.1 打包 #### 后端打包 @@ -147,6 +144,11 @@ server { } } ``` +#### 3.2 Nginx配置 + + + +## 捐献作者 💖 如果觉得有用记得点 Star⭐ @@ -156,7 +158,6 @@ server { -## 捐献作者 作者为兼职做开源,平时还需要工作,如果帮到了您可以请作者吃个盒饭(目前还希望接收大家的捐献可以搭建一个演示环境!)