慕旋后台管理模板

项目介绍

慕旋后台管理模板是一套完整的后台管理系统解决方案，前端采用 Vue3 + Vite 技术栈，后端采用 Golang + Gin + GORM 框架，数据存储使用 MySQL 和 Redis。

技术栈

前端: Vue3 + Vite
UI 组件: 待确定
后端: Golang + Gin
数据库: MySQL + GORM
缓存: Redis

Git 仓库

前端项目:

git clone https://git.2p2.cn/bug_busters/mx-base-admin-vue3.git

后端项目:

git clone https://git.2p2.cn/bug_busters/mx-base-admin-go.git

开发规范

本文档详细说明了项目的开发规范、Git提交规范、分支管理策略以及各环境的配置信息。

Git 提交规范

提交信息格式

所有提交信息必须遵循以下格式：

<type>(<scope>): <subject>

Type（类型）

feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整（不影响代码逻辑）
refactor: 代码重构
test: 测试相关
chore: 构建过程或辅助工具的变动

Scope（范围）

说明提交影响的范围，如：user、order、auth等

提交示例

feat(user): 添加用户注册功能

分支管理策略

分支类型

1. 主分支（master）

用途: 生产环境代码
保护: 禁止直接推送，必须通过Merge Request
合并: 只能从特性分支合并

2. 测试分支（sit）

用途: 测试环境代码
保护: 禁止直接推送，必须通过Merge Request
合并: 接收特性分支的合并请求

3. 特性分支（feature/*）

命名: feat/账号名-功能名称-日期，如：feat/LuaoX-createUser-20260331
来源: 从master分支创建
目标: 合并到sit或master分支

开发流程

1. 创建特性分支

# 从master分支创建新特性分支
git switch master
git pull origin master
git switch -c feat/账号名-功能名称-$(date +%Y%m%d)

2. 提交代码到特性分支

# 在特性分支上开发并提交
git add .
git commit -m "feat(scope): 功能描述"
git push -u origin feat/账号名-功能名称-$(date +%Y%m%d)

3. 提交Merge Request到sit分支

在代码管理平台创建Merge Request
源分支：特性分支
目标分支：sit分支
添加相关Reviewers

4. 处理冲突

sit分支冲突处理：

# 将sit分支合并到特性分支解决冲突
git switch sit
git pull
git merge feat/账号名-功能名称-$(date +%Y%m%d)
# 解决冲突后提交
git add .
git commit -m "fix: 解决合并冲突"
git push

master分支冲突处理：

# 将master分支合并到特性分支解决冲突
git switch master
git pull
git switch feat/账号名-功能名称-$(date +%Y%m%d)
git merge master
# 解决冲突后提交
git add .
git commit -m "fix: 解决与master分支的冲突"
git push feat/账号名-功能名称-$(date +%Y%m%d)