Skip to content

源码目录介绍

SparkShop 是一个基于 Java 的电商平台项目,采用前后端分离架构。下面是项目的目录结构及各部分的详细介绍:

项目根目录结构

sparkshop-java
├── LICENSE                    # 开源许可证文件
├── README.md                  # 项目说明文档
├── README.en.md               # 英文项目说明文档
├── sparkshop_java.sql         # 数据库初始化脚本
├── screenshot                 # 项目截图目录
├── server                     # 后端服务目录
└── web                        # 前端项目目录

后端服务目录 (server)

后端采用 Spring Boot 框架,使用 Maven 进行项目管理,分为多个模块:

server
├── sparkshop-admin           # 管理后台API模块
├── sparkshop-common          # 公共工具模块
├── sparkshop-front           # 前台API模块
├── sparkshop-pc              # PC端API模块
├── sparkshop-resources       # 静态资源目录
└── sparkshop-service         # 服务层模块

sparkshop-admin

管理后台API模块,提供后台管理系统的接口服务,包含商品管理、订单管理、用户管理等功能。

sparkshop-common

公共工具模块,包含项目中使用的通用工具类、常量定义、异常处理等公共代码。

sparkshop-front

前台API模块,提供面向普通用户的接口服务,如商品浏览、购物车、下单等功能。

sparkshop-pc

PC端API模块,专门为PC端网站提供的接口服务。

sparkshop-resources

静态资源目录,主要用于存储上传的图片等媒体文件。

sparkshop-service

服务层模块,包含业务逻辑实现和实体类定义,主要分为:

  • entity:实体类定义,包含商品、用户、订单等相关实体
  • vo:视图对象,用于前后端数据传输

前端项目目录 (web)

前端分为管理后台和移动端应用两部分:

web
├── admin                     # 管理后台项目
└── uniapp                    # 移动端应用项目

管理后台 (admin)

基于 Vue.js 和 Element UI 构建的管理后台系统:

admin
├── src
│   ├── assets               # 静态资源
│   │   ├── diy_img          # DIY页面图片资源
│   │   └── icons            # 图标组件
│   ├── views                # 页面组件
│   │   ├── admin            # 管理员管理
│   │   ├── appraise         # 评价管理
│   │   ├── article          # 文章管理
│   │   ├── city             # 城市管理
│   │   ├── coupon           # 优惠券管理
│   │   ├── diy              # DIY页面管理
│   │   ├── express          # 快递管理
│   │   ├── financeLog       # 财务日志
│   │   ├── goods            # 商品管理
│   │   ├── order            # 订单管理
│   │   ├── refund           # 退款管理
│   │   ├── seckill          # 秒杀管理
│   │   ├── system           # 系统设置
│   │   └── user             # 用户管理
│   ├── store                # Vuex状态管理
│   ├── utils                # 工具函数
│   └── style                # 样式文件
├── babel.config.js          # Babel配置
├── vite.config.js           # Vite构建配置
└── vue.config.js            # Vue CLI配置

移动端应用 (uniapp)

基于 uni-app 框架开发的跨平台移动应用:

uniapp
├── pages                    # 页面目录
│   ├── address              # 地址管理
│   ├── cart                 # 购物车
│   ├── category             # 商品分类
│   ├── index                # 首页
│   ├── mine                 # 个人中心
│   ├── order                # 订单相关
│   ├── product              # 商品详情
│   ├── public               # 公共页面
│   ├── refund               # 退款相关
│   ├── seckill              # 秒杀活动
│   ├── set                  # 设置
│   └── user                 # 用户相关
├── components               # 公共组件
├── static                   # 静态资源
├── store                    # Vuex状态管理
├── utils                    # 工具函数
├── api                      # API接口
├── config                   # 配置文件
├── mixins                   # 混入
├── uni_modules              # uni-app插件模块
└── pages.json               # 页面配置文件

项目特点

  1. 模块化设计:后端采用多模块设计,各模块职责清晰,便于维护和扩展
  2. 前后端分离:前端和后端完全分离,通过API接口进行数据交互
  3. 多端支持:支持管理后台、PC端和移动端多平台应用
  4. 丰富的功能:包含商品管理、订单管理、用户管理、优惠券、秒杀等电商核心功能
  5. DIY页面:支持可视化DIY页面设计,灵活定制商城页面

技术栈

后端

  • Spring Boot:基础框架
  • MyBatis:ORM框架
  • Maven:项目管理工具

前端

  • Vue.js:前端框架
  • Element UI:管理后台UI框架
  • uni-app:跨平台移动端开发框架
  • Vite:前端构建工具