Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/congz666/cmall-go
golang写的电子商城的API接口
https://github.com/congz666/cmall-go
gin golang gorm
Last synced: 4 days ago
JSON representation
golang写的电子商城的API接口
- Host: GitHub
- URL: https://github.com/congz666/cmall-go
- Owner: congz666
- License: mit
- Created: 2020-06-14T14:58:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-03-13T03:28:30.000Z (almost 4 years ago)
- Last Synced: 2025-01-21T05:06:52.777Z (12 days ago)
- Topics: gin, golang, gorm
- Language: Go
- Homepage: http://cmall.congz.top
- Size: 155 KB
- Stars: 411
- Watchers: 8
- Forks: 81
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CMall 电子商城
#### 此项目为前后端分离项目，已经部署至[CMall http://cmall.congz.top/#/](http://cmall.congz.top/#/)，用 golang 实现接口函数，如需要看前端请前往[cmall-vue](https://github.com/congz666/cmall-vue)
## 前言
本人准备大三，拿这个项目学习一些新的技能，如果有错误或者实现不好的地方欢迎 issues
后续会实现支付功能（已完成)，QQ 第三方登录 (已完成)，重写搜索系统，后台管理系统，优化代码和数据库，因为即将开学，后续更新的进度可能会放慢。
如果觉得这个项目不错，您可以右上角 Star 支持一下！谢谢您的支持，您的支持是我完善的动力！
## 项目依赖
本项目采用了一系列 golang 中比较流行的组件来进行开发
- Gin
- Gorm
- mysql
- redis
- godotenv
- jwt-go
- go-mail
使用的 SDK 或调用的 API
- 阿里云 OSS
- 极验
- 支付 FM
- QQ 第三方登录
## 目录结构
```
mall-go/
├── api
├── cache
├── conf
├── middleware
├── model
├── pkg
│ ├── e
│ ├── util
│ ├── sdk
├── serializer
├── server
└── service
```
- api：用于定义接口函数
- cache：redis 相关操作
- conf：用于存储配置文件
- middleware：应用中间件
- model：应用数据库模型
- pkg / e：封装错误码
- pkg / util：工具函数
- pkg / sdk: 极验 sdk 核心函数
- serializer：将数据序列化为 json 的函数
- server 路由逻辑处理
- service：接口函数的实现
## Godotenv
项目在启动的时候依赖以下环境变量，但是在也可以在项目根目录创建.env 文件设置环境变量便于使用(建议开发环境使用)
```
MYSQL_DSN="db_user:db_password@/db_name?charset=utf8&parseTime=True&loc=Local" # Mysql连接语句
REDIS_ADDR="127.0.0.1:6379" # Redis端口地址
REDIS_PW="" # Redis连接密码
REDIS_DB="" # Redis库从0到10
GIN_MODE="debug"#开发模式下使用debug
OSS_END_POINT="oss-cn-shenzhen.aliyuncs.com"#你的仓库所在的阿里云对象存储地域节点
OSS_ACCESS_KEY_ID=""#阿里云RAM访问控制用户ID
OSS_ACCESS_KEY_SECRET=""#阿里云RAM访问控制KEY
OSS_BUCKET=""#阿里云OSS仓库名
VAILD_EMAIL="http://localhost:8080/#/vaild/email/" #本地环境邮箱验证地址
#本项目用的是163邮箱STMP
SMTP_HOST=""#163是smtp.163.com
SMTP_EMAIL=""#发送邮件的邮箱
SMTP_PASS=""#SMTP服务的通行证
#极验配置
GEETEST_ID=""#极验账号对应的ID（需要申请）
GEETEST_KEY=""#极验账号对应的KEY（需要申请）
#以下是支付FM配置，详情请查阅支付FM文档
FM_Pay_ID=""#支付FM账号对应的ID
FM_Pay_Key=""#支付FM账号对应的KEY
FM_Pay_NotifyURL=""#支付FM回调地址
FM_Pay_ReturnURL=""#支付FM返回地址
#以下是QQ第三方登录配置，详情请查阅QQ开放平台帮助文档
QQ_Client_ID=""#申请QQ登录时的ID
QQ_Client_KEY=""#申请QQ登录时的KEY
QQ_Redirect_URI=""#QQ登录回调地址
QQ_State=""
```
## 运行
本项目使用[Go Mod](https://github.com/golang/go/wiki/Modules)管理依赖。
```
git clone https://github.com/congz666/cmall-go.git
cd cmall-go
go run main.go
```
项目运行后启动在 3000 端口