项目地址：https://gitee.com/qiliping/qihang-oms

一、项目整体定位与业务定位

1.1 产品定位

启航 OMS 是开源轻量级全渠道电商订单管理中台系统，纯 Java+Vue 前后端分离架构，面向电商卖家、多店铺运营团队、电商代运营、货源分销、直播电商群体，解决多平台订单分散、人工对账慢、发货混乱、售后难统一管理等痛点。

1.2 业务定位

• 不属于重型 ERP，专注订单履约全流程

• 打通多平台订单统一归集、审单、分拣、发货、物流回传、售后闭环

• 可独立部署使用，也可作为前置订单中台对接 WMS 仓储、ERP 进销存、财务系统

• 支持自有商城 + 第三方电商平台混合订单统一管控

1.3 核心解决业务痛点

1. 多平台订单分散，人工导出 Excel 对账效率极低

2. 多店铺库存不同步，超卖、漏发频发

3. 手工填物流单号，出错率高、平台回传慢

4. 售后订单杂乱，退货退款、换货补发无统一流程

5. 代发货源、一件代发模式无系统化管理

6. 无统一订单数据报表，运营决策无数据支撑

二、项目底层技术架构详情

2.1 完整技术栈

后端

• 核心框架：Spring Boot 3.x

• 数据库：MySQL 8.0+

• 缓存中间件：Redis

• 权限框架：Sa-Token

• 持久层：Mybatis-Plus

• 工具类：Hutool、Fastjson、POI 导入导出

• 接口规范：RESTful API

前端

• 框架：Vue2 + Vue CLI

• UI 组件：Element UI

• 状态管理：Vuex

• 网络请求：Axios

• 部署：Nginx 静态资源部署

运行环境

• JDK17、Maven3.6+、Node14~16

• 支持 Windows / CentOS / Ubuntu 全服务器部署

• 单机单体架构，无需微服务、无依赖复杂中间件，中小企业零运维压力

2.2 系统分层架构

1. 接入层：前端页面、第三方平台 API 回调、外部系统对接 API

2. 应用层：订单服务、商品服务、店铺服务、发货服务、售后服务、权限服务

3. 业务逻辑层：订单校验、库存锁定、审单规则、发货策略、售后流程

4. 数据持久层：MySQL 主业务数据、Redis 热点缓存数据

5. 外部对接层：电商平台开放 API、快递电子面单 API、物流轨迹查询 API

2.3 架构优势

1. 轻量易上线，1 天完成部署投产

2. 代码开源可二次定制，无商业授权束缚

3. 权限颗粒度细，支持多运营账号分权管理

4. 接口开放，极易对接外部业务系统

5. 数据本地化部署，订单、客户数据自主掌控

三、全业务模块详细业务设计

3.1 基础数据管理模块（业务底座）

3.1.1 商品档案管理

业务功能

1. 统一建立企业标准商品库，统一品名、规格、分类、品牌、成本价、售价

2. 支持多规格 SKU 管理：颜色、尺寸、型号、款式

3. 支持设置发货模式：仓库自发货 / 供应商一件代发

4. 支持商品上下架、禁用、批量导入批量修改

5. 绑定供应商货源信息，一键匹配代发渠道

业务价值 统一全平台商品口径，杜绝同款商品多名称导致订单匹配混乱。

3.1.2 店铺渠道管理

支持渠道业务

• 主流电商平台店铺绑定配置

• 配置平台 AppKey、AppSecret、店铺 ID、授权令牌

• 自定义订单拉取时间、自动同步频率

• 店铺分组管理：直营店铺、分销店铺、直播店铺

业务流程 新增店铺→平台授权→配置同步规则→自动拉取订单与商品

3.1.3 快递公司与物流管理

1. 维护全网主流快递公司编码、名称、优先级

2. 配置电子面单服务商账号、密钥、网点

3. 设置默认发货快递、偏远地区指定快递

4. 物流轨迹自动订阅、自动回写订单

3.1.4 供应商管理

1. 代发供货商信息建档

2. 绑定供货商可发商品 SKU

3. 设置供货商接单时效、发货时效

4. 代发订单自动分流分配

3.2 核心订单管理模块（核心业务中枢）

3.2.1 订单自动归集业务

业务流程

1. 系统定时自动拉取各平台待付款、已付款、待发货订单

2. 自动过滤取消订单、关闭订单、无效订单

3. 按买家信息、收货地址、商品 SKU 自动规整数据

4. 统一进入 OMS 订单池，全平台订单一页查看

订单状态全生命周期 待付款 → 已付款待审核 → 审核通过待发货 → 已发货 → 运输中 → 已签收 → 交易完成 → 已关闭

3.2.2 订单审核业务（风控核心）

人工 / 自动审单双模式

1. 基础信息校验：收货地址、手机号、邮编合规校验

2. 库存校验：校验本地库存 / 代发货源库存，防超卖

3. 订单拦截规则：黑名单买家、恶意下单、异常地址直接拦截

4. 订单合并、订单拆分、订单备注修改、赠品添加

5. 审核通过自动进入发货任务池

3.2.3 订单人工创建业务

业务场景：线下订单、微信私域订单、电话下单 支持手动录入买家信息、商品、金额、运费、备注，快速建单进入统一履约流程。

3.2.4 订单批量运营业务

1. 批量审核、批量驳回、批量改地址

2. 批量导出订单明细表、备货单、对账单

3. 订单标签自定义：引流单、活动单、直播单、批发单

3.3 发货履约业务模块（落地执行层）

3.3.1 两种核心发货业务模式

模式 1：自有仓库发货业务流程

OMS 审核订单 → 生成仓库备货单 → 仓库拣货分拣 → 确认出库 → 录入物流单号 / 打印电子面单 → 系统自动推送物流单号至电商平台 → 扣减本地库存 → 订单状态变更已发货

模式 2：供应商一件代发业务流程

OMS 审核订单 → 自动匹配对应供货商 → 推送订单至供货商接单后台 → 供货商接单发货 → 回传物流单号 → OMS 同步单号回传平台 → 完成履约

3.3.2 电子面单打印业务

1. 对接主流快递电子面单接口

2. 批量打印、一单多打、热敏纸适配

3. 自动填充收件人、电话、地址、商品信息

4. 打印记录留存，便于对账追责

3.3.3 发货异常业务处理

1. 地址错误：锁定订单→修改地址→重新发货

2. 缺货无货：暂停发货→通知买家→换品 / 退款

3. 快递停发：更换指定快递渠道

4. 错发漏发：订单召回、补发登记

3.4 库存统一管控业务模块

3.4.1 库存统一同步逻辑

1. 商品设置总可用库存

2. 订单审核通过预占库存，防止超卖

3. 实际发货完成正式扣减库存

4. 买家退款关闭订单自动释放预占库存

3.4.2 多场景库存管理

1. 本地仓库实时库存

2. 虚拟代发库存（供货商共享库存）

3. 安全库存预警，低于阈值自动提醒补货

4. 库存变动日志全记录，可溯源查账

3.5 售后全流程业务模块（客户服务闭环）

3.5.1 售后订单自动归集

自动同步各平台售后单：仅退款、退货退款、换货、补发、价保

3.5.2 分类售后业务流程

1. 仅退款业务 售后申请→运营审核→确认退款金额→线上 / 线下退款→售后完结

2. 退货退款业务 买家申请退货→审核通过→推送退货地址→买家寄回→仓库验货入库→确认收货→完成退款→订单闭环

3. 换货 / 补发业务 审核通过→原单补发 / 换新商品→重新发货→回填物流→售后完成

3.5.3 售后台账管理

所有售后单据统一归档、备注记录、处理进度追踪，解决跨平台售后混乱问题。

3.6 数据报表与运营分析业务

3.6.1 核心业务报表

1. 每日订单统计报表：销量、销售额、订单量

2. 店铺渠道销量占比报表

3. 发货时效统计、揽收时效报表

4. 售后退款率、纠纷率统计

5. 库存进销存变动报表

6. 代发订单对账明细表

3.6.2 业务数据价值

1. 快速判断爆款商品、滞销商品

2. 分析各平台运营产出，调整投放策略

3. 统计售后占比，优化发货与品控

3.7 系统权限与组织架构业务

1. 超级管理员：全系统所有权限

2. 运营管理员：订单审核、售后处理、数据查看

3. 仓库操作员：仅备货、出库、打单权限

4. 财务专员：仅订单金额、退款对账查看权限

5. 角色自定义创建，菜单权限、数据权限双重管控

四、标准落地实施业务流程

4.1 项目上线实施五步流程

1. 需求梳理 确认企业业务模式：自发货 / 一件代发 / 混合模式、对接平台数量、是否对接 WMS/ERP

2. 环境部署 服务器选型→安装运行环境→部署后端 Jar→部署前端页面→初始化数据库

3. 基础资料初始化 导入商品库→录入店铺信息→配置快递与面单→搭建账号权限体系

4. 业务流程配置 配置审单规则、库存规则、发货分流规则、售后处理流程

5. 试运行正式投产 小范围测试订单同步→全量店铺接入→全员培训→正式日常业务运转

4.2 推荐服务器业务配置

中小企业标准版

• 配置：2 核 4G 4M 带宽

• 适用：10 万以内年订单量、10 个以内店铺 中大型电商高配版

• 配置：4 核 8G 10M 带宽

• 适用：多店铺矩阵、直播高并发订单场景

五、系统对外业务集成方案

5.1 对接 WMS 仓储系统业务方案

对接方向

1. OMS 向 WMS 推送审核完成备货订单

2. WMS 完成拣货出库后，回传物流单号与出库结果

3. OMS 同步更新订单状态、扣减库存、回传电商平台

集成方式：HTTP 开放 API 接口对接

5.2 对接 ERP 进销存系统

1. ERP 同步商品资料、成本、供应商至 OMS

2. OMS 回传成交订单、发货单、售后退款单至 ERP 做财务核算

3. 实现订单 - 库存 - 财务数据全线打通

5.3 对接私域商城 / 小程序

自有商城订单直接调用 OMS 下单接口，统一进入履约体系，公私域订单一体化管理。

六、适配行业与精准业务场景

6.1 适配行业

1. 全品类电商卖家、多店铺电商运营团队

2. 直播电商、短视频带货团队

3. 电商代运营公司、托管发货服务商

4. 货源分销平台、一件代发供应链企业

5. 实体门店线上多渠道售货企业

6.2 核心适配业务模式

1. 多平台直营零售模式

2. 无货源一件代发模式

3. 自有仓库 + 代发混合发货模式

4. 电商直播集中爆单履约模式

5. 线上分销渠道订单统一管理模式

七、项目商业业务价值总结

1. 人力成本降低：告别 Excel 手工整理订单，订单处理人力减少 50% 以上

2. 履约效率提升：订单自动同步、自动分流、批量打单，发货效率翻倍

3. 库存风险可控：预占库存机制，彻底解决超卖、滞销积压问题

4. 售后体验提升：统一售后流程，缩短客诉处理时长

5. 数据数字化转型：全业务数据可视化，实现精细化电商运营

6. 低成本数字化：开源无年费，一次性部署长期使用，中小企业数字化首选

7. 业务可扩展：支持后续拓展分销、会员、拼团、财务对账等二次业务开发

八、项目现存业务短板与优化升级方案

8.1 原生开源版业务短板

1. 暂无强大分销、团长、团购业务模块

2. 缺少完整财务对账、往来账款核算模块

3. 高并发爆单场景无消息队列削峰

4. 缺少移动端 APP / 小程序运营端

8.2 二次开发业务升级方向

1. 新增分销订单、团长分佣业务

2. 接入消息队列实现高并发订单削峰

3. 开发手机端订单审核、发货查看、售后处理

4. 完善财务对账、利润核算、成本统计模块

5. 对接快递驿站、同城配送、外卖履约渠道

九、项目落地交付物清单

1. 《启航 OMS 详细业务解决方案文档》

2. 系统完整部署手册 + 环境配置手册

3. 数据库表结构说明文档

4. 前后端接口 API 文档

5. 日常业务操作培训手册

6. 常见业务异常问题排查手册