启航零售ERP — 零售数字化管理平台

开源、轻量、可扩展的零售业务管理平台。基于电商ERP扩展，支持线上电商订单管理 + 线下POS收银 + 即时零售对接（美团闪购/淘宝闪购/京东到家/抖音小时达）。帮助零售商实现商品、采购、库存、销售、会员全链路数字化管理。

---

📖 目录

• 一、系统概述
• 二、开发状态
• 三、适用场景
• 四、核心功能详解
• 五、业务流程图
• 六、角色与权限
• 七、技术架构
• 八、快速开始
• 九、配置说明
• 十、部署指南
• 十一、数据模型
• 十二、API 概览
• 十三、常见问题
• 十四、开源生态

---

一、系统概述

1.1 什么是启航零售ERP？

启航零售ERP 是一个面向零售企业的开源业务管理平台。它将零售企业最核心的商品管理、采购管理、库存管理、销售管理、售后管理、会员管理等环节整合到一个统一平台，帮助零售商实现从进货到销售的全链路数字化。

当前状态：已实现电商ERP核心功能（OMS订单管理、商品/库存/采购/供应商/仓储），正在扩展线下POS收银和即时零售对接能力。

1.2 解决的问题

业务痛点	系统方案
商品信息分散在 Excel 中，查询困难	统一商品库，分类/品牌/规格/属性结构化存储
采购靠电话微信，无流程记录	采购单全流程管理，从询价到入库完整追溯
库存数据滞后，盘点靠人工	实时库存更新，出入库自动扣增，库存明细随时可查
销售无记录，业绩难统计	内销订单数字化，销售数据自动汇总
会员信息散乱，无消费记录	会员档案统一管理，消费记录可追溯
多人协作权限不清	RBAC 角色权限，精细控制每个功能访问
线下门店收银效率低	Electron POS收银端，支持离线+硬件外设
即时零售平台订单处理混乱	对接美团/淘宝/京东/抖音，订单统一管理

1.3 系统定位

┌─────────────────────────────────────────────────────────────┐
│                    启航零售ERP                                │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────────┐│
│  │  电商ERP（已有）  │  │  POS收银（开发中） │  │ 即时零售（规划）││
│  │  · OMS订单管理   │  │  · 收银台        │  │ · 美团闪购    ││
│  │  · 商品/库存     │  │  · 会员/储值     │  │ · 淘宝闪购    ││
│  │  · 采购/供应商   │  │  · 班次/小票     │  │ · 京东到家    ││
│  │  · 财务/报表     │  │  · 营销/促销     │  │ · 抖音小时达  ││
│  └─────────────────┘  └─────────────────┘  └──────────────┘│
├─────────────────────────────────────────────────────────────┤
│          技术底座：Spring Boot 4.1 + Vue 3.5                 │
└─────────────────────────────────────────────────────────────┘

---

二、开发状态

模块	状态	说明
电商ERP（OMS订单管理）	✅ 已完成	淘宝/京东/拼多多/抖店/微信/快手/小红书
商品管理	✅ 已完成	SPU/SKU/分类/品牌/规格属性
库存管理	✅ 已完成	多仓库/出入库/盘点/库存预警
采购管理	✅ 已完成	采购订单/入库/供应商管理
仓储管理	✅ 已完成	仓库/仓位/调拨
系统管理	✅ 已完成	用户/角色/菜单/字典/日志
会员管理	✅ 已完成	复用 oms_shop_member（扩展字段）
营业员管理	✅ 已完成	复用 erp_sales_person（扩展字段）
门店管理	✅ 已完成	复用 o_shop（type=999）
营销促销	✅ 已完成	复用 o_marketing_discount_rule
POS收银	🚧 开发中	Electron桌面端 + 离线模式
即时零售	📋 规划中	美团/淘宝/京东/抖音对接
商业版	📋 规划中	加盟/业财/AI/开放API

---

三、适用场景

3.1 目标用户

用户类型	典型场景
线下品牌零售商	拥有多家门店，需要统一管理商品、库存、采购
批发商/经销商	有稳定的供应商和客户，需要采购和销售管理
中小型连锁店	需要管理多门店商品信息、会员信息
商贸公司	有进销存全链路管理需求
个体商户升级	从 Excel 手工记账向系统化管理转型

3.2 典型业务场景

场景一：便利店进货到销售

采购员创建采购单 → 经理审核 → 供应商发货 → 
→ 仓库收货入库 → 库存更新 → 门店上架销售 → 
→ 客户购买 → 收银开单 → 库存扣减

场景二：会员到店消费

会员到店 → 员工录入内销订单 → 选择会员 → 
→ 享受折扣价 → 支付完成 → 订单审核 → 
→ 仓库出库 → 会员积分累计

场景三：多门店调拨

A 门店库存不足 → 创建调拨单 → 
→ B 门店出库 → A 门店入库 → 库存同步更新

---

四、核心功能详解

4.1 商品管理

商品管理是零售业务的基础。系统提供完整的商品信息管理能力。

商品库管理

• 商品信息：商品名称、编码、条码、规格、单位、价格（进价/售价/会员价）
• SKU 管理：同一商品支持多规格（如颜色、尺寸），每个 SKU 独立管理库存
• 分类体系：多级商品分类，支持树形结构
• 品牌管理：商品品牌统一维护
• 规格属性：分类级联规格属性配置，如服装类有颜色、尺码

商品 ── 品牌 (1:1)
 ├── 分类 (N:1)
 ├── SKU1 ── 库存
 ├── SKU2 ── 库存
 └── SKU3 ── 库存

供应商产品

记录每个供应商提供的商品及价格信息，便于采购时快速比价。

功能	说明
商品-供应商关联	一个商品可对应多个供应商
供应商价格	记录不同供应商的报价
价格历史	供应商价格变更记录可追溯

4.2 采购管理

采购管理覆盖从采购需求到入库的全流程。

采购订单

创建采购单 → 提交审核 → 审核通过 → 供应商发货 → 采购入库 → 完成

• 采购单创建：选择供应商、商品、数量、价格，自动计算采购金额
• 采购单状态：待审核 / 已审核 / 已入库 / 已完成 / 已取消
• 采购入库：到货后入库，支持分批入库
• 历史查询：按供应商、商品、日期等多维度查询

供应商管理

• 供应商档案：名称、联系人、电话、地址、结算方式
• 供应商报价：按商品记录供应商报价，采购时自动引用
• 采购承运商：物流承运商信息维护

4.3 仓库管理

仓库管理实现商品实物的精细化管控。

仓库与仓位

• 多仓库：支持多个仓库独立管理
• 仓位管理：仓库内细分仓位，精确定位商品存放位置

出入库管理

类型	说明
采购入库	采购单到货后入库，增加库存
销售出库	内销订单审核后出库，扣减库存
调拨出入库	仓库间商品调拨
盘点调整	盘点后库存调整

库存查询

• 实时库存：按仓库、商品、SKU 查看当前库存
• 库存流水：每次出入库操作均有记录，可追溯

4.4 销售管理（内销）

内销管理是零售业务的核心环节，处理线下门店的销售业务。

内销订单

订单生命周期：

创建草稿 → 提交审核 → 审核通过 → 出库发货 → 完成
      ↓                        ↓
    驳回修改                 取消订单

• 创建订单：选择商品、数量，自动带出价格，支持折扣
• 会员关联：可选择会员，享受会员价和积分
• 审核流程：订单需审核后才能出库
• 多种状态：待审核 / 已审核 / 已出库 / 已完成 / 已取消

折扣管理

• 折扣规则：按商品、分类、会员等级配置折扣
• 促销活动：满减、打折、特价等多种促销方式

4.5 会员管理

会员管理帮助零售商沉淀客户资产。

功能	说明
会员档案	姓名、手机号、等级、积分、消费记录
会员等级	不同等级享受不同折扣
积分管理	消费自动累计积分，积分可抵扣
消费记录	会员历史订单查询

4.6 POS收银（开发中）

Electron桌面端收银系统，支持离线模式和硬件外设对接。

功能	说明
收银台	扫码枪/键盘输入，支持计件/称重商品
支付方式	现金/微信/支付宝/银行卡/会员余额/组合支付
班次管理	开班/交班/班次对账
小票打印	USB/网口打印机（ESC/POS指令）+ 云打印
离线收银	断网时本地SQLite缓存，网络恢复后批量上传
退货退款	整单/部分退货，原路退回/现金/余额
硬件对接	电子秤（RS232串口）、钱箱、客显屏

4.7 即时零售对接（规划中）

对接主流即时零售平台，实现订单/库存/商品统一管理。

平台	平台ID	对接内容
美团闪购	1100	商品同步/订单拉取/配送呼叫
淘宝闪购	1200	商品同步/订单拉取/配送对接
京东到家	1300	商品同步/订单拉取/达达配送
抖音小时达	1400	商品同步/订单拉取/直播联动

4.8 发货管理

菜单	说明
手动发货	手工录入发货物流信息
打单发货	电子面单批量打印发货
供应商发货	订单分配给供应商代发
云仓发货	推送到第三方云仓发货
发货记录	所有发货记录查询
电子面单设置	快递电子面单账户配置
发货快递设置	默认发货快递配置

4.9 售后管理

菜单	说明
售后库	所有售后单统一查询、处理
售后台账	售后处理结果记录台账

4.10 通知渠道

系统支持对接外部即时通讯工具，将运营异常及时推送给相关人员。

• 飞书机器人：Webhook 推送
• 钉钉机器人：支持签名校验
• 企业微信机器人：Webhook 推送

---

五、业务流程图

4.1 零售业务总览

graph TB
    subgraph 采购
        A1[供应商管理] --> A2[供应商报价]
        A2 --> A3[创建采购单]
        A3 --> A4[采购审核]
        A4 --> A5[采购入库]
    end
    
    subgraph 库存
        A5 --> B1[库存增加]
        B2[库存扣减] --> B3[库存查询]
        B1 --> B3
    end
    
    subgraph 销售
        C1[创建内销订单] --> C2[订单审核]
        C2 --> C3[仓库出库]
        C3 --> B2
        C4[会员管理] --> C1
    end
    
    subgraph 售后
        D1[售后申请] --> D2[售后处理]
        D2 --> D3[补发/换货/退货]
    end

4.2 内销订单流程

sequenceDiagram
    participant 店员
    participant 系统
    participant 仓库
    participant 会员
    
    店员->>系统: 创建内销订单
    店员->>系统: 选择商品/数量
    店员->>系统: 关联会员（可选）
    系统->>系统: 自动计算金额/折扣
    店员->>系统: 提交订单
    
    系统->>系统: 订单状态 → 待审核
    
    店员->>系统: 审核通过
    系统->>仓库: 生成出库单
    仓库->>系统: 确认出库
    系统->>系统: 扣减库存
    系统->>系统: 订单状态 → 已完成
    
    系统->>会员: 累计消费积分

4.3 采购到销售全链路

graph LR
    A[供应商报价] --> B[创建采购单]
    B --> C[采购审核]
    C --> D[供应商发货]
    D --> E[采购入库]
    E --> F[库存增加]
    F --> G[零售出库]
    G --> H[库存扣减]
    H --> I[会员积分]

4.4 售后处理流程

graph TD
    A[客户申请售后] --> B{售后类型}
    B -->|退货| C[退货入库]
    B -->|换货| D[换货出库]
    B -->|补发| E[重新发货]
    C --> F[退款处理]
    D --> G[完成]
    E --> G
    F --> G

---

六、角色与权限

系统采用 RBAC（基于角色的访问控制）模型，可实现精细化的权限管理。

5.1 预设角色参考

角色	主要权限	适用人员
管理员	全部功能	系统管理员
采购员	采购单创建、供应商管理、采购入库	采购部门
仓库员	出入库操作、库存查询、仓位管理	仓库人员
销售员	内销订单创建/审核、会员管理	门店销售人员
商品管理员	商品库维护、分类/品牌管理	商品运营
财务	订单查询、报表查看	财务人员

5.2 权限控制粒度

• 功能权限：控制菜单和按钮的可见性
• 数据权限：控制数据访问范围（如仅本部门数据）
• 操作权限：增删改查独立控制

---

七、技术架构

6.1 技术栈

层级	组件	版本
后端框架	Spring Boot	4.1.0
安全框架	Spring Security	7.1.0
持久层	MyBatis-Plus	3.5.16
数据库	MySQL	8
缓存	Redis	7.x
前端框架	Vue	3.5
前端语言	TypeScript	5.x
UI 框架	Element Plus	最新
构建工具	Vite	8
JDK	Java	17
Node.js	-	20+

6.2 项目结构

qihang-retail/
│
├── common/                   # 通用工具模块
│   ├── src/main/java/cn/qihangerp/common/
│   │   ├── utils/            # 工具类
│   │   ├── vo/               # ResultVo 统一响应
│   │   ├── query/            # PageQuery 分页查询
│   │   └── result/           # PageResult 分页结果
│   └── pom.xml
│
├── security/                 # 安全认证模块
│   ├── src/main/java/cn/qihangerp/security/
│   │   ├── config/           # Spring Security 配置
│   │   ├── jwt/              # JWT Token 管理
│   │   ├── filter/           # 认证过滤器
│   │   └── entity/           # 安全相关实体
│   └── pom.xml
│
├── model/                    # 领域模型模块
│   ├── src/main/java/cn/qihangerp/
│   │   ├── oms/domain/       # 订单相关实体
│   │   ├── module/domain/    # 业务实体
│   │   └── security/entity/  # 用户/角色实体
│   └── pom.xml
│
├── mapper/                   # 数据访问模块
│   ├── src/main/java/cn/qihangerp/mapper/
│   └── src/main/resources/mapper/  # MyBatis XML
│   └── pom.xml
│
├── service/                  # 业务逻辑模块
│   ├── src/main/java/cn/qihangerp/
│   │   ├── service/          # Service 接口
│   │   └── service/impl/     # Service 实现
│   └── pom.xml
│
├── erp-api/                  # Spring Boot 主应用模块
│   ├── src/main/java/cn/qihangerp/erp/
│   │   ├── ErpApi.java       # 启动类
│   │   ├── controller/
│   │   │   ├── erp/          # 核心业务控制器
│   │   │   └── sys/          # 系统管理控制器
│   │   └── config/           # 全局配置
│   ├── src/main/resources/
│   │   ├── application.yml
│   │   └── application-dev.yml
│   └── pom.xml
│
└── vue/                      # 前端项目
    ├── src/
    │   ├── views/            # 页面组件
    │   ├── router/           # 路由配置
    │   ├── store/            # Pinia 状态管理
    │   ├── utils/            # 工具函数
    │   └── api/              # API 接口封装
    ├── .env.development
    └── .env.production

6.3 模块依赖

    erp-api
       │
       ├──→ security
       │       │
       │       └──→ common
       │
       ├──→ service
       │       │
       │       └──→ mapper
       │               │
       │               └──→ model
       │
       └──→ common

6.4 数据模型

核心表结构

o_goods          ← 商品库
o_goods_sku      ← 商品 SKU
o_goods_category ← 商品分类
o_goods_brand    ← 商品品牌
o_goods_spec     ← 商品规格

o_supplier       ← 供应商
o_supplier_product ← 供应商产品
o_purchase_order ← 采购订单
o_purchase_order_item ← 采购订单明细

s_warehouse      ← 仓库
s_warehouse_pos  ← 仓位
s_stock          ← 库存
s_stock_log      ← 库存流水

o_order          ← 内销订单（erp_order 业务订单）
o_order_item     ← 内销订单明细

sys_user         ← 系统用户
sys_role         ← 角色
sys_menu         ← 菜单
sys_dept         ← 部门

---

八、快速开始

7.1 环境要求

组件	最低版本	备注
JDK	17	必须 JDK 17+
Node.js	20	推荐 20.20.0
Maven	3.9	构建工具
MySQL	8	数据库
Redis	7	缓存

7.2 数据库初始化

# 创建数据库
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS \`qihang-retail\` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 导入数据表结构
mysql -u root -p qihang-retail < docs/qihang-retail.sql

7.3 启动后端

# 克隆项目
git clone https://github.com/zeasin/qihang-retail.git
cd qihang-retail

# 编译打包
mvn clean install -DskipTests

# 启动
java -jar erp-api/target/erp-api-4.1.0.jar

启动后访问 http://localhost:8088 验证后端服务。

7.4 启动前端

cd vue
npm install
npm run dev

启动后访问 http://localhost:88。

7.5 登录系统

• 默认账号：admin
• 默认密码：QHerp@23

---

九、配置说明

8.1 环境切换

erp-api/src/main/resources/application.yml：

spring:
  profiles:
    active: dev   # 可选：dev（开发）、demo（演示）

8.2 数据库配置

spring:
  datasource:
    driverClassName: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/qihang-retail?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
    username: root
    password: your_password
    hikari:
      maximum-pool-size: 10
      minimum-idle: 5

8.3 Redis 配置

spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      database: 0
      timeout: 10s
      lettuce:
        pool:
          min-idle: 0
          max-idle: 8
          max-active: 8

8.4 Token 配置

token:
  expireTime: 60       # Token 过期时间（分钟）
  secret: your-secret-key-here

---

十、部署指南

9.1 后端部署

JAR 部署

# 打包（跳过测试）
mvn clean package -DskipTests

# 后台启动
nohup java -jar erp-api/target/erp-api.jar > erp.log 2>&1 &

系统服务（Linux systemd）

[Unit]
Description=qihang-retail
After=syslog.target

[Service]
User=root
ExecStart=/usr/bin/java -jar /opt/qihang-retail/erp-api.jar
SuccessExitStatus=143
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

9.2 前端部署

cd vue
npm run build
# 构建产物在 vue/dist/ 目录

9.3 Nginx 配置

# 前端静态资源
server {
    listen 80;
    server_name your-domain.com;
    
    # API 代理
    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/;
    }
    
    # 前端页面
    location / {
        root /opt/qihang-retail/vue/dist;
        try_files $uri $uri/ /index.html;
        index index.html;
    }
}

9.4 Docker 部署

FROM openjdk:17-jdk-slim
COPY erp-api/target/erp-api.jar /app/app.jar
EXPOSE 8088
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

---

十一、数据模型

10.1 商品相关

o_goods                          ← 商品库
├── id            BIGINT PK
├── name          VARCHAR(200)    商品名称
├── goods_num     VARCHAR(100)    商品编码
├── bar_code      VARCHAR(100)    条码
├── category_id   BIGINT          分类ID
├── brand_id      BIGINT          品牌ID
├── unit_name     VARCHAR(20)     单位
├── retail_price  DECIMAL         零售价
├── pur_price     DECIMAL         采购价
├── merchant_id   BIGINT          商户ID
├── shop_id       BIGINT          店铺ID
├── is_weighted   TINYINT         是否称重（扩展）
├── shelf_date_type TINYINT       保质期录入方式（扩展）
├── status        INT             状态
└── ...

o_goods_sku                      ← 商品SKU
├── id            BIGINT PK
├── goods_id      BIGINT          商品ID
├── sku_code      VARCHAR(100)    SKU编码
├── bar_code      VARCHAR(100)    条码
├── price         DECIMAL         售价
├── cost_price    DECIMAL         成本价
└── spec_info     VARCHAR(500)    规格信息（JSON）

o_goods_category                 ← 商品分类
├── id            BIGINT PK
├── name          VARCHAR(50)     分类名称
├── parent_id     BIGINT          父分类ID
├── merchant_id   BIGINT          商户ID
└── image         VARCHAR(255)    分类图标

o_goods_brand                    ← 商品品牌
├── id            BIGINT PK
├── name          VARCHAR(50)     品牌名称
└── merchant_id   BIGINT          商户ID

10.2 订单相关

o_order                          ← OMS订单（电商+即时零售）
├── id            BIGINT PK
├── order_num     VARCHAR(50)     订单号
├── shop_id       BIGINT          店铺ID
├── shop_type     INT             平台类型（1淘宝/2京东/.../1100美团闪购）
├── order_status  INT             订单状态
├── total_amount  DECIMAL         订单金额
├── receiver_name VARCHAR(50)     收货人
├── receiver_mobile VARCHAR(20)   收货电话
├── address       VARCHAR(255)    收货地址
├── delivery_type TINYINT         配送方式（扩展）
├── store_id      BIGINT          履约门店（扩展）
├── merchant_id   BIGINT          商户ID
├── create_time   DATETIME        创建时间
└── ...

o_order_item                     ← 订单明细
├── id            BIGINT PK
├── order_id      BIGINT          订单ID
├── goods_name    VARCHAR(200)    商品名称
├── sku_id        BIGINT          SKU ID
├── quantity      INT             数量
├── price         DECIMAL         单价
└── subtotal      DECIMAL         小计

erp_sales_order                  ← 内销订单（POS销售单）
├── id            BIGINT PK
├── order_no      VARCHAR(50)     订单号
├── member_id     BIGINT          会员ID
├── total_amount  DECIMAL         订单金额
├── status        INT             状态
├── salesman_id   BIGINT          营业员ID
└── create_time   DATETIME        创建时间

10.3 采购相关

erp_purchase_order               ← 采购订单
├── id            BIGINT PK
├── order_no      VARCHAR(50)     采购单号
├── supplier_id   BIGINT          供应商ID
├── merchant_id   BIGINT          商户ID
├── warehouse_id  BIGINT          仓库ID
├── total_amount  DECIMAL         采购金额
├── status        INT             状态
└── create_time   DATETIME        创建时间

erp_purchase_order_item          ← 采购订单明细
├── id            BIGINT PK
├── purchase_id   BIGINT          采购单ID
├── sku_id        BIGINT          SKU ID
├── quantity      INT             采购数量
├── price         DECIMAL         采购单价
└── received_qty  INT             已入库数量

erp_supplier                     ← 供应商
├── id            BIGINT PK
├── name          VARCHAR(100)    供应商名称
├── contact       VARCHAR(50)     联系人
├── phone         VARCHAR(20)     联系电话
└── merchant_id   BIGINT          商户ID

10.4 库存相关

o_goods_inventory                ← 商品库存
├── id            BIGINT PK
├── goods_id      BIGINT          商品ID
├── sku_id        BIGINT          SKU ID
├── warehouse_id  BIGINT          仓库ID
├── merchant_id   BIGINT          商户ID
├── shop_id       BIGINT          店铺ID
├── store_id      BIGINT          门店ID（扩展）
├── quantity      INT             库存数量
├── locked_quantity INT           锁定数量
└── available_quantity INT        可用数量

erp_warehouse                    ← 仓库
├── id            BIGINT PK
├── name          VARCHAR(100)    仓库名称
├── merchant_id   BIGINT          商户ID
├── shop_id       BIGINT          店铺ID
├── store_id      BIGINT          门店ID（扩展）
└── warehouse_type TINYINT        仓库类型

---

十二、API 概览

所有 API 统一返回 ResultVo<T> 格式：

{
    "code": 200,
    "msg": "操作成功",
    "data": {}
}

核心 API 列表

模块	方法	路径	说明
认证	POST	/api/sys-api/login	用户登录
	GET	/api/sys-api/getInfo	获取用户信息
商品	GET	/api/erp-api/goods/list	商品列表
	POST	/api/erp-api/goods/add	新增商品
	PUT	/api/erp-api/goods/edit	编辑商品
	DELETE	/api/erp-api/goods/del	删除商品
	GET	/api/erp-api/goodsSku/list	SKU 列表
采购	GET	/api/erp-api/purchase/list	采购单列表
	POST	/api/erp-api/purchase/add	创建采购单
	POST	/api/erp-api/purchase/audit	审核采购单
	POST	/api/erp-api/purchase/stockIn	采购入库
库存	GET	/api/erp-api/stock/list	库存列表
	GET	/api/erp-api/stock/log	库存流水
内销	GET	/api/erp-api/order/list	内销订单列表
	POST	/api/erp-api/order/add	创建内销订单
	POST	/api/erp-api/order/audit	审核订单
会员	GET	/api/erp-api/member/list	会员列表
	POST	/api/erp-api/member/add	新增会员
系统	GET	/api/sys-api/user/list	用户列表
	GET	/api/sys-api/role/list	角色列表
	GET	/api/sys-api/menu/list	菜单列表

---

十三、常见问题

启动报错：数据库连接失败

CannotGetJdbcConnectionException: Failed to obtain JDBC Connection

解决： 确认 MySQL 已启动，检查 application.yml 中的数据库地址、用户名、密码是否正确。

启动报错：Redis 连接失败

RedisConnectionFailureException: Unable to connect to Redis

解决： 确认 Redis 已启动，检查 application.yml 中的 Redis 配置。

登录后页面空白

解决： 按 F12 打开开发者工具，查看 Console 和 Network 标签。确认 API 请求是否正常返回，Token 是否正确传递。

前端打包后访问接口 404

解决： 确认 Nginx 配置中 /prod-api/ 的 proxy_pass 已正确配置，且后端服务已启动。

---

十四、开源生态

启航开源项目矩阵：

项目	定位	Gitee	GitHub
启航零售ERP ⬅	线下零售管理平台	Gitee	GitHub
启航电商ERP	电商业务 AI 底座	Gitee	GitHub
OMS 订单中台	轻量级订单管理	Gitee	GitHub
启航跨境电商ERP	跨境电商专用版	Gitee	GitHub

---

商业版

如需多商户架构、专业技术支持、功能定制、私有化部署等，请联系：

方式	信息
官网	https://qihangerp.cn
邮箱	qihangerp@qq.com

---

💖 启航零售ERP 持续开源迭代中。如果项目对您有帮助，请点个 Star ⭐ 给予鼓励！

项目还在成长阶段，如有任何问题或建议，欢迎提交 Issue 反馈。