Version:0.0.1.dev.260202

feat: build core architecture & implement user auth modules 🚀 feat: 搭建核心架构并实现用户认证模块 🚀 Framework Migration: Switched from Hertz to Gin, providing a more idiomatic and lightweight web foundation. ⚡ 框架迁移：从 Hertz 切换至 Gin，构建了更符合 Go 惯例且轻量级的 Web 基础。⚡ Architectural Overhaul: Refactored the 3-layer architecture from global-variable-based calls to Explicit Dependency Injection (DI) via New... factory functions. This significantly improves testability and decoupling. 🏗️ 架构重构：将三层架构从基于“全局变量”的调用重构为通过 New... 工厂函数实现的显式依赖注入 (DI)。这大幅提升了代码的可测试性与解耦程度。🏗️ User Auth: Completed and tested Register, Login, and Token Refresh APIs with robust error handling and Bcrypt password hashing. 🔐 用户认证：完成了注册、登录与 Token 刷新接口并通过测试，包含健壮的错误处理与 Bcrypt 密码哈希加密。🔐 Config Management: Integrated Viper for centralized, environment-aware configuration management. ⚙️ 配置管理：集成了 Viper，实现了中心化且具备环境感知能力的配置管理。⚙️ DevOps & Docs: Added docker-compose.yml for seamless MySQL 8.0 & environment setup. 🐳 Updated README.md with corrections for mistakes in image quoting and formats. 📝 运维与文档：新增 docker-compose.yml，实现 MySQL 8.0 环境的一键启动。🐳 更新 README.md，修改了一些图片引用和格式上小错误。📝
2026-02-02 21:32:21 +08:00
parent 8b45e0e332
commit 78aa38a6f3
19 changed files with 988 additions and 24 deletions
--- a/backend/respond/respond.go
+++ b/backend/respond/respond.go
@@ -0,0 +1,121 @@
+// Package respond 响应处理
+// 统一API响应格式和处理逻辑
+package respond
+
+type Response struct { //响应结构体
+	Status string `json:"status"`
+	Info   string `json:"info"`
+}
+
+type FinalResponse struct { //最终响应结构体
+	Status string      `json:"status"`
+	Info   string      `json:"info"`
+	Data   interface{} `json:"data"`
+}
+
+// 实现error接口
+func (r Response) Error() string { // 实现 error 接口
+	return r.Info
+}
+
+func OKWithData(response Response, data interface{}) FinalResponse { //传入一个响应结构体和数据，返回一个最终响应结构体
+	var finalResponse FinalResponse
+	finalResponse.Status = response.Status
+	finalResponse.Info = response.Info
+	finalResponse.Data = data
+	return finalResponse
+}
+
+func InternalError(err error) Response { //服务器错误
+	return Response{
+		Status: "500",
+		Info:   err.Error(),
+	}
+}
+
+var ( //请求相关的响应
+	Ok = Response{ //正常
+		Status: "10000",
+		Info:   "success",
+	}
+
+	WrongName = Response{ //用户名错误
+		Status: "40001",
+		Info:   "wrong username",
+	}
+
+	WrongPwd = Response{ //密码错误
+		Status: "40002",
+		Info:   "wrong password",
+	}
+
+	InvalidName = Response{ //用户名无效
+		Status: "40003",
+		Info:   "the username already exists",
+	}
+
+	MissingParam = Response{ //缺少参数
+		Status: "40004",
+		Info:   "missing param",
+	}
+
+	WrongParamType = Response{ //参数错误
+		Status: "40005",
+		Info:   "wrong param type",
+	}
+
+	ParamTooLong = Response{ //参数过长
+		Status: "40006",
+		Info:   "param too long",
+	}
+
+	WrongUsernameOrPwd = Response{ //用户名或密码错误
+		Status: "40007",
+		Info:   "wrong username or password",
+	}
+
+	WrongGender = Response{ //性别错误
+		Status: "40008",
+		Info:   "wrong gender",
+	}
+
+	MissingToken = Response{ //缺少token
+		Status: "40009",
+		Info:   "missing token",
+	}
+
+	InvalidTokenSingingMethod = Response{ //jwt token签名方法无效
+		Status: "40010",
+		Info:   "invalid signing method",
+	}
+
+	InvalidToken = Response{ //无效token
+		Status: "40011",
+		Info:   "invalid token",
+	}
+
+	InvalidClaims = Response{ //无效声明
+		Status: "40012",
+		Info:   "invalid claims",
+	}
+
+	WrongUserID = Response{ //用户ID错误
+		Status: "40013",
+		Info:   "wrong userid",
+	}
+
+	ErrUnauthorized = Response{ //未授权，没有权限
+		Status: "40014",
+		Info:   "unauthorized",
+	}
+
+	InvalidRefreshToken = Response{ //刷新令牌无效
+		Status: "40015",
+		Info:   "invalid refresh token",
+	}
+
+	WrongTokenType = Response{ //无效令牌类型
+		Status: "40016",
+		Info:   "wrong token type",
+	}
+)