ARCHITECTURE · MONOLITH FIRST

开源项目架构

Spring Boot + Vue 单体应用，无需微服务组件，一台服务器即可运行。
完整源码开放，架构透明、易于学习与二次开发。

技术栈整体架构四套系统对比部署架构目录结构

TECH STACK

技术栈概览

主流成熟技术组合，学习门槛低、社区资料丰富，招人与交接都容易。

☕ 后端 Spring Boot 4.1最新稳定版，内嵌 Tomcat 打包即跑，统一 RESTful API，日处理万单不卡顿

🎨 前端 Vue 3TypeScript + Vite + Element Plus，前后端分离，JSON 接口交互（保留 Vue2 旧版可切换）

🗄️ 存储 MySQL + RedisMySQL 8.x 业务数据，Redis 7.x 热点缓存与登录态，支撑高并发读写

📦 单体应用架构一个后端承载全部业务，无需 Nacos、网关等组件，部署运维成本极低

ARCHITECTURE FLOW

整体架构

浏览器访问 Vue 前端，前端通过 HTTP 调用后端接口，后端直连 MySQL 与 Redis——全链路只有三个进程，简单清晰。

🖥️ 浏览器

用户操作

→

🎨 Vue 前端

页面 + 静态资源

→

⚙️ Spring Boot

业务逻辑 + RESTful API

→

🗄️ MySQL

业务数据存储

→

⚡ Redis

缓存 / 会话

FOUR SYSTEMS

四套开源系统架构

四套独立开源系统各自成体系，按业务场景选用，互不依赖、可独立部署。

系统	技术架构	业务定位
电商 ERP	Spring Boot 4.1.0 + Vue 3	多平台多店铺统一管理：订单、商品、采购、库存、发货、售后全链路
电商 OMS 订单中台	Spring Boot 3.0 + Vue	轻量订单管理：多平台订单统一管理、库存同步、物流发货
零售 ERP	Spring Boot 4.1.0 + Vue 3.5	POS 收银、进销存、会员管理，线上线下零售一体化
跨境电商 ERP	SpringCloud + Spring Boot 3 + Vue 2	Shopify / SHEIN 等跨境平台订单管理，微服务架构支持复杂扩展

DEPLOY TOPOLOGY

部署架构

单机即可完成部署：Nginx 托管前端静态文件并反代后端接口，后端 Jar 包直连数据库，无需安装任何微服务组件。

Nginx 托管 dist 静态资源 + /prod-api/ 反向代理（需开启 SSE 配置）
后端一条命令启动：java -jar erp-api.jar，默认端口 8088
Docker 可选：erp-api 内置 Dockerfile，容器化一键运行

查看完整部署说明 → 快速上手三步走 →

Nginx
静态页面 / 反代 → 后端 Jar
java -jar 启动

↓

MySQL 8.x
数据存储＋ Redis 7.x
缓存

PROJECT LAYOUT

代码目录结构

标准分层架构：Controller 接收请求、Service 处理业务、Mapper 访问数据库，职责清晰、易于扩展与交接。

统一 RESTful 接口风格，前端 src/api 一处封装
MyBatis-Plus 数据访问，少写 80% 的 SQL
OpenAPI 接口授权（appKey），方便对接自有系统

# 后端项目结构（电商ERP 开源版）qihang-erp-open/
├── controller/          # 接口层：订单/商品/库存/发货/售后
├── service/             # 业务层：核心业务逻辑
│   └── impl/
├── mapper/              # 数据访问层：MyBatis-Plus
├── domain/              # 实体对象
├── config/              # 配置类（安全/分页/跨域）
├── utils/
└── application.yml      # 数据库/Redis/端口配置

# 前端项目结构
qihang-erp-vue/
├── src/views/           # 页面：订单/商品/库存/报表
├── src/api/             # 接口封装
├── src/router/          # 路由配置
└── src/store/           # 全局状态

微信扫码登录