oci-portal/internal/api/proxy.go

package api

import (
	"errors"
	"net/http"

	"github.com/gin-gonic/gin"

	"oci-portal/internal/service"
)

// proxyHandler 处理出站代理配置的增删改查。
type proxyHandler struct {
	svc *service.ProxyService
}

// list 返回全部代理(脱敏视图,含引用计数)。
//
// @Summary  代理列表
// @Tags     设置
// @Success  200 {object} itemsResponse[service.ProxyView] "items"
// @Security BearerAuth
// @Router   /api/v1/proxies [get]
func (h *proxyHandler) list(c *gin.Context) {
	items, err := h.svc.List(c.Request.Context())
	if err != nil {
		respondError(c, err)
		return
	}
	c.JSON(http.StatusOK, gin.H{"items": items})
}

// create 新建代理。
//
// @Summary  创建代理
// @Tags     设置
// @Param    body body service.ProxyInput true "代理配置(密码只写不回)"
// @Success  201 {object} service.ProxyView
// @Security BearerAuth
// @Router   /api/v1/proxies [post]
func (h *proxyHandler) create(c *gin.Context) {
	var req service.ProxyInput
	if err := c.ShouldBindJSON(&req); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	view, err := h.svc.Create(c.Request.Context(), req)
	if err != nil {
		h.respond(c, err)
		return
	}
	c.JSON(http.StatusCreated, view)
}

// update 更新代理;密码缺省沿用、空串清除。
//
// @Summary  更新代理
// @Tags     设置
// @Param    id path int true "代理 ID"
// @Param    body body service.ProxyInput true "代理配置(密码缺省沿用)"
// @Success  200 {object} service.ProxyView
// @Security BearerAuth
// @Router   /api/v1/proxies/{id} [put]
func (h *proxyHandler) update(c *gin.Context) {
	id, ok := pathID(c)
	if !ok {
		return
	}
	var req service.ProxyInput
	if err := c.ShouldBindJSON(&req); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	view, err := h.svc.Update(c.Request.Context(), id, req)
	if err != nil {
		h.respond(c, err)
		return
	}
	c.JSON(http.StatusOK, view)
}

// remove 删除代理;仍被租户引用时返回 409。
//
// @Summary  删除代理
// @Tags     设置
// @Param    id path int true "代理 ID"
// @Success  204 "无内容"
// @Security BearerAuth
// @Router   /api/v1/proxies/{id} [delete]
func (h *proxyHandler) remove(c *gin.Context) {
	id, ok := pathID(c)
	if !ok {
		return
	}
	if err := h.svc.Delete(c.Request.Context(), id); err != nil {
		h.respond(c, err)
		return
	}
	c.Status(http.StatusNoContent)
}

// importBatch 批量导入代理;逐行解析,返回成功与脱敏后的失败明细。
//
// @Summary  批量导入代理
// @Tags     设置
// @Param    body body object true "请求体(见接口说明)"
// @Success  200 {object} service.ImportResult
// @Security BearerAuth
// @Router   /api/v1/proxies/import [post]
func (h *proxyHandler) importBatch(c *gin.Context) {
	var req struct {
		Text string `json:"text" binding:"required"`
	}
	if err := c.ShouldBindJSON(&req); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	res, err := h.svc.Import(c.Request.Context(), req.Text)
	if err != nil {
		respondError(c, err)
		return
	}
	c.JSON(http.StatusOK, res)
}

// probe 手动重测代理出口地区,同步返回最新视图。
//
// @Summary  手动重测代理出口地区,同步返回最新视图
// @Tags     设置
// @Param    id path int true "配置 ID"
// @Success  200 {object} service.ProxyView
// @Security BearerAuth
// @Router   /api/v1/proxies/{id}/probe [post]
func (h *proxyHandler) probe(c *gin.Context) {
	id, ok := pathID(c)
	if !ok {
		return
	}
	view, err := h.svc.Probe(c.Request.Context(), id)
	if err != nil {
		h.respond(c, err)
		return
	}
	c.JSON(http.StatusOK, view)
}

// setTenants 设置代理关联的租户全集(代理侧批量关联 / 解除)。
//
// @Summary  设置代理关联的租户全集
// @Tags     设置
// @Param    id path int true "代理 ID"
// @Param    body body object true "请求体 {\"ociConfigIds\": [1,2]}"
// @Success  200 {object} usedByResponse "usedBy"
// @Security BearerAuth
// @Router   /api/v1/proxies/{id}/tenants [put]
func (h *proxyHandler) setTenants(c *gin.Context) {
	id, ok := pathID(c)
	if !ok {
		return
	}
	var req struct {
		OciConfigIDs []uint `json:"ociConfigIds"`
	}
	if err := c.ShouldBindJSON(&req); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	used, err := h.svc.SetTenants(c.Request.Context(), id, req.OciConfigIDs)
	if err != nil {
		h.respond(c, err)
		return
	}
	c.JSON(http.StatusOK, gin.H{"usedBy": used})
}

// respond 把代理业务错误映射到语义状态码。
func (h *proxyHandler) respond(c *gin.Context, err error) {
	switch {
	case errors.Is(err, service.ErrProxyInvalid):
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
	case errors.Is(err, service.ErrProxyInUse):
		c.JSON(http.StatusConflict, gin.H{"error": err.Error()})
	default:
		respondError(c, err)
	}
}