# GalaxyMart

**Repository Path**: waceen/galaxy-mart

## Basic Information

- **Project Name**: GalaxyMart
- **Description**: 售货机项目物联网
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-29
- **Last Updated**: 2025-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GalaxyMart

#### 项目概述
参与开发"星售站"物联网售货平台。该项目致力于打造一个智能、高效、便捷的无人售货解决方案，整合了用户小程序、后台管理系统及售货机硬件接口，实现了从用户下单到售货机自动掉货的全流程自动化。平台不仅支持多终端协同，还通过物联网技术实现设备远程监控与智能运维。我的工作旨在提升购物便捷性，显著加快交易完成速度，为用户提供流畅的即时购物体验，助力企业实现智能零售升级。

基于若依框架进行搭建，，模拟使用并学习框架

#### 技术栈
- **后端**：Spring Cloud 微服务架构，集成 Spring AI 实现智能推荐与数据分析，MyBatis-Plus 提升数据访问效率。
- **前端**：采用 Vue3 + TypeScript + Element-Plus，构建高效、易用的管理后台和用户界面。
- **数据库**：MySQL 作为主数据存储，InFluxDB 用于时序数据采集与分析。
- **中间件**：Redis 实现缓存与分布式锁，RabbitMQ 负责消息队列，EMQX 支撑物联网消息通信，Elasticsearch 用于日志检索与数据分析。

#### 核心功能
- **后台管理系统**：
  - 售货机管理：支持设备的创建、状态实时监控、站点部署、维护记录等，保障设备稳定运行。
  - 商品管理：涵盖商品分类、品牌、单位、库存、价格等多维度管理，支持批量导入导出与库存预警。
  - 优惠管理：支持优惠券的创建、发放、核销全流程，灵活配置促销策略，提升用户粘性。
  - 订单管理：实现订单全流程流转、状态跟踪、异常处理及用户评论管理，保障交易闭环。
  - 会员管理：管理用户信息、积分、余额及用户反馈，支持多种会员权益和成长体系。
  - 数据分析：整合腾讯地图展示设备分布，提供多维度销售、库存、运营数据报表，辅助决策。
- **用户小程序**：
  - 商品浏览与推荐：基于用户行为和AI算法，提供个性化商品推荐，提升转化率。
  - 门店导航与站点查询：结合地图服务，帮助用户快速查找附近售货机及导航到达。
  - 购物流程：支持优惠券兑换、扫码选货、购物车管理、在线支付等一站式购物体验。
  - 互动功能：包含活动参与、意见反馈、订单评价、个人中心设置等，增强用户互动与粘性。
  - AI功能：集成AI商品推荐，智能分析用户偏好，提升商品发现效率。

#### 软件架构
软件架构说明

**项目架构图**

![img.png](img.png)

#### 部署架构

**项目部署图**

![img_1.png](img_1.png)

#### 业务流程

**流程泳道图**

![img_2.png](img_2.png)

#### 安装教程

1. 克隆本项目到本地：
   ```bash
   git clone <项目地址>
   ```
2. 进入前端目录，安装依赖：
   ```bash
   cd backend/galaxy-ui/
   npm install
   ```
3. 启动前端开发环境：
   ```bash
   npm run dev
   ```
4. 后端各服务可通过IDE或命令行直接运行对应的 Application 启动类（如 GalaxyAiApplication、GalaxyMartGatewayApplication 等）。
![img_6.png](img_6.png)
#### 使用说明

1. 启动后端所有核心服务（可根据实际需求选择启动模块）。
2. 启动前端后，访问前端页面（默认端口一般为 http://localhost:80，具体以控制台输出为准）。
3. 用户可通过小程序或前端页面进行商品浏览、下单、支付等操作。
4. 管理员可通过后台管理系统进行设备、商品、订单、会员等管理。
5. **测试环境地址**：后端测试地址为 [http://121.40.132.119/](http://121.40.132.119/)
6. **账号密码获取**：如需测试账号密码，请联系相关人员：朱先生（微信：h20060614_17，QQ：2997587532）

#### 参与贡献

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

#### 目录结构与配置说明

- **前端项目目录**：`/backend/galaxy-ui/`，请进入该目录进行前端相关操作。
- **小程序项目目录**：`/smallProgram/galaxy-mart-app-master/`，小程序源码位于此处。
- **Nacos配置目录**：`/config/nacos/`，包含各服务的配置文件。

#### 配置修改

- 各后端服务的 `application.yml` 配置文件需根据实际部署环境进行调整（如数据库、Redis、Nacos等连接信息）。
- 请确保所有服务的配置文件已正确指向实际的服务地址和端口。