启航电商ERP2.0版本

一、介绍

启航电商OMS系统是一套多平台多店铺订单处理系统，本项目后端采用SpringCloudAlibaba 微服务架构，前端采用Vue2开发。

平台支持：淘宝、京东、拼多多、抖店、微信视频号。

主要功能包括：订单管理、打单发货（电子面单打印）、售后处理、商品管理等。

TODO

• • 库存模块（库存查询、入库操作、出库操作）

二、主体功能及流程

主体功能

1、订单管理

• • 订单管理：聚合订单查询、详情、管理。
• • 订单明细：聚合订单明细查询。
• • 店铺订单管理：订单API拉取、订单API更新、订单手动推送等，支持淘宝天猫、京东、拼多多、抖店、微信视频号。
• • 订单更新日志：查询更新日志，主动排错。

2、发货管理

• • 订单打印：电子面单取号、打印、发货，支持淘宝天猫、京东、拼多多、抖店、微信视频号。
• • 备货清单：电子面单取号之后会加入备货清单，提供给仓库备货查询。发货之后会从备货清单中移除。
• • 发货记录：发货记录，提供手动发货功能。
• • 物流跟踪：提供发货物流查询。
• • 快递公司管理：管理发货的快递公司。

3、售后管理

• • 售后管理：聚合售后查询、详情、管理。
• • 店铺售后管理：售后API拉取、售后API更新、手动推送、售后操作（同意、备注）。
• • 售后处理记录：售后处理的记录查询，提供手动售后处理功能。
• • 售后更新日志：查询更新日志，主动排错。

4、商品管理

• • ERP商品SKU：管理ERP商品SKU，提供手动录入、API接收功能。
• • 店铺商品管理：店铺商品管理，店铺商品API拉取、店铺商品API更新。

4、店铺管理

• • 店铺列表
• • 开放平台设置

支持多店铺管理

• • 店铺参数设置（appkey等）
• • 基础管理
• • 发货地址库
• • 发货物流公司库

主体流程

1、主流程

店铺参数设置-->ERP商品SKU录入-->
店铺商品拉取（程序会根据SKU编码自动关联ERP商品SKU）-->
API拉取订单(程序根据平台skuid查找店铺)-->
订单打印（消息通知备货）-->
备货（备货清单）-->
发货出库（消息通知接口处理）-->
查询发货(物流跟踪)-->
店铺售后拉取-->
售后操作（拦截订单、补发商品、换货、退货）-->
售后记录查询

库存并发设计

• • 1、入库实时增加库存；
• • 2、出库先锁定库存：设计一张表存储库存锁定，状态：已结算、未结算、已释放，每天闲时进行库存结算；
• • 3、查询库存时，需要把未结算的锁定库存扣减掉；

三、软件架构

1、开发环境级组件

1.1 开发环境

• • Jdk：17
• • Nodejs：v16.20.0

1.2 项目组件

后端核心组件

• • SpringBoot：3.0.2
• • spring-boot-starter-security

微服务版本

• • SpringCloudAlibaba：2022.0.0.0
• • Nacos
• • SpringCloud Gateway
• • spring-cloud-starter-loadbalancer

前端框架及组件

• • vue2
• • element

1.3、存储及中间件

• • MySQL8
• • 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

2、项目结构

2.1 core

项目公共模块包括：

• • common:公共类库
• • security:公共权限验证模块
• • module数据库操作层

2.2 open-api2

早期版本的各个平台的微服务，包括

• • dou-api
• • jd-api
• • pdd-api
• • tao-api
• • wei-api

后期这些微服务统一合并到open-api

2.3 open-api-sdk

各电商开放平台接口sdk

3、运行说明

3.1、启动环境

1. 1. 启动MySQL8
2. 2. 启动Redis7
3. 3. 启动Nacos2.2.0

3.2、启动服务(项目)

3.2.1 单体版本

启动app项目即可，注意修改application.yml配置

3.2.2 微服务版本

1. 1. 启动业务微服务api父项目下：（sys-api、oms-api、wms-api、open-api、op、gateway微服务）

3.3、运行前端

不管后端是微服务版本还是单体版本，前端vue项目都是一样的

• • Nodejs版本：v16.20.0
• • 进入vue文件夹
• • 运行npm install
• • 运行npm run dev
• • 浏览网页http://localhost

4、前端部署

4.1 打包

前端打包

pnpm run build:prod
README.md

4.2 Nginx配置

# 上传文件至远程服务器
将打包生成在 `dist` 目录下的文件拷贝至 `/opt/qihangerp/nginx/dist` 目录

# nginx.cofig 配置
server {
    listen     80;
    server_name  localhost;
    location / {
        #root   /opt/qihangerp/nginx/dist;
        root /usr/share/nginx/html;
        index  index.html index.htm;
        try_files $uri $uri/ /index.html;
    }

    # 反向代理配置
    location /prod-api/ {
            proxy_set_header Host $http_host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header REMOTE-HOST $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_pass http://127.0.0.1:8088/; # 替换成你的后端网关API地址
    }
}