shanshanzhong147
ce3babcc33
Closes HIF-3 Stage 1 完整闭环 PR C：用户 API + 后台 CRUD + 抽奖事务服务 + 审计 + QA curl。合并后 Stage 1 可交测试。 架构师 review R1（rulecaps depth≤8/nodes≤64/bytes≤8KB）+ R2（InviteHook source_ref 加 order: 前缀）已全部落地。 - 迁移 02158_admin_action_log：后台写操作审计 - xerr 100xxx 段：抽奖错误码（NotEligible/NoChances/ActivityEnded/RateLimited/NotClaimable/InternalError/RuleTooDeep/RuleTooMany/RuleTooLarge） - feature flag config.Lottery.Enable 默认 false，合并后线上零副作用 - draw service：feature flag → rate limit → pre-tx reads → nonce dedupe → Consume → Pick → 乐观扣库存 → 双快照 → Dispatch → finalize - 用户 API 4 个：GET /config、POST /draw、GET /records、POST /claim（Stage 1 返回 100010） - 后台 CRUD：活动 / 奖品 / rules PUT（rulecaps gate）/ chances/grant - audit.WriteAdminAction：与调用方 tx 同生共死，SHA1 body 摘要 - QA 脚本：qa/lottery/stage1_curl.sh 全链路 curl 测试覆盖：model 76.5% / draw 69% / handler 68.3% / hook 91.9% / rulecaps 87.8% / audit 100% 100 并发抢库存 + 10000 次概率分布 e2e 推 QA 环境（sqlmock 无法忠实模拟 InnoDB 行锁） CI 全绿：构建/Vet/测试 + golangci-lint
70 lines
2.3 KiB
Go
70 lines
2.3 KiB
Go
// Package lottery contains the user-facing lottery HTTP handlers. Each handler
|
|
// binds request params via gin, validates, delegates to the logic package,
|
|
// and renders through pkg/result to keep the API response envelope consistent.
|
|
package lottery
|
|
|
|
import (
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/perfect-panel/server/internal/logic/public/lottery"
|
|
"github.com/perfect-panel/server/internal/svc"
|
|
"github.com/perfect-panel/server/internal/types"
|
|
"github.com/perfect-panel/server/pkg/result"
|
|
)
|
|
|
|
// QueryLotteryConfigHandler serves GET /api/v1/lottery/config.
|
|
func QueryLotteryConfigHandler(svcCtx *svc.ServiceContext) func(c *gin.Context) {
|
|
return func(c *gin.Context) {
|
|
var req types.GetLotteryConfigRequest
|
|
_ = c.ShouldBind(&req)
|
|
if err := svcCtx.Validate(&req); err != nil {
|
|
result.ParamErrorResult(c, err)
|
|
return
|
|
}
|
|
l := lottery.NewQueryLotteryConfigLogic(c.Request.Context(), svcCtx)
|
|
resp, err := l.QueryLotteryConfig(&req)
|
|
result.HttpResult(c, resp, err)
|
|
}
|
|
}
|
|
|
|
// DrawLotteryHandler serves POST /api/v1/lottery/draw.
|
|
func DrawLotteryHandler(svcCtx *svc.ServiceContext) func(c *gin.Context) {
|
|
return func(c *gin.Context) {
|
|
var req types.DrawLotteryRequest
|
|
_ = c.ShouldBind(&req)
|
|
if err := svcCtx.Validate(&req); err != nil {
|
|
result.ParamErrorResult(c, err)
|
|
return
|
|
}
|
|
l := lottery.NewDrawLotteryLogic(c.Request.Context(), svcCtx)
|
|
resp, err := l.DrawLottery(&req)
|
|
result.HttpResult(c, resp, err)
|
|
}
|
|
}
|
|
|
|
// QueryLotteryRecordsHandler serves GET /api/v1/lottery/records.
|
|
func QueryLotteryRecordsHandler(svcCtx *svc.ServiceContext) func(c *gin.Context) {
|
|
return func(c *gin.Context) {
|
|
var req types.GetLotteryRecordsRequest
|
|
_ = c.ShouldBind(&req)
|
|
l := lottery.NewQueryLotteryRecordsLogic(c.Request.Context(), svcCtx)
|
|
resp, err := l.QueryLotteryRecords(&req)
|
|
result.HttpResult(c, resp, err)
|
|
}
|
|
}
|
|
|
|
// ClaimLotteryPrizeHandler serves POST /api/v1/lottery/claim. Stage 1
|
|
// always returns 4010 not_claimable.
|
|
func ClaimLotteryPrizeHandler(svcCtx *svc.ServiceContext) func(c *gin.Context) {
|
|
return func(c *gin.Context) {
|
|
var req types.ClaimLotteryPrizeRequest
|
|
_ = c.ShouldBind(&req)
|
|
if err := svcCtx.Validate(&req); err != nil {
|
|
result.ParamErrorResult(c, err)
|
|
return
|
|
}
|
|
l := lottery.NewClaimLotteryPrizeLogic(c.Request.Context(), svcCtx)
|
|
resp, err := l.ClaimLotteryPrize(&req)
|
|
result.HttpResult(c, resp, err)
|
|
}
|
|
}
|