opensource/qihang-oms
3
0
Fork 0
mirror of https://gitee.com/qiliping/qihang-oms.git synced 2026-08-28 22:30:42 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
master
qihang-oms/README.md
T
richie ce6703039e README
2026-08-17 09:50:37 +08:00

10 KiB
Raw Permalink Blame History

启航电商OMS系统3.0版

欢迎来到我们的开源项目！创新、协作、高质量的代码。您的Star🌟，是我们前进的动力！ 💪✨🏆

项目持续更新中，还有很多不足，请多包含！如有任何疑问请提交issue！谢谢！ 💪✨🏆

🎉 3.0版本重大升级

启航OMS 3.0版本全新发布！带来了多项重大升级，为您的电商订单管理提供更强大的支持。

🌟 核心升级亮点

升级项 说明
多商户架构 支持多租户数据隔离，店铺归属商户管理
自动任务系统 订单自动拉取，无需手动操作
统一数据结构 采用企业版数据结构，底层架构升级
前端Vue2升级 底层框架升级，UI界面看齐企业版
AI智能分析 销售分析、库存优化、客户洞察等AI功能
多平台扩展 新增快手、小红书平台支持

📖 详细升级文档

一、系统介绍

启航电商OMS系统是一个完整开箱即用的开源电商OMS系统，经历多个版本的迭代优化和客户使用验证。开发者可以直接部署即可使用。

启航电商OMS系统专注核心订单处理业务，主体功能包括：商品管理、店铺商品管理、订单库、店铺订单管理、发货管理（支持仓库发货、供应商发货）、售后管理、库存管理等。

与此同时该系统会陆续增加供外部调用的API，以便开发者满足自己的个性化业务需求。

启航电商ERP系统支持：淘宝天猫、京东、拼多多、抖店、微信小店、快手、小红书等平台，后续将继续对接其他电商平台。

二、主体功能

主体功能包括：

  • 商品管理：商品库管理、店铺商品管理（拉取店铺商品、ERP关联）。
  • 订单管理：店铺订单同步、管理、自动拉取。
  • 发货管理：电子面单打印、发货记录、物流跟踪等。
  • 售后管理：店铺售后同步、售后处理（补发、换货、退货处理）等。
  • 店铺&平台参数设置：店铺管理、商户管理、平台参数设置。

基本上覆盖了电商网店管理日常业务，可使用接口对接内部ERP系统。

订单打单（电子面单打印）已支持：淘宝、京东、拼多多、抖店、微信小店

三、功能模块

1、商品管理

  • 商品库：管理商品库商品，提供手动录入、API接收功能，可以设置自己发货还是供应商发货（影响到后台分单逻辑，即时生效）。
    • 商品Sku：查看所有商品库SKU
  • 库存管理：支持手动修改库存（备货出库之后会扣减库存）
  • 店铺商品：店铺商品管理，店铺商品API拉取、店铺商品API更新（进行店铺商品与商品库商品关联，根据SKU编码关联）。
  • 分类管理：分类及分类属性管理（规格属性是用来组合Sku的）
  • 品牌管理
  • 供应商管理

2、订单管理

  • 发货订单库：需要发货的订单查询，发货订单明细查询。
  • 店铺订单管理：订单API拉取、订单API更新、订单确认（确认之后订单进入发货订单库）等，支持淘宝天猫、京东、拼多多、抖店、微信小店、快手、小红书。
  • 订单拉取日志：记录店铺订单每次拉取日志。
  • 折扣管理：折扣活动配置

3、发货管理

  • 订单发货：处理待发货的订单，支持手动发货、分配给供应商发货。

    • 手动发货：手动填写物流单号进行发货，手动发货之后将进入备货出库中。
    • 供应商发货：分配给供应商发货，分配之后将进入备货出库中；
    • 云仓发货：推送订单至云仓发货（钩子功能）

  • 电子面单发货：支持快递打印、发货、补单等功能。

  • 备货出库：已发货、已分配给供应商发货、电子面单打印快递单完成都会加入备货清单，提供给仓库备货查询。备货单可以生成出库单。

    • 供应商备货支持手动填写物流单号，实现发货。
    • 仓库备货出库：备货出库之后将扣减库存。

  • 发货记录：发货记录，提供手动发货功能。

  • 发货设置：设置发货快递、电子面单账户等信息

    • 快递公司管理：管理发货的快递公司（支持从平台拉取、支持手动添加）。
    • 电子面单账户设置：管理店铺开通的电子面单账户

4、售后管理

  • 售后中心：聚合售后查询、详情、管理。
  • 店铺售后管理：售后API拉取、售后API更新、手动推送、售后操作（同意、备注）。
  • 售后处理记录：售后处理的记录查询，提供手动售后处理功能。
  • 售后台账：售后统计台账

5、店铺&平台设置

  • 店铺管理
  • 商户管理（多租户）
  • 平台开关
  • 接口授权
  • 定时任务配置
  • 平台拉取日志
  • 快递公司库

6、系统设置

  • 用户管理
  • 菜单管理
  • 角色管理
  • 部门管理
  • 字典管理

四、技术文档

👉 详细技术文档请参考：OMS3.0架构文档

技术文档包含：

  • 技术架构设计
  • 核心功能实现
  • 业务流程图
  • API接口规范
  • 代码规范
  • 扩展建议

五、主要流程

1 发货流程

订单发货流程

graph TD
A[网店拉取订单] -->B(审核订单)
    B --> C[发货订单库]
    C --> C1[订单发货中展示需要发货的订单]
    C1 --> D[仓库发货]
    C1 --> E[分配供应商发货]
    D --> D1[生成仓库备货出库]
    D1 --> F(备货出库)
    F --> F1[扣减库存]
    E --> E1[生成供应商备货出库]
    E1 --> E2[手动录入供应商发货物流单号]
    E2 --> H(完成发货)
    F1 --> H

2 售后处理流程

退货退款流程

graph LR
A[录入退款退货] -->B(仅退款)
    B --> H(完成)
    A --> D(退货退款)
    D --> E[仓库收货]
    E --> F[退货入库处理]
    F --> H

售后流程

graph LR
A[录入售后] -->B(补发商品)
    B --> H[仓库出库-记录]
    A --> D(换货)
    D --> E[仓库收货-入库]
    E --> H
    H --> F(完成)

订单拦截

graph LR
A[录入拦截] -->B(通知仓库)
    B --> H1[未发货-直接入库]
    B --> D(已发货)
    D --> E[通知消费者拒收]
    E --> H[消费者拒收]
    H --> C[退回入库]
    C --> F(退款给消费者)
    F --> G[完成]
    H1 --> G

六、部署说明

0 版本说明

  • Java：17
  • Nodejs：v16
  • SpringBoot:3
  • MySQL:8
  • Redis:7

1 配置MySQL

  • 创建数据库qihang-oms
  • 导入数据库结构：sql脚本docs\qihang-oms.sql

2 启动Redis

3 修改项目配置

  • 修改api项目中的配置文件application.yml配置Mysql相关配置。

4 mvn打包部署

  • Java版本：Java 17
  • Maven版本：3.8 mvn clean package

5 前端 vue打包

  • nodejs版本要求：v16.x
  • 安装依赖：npm install --registry=https://registry.npmmirror.com
  • 打包npm run build:prod

6 修改Nginx配置

# 前端web配置
location / {
        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://localhost:8086/;
}

7 访问web

  • 访问地址：http://localhost
  • 登录名：admin
  • 登录密码：Andy@2025
💡 如果不想自己折腾？
  • 没有技术团队？ 启航电商ERP企业版提供一键部署 + 7x24小时技术支持
  • 申请不到 AppKey？ 企业版除了支持电商开放平台AppKey之外还集成了第三方API接口（使用第三方API无需自行申请Appkey）
  • 需要更多功能？ 企业版支持多商户、多仓库、AI智能分析

👉 启航电商ERP企业版 |

🔗 相关链接

链接 地址
ERP https://qihangerp.cn/open/erp.html
OMS https://qihangerp.cn/open/oms.html
零售ERP https://qihangerp.cn/open/retail-erp.html
跨境ERP https://qihangerp.cn/open/cross-border.html
企业版 https://qihangerp.cn/

📦 启航电商开源生态

启航电商旗下开源项目矩阵：

项目 定位 官网 Gitee GitHub
启航电商ERP 电商业务AI底座（单体应用，v4.1） 官网 Gitee GitHub
OMS 订单中台 ⬅ **轻量级订单管理 ** 官网 Gitee GitHub
启航零售ERP 线下零售管理平台 官网 Gitee GitHub
启航跨境电商ERP 跨境电商专用版 官网 Gitee GitHub

💼 企业版

👉 启航电商ERP官网

📱 关注我们

公众号：启航电商ERP 个人号：码农老齐
产品动态·行业方案·客户案例 技术实战·开源故事·创业心得

感谢关注！我希望将从事电商 10 余年的行业经验沉淀在代码中，帮助大家真正提升经营效率。

💖 如果项目对您有帮助，请点个 Star ⭐ 给予鼓励！

Reference in New Issue View Git Blame Copy Permalink