# 微服务校园电商 **Repository Path**: outoftime/wfw-e-commerce ## Basic Information - **Project Name**: 微服务校园电商 - **Description**: 基于golang 的微服务校园电商 - **Primary Language**: Go - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 3 - **Created**: 2026-04-03 - **Last Updated**: 2026-04-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 微服务校园电商项目 2025.11.20：将文件上传（资源服务）从业务网关（Gateway-Admin）中拆分出来：[https://docs.qq.com/doc/DTVNsbEtISXBCRUdv](http://) 2025.11.23：解决ES相关搜索问题：[https://docs.qq.com/doc/DTXJaVU1MdnduQmtx?nlc=1](http://) [https://docs.qq.com/doc/DTUtweXFuaWZncEFk?nlc=1](http://) [https://docs.qq.com/doc/DTVVMdFZvY2FQTmdO?nlc=1](http://) # 🎓 微服务校园电商系统 (WFW E-Commerce) ![Go Version](https://img.shields.io/badge/Go-1.16%2B-blue?logo=go) ![Architecture](https://img.shields.io/badge/Architecture-Microservices-orange) ![License](https://img.shields.io/badge/License-MIT-green) ![Status](https://img.shields.io/badge/Status-Developing-yellow) ## 📖 项目概述 本项目是一个基于 **Go** 语言实现的校园电商系统，采用 **微服务架构**，旨在为校园电商平台提供一个高效、可扩展的解决方案。通过拆分为多个微服务模块，系统能高效地处理商品管理、用户管理、订单管理、搜索功能等任务。 --- ## 🛠️ 技术栈 - **编程语言**: 🐹 Go (Golang) - **架构设计**: ☁️ 微服务架构 (Microservices) - **服务发现**: ⚙️ etcd - **消息队列**: 🐇 RabbitMQ - **搜索引擎**: 🔍 Elasticsearch - **依赖管理**: 📦 Go Modules - **容器化**: 🐳 Docker（可选） --- ## 🏗️ 项目结构 ```text ├── 📂 app/ # 核心业务模块 │ ├── 📦 order # 订单管理模块 │ ├── 🛡️ gateway-admin # 后台管理网关 │ ├── 👮 admin # 管理员相关功能 │ ├── 📱 gateway-h5 # H5端网关 │ ├── 👤 user # 用户管理模块 │ ├── 🔍 search # 搜索服务模块 │ ├── 🛍️ goods # 商品管理模块 │ ├── 👷 worker # 工作者模块 │ ├── 💾 resource # 资源管理模块 │ ├── 💬 interaction # 用户交互模块 │ └── 🖼️ banner # 广告横幅管理模块 ├── 📂 utility/ # 公共工具模块 │ ├── 🔌 middleware # 中间件 │ ├── 📜 jiaoben # 脚本文件 │ ├── 🔑 token.go # Token 处理工具 │ ├── 🕒 time.go # 时间工具函数 │ ├── 🐇 rabbitmq # RabbitMQ 相关工具 │ └── 📄 .gitkeep # 保持空文件夹 ├── 📂 hack/ # 构建和脚本工具 │ ├── 🔨 hack-cli.mk # Makefile（命令行工具） │ └── 📜 hack.mk # 另一脚本文件 ├── 📄 go.mod # Go模块依赖管理文件 ├── 📄 go.sum # Go模块校验文件 ├── 📝 README.MD # 项目说明文档 ├── 📊 test1.csv # 测试数据文件1 ├── 📊 test2.csv # 测试数据文件2 └── ⚙️ .DS_Store # macOS 系统生成的文件（可忽略） ``` ## 🧩 功能模块 ### 1. 📦 订单管理 (`order`) 该模块负责管理用户的订单创建、查询、支付和状态更新等操作。 ### 2. 🛡️ 后台管理系统网关 (`gateway-admin`) 这是管理系统的后台入口，提供管理人员对商品、用户和订单的操作权限。 ### 3. 👤 用户管理 (`user`) 该模块用于用户的注册、登录和信息管理，包括用户认证和权限控制。 ### 4. 🔍 搜索服务 (`search`) 该模块通过 **Elasticsearch** 提供商品的搜索功能，支持多条件筛选与高效查询。 ### 5. 🛍️ 商品管理 (`goods`) 负责商品信息的增删改查，商品的分类、库存管理和价格设置。 ### 6. 🖼️ 广告横幅管理 (`banner`) 为平台提供广告横幅展示和管理功能。 ### 7. 👷 工作者模块 (`worker`) 该模块负责处理后台任务的执行，比如数据同步和清理操作。 ### 8. 💾 资源管理 (`resource`) 负责平台资源（如图片、视频等）的上传、存储和分发。 ### 9. 💬 用户交互 (`interaction`) 提供用户之间的互动功能，比如评论、点赞、私信等。 ### 10. 🔑 管理员功能 (`admin`) 管理员可以管理用户、商品、订单、系统设置等。 ------ ## 🚀 快速开始 ### 1. 环境准备 确保你已经安装了以下工具： - [Go](https://golang.org/doc/install) 1.16+ 版本 - [Docker](https://www.docker.com/products/docker-desktop)（可选） - [Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/index.html) - [etcd](https://etcd.io/docs/) - [RabbitMQ](https://www.rabbitmq.com/) ### 2. 克隆项目 Bash ``` git clone [https://gitee.com/pasionfru/wfw-e-commerce.git](https://gitee.com/pasionfru/wfw-e-commerce.git) cd wfw-e-commerce ``` ### 3. 安装依赖 通过以下命令安装所有依赖： Bash ``` go mod tidy ``` ### 4. 启动服务 **直接运行：** 运行以下命令启动项目： Bash ``` go run main.go ``` **使用 Docker：** 构建并运行 Docker 容器： Bash ``` docker build -t wfw-ecommerce . docker run -p 8080:8080 wfw-ecommerce ``` ### 5. 访问系统 默认情况下，系统将启动在 `http://localhost:8080`。你可以通过浏览器访问该地址进行操作。 ------ ## ⚙️ 配置说明 ### etcd 配置 `default.etcd/` 文件夹包含与服务发现和配置相关的文件。你可以根据需要进行修改。 ### RabbitMQ 配置 项目使用 RabbitMQ 进行异步任务处理。你需要配置 RabbitMQ 服务的连接信息。