feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
package handler
|
|
|
|
|
|
|
|
|
|
import (
|
|
|
|
|
"net/http"
|
|
|
|
|
"strconv"
|
|
|
|
|
|
|
|
|
|
"github.com/gin-gonic/gin"
|
|
|
|
|
|
|
|
|
|
"github.com/user-management-system/internal/service"
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
// ThemeHandler 主题配置处理器
|
|
|
|
|
type ThemeHandler struct {
|
|
|
|
|
themeService *service.ThemeService
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// NewThemeHandler 创建主题配置处理器
|
|
|
|
|
func NewThemeHandler(themeService *service.ThemeService) *ThemeHandler {
|
|
|
|
|
return &ThemeHandler{themeService: themeService}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// CreateTheme 创建主题
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 创建主题
|
|
|
|
|
// @Description 创建新的主题配置
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Accept json
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Param request body service.CreateThemeRequest true "主题信息"
|
|
|
|
|
// @Success 201 {object} Response{data=domain.Theme} "主题创建成功"
|
|
|
|
|
// @Failure 400 {object} Response "请求参数错误"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes [post]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) CreateTheme(c *gin.Context) {
|
|
|
|
|
var req service.CreateThemeRequest
|
|
|
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
fix: unify handler response format in multiple handlers
- captcha_handler.go: Fix GenerateCaptcha/VerifyCaptcha to use {code, message, data}
- password_reset_handler.go: Fix all error responses to use {code, message}
- settings_handler.go: Add missing "code" and "message" fields
- sms_handler.go: Fix error responses to use {code, message}
- sso_handler.go: Fix all error responses to use {code, message, data}
- stats_handler.go: Add missing "message" field in success responses
- theme_handler.go: Fix error responses to use {code, message}
- totp_handler.go: Fix all responses to use {code, message, data}
Standardize all JSON responses to {code: 0, message: "success", data: ...} for success
and {code: XXX, message: "..."} for errors.
2026-04-11 13:06:58 +08:00
|
|
|
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": err.Error()})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
theme, err := h.themeService.CreateTheme(c.Request.Context(), &req)
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusCreated, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": theme,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// UpdateTheme 更新主题
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 更新主题
|
|
|
|
|
// @Description 更新指定主题的配置
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Accept json
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Param id path int true "主题ID"
|
|
|
|
|
// @Param request body service.UpdateThemeRequest true "更新信息"
|
|
|
|
|
// @Success 200 {object} Response{data=domain.Theme} "主题更新成功"
|
|
|
|
|
// @Failure 400 {object} Response "请求参数错误"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/{id} [put]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) UpdateTheme(c *gin.Context) {
|
|
|
|
|
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
|
|
|
|
if err != nil {
|
fix: unify handler response format in multiple handlers
- captcha_handler.go: Fix GenerateCaptcha/VerifyCaptcha to use {code, message, data}
- password_reset_handler.go: Fix all error responses to use {code, message}
- settings_handler.go: Add missing "code" and "message" fields
- sms_handler.go: Fix error responses to use {code, message}
- sso_handler.go: Fix all error responses to use {code, message, data}
- stats_handler.go: Add missing "message" field in success responses
- theme_handler.go: Fix error responses to use {code, message}
- totp_handler.go: Fix all responses to use {code, message, data}
Standardize all JSON responses to {code: 0, message: "success", data: ...} for success
and {code: XXX, message: "..."} for errors.
2026-04-11 13:06:58 +08:00
|
|
|
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": "invalid theme id"})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
var req service.UpdateThemeRequest
|
|
|
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
fix: unify handler response format in multiple handlers
- captcha_handler.go: Fix GenerateCaptcha/VerifyCaptcha to use {code, message, data}
- password_reset_handler.go: Fix all error responses to use {code, message}
- settings_handler.go: Add missing "code" and "message" fields
- sms_handler.go: Fix error responses to use {code, message}
- sso_handler.go: Fix all error responses to use {code, message, data}
- stats_handler.go: Add missing "message" field in success responses
- theme_handler.go: Fix error responses to use {code, message}
- totp_handler.go: Fix all responses to use {code, message, data}
Standardize all JSON responses to {code: 0, message: "success", data: ...} for success
and {code: XXX, message: "..."} for errors.
2026-04-11 13:06:58 +08:00
|
|
|
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": err.Error()})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
theme, err := h.themeService.UpdateTheme(c.Request.Context(), id, &req)
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": theme,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// DeleteTheme 删除主题
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 删除主题
|
|
|
|
|
// @Description 删除指定的主题
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Param id path int true "主题ID"
|
|
|
|
|
// @Success 200 {object} Response "主题删除成功"
|
|
|
|
|
// @Failure 400 {object} Response "请求参数错误"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/{id} [delete]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) DeleteTheme(c *gin.Context) {
|
|
|
|
|
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
|
|
|
|
if err != nil {
|
fix: unify handler response format in multiple handlers
- captcha_handler.go: Fix GenerateCaptcha/VerifyCaptcha to use {code, message, data}
- password_reset_handler.go: Fix all error responses to use {code, message}
- settings_handler.go: Add missing "code" and "message" fields
- sms_handler.go: Fix error responses to use {code, message}
- sso_handler.go: Fix all error responses to use {code, message, data}
- stats_handler.go: Add missing "message" field in success responses
- theme_handler.go: Fix error responses to use {code, message}
- totp_handler.go: Fix all responses to use {code, message, data}
Standardize all JSON responses to {code: 0, message: "success", data: ...} for success
and {code: XXX, message: "..."} for errors.
2026-04-11 13:06:58 +08:00
|
|
|
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": "invalid theme id"})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if err := h.themeService.DeleteTheme(c.Request.Context(), id); err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "theme deleted",
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// GetTheme 获取主题
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 获取主题
|
|
|
|
|
// @Description 根据ID获取主题详情
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Param id path int true "主题ID"
|
|
|
|
|
// @Success 200 {object} Response{data=domain.Theme} "主题详情"
|
|
|
|
|
// @Failure 400 {object} Response "请求参数错误"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/{id} [get]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) GetTheme(c *gin.Context) {
|
|
|
|
|
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
|
|
|
|
if err != nil {
|
fix: unify handler response format in multiple handlers
- captcha_handler.go: Fix GenerateCaptcha/VerifyCaptcha to use {code, message, data}
- password_reset_handler.go: Fix all error responses to use {code, message}
- settings_handler.go: Add missing "code" and "message" fields
- sms_handler.go: Fix error responses to use {code, message}
- sso_handler.go: Fix all error responses to use {code, message, data}
- stats_handler.go: Add missing "message" field in success responses
- theme_handler.go: Fix error responses to use {code, message}
- totp_handler.go: Fix all responses to use {code, message, data}
Standardize all JSON responses to {code: 0, message: "success", data: ...} for success
and {code: XXX, message: "..."} for errors.
2026-04-11 13:06:58 +08:00
|
|
|
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": "invalid theme id"})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
theme, err := h.themeService.GetTheme(c.Request.Context(), id)
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": theme,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
2026-04-11 22:49:13 +08:00
|
|
|
// ListThemes 获取主题列表
|
|
|
|
|
// @Summary 获取主题列表
|
|
|
|
|
// @Description 获取所有已启用的主题
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Success 200 {object} Response{data=[]domain.Theme} "主题列表"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes [get]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) ListThemes(c *gin.Context) {
|
|
|
|
|
themes, err := h.themeService.ListThemes(c.Request.Context())
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": themes,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ListAllThemes 获取所有主题(包括禁用的)
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 获取所有主题
|
|
|
|
|
// @Description 获取所有主题(包括已禁用的)
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Success 200 {object} Response{data=[]domain.Theme} "主题列表"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/all [get]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) ListAllThemes(c *gin.Context) {
|
|
|
|
|
themes, err := h.themeService.ListAllThemes(c.Request.Context())
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": themes,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// GetDefaultTheme 获取默认主题
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 获取默认主题
|
|
|
|
|
// @Description 获取系统默认主题
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Success 200 {object} Response{data=domain.Theme} "默认主题"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/default [get]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) GetDefaultTheme(c *gin.Context) {
|
|
|
|
|
theme, err := h.themeService.GetDefaultTheme(c.Request.Context())
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": theme,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// SetDefaultTheme 设置默认主题
|
2026-04-11 22:49:13 +08:00
|
|
|
// @Summary 设置默认主题
|
|
|
|
|
// @Description 将指定主题设为系统默认主题
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Security BearerAuth
|
|
|
|
|
// @Param id path int true "主题ID"
|
|
|
|
|
// @Success 200 {object} Response "设置成功"
|
|
|
|
|
// @Failure 400 {object} Response "请求参数错误"
|
|
|
|
|
// @Failure 401 {object} Response "未认证"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/{id}/default [put]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) SetDefaultTheme(c *gin.Context) {
|
|
|
|
|
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
|
|
|
|
if err != nil {
|
fix: unify handler response format in multiple handlers
- captcha_handler.go: Fix GenerateCaptcha/VerifyCaptcha to use {code, message, data}
- password_reset_handler.go: Fix all error responses to use {code, message}
- settings_handler.go: Add missing "code" and "message" fields
- sms_handler.go: Fix error responses to use {code, message}
- sso_handler.go: Fix all error responses to use {code, message, data}
- stats_handler.go: Add missing "message" field in success responses
- theme_handler.go: Fix error responses to use {code, message}
- totp_handler.go: Fix all responses to use {code, message, data}
Standardize all JSON responses to {code: 0, message: "success", data: ...} for success
and {code: XXX, message: "..."} for errors.
2026-04-11 13:06:58 +08:00
|
|
|
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": "invalid theme id"})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if err := h.themeService.SetDefaultTheme(c.Request.Context(), id); err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "default theme set",
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|
|
|
|
|
|
2026-04-11 22:49:13 +08:00
|
|
|
// GetActiveTheme 获取当前生效的主题
|
|
|
|
|
// @Summary 获取当前生效的主题
|
|
|
|
|
// @Description 获取当前系统正在使用的主题(公开接口)
|
|
|
|
|
// @Tags 主题管理
|
|
|
|
|
// @Produce json
|
|
|
|
|
// @Success 200 {object} Response{data=domain.Theme} "当前生效主题"
|
|
|
|
|
// @Failure 500 {object} Response "服务器错误"
|
|
|
|
|
// @Router /api/v1/themes/active [get]
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
func (h *ThemeHandler) GetActiveTheme(c *gin.Context) {
|
|
|
|
|
theme, err := h.themeService.GetActiveTheme(c.Request.Context())
|
|
|
|
|
if err != nil {
|
|
|
|
|
handleError(c, err)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-08 20:06:54 +08:00
|
|
|
c.JSON(http.StatusOK, gin.H{
|
|
|
|
|
"code": 0,
|
|
|
|
|
"message": "success",
|
|
|
|
|
"data": theme,
|
|
|
|
|
})
|
feat: backend core - auth, user, role, permission, device, webhook, monitoring, cache, repository, service, middleware, API handlers
2026-04-02 11:19:50 +08:00
|
|
|
}
|