perf: access token cache

internal/apps/cap/routers.go

@@ -6,9 +6,15 @@ package cap
 import (
 	"net/http"
 
-		"github.com/gin-gonic/gin"
+	"github.com/Rain-kl/Wavelet/internal/common/response"
+	pkgcap "github.com/Rain-kl/Wavelet/pkg/cap"
+	"github.com/Rain-kl/Wavelet/pkg/logger"
+	"github.com/gin-gonic/gin"
 )
 
+// ChallengeResponse is a local type alias for the pkg/cap.ChallengeResponse struct
+type ChallengeResponse = pkgcap.ChallengeResponse
+
 type challengeRequest struct {
 	Scope string `json:"scope" form:"scope"`
 }
@@ -26,8 +32,8 @@ type redeemRequest struct {
 // @Accept json
 // @Produce json
 // @Param request body challengeRequest false "可选范围限制参数"
-// @Success 200 {object} cap.ChallengeResponse "成功返回 PoW 难题"
-// @Failure 500 {object} RedeemResponse "内部服务错误"
+// @Success 200 {object} response.Any{data=cap.ChallengeResponse} "成功返回 PoW 难题"
+// @Failure 500 {object} response.Any "内部服务错误"
 // @Router /api/cap/challenge [post]
 func Challenge(c *gin.Context) {
 	var req challengeRequest
@@ -40,14 +46,12 @@ func Challenge(c *gin.Context) {
 	mgr := GetDefaultManager()
 	resp, err := mgr.Generate(c.Request.Context(), req.Scope)
 	if err != nil {
-		c.JSON(http.StatusInternalServerError, RedeemResponse{
-			Success: false,
-			Error:   err.Error(),
-		})
+		logger.ErrorF(c.Request.Context(), "Generate cap challenge failed: %v", err)
+		response.AbortInternal(c, "生成验证难题失败，请稍后再试")
 		return
 	}
 
-	c.JSON(http.StatusOK, resp)
+	c.JSON(http.StatusOK, response.OK(resp))
 }
 
 // Redeem 提交 PoW 解答并兑换一次性凭证 Token
@@ -57,17 +61,14 @@ func Challenge(c *gin.Context) {
 // @Accept json
 // @Produce json
 // @Param request body redeemRequest true "难题 Token 与解答 solutions 数组"
-// @Success 200 {object} RedeemResponse "核销成功，返回 X-Cap-Token"
-// @Failure 400 {object} RedeemResponse "参数错误或核销失败"
-// @Failure 500 {object} RedeemResponse "内部服务错误"
+// @Success 200 {object} response.Any{data=cap.RedeemResponse} "核销成功，返回 X-Cap-Token"
+// @Failure 400 {object} response.Any "参数错误或核销失败"
+// @Failure 500 {object} response.Any "内部服务错误"
 // @Router /api/cap/redeem [post]
 func Redeem(c *gin.Context) {
 	var req redeemRequest
 	if err := c.ShouldBindJSON(&req); err != nil {
-		c.JSON(http.StatusBadRequest, RedeemResponse{
-			Success: false,
-			Error:   "无效的参数",
-		})
+		response.AbortBadRequest(c, "无效的参数")
 		return
 	}
 
@@ -78,17 +79,15 @@ func Redeem(c *gin.Context) {
 	mgr := GetDefaultManager()
 	resp, err := mgr.Redeem(c.Request.Context(), req.Token, req.Solutions, req.Scope)
 	if err != nil {
-		c.JSON(http.StatusInternalServerError, RedeemResponse{
-			Success: false,
-			Error:   err.Error(),
-		})
+		logger.ErrorF(c.Request.Context(), "Redeem cap solutions failed: %v", err)
+		response.AbortInternal(c, "校验验证解答失败，请稍后再试")
 		return
 	}
 
 	if !resp.Success {
-		c.JSON(http.StatusBadRequest, resp)
+		response.AbortBadRequest(c, resp.Error)
 		return
 	}
 
-	c.JSON(http.StatusOK, resp)
+	c.JSON(http.StatusOK, response.OK(resp))
 }

internal/apps/cap/routers_test.go

@@ -46,10 +46,14 @@ func TestCapEndpointsAndMiddleware(t *testing.T) {
 		t.Fatalf("expected 200 OK, got %d. Body: %s", w.Code, w.Body.String())
 	}
 
-	var challengeResp pkgcap.ChallengeResponse
-	if err := json.Unmarshal(w.Body.Bytes(), &challengeResp); err != nil {
+	var envelope struct {
+		ErrorMsg string                   `json:"error_msg"`
+		Data     pkgcap.ChallengeResponse `json:"data"`
+	}
+	if err := json.Unmarshal(w.Body.Bytes(), &envelope); err != nil {
 		t.Fatalf("failed to unmarshal challenge response: %v", err)
 	}
+	challengeResp := envelope.Data
 
 	if challengeResp.Token == "" {
 		t.Fatalf("expected token in challenge response")
@@ -99,10 +103,14 @@ func TestCapEndpointsAndMiddleware(t *testing.T) {
 		t.Fatalf("expected 200 OK for redeem, got %d. Body: %s", w.Code, w.Body.String())
 	}
 
-	var redeemResp RedeemResponse
-	if err := json.Unmarshal(w.Body.Bytes(), &redeemResp); err != nil {
+	var redeemEnvelope struct {
+		ErrorMsg string         `json:"error_msg"`
+		Data     RedeemResponse `json:"data"`
+	}
+	if err := json.Unmarshal(w.Body.Bytes(), &redeemEnvelope); err != nil {
 		t.Fatalf("failed to unmarshal redeem response: %v", err)
 	}
+	redeemResp := redeemEnvelope.Data
 
 	if !redeemResp.Success || redeemResp.Token == "" {
 		t.Fatalf("redeem failed or returned empty token: %+v", redeemResp)