# spzx

**Repository Path**: ShallowRecall/spzx

## Basic Information

- **Project Name**: spzx
- **Description**: 尚品甄选是基于若依微服务版本开发的一个B2C电商系统，项目包含平台管理端与手机H5端。有一套完善的电商业务流程：包含商品管理、商品详情、单点登录、购物车、订单、支付、库存管理等，其中覆盖了分布式文件系统、缓存、消息队列等多种业务场景和技术实现。
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-24
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 尚品甄选电商平台

## 介绍
尚品甄选是基于若依微服务版本开发的一个B2C电商系统，项目包含平台管理端与手机H5端。系统实现了完善的电商业务流程，包括商品管理、商品详情、单点登录、购物车、订单、支付、库存管理等核心功能。项目中涵盖了分布式文件系统、缓存、消息队列等多种技术场景，适用于企业级电商系统的开发参考。

## 软件架构
- **基础框架**：基于Spring Boot与若依微服务架构
- **服务模块**：
  - `spzx-auth`：认证中心，负责用户登录、Token生成与验证
  - `spzx-gateway`：网关服务，负责路由、权限控制、验证码、XSS过滤等
  - `spzx-system`：系统管理模块，包含用户、角色、权限、菜单、日志等基础功能
  - `spzx-product`：商品管理模块，包含商品、品牌、分类、库存等业务功能
  - `spzx-file`：文件服务，支持本地与MinIO文件上传与管理
  - `spzx-gen`：代码生成模块，支持数据库表结构自动生成前后端代码
  - `spzx-monitor`：监控模块，集成Spring Boot Admin进行服务监控
- **公共组件**：
  - `spzx-common-core`：核心工具类与基础封装
  - `spzx-common-security`：安全控制、权限验证、Token处理
  - `spzx-common-redis`：Redis缓存封装
  - `spzx-common-datascope`：数据权限控制
  - `spzx-common-log`：操作日志记录
- **服务注册与发现**：使用Nacos作为服务注册中心
- **网关与安全**：Spring Cloud Gateway + Spring Security + JWT
- **缓存**：Redis
- **文件存储**：支持本地存储与MinIO对象存储
- **日志**：集成操作日志、登录日志、异常处理等模块
- **前端**：支持H5端与管理后台界面

## 安装教程

1. **环境准备**
   - JDK 1.8+
   - Maven 3.6+
   - MySQL 5.7+
   - Redis 6.0+
   - Nacos 2.0+
   - MinIO（可选）

2. **数据库初始化**
   - 创建数据库 `spzx`
   - 执行SQL脚本（位于各模块的`resources/mapper`目录下）

3. **配置修改**
   - 修改各模块的 `application.yml` 或 `bootstrap.yml` 文件，配置数据库、Redis、MinIO等连接信息

4. **启动服务**
   - 启动 Nacos 注册中心
   - 启动 `spzx-auth` 认证服务
   - 启动 `spzx-gateway` 网关服务
   - 启动 `spzx-system` 系统管理服务
   - 启动 `spzx-product` 商品服务
   - 启动 `spzx-file` 文件服务
   - 启动 `spzx-monitor` 监控服务（可选）

5. **访问系统**
   - 管理后台：`http://localhost:8080`
   - H5端：`http://localhost:8080/h5`

## 使用说明

1. **登录系统**
   - 使用默认账号 `admin` 登录后台管理系统

2. **系统管理**
   - 用户管理：添加、编辑、删除用户，分配角色与权限
   - 角色管理：定义角色权限与数据范围
   - 菜单管理：配置系统菜单与权限标识
   - 参数管理：配置系统参数与缓存刷新
   - 操作日志：查看用户操作记录
   - 登录日志：查看用户登录记录

3. **商品管理**
   - 商品分类：支持多级分类管理
   - 商品品牌：管理商品品牌信息
   - 商品管理：添加、编辑、上下架商品
   - SKU管理：管理商品规格与库存
   - 商品详情：设置商品图文详情

4. **文件管理**
   - 支持本地与MinIO上传图片、文件
   - 支持文件上传、下载、删除等操作

5. **代码生成**
   - 使用 `spzx-gen` 模块，支持根据数据库表结构自动生成前后端代码
   - 支持树形结构、CRUD结构等模板

6. **监控管理**
   - 使用 `spzx-monitor` 模块，集成Spring Boot Admin，可查看各服务运行状态、内存、线程、日志等信息

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 特技

1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)