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
66 lines
1.9 KiB
Plaintext
66 lines
1.9 KiB
Plaintext
syntax = "v1"
|
|
|
|
info (
|
|
title: "Lottery Admin API"
|
|
desc: "Admin-facing lottery endpoints for HIF-3 Stage 1"
|
|
author: "hifast"
|
|
version: "0.1.0"
|
|
)
|
|
|
|
import "../types.api"
|
|
|
|
@server (
|
|
prefix: v1/admin/lottery
|
|
group: admin/lottery
|
|
middleware: AuthMiddleware
|
|
)
|
|
service ppanel {
|
|
@doc "Create a new activity (status=draft)"
|
|
@handler CreateLotteryActivity
|
|
post /activities (CreateAdminLotteryActivityRequest) returns (AdminLotteryActivity)
|
|
|
|
@doc "Update mutable activity fields"
|
|
@handler UpdateLotteryActivity
|
|
put /activities (UpdateAdminLotteryActivityRequest) returns (AdminLotteryActivity)
|
|
|
|
@doc "List activities (paginated)"
|
|
@handler ListLotteryActivities
|
|
get /activities (ListAdminLotteryActivitiesRequest) returns (ListAdminLotteryActivitiesResponse)
|
|
|
|
@doc "Get one activity"
|
|
@handler GetLotteryActivity
|
|
get /activities/detail (AdminActivityIdRequest) returns (AdminLotteryActivity)
|
|
|
|
@doc "Publish (draft/paused → running)"
|
|
@handler PublishLotteryActivity
|
|
post /activities/publish (AdminActivityIdRequest)
|
|
|
|
@doc "Pause (running → paused)"
|
|
@handler PauseLotteryActivity
|
|
post /activities/pause (AdminActivityIdRequest)
|
|
|
|
@doc "Update eligibility/chance_sources (rule-caps enforced)"
|
|
@handler UpdateLotteryRules
|
|
put /activities/rules (UpdateAdminLotteryRulesRequest)
|
|
|
|
@doc "Create prize"
|
|
@handler CreateLotteryPrize
|
|
post /prizes (CreateAdminLotteryPrizeRequest) returns (AdminLotteryPrize)
|
|
|
|
@doc "Update prize"
|
|
@handler UpdateLotteryPrize
|
|
put /prizes (UpdateAdminLotteryPrizeRequest) returns (AdminLotteryPrize)
|
|
|
|
@doc "Delete prize"
|
|
@handler DeleteLotteryPrize
|
|
delete /prizes (AdminPrizeIdRequest)
|
|
|
|
@doc "List prizes on an activity"
|
|
@handler ListLotteryPrizes
|
|
get /prizes (ListAdminLotteryPrizesRequest) returns (ListAdminLotteryPrizesResponse)
|
|
|
|
@doc "Manually grant N chances to a user (idempotent by source_ref)"
|
|
@handler GrantLotteryChance
|
|
post /chances/grant (GrantAdminLotteryChanceRequest)
|
|
}
|