Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lazybearlee/yuedong-fitness-server
运动健康APP后端部分
https://github.com/lazybearlee/yuedong-fitness-server
gin golang gorm mysql
Last synced: 2 months ago
JSON representation
运动健康APP后端部分
- Host: GitHub
- URL: https://github.com/lazybearlee/yuedong-fitness-server
- Owner: lazybearlee
- License: mit
- Created: 2024-08-21T14:51:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-08T15:04:57.000Z (4 months ago)
- Last Synced: 2024-10-15T17:21:35.272Z (2 months ago)
- Topics: gin, golang, gorm, mysql
- Language: Go
- Homepage:
- Size: 25.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# YueDong-Fitness-Server
## 1. 项目简介
本项目是一个运动健康类的APP项目,主要功能包括用户注册登录、个人信息管理、运动数据记录、运动数据展示、个人健康状况查看等功能。本项目是后端部分,采用Gin+Gorm框架,数据库采用MySQL。
## 2. 项目结构
```
YueDong-Fitness-Server
├─annex
├─api
│ └─v1
│ ├─app
│ └─system
├─config
├─core
│ └─initialize
│ ├─app
│ └─system
├─deploy
├─docs
├─global
├─log
│ ├─2024-08-25
│ ├─2024-08-26
│ ├─2024-08-27
│ └─2024-08-28
├─middleware
├─model
│ ├─app
│ │ ├─request
│ │ └─response
│ ├─common
│ │ ├─gc
│ │ ├─request
│ │ └─response
│ └─system
│ ├─request
│ └─response
├─oss
│ └─uploads
├─router
│ ├─app
│ └─system
├─service
│ ├─app
│ ├─oss
│ └─system
├─tasks
└─utils
└─timer
```## 3. 项目运行说明
### 3.1 基础环境配置
- Go 1.18+ 版本,本项目采用 Go 1.22 版本。
- MySQL 8.0+ 版本,本项目采用 MySQL 8.0.21 版本。(mysql配置可参考docker-mysql.md文档)### 3.2 项目配置
- 在项目根目录下复制 `config_backup.yaml` 文件,并重命名为 `config.yaml`。
- 修改 `config.yaml` 文件中的数据库配置。
- `mysql`:数据库连接配置。修改path、username、password等字段。
- 确保 `system` 中的 `mysql-init-data` 字段配置正确。
- 如果初次运行项目,需要将 `mysql-init-data` 字段设置为 `true`,项目会自动初始化数据库。
- 如果需要使用云服务器部署,请修改 `system` 的 `addr` 和 `port` 字段。
- `addr`:服务器地址。(一般为服务器内网网址)### 3.3 项目运行
- 确保 MySQL 服务已启动,但不需要手动创建数据库和表,项目会自动初始化。
- 在项目根目录下执行 `go run main.go -c config.yaml` 命令运行项目。
- 也可以使用 `go build` 命令编译项目,然后执行编译后的文件。
- 也可以使用 `go build -o ` 命令编译项目,生成指定文件名的可执行文件。
- 如果是 `Windows` 系统,可以在命令行输入 `.\server_windows64.exe -c config.yaml` 运行项目。
- 如果是 `Linux` 系统,可以使用 `nohup ./server_linux64 -c config.yaml &` 命令后台运行项目。(需要先给文件执行权限)
- 如果不能直接运行,请尝试在本机安装 `Go` 环境,然后运行项目。## 4. git 使用规范
### 4.1 commit message 规范
```git
:
```#### 1. type
用于说明 commit 的类别,只允许使用下面7个标识。
- `feat`:新功能(feature)
- `fix`:修补bug
- `docs`:文档(documentation)
- `style`: 格式(不影响代码运行的变动)
- `refactor`:重构(即不是新增功能,也不是修改bug的代码变动)
- `test`:增加测试
- `chore`:构建过程或辅助工具的变动#### 2. subject
是 commit 目的的简短描述,不超过50个字符。
### 4.2 分支管理规范
- `main` 分支:主分支,只能用来发布新版本,不能在上面干活。
- `develop` 分支:开发分支,用于存放临时的开发版本。采用 Feature Branching 模型,采用多分支进行管理。
#### 4.2.1 项目管理
- 首先从 main 分支拉取最新代码:`git pull origin main`
- 新建分支:`git checkout -b develop/`
- 修改、新增或删除代码
- 提交代码:`git add .`、`git commit -m "(): "`
- 推送分支:`git push origin develop/`
- 提交 PR### 4.3 PR 规范
- PR 标题:简洁明了,包含了本次 PR 的目的。
- PR 描述:详细描述本次 PR 的内容。
- Review:指派给相关人员进行 Review。
- Assignees:指派给相关人员进行处理。