feat: 统一sql命名、函数命名

internal/pkg/errs/errs.go

@@ -19,34 +19,35 @@ func New(httpCode int, msg string) *AppError {
 }
 
 var (
-	ErrInvalidCredentials            = New(http.StatusUnauthorized, "用户名或密码错误")
-	ErrUserDisabled                  = New(http.StatusForbidden, "用户已被禁用")
-	ErrUnauthenticated               = New(http.StatusUnauthorized, "用户未登录或登录已失效")
-	ErrUnauthorized                  = New(http.StatusUnauthorized, "认证失败：无法获取当前用户信息")
-	ErrInvalidToken                  = New(http.StatusUnauthorized, "登录凭证无效")
-	ErrInvalidTokenClaims            = New(http.StatusUnauthorized, "登录凭证解析失败")
-	ErrInvalidRefreshToken           = New(http.StatusBadRequest, "invalid_grant")
-	ErrExpiredRefreshToken           = New(http.StatusBadRequest, "invalid_grant")
-	ErrUserNotFound                  = New(http.StatusNotFound, "用户数据不存在")
-	ErrCategoryNotFound              = New(http.StatusNotFound, "分类数据不存在")
-	ErrTagNotFound                   = New(http.StatusNotFound, "标签数据不存在")
-	ErrSysApiNotFound                = New(http.StatusNotFound, "接口数据不存在")
-	ErrPostNotFound                  = New(http.StatusNotFound, "文章数据不存在")
-	ErrSysMenuNotFound               = New(http.StatusNotFound, "菜单数据不存在")
-	ErrSysRoleNotFound               = New(http.StatusNotFound, "角色数据不存在")
-	ErrCannotDeleteSuperAdmin        = New(http.StatusForbidden, "超级管理员账号无法被删除")
-	ErrSlugRequired                  = New(http.StatusBadRequest, "slug不能为空")
-	ErrIDRequired                    = New(http.StatusBadRequest, "id不能为空")
-	ErrPermissionDenied              = New(http.StatusForbidden, "没有权限访问该资源")
-	ErrInvalidID                     = New(http.StatusBadRequest, "id非法请检查传入的id")
-	ErrEmptyBody                     = New(http.StatusBadRequest, "请求内容(body)不能为空")
-	ErrInvalidJSON                   = New(http.StatusBadRequest, "请求数据格式错误")
-	ErrAccountAlreadyExists          = New(http.StatusBadRequest, "账号已存在")
-	ErrCodeAlreadyExists             = New(http.StatusBadRequest, "角色编码不允许重复")
-	ErrSlugAlreadyExists             = New(http.StatusBadRequest, "slug不允许重复")
-	ErrPermissionCodeAlreadyExists   = New(http.StatusBadRequest, "权限编码不允许重复")
-	ErrCategoryCodeAlreadyExists     = New(http.StatusBadRequest, "分类编码不允许重复")
-	ErrTagCodeAlreadyExists          = New(http.StatusBadRequest, "标签编码不允许重复")
-	ErrSysMenusPathUniqueIdx         = New(http.StatusBadRequest, "菜单路径不允许重复")
-	ErrSysApiMethodPathAlreadyExists = New(http.StatusBadRequest, "接口方法(method)路径(path)不允许重复")
+	ErrInvalidCredentials          = New(http.StatusUnauthorized, "用户名或密码错误")
+	ErrUserDisabled                = New(http.StatusForbidden, "用户已被禁用")
+	ErrUnauthenticated             = New(http.StatusUnauthorized, "用户未登录或登录已失效")
+	ErrUnauthorized                = New(http.StatusUnauthorized, "认证失败：无法获取当前用户信息")
+	ErrInvalidToken                = New(http.StatusUnauthorized, "登录凭证无效")
+	ErrInvalidTokenClaims          = New(http.StatusUnauthorized, "登录凭证解析失败")
+	ErrInvalidRefreshToken         = New(http.StatusBadRequest, "invalid_grant")
+	ErrExpiredRefreshToken         = New(http.StatusBadRequest, "invalid_grant")
+	ErrUserNotFound                = New(http.StatusNotFound, "用户数据不存在")
+	ErrCategoryNotFound            = New(http.StatusNotFound, "分类数据不存在")
+	ErrTagNotFound                 = New(http.StatusNotFound, "标签数据不存在")
+	ErrApiNotFound                 = New(http.StatusNotFound, "接口数据不存在")
+	ErrPostNotFound                = New(http.StatusNotFound, "文章数据不存在")
+	ErrMenuNotFound                = New(http.StatusNotFound, "菜单数据不存在")
+	ErrRoleNotFound                = New(http.StatusNotFound, "角色数据不存在")
+	ErrCannotDeleteSuperAdmin      = New(http.StatusForbidden, "超级管理员账号无法被删除")
+	ErrSlugRequired                = New(http.StatusBadRequest, "slug不能为空")
+	ErrIDRequired                  = New(http.StatusBadRequest, "id不能为空")
+	ErrPermissionDenied            = New(http.StatusForbidden, "没有权限访问该资源")
+	ErrInvalidID                   = New(http.StatusBadRequest, "id非法请检查传入的id")
+	ErrEmptyBody                   = New(http.StatusBadRequest, "请求内容(body)不能为空")
+	ErrInvalidJSON                 = New(http.StatusBadRequest, "请求数据格式错误")
+	ErrAccountAlreadyExists        = New(http.StatusBadRequest, "账号已存在")
+	ErrCodeAlreadyExists           = New(http.StatusBadRequest, "角色编码不允许重复")
+	ErrSlugAlreadyExists           = New(http.StatusBadRequest, "slug不允许重复")
+	ErrPermissionCodeAlreadyExists = New(http.StatusBadRequest, "权限编码不允许重复")
+	ErrCategoryCodeAlreadyExists   = New(http.StatusBadRequest, "分类编码不允许重复")
+	ErrTagCodeAlreadyExists        = New(http.StatusBadRequest, "标签编码不允许重复")
+	ErrMenusPathUniqueIdx          = New(http.StatusBadRequest, "菜单路径不允许重复")
+	ErrApiMethodPathAlreadyExists  = New(http.StatusBadRequest, "接口方法(method)路径(path)不允许重复")
+	ErrInvalidApiPath              = New(http.StatusBadRequest, "接口路径格式不正确，必须以/开头，参数段需为{name}格式")
 )

internal/pkg/httputil/request.go

@@ -4,6 +4,7 @@ import (
 	"encoding/json"
 	"errors"
 	"io"
+	"net"
 	"net/http"
 	"net/url"
 	"server/internal/config"
@@ -11,6 +12,7 @@ import (
 	"server/internal/pkg/errs"
 	"server/internal/pkg/validator"
 	"strconv"
+	"strings"
 
 	"github.com/go-chi/chi/v5"
 )
@@ -71,6 +73,28 @@ func BindJson(r *http.Request, dest any) error {
 	return nil
 }
 
+// ClientIP 获取客户端 IP，依次从 X-Forwarded-For、X-Real-IP、RemoteAddr 取值
+func ClientIP(r *http.Request) string {
+	if xff := r.Header.Get("X-Forwarded-For"); xff != "" {
+		parts := strings.Split(xff, ",")
+		if len(parts) > 0 {
+			return strings.TrimSpace(parts[0])
+		}
+	}
+
+	if ip := r.Header.Get("X-Real-IP"); ip != "" {
+		return ip
+	}
+
+	// RemoteAddr: IP:port
+	host, _, err := net.SplitHostPort(r.RemoteAddr)
+	if err == nil {
+		return host
+	}
+
+	return r.RemoteAddr
+}
+
 func BuildFileUrl(path *string) string {
 	if path == nil || *path == "" {
 		return ""