feat: 后台抽奖活动管理(Stage 1)

- 服务层:12 个 /v1/admin/lottery 接口封装与 API 类型定义
- 活动列表:状态筛选、上架/暂停(带确认)、编辑、管理、发次数
- 奖品管理:3×3 九宫格可视化编辑、概率预览、保底奖警告、佣金元↔分转换、无限库存
- 规则设置:chance_sources 动态编辑,eligibility 简单/高级(JSON)双模式,本地 rulecaps 校验(深度≤8/节点≤64/≤8KB),Stage 1 未接线警示
- 手动发次数:自动生成幂等 source_ref
- 路由 /dashboard/lottery、Commerce 菜单项、en-US/zh-CN 双语文案
- 对接文档见 vpn/aaaa.txt(Stage 1)
This commit is contained in:
2026-07-09 13:35:35 -07:00
parent dfe1bafd1c
commit ab327f5118
18 changed files with 3315 additions and 0 deletions
Binary file not shown.
@@ -0,0 +1,181 @@
{
"activityTime": "Activity Time",
"cancel": "Cancel",
"confirm": "Confirm",
"confirmPause": "Are you sure you want to pause this activity?",
"confirmPublish": "Are you sure you want to publish this activity?",
"create": "Create",
"createActivity": "Create Activity",
"createSuccess": "Create Success",
"detail": {
"prizesTab": "Prizes",
"rulesTab": "Rules"
},
"edit": "Edit",
"editActivity": "Edit Activity",
"form": {
"cancel": "Cancel",
"confirm": "Confirm",
"description": "Description",
"descriptionPlaceholder": "Activity description (Markdown supported)",
"endAt": "End Time",
"endAtAfterStartAt": "End time must be later than start time",
"endAtRequired": "End time is required",
"gridSize": "Grid Size",
"selectEndAt": "Select time",
"selectGridSize": "Select grid size",
"selectStartAt": "Select time",
"startAt": "Start Time",
"startAtRequired": "Start time is required",
"title": "Title",
"titlePlaceholder": "Activity title",
"titleRequired": "Title is required"
},
"grant": {
"amount": "Amount",
"description": "Manually grant draw chances to a user for activity: {{title}}",
"sourceRef": "Source Reference",
"sourceRefHint": "Idempotency key: the same reference only grants once. Repeated submissions will not grant again.",
"sourceRefPlaceholder": "grant-20260709-abc123",
"success": "Chances granted",
"title": "Grant Chances",
"userId": "User ID",
"userIdHint": "Enter the numeric user ID. You can find it in the user management list.",
"userIdPlaceholder": "e.g. 87433"
},
"grantChances": "Grant Chances",
"gridSize": "Grid Size",
"id": "ID",
"manage": "Manage",
"pause": "Pause",
"pauseSuccess": "Pause Success",
"pauseWarning": "Users will not be able to draw while the activity is paused.",
"prize": {
"addPrize": "Add Prize",
"amountPrecision": "Amount supports at most 2 decimal places",
"amountRequired": "Amount must be greater than 0",
"amountUnitHint": "Entered in CNY (yuan), stored as cents; up to 2 decimal places",
"amountYuan": "Commission Amount (CNY)",
"cancel": "Cancel",
"centerSlotHint": "Usually the draw button",
"confirm": "Confirm",
"confirmDelete": "Delete",
"createSuccess": "Prize created",
"createTitle": "Add Prize",
"daysSuffix": "days",
"delete": "Delete",
"deleteDescription": "This prize will be removed from the grid. This action cannot be undone.",
"deleteSuccess": "Prize deleted",
"deleteTitle": "Delete this prize?",
"durationDays": "Duration (days)",
"durationDaysPlaceholder": "e.g. 1",
"durationDaysRequired": "Duration days must be a positive integer",
"editTitle": "Edit Prize",
"fallbackBadge": "Fallback",
"fallbackIgnoresWeight": "Fallback prize ignores weight",
"iconUrl": "Icon URL",
"iconUrlInvalid": "Must be a valid URL",
"isFallback": "Fallback Prize",
"isFallbackHint": "Awarded when limited prizes are sold out",
"name": "Prize Name",
"namePlaceholder": "e.g. 1-Day Pass",
"nameRequired": "Name is required",
"noFallbackHint": "Consider configuring a fallback prize so draws never fail when limited prizes run out.",
"noFallbackTitle": "No fallback prize",
"noRandomPrizes": "No prizes participate in the random draw yet",
"noneHint": "No config needed. Consider enabling fallback so users always land on this prize when limited prizes run out.",
"probabilityPreview": "Probability Preview",
"selectType": "Select type",
"slotLabel": "Slot",
"soldOutBadge": "Sold Out",
"stage2Hint": "Available in Stage 2",
"stockShort": "Stock",
"totalStock": "Total Stock",
"totalStockPlaceholder": "e.g. 100",
"totalStockRequired": "Total stock must be a positive integer",
"type": "Prize Type",
"typeCommission": "Commission",
"typeCoupon": "Coupon",
"typeCrypto": "Crypto",
"typeManualOther": "Manual (Other)",
"typeNone": "No Prize (Thanks)",
"typePhysical": "Physical",
"typePoints": "Points",
"typeVpnDuration": "VPN Duration",
"unlimitedStock": "Unlimited Stock",
"updateSuccess": "Prize updated",
"weight": "Weight",
"weightHint": "0 = displayed but excluded from random draw",
"weightInteger": "Weight must be an integer",
"weightMin": "Weight must be at least 0",
"weightShort": "Weight",
"yuanSuffix": "CNY"
},
"publish": "Publish",
"publishSuccess": "Publish Success",
"publishWarning": "Once published, the activity becomes visible to users.",
"rules": {
"addCondition": "Add Condition",
"addSource": "Add Source",
"amount": "Amount",
"cannotSimplify": "This rule tree is too complex for simple mode. Please edit it in Advanced mode.",
"capsBytesExceeded": "Size {{value}} bytes exceeds limit {{limit}} bytes",
"capsDepthExceeded": "Depth {{value}} exceeds limit {{limit}}",
"capsExceeded": "Rule tree exceeds limits",
"capsNodesExceeded": "Node count {{value}} exceeds limit {{limit}}",
"chanceSources": "Chance Sources",
"chanceSourcesDescription": "Configure how users earn draw chances. Each source can only appear once.",
"conditionType": {
"has_subscription": "Has Subscription",
"invite_count": "Invite Count",
"register_days": "Register Days",
"subscription_type": "Subscription Type",
"total_recharge": "Total Recharge",
"user_tag": "User Tag"
},
"dailyLimit": "Daily limit (optional)",
"duplicateSource": "Duplicate source",
"eligibility": "Eligibility",
"jsonInvalid": "Invalid JSON: {{error}}",
"jsonMustBeObject": "Rule tree must be a JSON object",
"jsonPlaceholder": "Rule tree JSON, e.g. {\"op\":\"AND\",\"children\":[...]}. Leave empty for no requirement.",
"noConditions": "No conditions. Everyone is eligible to join.",
"op": "Combine Conditions With",
"opAnd": "AND",
"opOr": "OR",
"param": {
"min": "Min Count",
"minDaysRemaining": "Min Days Remaining",
"minUsdt": "Min USDT",
"planIds": "Plan IDs",
"planIdsPlaceholder": "Comma separated, e.g. 1,2,3",
"tags": "Tags",
"tagsPlaceholder": "Comma separated, e.g. vip,beta",
"windowDays": "Window Days (optional)"
},
"save": "Save Rules",
"saveFailed": "Failed to save rules",
"saveSuccess": "Rules saved",
"selectSource": "Select source",
"simpleMode": "Simple",
"advancedMode": "Advanced (JSON)",
"source": {
"dailySignin": "Daily Sign-in",
"inviteSuccess": "Invite Success",
"manualGrant": "Manual Grant",
"newSubscription": "New Subscription"
},
"stage1Warning": "Stage 1 notice",
"stage1WarningDescription": "The rule context is not wired up in the current version (Stage 1). Configuring eligibility will prevent users from joining the lottery. It is recommended to keep it empty."
},
"status": {
"draft": "Draft",
"ended": "Ended",
"paused": "Paused",
"running": "Running"
},
"statusAll": "All",
"statusLabel": "Status",
"title": "Title",
"updateSuccess": "Update Success"
}
@@ -14,6 +14,7 @@
"Invite Management": "Invite Management",
"Login": "Login",
"Logs & Analytics": "Logs & Analytics",
"Lottery Management": "Lottery Management",
"Maintenance": "Maintenance",
"Marketing Management": "Marketing Management",
"Mobile": "Mobile",
@@ -0,0 +1,181 @@
{
"activityTime": "活动时间",
"cancel": "取消",
"confirm": "确认",
"confirmPause": "确定要暂停该活动吗?",
"confirmPublish": "确定要上架该活动吗?",
"create": "创建",
"createActivity": "创建活动",
"createSuccess": "创建成功",
"detail": {
"prizesTab": "奖品",
"rulesTab": "规则"
},
"edit": "编辑",
"editActivity": "编辑活动",
"form": {
"cancel": "取消",
"confirm": "确认",
"description": "活动描述",
"descriptionPlaceholder": "活动描述(支持 Markdown",
"endAt": "结束时间",
"endAtAfterStartAt": "结束时间必须晚于开始时间",
"endAtRequired": "请选择结束时间",
"gridSize": "格子数",
"selectEndAt": "选择时间",
"selectGridSize": "选择格子数",
"selectStartAt": "选择时间",
"startAt": "开始时间",
"startAtRequired": "请选择开始时间",
"title": "标题",
"titlePlaceholder": "活动标题",
"titleRequired": "请输入活动标题"
},
"grant": {
"amount": "发放数量",
"description": "为用户手动发放活动「{{title}}」的抽奖次数",
"sourceRef": "来源引用号",
"sourceRefHint": "幂等键:相同的引用号只会发放一次,重复提交不会重复发放。",
"sourceRefPlaceholder": "grant-20260709-abc123",
"success": "次数发放成功",
"title": "发放次数",
"userId": "用户 ID",
"userIdHint": "请输入用户的数字 ID,可在用户管理列表中查看。",
"userIdPlaceholder": "例如:87433"
},
"grantChances": "发放次数",
"gridSize": "格子数",
"id": "ID",
"manage": "管理",
"pause": "暂停",
"pauseSuccess": "暂停成功",
"pauseWarning": "活动暂停期间,用户将无法抽奖。",
"prize": {
"addPrize": "添加奖品",
"amountPrecision": "金额最多支持 2 位小数",
"amountRequired": "金额必须大于 0",
"amountUnitHint": "以元为单位输入,按分存储;最多支持 2 位小数",
"amountYuan": "佣金金额(元)",
"cancel": "取消",
"centerSlotHint": "通常为抽奖按钮",
"confirm": "确认",
"confirmDelete": "删除",
"createSuccess": "奖品创建成功",
"createTitle": "添加奖品",
"daysSuffix": "天",
"delete": "删除",
"deleteDescription": "该奖品将从九宫格中移除,此操作不可撤销。",
"deleteSuccess": "奖品删除成功",
"deleteTitle": "确定删除该奖品吗?",
"durationDays": "时长(天)",
"durationDaysPlaceholder": "例如:1",
"durationDaysRequired": "时长天数必须为正整数",
"editTitle": "编辑奖品",
"fallbackBadge": "保底",
"fallbackIgnoresWeight": "保底奖品不参与权重计算",
"iconUrl": "图标 URL",
"iconUrlInvalid": "请输入有效的 URL",
"isFallback": "保底奖品",
"isFallbackHint": "限量奖品抽完后发放该奖品",
"name": "奖品名称",
"namePlaceholder": "例如:1 天时长卡",
"nameRequired": "请输入奖品名称",
"noFallbackHint": "建议配置一个保底奖品,避免限量奖品抽完后抽奖失败。",
"noFallbackTitle": "未配置保底奖品",
"noRandomPrizes": "暂无参与随机抽取的奖品",
"noneHint": "无需额外配置。建议开启保底,限量奖品抽完后用户将始终抽中该奖品。",
"probabilityPreview": "概率预览",
"selectType": "选择类型",
"slotLabel": "格子",
"soldOutBadge": "已抽完",
"stage2Hint": "Stage 2 开放",
"stockShort": "库存",
"totalStock": "总库存",
"totalStockPlaceholder": "例如:100",
"totalStockRequired": "总库存必须为正整数",
"type": "奖品类型",
"typeCommission": "佣金",
"typeCoupon": "优惠券",
"typeCrypto": "加密货币",
"typeManualOther": "人工发放(其他)",
"typeNone": "谢谢参与",
"typePhysical": "实物奖品",
"typePoints": "积分",
"typeVpnDuration": "免费时长",
"unlimitedStock": "无限库存",
"updateSuccess": "奖品更新成功",
"weight": "权重",
"weightHint": "权重为 0 时仅展示,不参与随机抽取",
"weightInteger": "权重必须为整数",
"weightMin": "权重不能小于 0",
"weightShort": "权重",
"yuanSuffix": "元"
},
"publish": "上架",
"publishSuccess": "上架成功",
"publishWarning": "上架后活动将对用户可见。",
"rules": {
"addCondition": "添加条件",
"addSource": "添加来源",
"amount": "次数",
"cannotSimplify": "规则树结构较复杂,无法用简单模式编辑,请在高级(JSON)模式下修改",
"capsBytesExceeded": "大小 {{value}} 字节超过上限 {{limit}} 字节",
"capsDepthExceeded": "深度 {{value}} 超过上限 {{limit}}",
"capsExceeded": "规则树超出限制",
"capsNodesExceeded": "节点数 {{value}} 超过上限 {{limit}}",
"chanceSources": "次数来源",
"chanceSourcesDescription": "配置用户获取抽奖次数的方式,每种来源只能配置一次。",
"conditionType": {
"has_subscription": "持有订阅",
"invite_count": "邀请人数",
"register_days": "注册天数",
"subscription_type": "订阅套餐类型",
"total_recharge": "累计充值",
"user_tag": "用户标签"
},
"dailyLimit": "每日上限(可选)",
"duplicateSource": "来源不能重复",
"eligibility": "参与门槛",
"jsonInvalid": "JSON 无效:{{error}}",
"jsonMustBeObject": "规则树必须是 JSON 对象",
"jsonPlaceholder": "规则树 JSON,例如 {\"op\":\"AND\",\"children\":[...]},留空表示无门槛。",
"noConditions": "暂无条件,所有用户均可参与。",
"op": "条件组合方式",
"opAnd": "且(AND",
"opOr": "或(OR",
"param": {
"min": "最小数量",
"minDaysRemaining": "剩余天数下限",
"minUsdt": "最低 USDT 金额",
"planIds": "套餐 ID",
"planIdsPlaceholder": "逗号分隔,例如 1,2,3",
"tags": "标签",
"tagsPlaceholder": "逗号分隔,例如 vip,beta",
"windowDays": "时间窗口天数(可选)"
},
"save": "保存规则",
"saveFailed": "规则保存失败",
"saveSuccess": "规则保存成功",
"selectSource": "选择来源",
"simpleMode": "简单模式",
"advancedMode": "高级模式(JSON",
"source": {
"dailySignin": "每日签到",
"inviteSuccess": "邀请成功",
"manualGrant": "手动发放",
"newSubscription": "新订阅"
},
"stage1Warning": "Stage 1 提示",
"stage1WarningDescription": "当前版本(Stage 1)规则上下文尚未接线,配置门槛将导致用户无法参与抽奖,建议保持为空。"
},
"status": {
"draft": "草稿",
"ended": "已结束",
"paused": "已暂停",
"running": "进行中"
},
"statusAll": "全部",
"statusLabel": "状态",
"title": "标题",
"updateSuccess": "更新成功"
}
@@ -14,6 +14,7 @@
"Invite Management": "邀请管理",
"Login": "登录",
"Logs & Analytics": "日志与分析",
"Lottery Management": "抽奖管理",
"Maintenance": "维护",
"Marketing Management": "营销管理",
"Mobile": "短信",
+5
View File
@@ -81,6 +81,11 @@ export function useNavs() {
url: "/dashboard/marketing",
icon: "flat-color-icons:bullish",
},
{
title: t("Lottery Management", "Lottery Management"),
url: "/dashboard/lottery",
icon: "flat-color-icons:ratings",
},
{
title: t("Announcement Management", "Announcement Management"),
url: "/dashboard/announcement",
+26
View File
@@ -47,6 +47,9 @@ const DashboardOrderIndexLazyRouteImport =
const DashboardMarketingIndexLazyRouteImport = createFileRoute(
'/dashboard/marketing/',
)()
const DashboardLotteryIndexLazyRouteImport = createFileRoute(
'/dashboard/lottery/',
)()
const DashboardInviteManagementIndexLazyRouteImport = createFileRoute(
'/dashboard/invite-management/',
)()
@@ -226,6 +229,14 @@ const DashboardMarketingIndexLazyRoute =
} as any).lazy(() =>
import('./routes/dashboard/marketing/index.lazy').then((d) => d.Route),
)
const DashboardLotteryIndexLazyRoute =
DashboardLotteryIndexLazyRouteImport.update({
id: '/lottery/',
path: '/lottery/',
getParentRoute: () => DashboardRouteLazyRoute,
} as any).lazy(() =>
import('./routes/dashboard/lottery/index.lazy').then((d) => d.Route),
)
const DashboardInviteManagementIndexLazyRoute =
DashboardInviteManagementIndexLazyRouteImport.update({
id: '/invite-management/',
@@ -411,6 +422,7 @@ export interface FileRoutesByFullPath {
'/dashboard/family': typeof DashboardFamilyIndexLazyRoute
'/dashboard/group': typeof DashboardGroupIndexLazyRoute
'/dashboard/invite-management': typeof DashboardInviteManagementIndexLazyRoute
'/dashboard/lottery': typeof DashboardLotteryIndexLazyRoute
'/dashboard/marketing': typeof DashboardMarketingIndexLazyRoute
'/dashboard/order': typeof DashboardOrderIndexLazyRoute
'/dashboard/payment': typeof DashboardPaymentIndexLazyRoute
@@ -448,6 +460,7 @@ export interface FileRoutesByTo {
'/dashboard/family': typeof DashboardFamilyIndexLazyRoute
'/dashboard/group': typeof DashboardGroupIndexLazyRoute
'/dashboard/invite-management': typeof DashboardInviteManagementIndexLazyRoute
'/dashboard/lottery': typeof DashboardLotteryIndexLazyRoute
'/dashboard/marketing': typeof DashboardMarketingIndexLazyRoute
'/dashboard/order': typeof DashboardOrderIndexLazyRoute
'/dashboard/payment': typeof DashboardPaymentIndexLazyRoute
@@ -488,6 +501,7 @@ export interface FileRoutesById {
'/dashboard/family/': typeof DashboardFamilyIndexLazyRoute
'/dashboard/group/': typeof DashboardGroupIndexLazyRoute
'/dashboard/invite-management/': typeof DashboardInviteManagementIndexLazyRoute
'/dashboard/lottery/': typeof DashboardLotteryIndexLazyRoute
'/dashboard/marketing/': typeof DashboardMarketingIndexLazyRoute
'/dashboard/order/': typeof DashboardOrderIndexLazyRoute
'/dashboard/payment/': typeof DashboardPaymentIndexLazyRoute
@@ -529,6 +543,7 @@ export interface FileRouteTypes {
| '/dashboard/family'
| '/dashboard/group'
| '/dashboard/invite-management'
| '/dashboard/lottery'
| '/dashboard/marketing'
| '/dashboard/order'
| '/dashboard/payment'
@@ -566,6 +581,7 @@ export interface FileRouteTypes {
| '/dashboard/family'
| '/dashboard/group'
| '/dashboard/invite-management'
| '/dashboard/lottery'
| '/dashboard/marketing'
| '/dashboard/order'
| '/dashboard/payment'
@@ -605,6 +621,7 @@ export interface FileRouteTypes {
| '/dashboard/family/'
| '/dashboard/group/'
| '/dashboard/invite-management/'
| '/dashboard/lottery/'
| '/dashboard/marketing/'
| '/dashboard/order/'
| '/dashboard/payment/'
@@ -744,6 +761,13 @@ declare module '@tanstack/react-router' {
preLoaderRoute: typeof DashboardMarketingIndexLazyRouteImport
parentRoute: typeof DashboardRouteLazyRoute
}
'/dashboard/lottery/': {
id: '/dashboard/lottery/'
path: '/lottery'
fullPath: '/dashboard/lottery'
preLoaderRoute: typeof DashboardLotteryIndexLazyRouteImport
parentRoute: typeof DashboardRouteLazyRoute
}
'/dashboard/invite-management/': {
id: '/dashboard/invite-management/'
path: '/invite-management'
@@ -926,6 +950,7 @@ interface DashboardRouteLazyRouteChildren {
DashboardFamilyIndexLazyRoute: typeof DashboardFamilyIndexLazyRoute
DashboardGroupIndexLazyRoute: typeof DashboardGroupIndexLazyRoute
DashboardInviteManagementIndexLazyRoute: typeof DashboardInviteManagementIndexLazyRoute
DashboardLotteryIndexLazyRoute: typeof DashboardLotteryIndexLazyRoute
DashboardMarketingIndexLazyRoute: typeof DashboardMarketingIndexLazyRoute
DashboardOrderIndexLazyRoute: typeof DashboardOrderIndexLazyRoute
DashboardPaymentIndexLazyRoute: typeof DashboardPaymentIndexLazyRoute
@@ -964,6 +989,7 @@ const DashboardRouteLazyRouteChildren: DashboardRouteLazyRouteChildren = {
DashboardGroupIndexLazyRoute: DashboardGroupIndexLazyRoute,
DashboardInviteManagementIndexLazyRoute:
DashboardInviteManagementIndexLazyRoute,
DashboardLotteryIndexLazyRoute: DashboardLotteryIndexLazyRoute,
DashboardMarketingIndexLazyRoute: DashboardMarketingIndexLazyRoute,
DashboardOrderIndexLazyRoute: DashboardOrderIndexLazyRoute,
DashboardPaymentIndexLazyRoute: DashboardPaymentIndexLazyRoute,
@@ -0,0 +1,6 @@
import { createLazyFileRoute } from "@tanstack/react-router";
import Lottery from "@/sections/lottery";
export const Route = createLazyFileRoute("/dashboard/lottery/")({
component: Lottery,
});
@@ -0,0 +1,119 @@
import { Badge } from "@workspace/ui/components/badge";
import {
Sheet,
SheetContent,
SheetHeader,
SheetTitle,
} from "@workspace/ui/components/sheet";
import {
Tabs,
TabsContent,
TabsList,
TabsTrigger,
} from "@workspace/ui/components/tabs";
import { getLotteryActivityDetail } from "@workspace/ui/services/admin/lottery";
import { useEffect, useState } from "react";
import { useTranslation } from "react-i18next";
import PrizeGrid from "./prize-grid";
import RuleEditor from "./rule-editor";
interface ActivityDetailProps {
activity: API.LotteryActivity | null;
open: boolean;
onOpenChange: (open: boolean) => void;
onChanged?: () => void;
}
type TranslateFn = (key: string, defaultValue: string) => string;
const STATUS_BADGE_VARIANTS: Record<
API.LotteryActivityStatus,
"default" | "secondary" | "destructive" | "outline"
> = {
draft: "secondary",
running: "default",
paused: "outline",
ended: "destructive",
};
function statusLabel(
status: API.LotteryActivityStatus,
t: TranslateFn
): string {
const labels: Record<API.LotteryActivityStatus, string> = {
draft: t("status.draft", "Draft"),
running: t("status.running", "Running"),
paused: t("status.paused", "Paused"),
ended: t("status.ended", "Ended"),
};
return labels[status] ?? status;
}
export default function ActivityDetail({
activity,
open,
onOpenChange,
onChanged,
}: ActivityDetailProps) {
const { t } = useTranslation("lottery");
// 抽屉打开时拉取详情作为数据源,避免列表行数据不完整时被全量 PUT 覆盖
const [detail, setDetail] = useState<API.LotteryActivity | null>(null);
const activityId = activity?.id;
useEffect(() => {
setDetail(null);
if (!(open && activityId)) return;
let cancelled = false;
getLotteryActivityDetail({ id: activityId })
.then(({ data }) => {
if (!cancelled && data.data) setDetail(data.data);
})
.catch(() => {
// Request layer already surfaces the error toast; fall back to prop data
});
return () => {
cancelled = true;
};
}, [open, activityId]);
const current = detail ?? activity;
return (
<Sheet onOpenChange={onOpenChange} open={open}>
<SheetContent className="w-[800px] max-w-full sm:max-w-3xl" side="right">
{current && (
<>
<SheetHeader>
<SheetTitle className="flex items-center gap-2">
<span className="truncate">{current.title}</span>
<Badge
variant={STATUS_BADGE_VARIANTS[current.status] ?? "outline"}
>
{statusLabel(current.status, t)}
</Badge>
</SheetTitle>
</SheetHeader>
<div className="max-h-[calc(100dvh-88px)] overflow-y-auto px-6 pb-6">
<Tabs defaultValue="prizes">
<TabsList className="mb-4">
<TabsTrigger value="prizes">
{t("detail.prizesTab", "Prizes")}
</TabsTrigger>
<TabsTrigger value="rules">
{t("detail.rulesTab", "Rules")}
</TabsTrigger>
</TabsList>
<TabsContent value="prizes">
<PrizeGrid activity={current} />
</TabsContent>
<TabsContent value="rules">
<RuleEditor activity={current} onSaved={onChanged} />
</TabsContent>
</Tabs>
</div>
</>
)}
</SheetContent>
</Sheet>
);
}
@@ -0,0 +1,286 @@
import { zodResolver } from "@hookform/resolvers/zod";
import { Button } from "@workspace/ui/components/button";
import {
Form,
FormControl,
FormField,
FormItem,
FormLabel,
FormMessage,
} from "@workspace/ui/components/form";
import { ScrollArea } from "@workspace/ui/components/scroll-area";
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@workspace/ui/components/select";
import {
Sheet,
SheetContent,
SheetFooter,
SheetHeader,
SheetTitle,
SheetTrigger,
} from "@workspace/ui/components/sheet";
import { Textarea } from "@workspace/ui/components/textarea";
import { DatePicker } from "@workspace/ui/composed/date-picker";
import { EnhancedInput } from "@workspace/ui/composed/enhanced-input";
import { Icon } from "@workspace/ui/composed/icon";
import { useEffect, useState } from "react";
import { useForm } from "react-hook-form";
import { useTranslation } from "react-i18next";
import { z } from "zod";
const GRID_SIZE_OPTIONS = [9] as const;
const getFormSchema = (t: (key: string, defaultValue: string) => string) =>
z
.object({
title: z.string().min(1, t("form.titleRequired", "Title is required")),
description: z.string().optional(),
// DatePicker works in milliseconds; converted to Unix seconds on submit
start_at: z
.number()
.min(1, t("form.startAtRequired", "Start time is required")),
end_at: z
.number()
.min(1, t("form.endAtRequired", "End time is required")),
grid_size: z.number(),
})
.superRefine((data, ctx) => {
if (
data.start_at > 0 &&
data.end_at > 0 &&
data.end_at <= data.start_at
) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: t(
"form.endAtAfterStartAt",
"End time must be later than start time"
),
path: ["end_at"],
});
}
});
type ActivityFormValues = z.infer<ReturnType<typeof getFormSchema>>;
interface ActivityFormProps {
trigger: React.ReactNode;
title: string;
loading?: boolean;
initialValues?: Partial<API.LotteryActivity>;
onSubmit: (values: API.CreateLotteryActivityRequest) => Promise<boolean>;
}
function toFormValues(
activity?: Partial<API.LotteryActivity>
): ActivityFormValues {
return {
title: activity?.title ?? "",
description: activity?.description ?? "",
start_at: activity?.start_at ? activity.start_at * 1000 : 0,
end_at: activity?.end_at ? activity.end_at * 1000 : 0,
grid_size: activity?.grid_size ?? GRID_SIZE_OPTIONS[0],
};
}
export default function ActivityForm({
trigger,
title,
loading,
initialValues,
onSubmit,
}: ActivityFormProps) {
const { t } = useTranslation("lottery");
const formSchema = getFormSchema(t);
const [open, setOpen] = useState(false);
const form = useForm<ActivityFormValues>({
resolver: zodResolver(formSchema),
defaultValues: toFormValues(initialValues),
});
useEffect(() => {
form.reset(toFormValues(initialValues));
}, [form, initialValues]);
async function handleSubmit(values: ActivityFormValues) {
const success = await onSubmit({
title: values.title.trim(),
description: values.description ?? "",
start_at: Math.floor(values.start_at / 1000),
end_at: Math.floor(values.end_at / 1000),
grid_size: values.grid_size,
eligibility: initialValues?.eligibility ?? {},
chance_sources: initialValues?.chance_sources ?? [],
unmet_action: "block",
});
if (success) {
setOpen(false);
form.reset(toFormValues(initialValues));
}
}
return (
<Sheet onOpenChange={setOpen} open={open}>
<SheetTrigger asChild>
<Button
onClick={() => {
form.reset(toFormValues(initialValues));
setOpen(true);
}}
size="sm"
>
{trigger}
</Button>
</SheetTrigger>
<SheetContent className="w-[520px] max-w-full md:max-w-screen-md">
<SheetHeader>
<SheetTitle>{title}</SheetTitle>
</SheetHeader>
<ScrollArea className="h-[calc(100vh-48px-36px-36px-env(safe-area-inset-top))]">
<Form {...form}>
<form
className="space-y-4 px-6 pt-4"
id="lottery-activity-form"
onSubmit={form.handleSubmit(handleSubmit)}
>
<FormField
control={form.control}
name="title"
render={({ field }) => (
<FormItem>
<FormLabel>{t("form.title", "Title")}</FormLabel>
<FormControl>
<EnhancedInput
onValueChange={(value) => field.onChange(value)}
placeholder={t(
"form.titlePlaceholder",
"Activity title"
)}
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name="description"
render={({ field }) => (
<FormItem>
<FormLabel>
{t("form.description", "Description")}
</FormLabel>
<FormControl>
<Textarea
onChange={(event) => field.onChange(event.target.value)}
placeholder={t(
"form.descriptionPlaceholder",
"Activity description (Markdown supported)"
)}
rows={5}
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<div className="grid gap-4 sm:grid-cols-2">
<FormField
control={form.control}
name="start_at"
render={({ field }) => (
<FormItem>
<FormLabel>{t("form.startAt", "Start Time")}</FormLabel>
<FormControl>
<DatePicker
onChange={(value) => field.onChange(value ?? 0)}
placeholder={t("form.selectStartAt", "Select time")}
value={field.value || undefined}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name="end_at"
render={({ field }) => (
<FormItem>
<FormLabel>{t("form.endAt", "End Time")}</FormLabel>
<FormControl>
<DatePicker
onChange={(value) => field.onChange(value ?? 0)}
placeholder={t("form.selectEndAt", "Select time")}
value={field.value || undefined}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
</div>
<FormField
control={form.control}
name="grid_size"
render={({ field }) => (
<FormItem>
<FormLabel>{t("form.gridSize", "Grid Size")}</FormLabel>
<Select
onValueChange={(value) => field.onChange(Number(value))}
value={String(field.value)}
>
<FormControl>
<SelectTrigger>
<SelectValue
placeholder={t(
"form.selectGridSize",
"Select grid size"
)}
/>
</SelectTrigger>
</FormControl>
<SelectContent>
{GRID_SIZE_OPTIONS.map((size) => (
<SelectItem key={size} value={String(size)}>
{size}
</SelectItem>
))}
</SelectContent>
</Select>
<FormMessage />
</FormItem>
)}
/>
</form>
</Form>
</ScrollArea>
<SheetFooter className="flex-row justify-end gap-2 pt-3">
<Button
disabled={loading}
onClick={() => {
setOpen(false);
}}
variant="outline"
>
{t("form.cancel", "Cancel")}
</Button>
<Button disabled={loading} form="lottery-activity-form" type="submit">
{loading && (
<Icon className="mr-2 animate-spin" icon="mdi:loading" />
)}{" "}
{t("form.confirm", "Confirm")}
</Button>
</SheetFooter>
</SheetContent>
</Sheet>
);
}
@@ -0,0 +1,207 @@
import { zodResolver } from "@hookform/resolvers/zod";
import { Button } from "@workspace/ui/components/button";
import {
Dialog,
DialogContent,
DialogDescription,
DialogFooter,
DialogHeader,
DialogTitle,
} from "@workspace/ui/components/dialog";
import {
Form,
FormControl,
FormDescription,
FormField,
FormItem,
FormLabel,
FormMessage,
} from "@workspace/ui/components/form";
import { EnhancedInput } from "@workspace/ui/composed/enhanced-input";
import { grantLotteryChances } from "@workspace/ui/services/admin/lottery";
import { useEffect, useState } from "react";
import { useForm } from "react-hook-form";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { z } from "zod";
const grantSchema = z.object({
user_id: z.number().int().min(1),
amount: z.number().int().min(1),
source_ref: z.string().trim().min(1),
});
type GrantFormValues = z.infer<typeof grantSchema>;
const SOURCE_REF_RANDOM_LENGTH = 6;
function generateSourceRef(): string {
const now = new Date();
const ymd = [
now.getFullYear(),
String(now.getMonth() + 1).padStart(2, "0"),
String(now.getDate()).padStart(2, "0"),
].join("");
const random = Math.random()
.toString(36)
.slice(2, 2 + SOURCE_REF_RANDOM_LENGTH)
.padEnd(SOURCE_REF_RANDOM_LENGTH, "0");
return `grant-${ymd}-${random}`;
}
interface GrantDialogProps {
activity: API.LotteryActivity | null;
open: boolean;
onOpenChange: (open: boolean) => void;
}
export default function GrantDialog({
activity,
open,
onOpenChange,
}: GrantDialogProps) {
const { t } = useTranslation("lottery");
const [loading, setLoading] = useState(false);
const form = useForm<GrantFormValues>({
resolver: zodResolver(grantSchema),
defaultValues: { amount: 1, source_ref: "" },
});
useEffect(() => {
if (open) {
form.reset({
user_id: undefined,
amount: 1,
source_ref: generateSourceRef(),
});
}
}, [open, form]);
async function handleSubmit(values: GrantFormValues) {
if (!activity) return;
setLoading(true);
try {
await grantLotteryChances({
activity_id: activity.id,
user_id: values.user_id,
amount: values.amount,
source_ref: values.source_ref.trim(),
});
toast.success(t("grant.success", "Chances granted"));
onOpenChange(false);
form.reset({ user_id: undefined, amount: 1, source_ref: "" });
} catch {
// Request layer already surfaces the error toast
} finally {
setLoading(false);
}
}
return (
<Dialog onOpenChange={onOpenChange} open={open}>
<DialogContent className="max-w-md">
<DialogHeader>
<DialogTitle>{t("grant.title", "Grant Chances")}</DialogTitle>
<DialogDescription>
{t(
"grant.description",
"Manually grant draw chances to a user for activity: {{title}}"
).replace("{{title}}", activity?.title ?? "")}
</DialogDescription>
</DialogHeader>
<Form {...form}>
<form
className="space-y-4"
id="lottery-grant-form"
onSubmit={form.handleSubmit(handleSubmit)}
>
<FormField
control={form.control}
name="user_id"
render={({ field }) => (
<FormItem>
<FormLabel>{t("grant.userId", "User ID")}</FormLabel>
<FormControl>
<EnhancedInput
min={1}
onValueChange={(value) => field.onChange(value)}
placeholder={t("grant.userIdPlaceholder", "e.g. 87433")}
type="number"
value={field.value}
/>
</FormControl>
<FormDescription>
{t(
"grant.userIdHint",
"Enter the numeric user ID. You can find it in the user management list."
)}
</FormDescription>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name="amount"
render={({ field }) => (
<FormItem>
<FormLabel>{t("grant.amount", "Amount")}</FormLabel>
<FormControl>
<EnhancedInput
min={1}
onValueChange={(value) => field.onChange(value)}
placeholder="1"
type="number"
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name="source_ref"
render={({ field }) => (
<FormItem>
<FormLabel>
{t("grant.sourceRef", "Source Reference")}
</FormLabel>
<FormControl>
<EnhancedInput
onValueChange={(value) => field.onChange(value)}
placeholder={t(
"grant.sourceRefPlaceholder",
"grant-20260709-abc123"
)}
value={field.value}
/>
</FormControl>
<FormDescription>
{t(
"grant.sourceRefHint",
"Idempotency key: the same reference only grants once. Repeated submissions will not grant again."
)}
</FormDescription>
<FormMessage />
</FormItem>
)}
/>
</form>
</Form>
<DialogFooter>
<Button
onClick={() => onOpenChange(false)}
type="button"
variant="outline"
>
{t("cancel", "Cancel")}
</Button>
<Button disabled={loading} form="lottery-grant-form" type="submit">
{t("confirm", "Confirm")}
</Button>
</DialogFooter>
</DialogContent>
</Dialog>
);
}
+265
View File
@@ -0,0 +1,265 @@
import { Badge } from "@workspace/ui/components/badge";
import { Button } from "@workspace/ui/components/button";
import { ConfirmButton } from "@workspace/ui/composed/confirm-button";
import {
ProTable,
type ProTableActions,
} from "@workspace/ui/composed/pro-table/pro-table";
import {
createLotteryActivity,
getLotteryActivityList,
pauseLotteryActivity,
publishLotteryActivity,
updateLotteryActivity,
} from "@workspace/ui/services/admin/lottery";
import { useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { formatDate } from "@/utils/common";
import ActivityDetail from "./activity-detail";
import ActivityForm from "./activity-form";
import GrantDialog from "./grant-dialog";
export default function Lottery() {
const { t } = useTranslation("lottery");
const [loading, setLoading] = useState(false);
const [detailOpen, setDetailOpen] = useState(false);
const [grantOpen, setGrantOpen] = useState(false);
const [selectedActivity, setSelectedActivity] =
useState<API.LotteryActivity | null>(null);
const ref = useRef<ProTableActions>(null);
const statusConfig: Record<
API.LotteryActivityStatus,
{
label: string;
variant: "secondary" | "destructive" | "outline";
className?: string;
}
> = {
draft: { label: t("status.draft", "Draft"), variant: "secondary" },
running: {
label: t("status.running", "Running"),
variant: "outline",
className: "border-transparent bg-green-500 text-white",
},
paused: {
label: t("status.paused", "Paused"),
variant: "outline",
className: "border-transparent bg-yellow-500 text-white",
},
ended: { label: t("status.ended", "Ended"), variant: "destructive" },
};
const statusOptions = [
{ label: t("statusAll", "All"), value: "all" },
{ label: t("status.draft", "Draft"), value: "draft" },
{ label: t("status.running", "Running"), value: "running" },
{ label: t("status.paused", "Paused"), value: "paused" },
{ label: t("status.ended", "Ended"), value: "ended" },
];
return (
<>
<ProTable<API.LotteryActivity, { status: string }>
action={ref}
actions={{
render: (row) => {
const rowActions: React.ReactNode[] = [];
if (row.status === "draft") {
rowActions.push(
<ConfirmButton
cancelText={t("cancel", "Cancel")}
confirmText={t("confirm", "Confirm")}
description={t(
"publishWarning",
"Once published, the activity becomes visible to users."
)}
key="publish"
onConfirm={async () => {
try {
await publishLotteryActivity({ id: row.id });
toast.success(t("publishSuccess", "Publish Success"));
ref.current?.refresh();
} catch {
// Request layer already surfaces the error toast
}
}}
title={t(
"confirmPublish",
"Are you sure you want to publish this activity?"
)}
trigger={<Button size="sm">{t("publish", "Publish")}</Button>}
/>
);
}
if (row.status === "running") {
rowActions.push(
<ConfirmButton
cancelText={t("cancel", "Cancel")}
confirmText={t("confirm", "Confirm")}
description={t(
"pauseWarning",
"Users will not be able to draw while the activity is paused."
)}
key="pause"
onConfirm={async () => {
try {
await pauseLotteryActivity({ id: row.id });
toast.success(t("pauseSuccess", "Pause Success"));
ref.current?.refresh();
} catch {
// Request layer already surfaces the error toast
}
}}
title={t(
"confirmPause",
"Are you sure you want to pause this activity?"
)}
trigger={
<Button size="sm" variant="destructive">
{t("pause", "Pause")}
</Button>
}
/>
);
}
rowActions.push(
<ActivityForm
initialValues={row}
key="edit"
loading={loading}
onSubmit={async (values) => {
setLoading(true);
try {
await updateLotteryActivity({ ...values, id: row.id });
toast.success(t("updateSuccess", "Update Success"));
ref.current?.refresh();
setLoading(false);
return true;
} catch (_error) {
setLoading(false);
return false;
}
}}
title={t("editActivity", "Edit Activity")}
trigger={t("edit", "Edit")}
/>,
<Button
key="manage"
onClick={() => {
setSelectedActivity(row);
setDetailOpen(true);
}}
size="sm"
variant="outline"
>
{t("manage", "Manage")}
</Button>,
<Button
key="grant"
onClick={() => {
setSelectedActivity(row);
setGrantOpen(true);
}}
size="sm"
variant="outline"
>
{t("grantChances", "Grant Chances")}
</Button>
);
return rowActions;
},
}}
columns={[
{
accessorKey: "id",
header: t("id", "ID"),
},
{
accessorKey: "title",
header: t("title", "Title"),
},
{
accessorKey: "status",
header: t("statusLabel", "Status"),
cell: ({ row }) => {
const status = statusConfig[row.original.status];
return (
<Badge className={status.className} variant={status.variant}>
{status.label}
</Badge>
);
},
},
{
accessorKey: "start_at",
header: t("activityTime", "Activity Time"),
cell: ({ row }) =>
`${formatDate(row.original.start_at)} - ${formatDate(
row.original.end_at
)}`,
},
{
accessorKey: "grid_size",
header: t("gridSize", "Grid Size"),
},
]}
header={{
toolbar: (
<ActivityForm
loading={loading}
onSubmit={async (values) => {
setLoading(true);
try {
await createLotteryActivity(values);
toast.success(t("createSuccess", "Create Success"));
ref.current?.refresh();
setLoading(false);
return true;
} catch (_error) {
setLoading(false);
return false;
}
}}
title={t("createActivity", "Create Activity")}
trigger={t("create", "Create")}
/>
),
}}
params={[
{
key: "status",
placeholder: t("statusLabel", "Status"),
options: statusOptions,
},
]}
request={async (pagination, filters) => {
const { data } = await getLotteryActivityList({
...pagination,
...filters,
status:
filters?.status && filters.status !== "all"
? filters.status
: undefined,
});
return {
list: data.data?.list || [],
total: data.data?.total || 0,
};
}}
/>
<ActivityDetail
activity={selectedActivity}
onChanged={() => ref.current?.refresh()}
onOpenChange={setDetailOpen}
open={detailOpen}
/>
<GrantDialog
activity={selectedActivity}
onOpenChange={setGrantOpen}
open={grantOpen}
/>
</>
);
}
@@ -0,0 +1,506 @@
import { zodResolver } from "@hookform/resolvers/zod";
import { Button } from "@workspace/ui/components/button";
import {
Form,
FormControl,
FormField,
FormItem,
FormLabel,
FormMessage,
} from "@workspace/ui/components/form";
import { ScrollArea } from "@workspace/ui/components/scroll-area";
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@workspace/ui/components/select";
import {
Sheet,
SheetContent,
SheetFooter,
SheetHeader,
SheetTitle,
} from "@workspace/ui/components/sheet";
import { Switch } from "@workspace/ui/components/switch";
import { ConfirmButton } from "@workspace/ui/composed/confirm-button";
import {
EnhancedInput,
type EnhancedInputProps,
} from "@workspace/ui/composed/enhanced-input";
import { Icon } from "@workspace/ui/composed/icon";
import {
createLotteryPrize,
deleteLotteryPrize,
updateLotteryPrize,
} from "@workspace/ui/services/admin/lottery";
import { useEffect, useState } from "react";
import { useForm } from "react-hook-form";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { z } from "zod";
const CENTS_PER_YUAN = 100;
type TranslateFn = (key: string, defaultValue: string) => string;
const PRIZE_TYPE_OPTIONS: {
value: API.LotteryPrizeType;
labelKey: string;
labelDefault: string;
disabled?: boolean;
}[] = [
{
value: "vpn_duration",
labelKey: "prize.typeVpnDuration",
labelDefault: "VPN Duration",
},
{
value: "commission",
labelKey: "prize.typeCommission",
labelDefault: "Commission",
},
{
value: "none",
labelKey: "prize.typeNone",
labelDefault: "No Prize (Thanks)",
},
{
value: "crypto",
labelKey: "prize.typeCrypto",
labelDefault: "Crypto",
disabled: true,
},
{
value: "physical",
labelKey: "prize.typePhysical",
labelDefault: "Physical",
disabled: true,
},
{
value: "manual_other",
labelKey: "prize.typeManualOther",
labelDefault: "Manual (Other)",
disabled: true,
},
];
const getPrizeSchema = (t: TranslateFn) =>
z
.object({
type: z.enum(["vpn_duration", "commission", "none"]),
name: z.string().min(1, t("prize.nameRequired", "Name is required")),
icon_url: z
.string()
.url(t("prize.iconUrlInvalid", "Must be a valid URL"))
.or(z.literal(""))
.optional(),
weight: z
.number()
.int(t("prize.weightInteger", "Weight must be an integer"))
.min(0, t("prize.weightMin", "Weight must be at least 0")),
unlimited_stock: z.boolean(),
total_stock: z.number().optional(),
is_fallback: z.boolean(),
duration_days: z.number().optional(),
amount_yuan: z.number().optional(),
})
.superRefine((data, ctx) => {
const issue = (path: string, message: string) => {
ctx.addIssue({ code: z.ZodIssueCode.custom, message, path: [path] });
};
const isPositiveInt = (value?: number) =>
!!value && value > 0 && Number.isInteger(value);
if (data.type === "vpn_duration" && !isPositiveInt(data.duration_days)) {
issue(
"duration_days",
t(
"prize.durationDaysRequired",
"Duration days must be a positive integer"
)
);
}
if (data.type === "commission") {
const yuan = data.amount_yuan ?? 0;
const cents = yuan * CENTS_PER_YUAN;
if (yuan <= 0) {
issue(
"amount_yuan",
t("prize.amountRequired", "Amount must be greater than 0")
);
} else if (Math.abs(Math.round(cents) - cents) > 1e-6) {
issue(
"amount_yuan",
t(
"prize.amountPrecision",
"Amount supports at most 2 decimal places"
)
);
}
}
if (!(data.unlimited_stock || isPositiveInt(data.total_stock))) {
issue(
"total_stock",
t(
"prize.totalStockRequired",
"Total stock must be a positive integer"
)
);
}
});
type PrizeFormValues = z.infer<ReturnType<typeof getPrizeSchema>>;
interface PrizeFormProps {
activityId: number;
slot: number;
initialValues?: API.LotteryPrize;
open: boolean;
onOpenChange: (open: boolean) => void;
onSuccess: () => void;
}
function toFormValues(prize?: API.LotteryPrize): PrizeFormValues {
return {
type: (prize?.type as PrizeFormValues["type"]) ?? "vpn_duration",
name: prize?.name ?? "",
icon_url: prize?.icon_url ?? "",
weight: prize?.weight ?? 1,
unlimited_stock: prize ? prize.total_stock === null : true,
total_stock: prize?.total_stock ?? undefined,
is_fallback: prize?.is_fallback ?? false,
duration_days: prize?.config?.duration_days as number | undefined,
amount_yuan:
typeof prize?.config?.amount_cents === "number"
? prize.config.amount_cents / CENTS_PER_YUAN
: undefined,
};
}
function toConfig(values: PrizeFormValues): Record<string, any> {
if (values.type === "vpn_duration") {
return { duration_days: values.duration_days };
}
if (values.type === "commission") {
return {
amount_cents: Math.round((values.amount_yuan ?? 0) * CENTS_PER_YUAN),
};
}
return {};
}
export default function PrizeForm({
activityId,
slot,
initialValues,
open,
onOpenChange,
onSuccess,
}: PrizeFormProps) {
const { t } = useTranslation("lottery");
const [loading, setLoading] = useState(false);
const form = useForm<PrizeFormValues>({
resolver: zodResolver(getPrizeSchema(t)),
defaultValues: toFormValues(initialValues),
});
const type = form.watch("type");
const unlimitedStock = form.watch("unlimited_stock");
const isFallback = form.watch("is_fallback");
const isEdit = !!initialValues?.id;
const targetSlot = initialValues?.slot ?? slot;
useEffect(() => {
if (open) form.reset(toFormValues(initialValues));
}, [form, initialValues, open]);
async function handleSubmit(values: PrizeFormValues) {
setLoading(true);
try {
const body: API.CreateLotteryPrizeRequest = {
activity_id: activityId,
slot: targetSlot,
type: values.type,
name: values.name.trim(),
icon_url: values.icon_url?.trim() ?? "",
config: toConfig(values),
weight: values.weight,
total_stock: values.unlimited_stock
? null
: (values.total_stock ?? null),
is_fallback: values.is_fallback,
};
if (isEdit) {
await updateLotteryPrize({ ...body, id: initialValues!.id });
toast.success(t("prize.updateSuccess", "Prize updated"));
} else {
await createLotteryPrize(body);
toast.success(t("prize.createSuccess", "Prize created"));
}
onSuccess();
onOpenChange(false);
} catch {
// Request layer already surfaces the error toast
} finally {
setLoading(false);
}
}
async function handleDelete() {
if (!initialValues?.id) return;
setLoading(true);
try {
await deleteLotteryPrize({ id: initialValues.id });
toast.success(t("prize.deleteSuccess", "Prize deleted"));
onSuccess();
onOpenChange(false);
} catch {
// Request layer already surfaces the error toast
} finally {
setLoading(false);
}
}
const renderInput = (
name:
| "name"
| "icon_url"
| "weight"
| "total_stock"
| "duration_days"
| "amount_yuan",
label: string,
inputProps: Partial<EnhancedInputProps<any>>,
description?: string
) => (
<FormField
control={form.control}
name={name}
render={({ field }) => (
<FormItem>
<FormLabel>{label}</FormLabel>
<FormControl>
<EnhancedInput
onValueChange={(value) => form.setValue(name, value)}
value={field.value}
{...inputProps}
/>
</FormControl>
{description && (
<p className="text-muted-foreground text-xs">{description}</p>
)}
<FormMessage />
</FormItem>
)}
/>
);
const renderSwitch = (
name: "unlimited_stock" | "is_fallback",
label: string,
description?: string
) => (
<FormField
control={form.control}
name={name}
render={({ field }) => (
<FormItem className="flex items-center justify-between rounded-md border p-3">
<div className="space-y-1">
<FormLabel>{label}</FormLabel>
{description && (
<p className="text-muted-foreground text-xs">{description}</p>
)}
</div>
<FormControl>
<Switch
checked={field.value}
onCheckedChange={(checked) => form.setValue(name, checked)}
/>
</FormControl>
</FormItem>
)}
/>
);
const stage2Hint = t("prize.stage2Hint", "Available in Stage 2");
return (
<Sheet onOpenChange={onOpenChange} open={open}>
<SheetContent className="w-[520px] max-w-full md:max-w-screen-md">
<SheetHeader>
<SheetTitle>
{isEdit
? t("prize.editTitle", "Edit Prize")
: t("prize.createTitle", "Add Prize")}
{" · "}
{t("prize.slotLabel", "Slot")} {targetSlot}
</SheetTitle>
</SheetHeader>
<ScrollArea className="h-[calc(100vh-48px-36px-36px-env(safe-area-inset-top))]">
<Form {...form}>
<form
className="space-y-4 px-6 pt-4"
onSubmit={form.handleSubmit(handleSubmit)}
>
<FormField
control={form.control}
name="type"
render={({ field }) => (
<FormItem>
<FormLabel>{t("prize.type", "Prize Type")}</FormLabel>
<FormControl>
<Select
onValueChange={(value) =>
form.setValue(
field.name,
value as PrizeFormValues["type"]
)
}
value={field.value}
>
<SelectTrigger className="w-full">
<SelectValue
placeholder={t("prize.selectType", "Select type")}
/>
</SelectTrigger>
<SelectContent>
{PRIZE_TYPE_OPTIONS.map((option) => (
<SelectItem
disabled={option.disabled}
key={option.value}
value={option.value}
>
{t(option.labelKey, option.labelDefault)}
{option.disabled ? ` · ${stage2Hint}` : ""}
</SelectItem>
))}
</SelectContent>
</Select>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
{renderInput("name", t("prize.name", "Prize Name"), {
placeholder: t("prize.namePlaceholder", "e.g. 1-Day Pass"),
})}
{renderInput("icon_url", t("prize.iconUrl", "Icon URL"), {
placeholder: "https://",
})}
{type === "vpn_duration" &&
renderInput(
"duration_days",
t("prize.durationDays", "Duration (days)"),
{
type: "number",
min: 1,
step: 1,
placeholder: t("prize.durationDaysPlaceholder", "e.g. 1"),
suffix: t("prize.daysSuffix", "days"),
}
)}
{type === "commission" &&
renderInput(
"amount_yuan",
t("prize.amountYuan", "Commission Amount (CNY)"),
{
type: "number",
min: 0,
step: 0.01,
placeholder: "0.00",
prefix: "¥",
suffix: t("prize.yuanSuffix", "CNY"),
},
t(
"prize.amountUnitHint",
"Entered in CNY (yuan), stored as cents; up to 2 decimal places"
)
)}
{type === "none" && (
<p className="rounded-md bg-muted/50 p-3 text-muted-foreground text-xs">
{t(
"prize.noneHint",
"No config needed. Consider enabling fallback so users always land on this prize when limited prizes run out."
)}
</p>
)}
{renderInput(
"weight",
t("prize.weight", "Weight"),
{ type: "number", min: 0, step: 1, disabled: isFallback },
isFallback
? t(
"prize.fallbackIgnoresWeight",
"Fallback prize ignores weight"
)
: t(
"prize.weightHint",
"0 = displayed but excluded from random draw"
)
)}
{renderSwitch(
"unlimited_stock",
t("prize.unlimitedStock", "Unlimited Stock")
)}
{!unlimitedStock &&
renderInput(
"total_stock",
t("prize.totalStock", "Total Stock"),
{
type: "number",
min: 1,
step: 1,
placeholder: t("prize.totalStockPlaceholder", "e.g. 100"),
}
)}
{renderSwitch(
"is_fallback",
t("prize.isFallback", "Fallback Prize"),
t(
"prize.isFallbackHint",
"Awarded when limited prizes are sold out"
)
)}
</form>
</Form>
</ScrollArea>
<SheetFooter className="flex-row justify-end gap-2 pt-3">
{isEdit && (
<ConfirmButton
cancelText={t("prize.cancel", "Cancel")}
confirmText={t("prize.confirmDelete", "Delete")}
description={t(
"prize.deleteDescription",
"This prize will be removed from the grid. This action cannot be undone."
)}
onConfirm={handleDelete}
title={t("prize.deleteTitle", "Delete this prize?")}
trigger={
<Button
className="mr-auto"
disabled={loading}
variant="destructive"
>
{t("prize.delete", "Delete")}
</Button>
}
/>
)}
<Button
disabled={loading}
onClick={() => onOpenChange(false)}
variant="outline"
>
{t("prize.cancel", "Cancel")}
</Button>
<Button disabled={loading} onClick={form.handleSubmit(handleSubmit)}>
{loading && (
<Icon className="mr-2 animate-spin" icon="mdi:loading" />
)}
{t("prize.confirm", "Confirm")}
</Button>
</SheetFooter>
</SheetContent>
</Sheet>
);
}
@@ -0,0 +1,228 @@
import {
Alert,
AlertDescription,
AlertTitle,
} from "@workspace/ui/components/alert";
import { Badge } from "@workspace/ui/components/badge";
import { Skeleton } from "@workspace/ui/components/skeleton";
import { cn } from "@workspace/ui/lib/utils";
import { getLotteryPrizeList } from "@workspace/ui/services/admin/lottery";
import { AlertTriangle, Plus } from "lucide-react";
import { useCallback, useEffect, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import PrizeForm from "./prize-form";
const DEFAULT_GRID_SIZE = 9;
const CENTER_SLOT = 4;
const PERCENT_DECIMALS = 1;
interface PrizeGridProps {
activity: API.LotteryActivity;
}
type TranslateFn = (key: string, defaultValue: string) => string;
function prizeTypeLabel(type: API.LotteryPrizeType, t: TranslateFn): string {
const labels: Record<string, string> = {
vpn_duration: t("prize.typeVpnDuration", "VPN Duration"),
commission: t("prize.typeCommission", "Commission"),
none: t("prize.typeNone", "No Prize (Thanks)"),
crypto: t("prize.typeCrypto", "Crypto"),
physical: t("prize.typePhysical", "Physical"),
manual_other: t("prize.typeManualOther", "Manual (Other)"),
coupon: t("prize.typeCoupon", "Coupon"),
points: t("prize.typePoints", "Points"),
};
return labels[type] ?? type;
}
interface FormState {
open: boolean;
slot: number;
prize?: API.LotteryPrize;
}
export default function PrizeGrid({ activity }: PrizeGridProps) {
const { t } = useTranslation("lottery");
const [prizes, setPrizes] = useState<API.LotteryPrize[]>([]);
const [loading, setLoading] = useState(false);
const [formState, setFormState] = useState<FormState>({
open: false,
slot: 0,
});
const fetchPrizes = useCallback(async () => {
setLoading(true);
try {
const { data } = await getLotteryPrizeList({ activity_id: activity.id });
setPrizes(data?.data?.list ?? []);
} catch {
// Request layer already surfaces the error toast
} finally {
setLoading(false);
}
}, [activity.id]);
useEffect(() => {
fetchPrizes();
}, [fetchPrizes]);
const prizeBySlot = useMemo(() => {
const map = new Map<number, API.LotteryPrize>();
for (const prize of prizes) {
map.set(prize.slot, prize);
}
return map;
}, [prizes]);
const randomPrizes = useMemo(
() => prizes.filter((prize) => prize.weight > 0 && !prize.is_fallback),
[prizes]
);
const totalWeight = useMemo(
() => randomPrizes.reduce((sum, prize) => sum + prize.weight, 0),
[randomPrizes]
);
const hasFallback = prizes.some((prize) => prize.is_fallback);
const gridSize = activity.grid_size || DEFAULT_GRID_SIZE;
const slots = Array.from({ length: gridSize }, (_, index) => index);
const openForm = (slot: number, prize?: API.LotteryPrize) => {
setFormState({ open: true, slot, prize });
};
if (loading && prizes.length === 0) {
return (
<div className="grid grid-cols-3 gap-3">
{slots.map((slot) => (
<Skeleton className="min-h-[132px] rounded-lg" key={slot} />
))}
</div>
);
}
return (
<div className="space-y-4">
<div className="rounded-lg border bg-muted/30 p-3">
<p className="mb-2 font-medium text-sm">
{t("prize.probabilityPreview", "Probability Preview")}
</p>
{randomPrizes.length > 0 ? (
<div className="flex flex-wrap gap-2">
{randomPrizes.map((prize) => (
<Badge key={prize.id} variant="secondary">
{prize.name}: {prize.weight}/{totalWeight} (
{((prize.weight / totalWeight) * 100).toFixed(PERCENT_DECIMALS)}
%)
</Badge>
))}
</div>
) : (
<p className="text-muted-foreground text-xs">
{t(
"prize.noRandomPrizes",
"No prizes participate in the random draw yet"
)}
</p>
)}
</div>
{!hasFallback && (
<Alert>
<AlertTriangle className="h-4 w-4" />
<AlertTitle>
{t("prize.noFallbackTitle", "No fallback prize")}
</AlertTitle>
<AlertDescription>
{t(
"prize.noFallbackHint",
"Consider configuring a fallback prize so draws never fail when limited prizes run out."
)}
</AlertDescription>
</Alert>
)}
<div className="grid grid-cols-3 gap-3">
{slots.map((slot) => {
const prize = prizeBySlot.get(slot);
return (
<button
className={cn(
"relative flex min-h-[132px] flex-col items-center justify-center gap-1 rounded-lg border p-3 text-center transition-colors hover:border-primary",
prize ? "bg-card" : "border-dashed text-muted-foreground"
)}
key={slot}
onClick={() => openForm(slot, prize)}
type="button"
>
<span className="absolute top-1 left-1.5 text-[10px] text-muted-foreground">
#{slot}
</span>
{slot === CENTER_SLOT && (
<Badge
className="absolute top-1 right-1 px-1.5 text-[10px]"
variant="outline"
>
{t("prize.centerSlotHint", "Usually the draw button")}
</Badge>
)}
{prize ? (
<>
{prize.icon_url ? (
<img
alt={prize.name}
className="h-8 w-8 rounded object-cover"
height={32}
src={prize.icon_url}
width={32}
/>
) : (
<span aria-hidden className="text-2xl">
🎁
</span>
)}
<span className="line-clamp-1 font-medium text-sm">
{prize.name}
</span>
<Badge variant="secondary">
{prizeTypeLabel(prize.type, t)}
</Badge>
<span className="text-muted-foreground text-xs">
{t("prize.weightShort", "Weight")}: {prize.weight} ·{" "}
{t("prize.stockShort", "Stock")}:{" "}
{prize.total_stock === null ? "∞" : prize.total_stock}
</span>
<div className="flex flex-wrap justify-center gap-1">
{prize.is_fallback && (
<Badge variant="outline">
{t("prize.fallbackBadge", "Fallback")}
</Badge>
)}
{prize.sold_out && (
<Badge variant="destructive">
{t("prize.soldOutBadge", "Sold Out")}
</Badge>
)}
</div>
</>
) : (
<>
<Plus className="h-5 w-5" />
<span className="text-xs">
{t("prize.addPrize", "Add Prize")}
</span>
</>
)}
</button>
);
})}
</div>
<PrizeForm
activityId={activity.id}
initialValues={formState.prize}
onOpenChange={(open) => setFormState((prev) => ({ ...prev, open }))}
onSuccess={fetchPrizes}
open={formState.open}
slot={formState.slot}
/>
</div>
);
}
@@ -0,0 +1,448 @@
import { z } from "zod";
export const RULE_CAPS = { maxDepth: 8, maxNodes: 64, maxBytes: 8192 } as const;
export const CHANCE_SOURCE_OPTIONS: {
value: API.LotteryChanceSourceType;
labelKey: string;
labelDefault: string;
}[] = [
{
value: "daily_signin",
labelKey: "rules.source.dailySignin",
labelDefault: "Daily Sign-in",
},
{
value: "new_subscription",
labelKey: "rules.source.newSubscription",
labelDefault: "New Subscription",
},
{
value: "invite_success",
labelKey: "rules.source.inviteSuccess",
labelDefault: "Invite Success",
},
{
value: "manual_grant",
labelKey: "rules.source.manualGrant",
labelDefault: "Manual Grant",
},
];
export const CONDITION_TYPES = [
"has_subscription",
"subscription_type",
"invite_count",
"total_recharge",
"register_days",
"user_tag",
] as const;
export type ConditionType = (typeof CONDITION_TYPES)[number];
export interface ConditionRow {
type: ConditionType;
minDaysRemaining?: number;
planIds?: string;
min?: number;
windowDays?: number;
minUsdt?: number;
tags?: string;
}
export interface ConditionParamField {
key: keyof Omit<ConditionRow, "type">;
inputType: "number" | "text";
labelKey: string;
labelDefault: string;
placeholderKey?: string;
placeholderDefault?: string;
}
export const CONDITION_PARAM_FIELDS: Record<
ConditionType,
ConditionParamField[]
> = {
has_subscription: [
{
key: "minDaysRemaining",
inputType: "number",
labelKey: "rules.param.minDaysRemaining",
labelDefault: "Min Days Remaining",
},
],
subscription_type: [
{
key: "planIds",
inputType: "text",
labelKey: "rules.param.planIds",
labelDefault: "Plan IDs",
placeholderKey: "rules.param.planIdsPlaceholder",
placeholderDefault: "Comma separated, e.g. 1,2,3",
},
],
invite_count: [
{
key: "min",
inputType: "number",
labelKey: "rules.param.min",
labelDefault: "Min Count",
},
{
key: "windowDays",
inputType: "number",
labelKey: "rules.param.windowDays",
labelDefault: "Window Days (optional)",
},
],
total_recharge: [
{
key: "minUsdt",
inputType: "number",
labelKey: "rules.param.minUsdt",
labelDefault: "Min USDT",
},
],
register_days: [
{
key: "min",
inputType: "number",
labelKey: "rules.param.min",
labelDefault: "Min Count",
},
],
user_tag: [
{
key: "tags",
inputType: "text",
labelKey: "rules.param.tags",
labelDefault: "Tags",
placeholderKey: "rules.param.tagsPlaceholder",
placeholderDefault: "Comma separated, e.g. vip,beta",
},
],
};
export function parseIntList(input?: string): number[] {
if (!input) return [];
return input
.split(/[,\s]+/)
.map((item) => item.trim())
.filter(Boolean)
.map((item) => Number.parseInt(item, 10))
.filter((item) => Number.isFinite(item));
}
export function parseStringList(input?: string): string[] {
if (!input) return [];
return input
.split(/[,]+/)
.map((item) => item.trim())
.filter(Boolean);
}
export function conditionToNode(row: ConditionRow): API.LotteryEligibilityNode {
switch (row.type) {
case "has_subscription":
return {
type: row.type,
params: { min_days_remaining: row.minDaysRemaining ?? 0 },
};
case "subscription_type":
return {
type: row.type,
params: { plan_ids: parseIntList(row.planIds) },
};
case "invite_count": {
const params: Record<string, number> = { min: row.min ?? 0 };
if (row.windowDays) params.window_days = row.windowDays;
return { type: row.type, params };
}
case "total_recharge":
return { type: row.type, params: { min_usdt: row.minUsdt ?? 0 } };
case "register_days":
return { type: row.type, params: { min: row.min ?? 0 } };
case "user_tag":
return { type: row.type, params: { tags: parseStringList(row.tags) } };
}
}
export function buildEligibility(
op: "AND" | "OR",
rows: ConditionRow[]
): API.LotteryEligibilityNode | Record<string, never> {
if (rows.length === 0) return {};
return { op, children: rows.map(conditionToNode) };
}
function isLeafNode(node: API.LotteryEligibilityNode): boolean {
return Boolean(node.type) && !node.op && !node.children?.length;
}
function nodeToCondition(
node: API.LotteryEligibilityNode
): ConditionRow | null {
const type = CONDITION_TYPES.find((item) => item === node.type);
if (!type) return null;
const params = node.params ?? {};
switch (type) {
case "has_subscription":
return { type, minDaysRemaining: params.min_days_remaining };
case "subscription_type":
return {
type,
planIds: Array.isArray(params.plan_ids)
? params.plan_ids.join(",")
: "",
};
case "invite_count":
return { type, min: params.min, windowDays: params.window_days };
case "total_recharge":
return { type, minUsdt: params.min_usdt };
case "register_days":
return { type, min: params.min };
case "user_tag":
return {
type,
tags: Array.isArray(params.tags) ? params.tags.join(",") : "",
};
}
}
export function isEmptyEligibility(
eligibility: API.LotteryActivity["eligibility"]
): boolean {
return (
eligibility === null ||
eligibility === undefined ||
Object.keys(eligibility).length === 0
);
}
/**
* 尝试把规则树还原成「一层 op + children 全是叶子」的简单模式;
* 结构更复杂时返回 null(调用方应切到高级模式)。
*/
export function treeToSimple(
eligibility: API.LotteryActivity["eligibility"]
): { op: "AND" | "OR"; rows: ConditionRow[] } | null {
if (isEmptyEligibility(eligibility)) return { op: "AND", rows: [] };
const tree = eligibility as API.LotteryEligibilityNode;
if (
(tree.op !== "AND" && tree.op !== "OR") ||
!Array.isArray(tree.children) ||
!tree.children.every(isLeafNode)
) {
return null;
}
const rows: ConditionRow[] = [];
for (const child of tree.children) {
const row = nodeToCondition(child);
if (!row) return null;
rows.push(row);
}
return { op: tree.op, rows };
}
export interface RuleCapsResult {
depth: number;
nodes: number;
bytes: number;
depthExceeded: boolean;
nodesExceeded: boolean;
bytesExceeded: boolean;
ok: boolean;
}
export function checkRuleCaps(
tree: API.LotteryEligibilityNode | Record<string, never>
): RuleCapsResult {
function walk(node: API.LotteryEligibilityNode): {
depth: number;
nodes: number;
} {
const children = Array.isArray(node.children) ? node.children : [];
let maxChildDepth = 0;
let nodes = 1;
for (const child of children) {
const result = walk(child);
maxChildDepth = Math.max(maxChildDepth, result.depth);
nodes += result.nodes;
}
return { depth: maxChildDepth + 1, nodes };
}
const { depth, nodes } = walk(tree);
const bytes = new TextEncoder().encode(JSON.stringify(tree)).length;
const depthExceeded = depth > RULE_CAPS.maxDepth;
const nodesExceeded = nodes > RULE_CAPS.maxNodes;
const bytesExceeded = bytes > RULE_CAPS.maxBytes;
return {
depth,
nodes,
bytes,
depthExceeded,
nodesExceeded,
bytesExceeded,
ok: !(depthExceeded || nodesExceeded || bytesExceeded),
};
}
export type TranslateFn = (key: string, defaultValue: string) => string;
/** 规则树超限时返回具体超限项的提示文案,未超限返回 null。 */
export function buildCapsErrorMessage(
t: TranslateFn,
eligibility: API.LotteryEligibilityNode | Record<string, never>
): string | null {
if (isEmptyEligibility(eligibility)) return null;
const caps = checkRuleCaps(eligibility);
if (caps.ok) return null;
const fill = (template: string, value: number, limit: number) =>
template
.replace("{{value}}", String(value))
.replace("{{limit}}", String(limit));
const parts: string[] = [];
if (caps.depthExceeded) {
parts.push(
fill(
t("rules.capsDepthExceeded", "Depth {{value}} exceeds limit {{limit}}"),
caps.depth,
RULE_CAPS.maxDepth
)
);
}
if (caps.nodesExceeded) {
parts.push(
fill(
t(
"rules.capsNodesExceeded",
"Node count {{value}} exceeds limit {{limit}}"
),
caps.nodes,
RULE_CAPS.maxNodes
)
);
}
if (caps.bytesExceeded) {
parts.push(
fill(
t(
"rules.capsBytesExceeded",
"Size {{value}} bytes exceeds limit {{limit}} bytes"
),
caps.bytes,
RULE_CAPS.maxBytes
)
);
}
return parts.join("; ");
}
export function validateJsonTree(input: string, t: TranslateFn): string | null {
try {
const parsed: unknown = JSON.parse(input);
if (parsed === null) return null;
if (typeof parsed !== "object" || Array.isArray(parsed)) {
return t("rules.jsonMustBeObject", "Rule tree must be a JSON object");
}
return null;
} catch (error: unknown) {
return error instanceof Error ? error.message : "Invalid JSON";
}
}
const chanceSourceSchema = z.object({
source: z.enum([
"daily_signin",
"new_subscription",
"invite_success",
"manual_grant",
]),
amount: z.number().int().min(0),
daily_limit: z.number().int().min(0).optional(),
});
const conditionSchema = z.object({
type: z.enum(CONDITION_TYPES),
minDaysRemaining: z.number().int().min(0).optional(),
planIds: z.string().optional(),
min: z.number().int().min(0).optional(),
windowDays: z.number().int().min(0).optional(),
minUsdt: z.number().min(0).optional(),
tags: z.string().optional(),
});
export const getRuleEditorSchema = (t: TranslateFn) =>
z
.object({
chanceSources: z.array(chanceSourceSchema),
mode: z.enum(["simple", "advanced"]),
op: z.enum(["AND", "OR"]),
conditions: z.array(conditionSchema),
advancedJson: z.string(),
})
.superRefine((data, ctx) => {
const seen = new Set<string>();
data.chanceSources.forEach((row, index) => {
if (seen.has(row.source)) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: t("rules.duplicateSource", "Duplicate source"),
path: ["chanceSources", index, "source"],
});
}
seen.add(row.source);
});
if (data.mode === "advanced" && data.advancedJson.trim()) {
const error = validateJsonTree(data.advancedJson, t);
if (error) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: error,
path: ["advancedJson"],
});
}
}
});
export type RuleEditorValues = z.infer<ReturnType<typeof getRuleEditorSchema>>;
export function toRuleEditorValues(
activity: API.LotteryActivity
): RuleEditorValues {
const chanceSources = (activity.chance_sources ?? []).map((row) => ({
source: row.source,
amount: row.amount,
daily_limit: row.daily_limit ?? undefined,
}));
const simple = treeToSimple(activity.eligibility);
if (simple) {
return {
chanceSources,
mode: "simple",
op: simple.op,
conditions: simple.rows,
advancedJson: "",
};
}
return {
chanceSources,
mode: "advanced",
op: "AND",
conditions: [],
advancedJson: JSON.stringify(activity.eligibility, null, 2),
};
}
export function resolveEligibility(
values: RuleEditorValues
): API.LotteryEligibilityNode | Record<string, never> {
if (values.mode === "simple") {
return buildEligibility(values.op, values.conditions);
}
const text = values.advancedJson.trim();
if (!text) return {};
const parsed = JSON.parse(text) as API.LotteryEligibilityNode | null;
return parsed ?? {};
}
@@ -0,0 +1,453 @@
import { zodResolver } from "@hookform/resolvers/zod";
import {
Alert,
AlertDescription,
AlertTitle,
} from "@workspace/ui/components/alert";
import { Button } from "@workspace/ui/components/button";
import {
Form,
FormControl,
FormField,
FormItem,
FormLabel,
FormMessage,
} from "@workspace/ui/components/form";
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@workspace/ui/components/select";
import {
Tabs,
TabsContent,
TabsList,
TabsTrigger,
} from "@workspace/ui/components/tabs";
import { Textarea } from "@workspace/ui/components/textarea";
import { EnhancedInput } from "@workspace/ui/composed/enhanced-input";
import { updateLotteryActivityRules } from "@workspace/ui/services/admin/lottery";
import { PlusIcon, Trash2Icon, TriangleAlertIcon } from "lucide-react";
import { useEffect, useMemo, useState } from "react";
import { useFieldArray, useForm } from "react-hook-form";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import {
buildCapsErrorMessage,
buildEligibility,
CHANCE_SOURCE_OPTIONS,
CONDITION_PARAM_FIELDS,
CONDITION_TYPES,
getRuleEditorSchema,
isEmptyEligibility,
type RuleEditorValues,
resolveEligibility,
toRuleEditorValues,
treeToSimple,
validateJsonTree,
} from "./rule-editor-utils";
interface RuleEditorProps {
activity: API.LotteryActivity;
onSaved?: () => void;
}
export default function RuleEditor({ activity, onSaved }: RuleEditorProps) {
const { t } = useTranslation("lottery");
const [loading, setLoading] = useState(false);
const [capsError, setCapsError] = useState<string | null>(null);
const form = useForm<RuleEditorValues>({
resolver: zodResolver(getRuleEditorSchema(t)),
defaultValues: toRuleEditorValues(activity),
});
const sourceRows = useFieldArray({
control: form.control,
name: "chanceSources",
});
const conditionRows = useFieldArray({
control: form.control,
name: "conditions",
});
const mode = form.watch("mode");
const advancedJson = form.watch("advancedJson");
useEffect(() => {
form.reset(toRuleEditorValues(activity));
setCapsError(null);
}, [form, activity]);
const jsonError = useMemo(
() => (advancedJson.trim() ? validateJsonTree(advancedJson, t) : null),
[advancedJson, t]
);
async function handleSubmit(values: RuleEditorValues) {
const eligibility = resolveEligibility(values);
const capsMessage = buildCapsErrorMessage(t, eligibility);
setCapsError(capsMessage);
if (capsMessage) return;
setLoading(true);
try {
await updateLotteryActivityRules({
id: activity.id,
eligibility,
chance_sources: values.chanceSources.map((row) => ({
source: row.source,
amount: row.amount,
daily_limit: row.daily_limit || undefined,
})),
});
toast.success(t("rules.saveSuccess", "Rules saved"));
onSaved?.();
} catch (_error) {
toast.error(t("rules.saveFailed", "Failed to save rules"));
} finally {
setLoading(false);
}
}
function handleModeChange(value: string) {
if (value === "advanced" && !form.getValues("advancedJson").trim()) {
const tree = buildEligibility(
form.getValues("op"),
form.getValues("conditions")
);
form.setValue(
"advancedJson",
isEmptyEligibility(tree) ? "" : JSON.stringify(tree, null, 2)
);
}
if (value === "simple") {
const text = form.getValues("advancedJson").trim();
let simple: ReturnType<typeof treeToSimple> = { op: "AND", rows: [] };
if (text) {
try {
simple = treeToSimple(
JSON.parse(text) as API.LotteryActivity["eligibility"]
);
} catch {
simple = null;
}
}
if (!simple) {
toast.error(
t(
"rules.cannotSimplify",
"This rule tree is too complex for simple mode. Please edit it in Advanced mode."
)
);
return;
}
form.setValue("op", simple.op);
form.setValue("conditions", simple.rows);
form.setValue("advancedJson", "");
}
form.setValue("mode", value as RuleEditorValues["mode"]);
}
return (
<Form {...form}>
<form className="space-y-6" onSubmit={form.handleSubmit(handleSubmit)}>
<section className="space-y-3">
<h3 className="font-medium text-base">
{t("rules.chanceSources", "Chance Sources")}
</h3>
<p className="text-muted-foreground text-sm">
{t(
"rules.chanceSourcesDescription",
"Configure how users earn draw chances. Each source can only appear once."
)}
</p>
{sourceRows.fields.map((row, index) => (
<div className="flex items-start gap-2" key={row.id}>
<FormField
control={form.control}
name={`chanceSources.${index}.source`}
render={({ field }) => (
<FormItem className="flex-1">
<Select onValueChange={field.onChange} value={field.value}>
<FormControl>
<SelectTrigger>
<SelectValue
placeholder={t(
"rules.selectSource",
"Select source"
)}
/>
</SelectTrigger>
</FormControl>
<SelectContent>
{CHANCE_SOURCE_OPTIONS.map((option) => (
<SelectItem key={option.value} value={option.value}>
{t(option.labelKey, option.labelDefault)}
</SelectItem>
))}
</SelectContent>
</Select>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name={`chanceSources.${index}.amount`}
render={({ field }) => (
<FormItem className="w-32">
<FormControl>
<EnhancedInput
min={0}
onValueChange={(value) => field.onChange(value)}
placeholder={t("rules.amount", "Amount")}
type="number"
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name={`chanceSources.${index}.daily_limit`}
render={({ field }) => (
<FormItem className="w-44">
<FormControl>
<EnhancedInput
min={0}
onValueChange={(value) => field.onChange(value)}
placeholder={t(
"rules.dailyLimit",
"Daily limit (optional)"
)}
type="number"
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<Button
onClick={() => sourceRows.remove(index)}
size="icon"
type="button"
variant="ghost"
>
<Trash2Icon className="size-4" />
</Button>
</div>
))}
<Button
onClick={() =>
sourceRows.append({ source: "daily_signin", amount: 1 })
}
size="sm"
type="button"
variant="outline"
>
<PlusIcon className="size-4" />
{t("rules.addSource", "Add Source")}
</Button>
</section>
<section className="space-y-3">
<h3 className="font-medium text-base">
{t("rules.eligibility", "Eligibility")}
</h3>
<Alert className="border-yellow-500/50 bg-yellow-50 text-yellow-800 dark:bg-yellow-900/20 dark:text-yellow-400">
<TriangleAlertIcon />
<AlertTitle>
{t("rules.stage1Warning", "Stage 1 notice")}
</AlertTitle>
<AlertDescription className="text-inherit">
{t(
"rules.stage1WarningDescription",
"The rule context is not wired up in the current version (Stage 1). Configuring eligibility will prevent users from joining the lottery. It is recommended to keep it empty."
)}
</AlertDescription>
</Alert>
<Tabs onValueChange={handleModeChange} value={mode}>
<TabsList>
<TabsTrigger value="simple">
{t("rules.simpleMode", "Simple")}
</TabsTrigger>
<TabsTrigger value="advanced">
{t("rules.advancedMode", "Advanced (JSON)")}
</TabsTrigger>
</TabsList>
<TabsContent className="space-y-3 pt-2" value="simple">
<FormField
control={form.control}
name="op"
render={({ field }) => (
<FormItem className="w-48">
<FormLabel>
{t("rules.op", "Combine Conditions With")}
</FormLabel>
<Select onValueChange={field.onChange} value={field.value}>
<FormControl>
<SelectTrigger>
<SelectValue />
</SelectTrigger>
</FormControl>
<SelectContent>
<SelectItem value="AND">
{t("rules.opAnd", "AND")}
</SelectItem>
<SelectItem value="OR">
{t("rules.opOr", "OR")}
</SelectItem>
</SelectContent>
</Select>
</FormItem>
)}
/>
{conditionRows.fields.length === 0 && (
<p className="text-muted-foreground text-sm">
{t(
"rules.noConditions",
"No conditions. Everyone is eligible to join."
)}
</p>
)}
{conditionRows.fields.map((row, index) => {
const type = form.watch(`conditions.${index}.type`);
return (
<div
className="flex flex-wrap items-start gap-2 rounded-md border p-3"
key={row.id}
>
<FormField
control={form.control}
name={`conditions.${index}.type`}
render={({ field }) => (
<FormItem className="w-56">
<Select
onValueChange={field.onChange}
value={field.value}
>
<FormControl>
<SelectTrigger>
<SelectValue />
</SelectTrigger>
</FormControl>
<SelectContent>
{CONDITION_TYPES.map((item) => (
<SelectItem key={item} value={item}>
{t(`rules.conditionType.${item}`, item)}
</SelectItem>
))}
</SelectContent>
</Select>
<FormMessage />
</FormItem>
)}
/>
{CONDITION_PARAM_FIELDS[type].map((param) => (
<FormField
control={form.control}
key={param.key}
name={`conditions.${index}.${param.key}`}
render={({ field }) => (
<FormItem className="w-52">
<FormControl>
<EnhancedInput
min={
param.inputType === "number" ? 0 : undefined
}
onValueChange={(value) => field.onChange(value)}
placeholder={
param.placeholderKey &&
param.placeholderDefault
? t(
param.placeholderKey,
param.placeholderDefault
)
: t(param.labelKey, param.labelDefault)
}
type={param.inputType}
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
))}
<Button
onClick={() => conditionRows.remove(index)}
size="icon"
type="button"
variant="ghost"
>
<Trash2Icon className="size-4" />
</Button>
</div>
);
})}
<Button
onClick={() =>
conditionRows.append({ type: "has_subscription" })
}
size="sm"
type="button"
variant="outline"
>
<PlusIcon className="size-4" />
{t("rules.addCondition", "Add Condition")}
</Button>
</TabsContent>
<TabsContent className="space-y-2 pt-2" value="advanced">
<FormField
control={form.control}
name="advancedJson"
render={({ field }) => (
<FormItem>
<FormControl>
<Textarea
className="min-h-56 font-mono text-sm"
onChange={field.onChange}
placeholder={t(
"rules.jsonPlaceholder",
'Rule tree JSON, e.g. {"op":"AND","children":[...]}. Leave empty for no requirement.'
)}
value={field.value}
/>
</FormControl>
<FormMessage />
</FormItem>
)}
/>
{jsonError && (
<p className="text-destructive text-sm">
{t("rules.jsonInvalid", "Invalid JSON: {{error}}").replace(
"{{error}}",
jsonError
)}
</p>
)}
</TabsContent>
</Tabs>
</section>
{capsError && (
<Alert variant="destructive">
<TriangleAlertIcon />
<AlertTitle>
{t("rules.capsExceeded", "Rule tree exceeds limits")}
</AlertTitle>
<AlertDescription>{capsError}</AlertDescription>
</Alert>
)}
<div className="flex justify-end">
<Button disabled={loading} type="submit">
{t("rules.save", "Save Rules")}
</Button>
</div>
</form>
</Form>
);
}
+287
View File
@@ -0,0 +1,287 @@
/* eslint-disable */
import request from "@workspace/ui/lib/request";
/**
* 创建抽奖活动
* POST /v1/admin/lottery/activities
* @param body - 创建抽奖活动请求参数
* @param options - 可选的请求配置
* @returns 创建结果
*/
export async function createLotteryActivity(
body: API.CreateLotteryActivityRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.LotteryActivity }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 更新抽奖活动
* PUT /v1/admin/lottery/activities
* @param body - 更新抽奖活动请求参数
* @param options - 可选的请求配置
* @returns 更新结果
*/
export async function updateLotteryActivity(
body: API.UpdateLotteryActivityRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.LotteryActivity }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities`,
{
method: "PUT",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 获取抽奖活动分页列表
* GET /v1/admin/lottery/activities
* @param params - 分页及筛选参数
* @param options - 可选的请求配置
* @returns 抽奖活动列表及总数
*/
export async function getLotteryActivityList(
params: API.GetLotteryActivityListParams,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.GetLotteryActivityListResponse }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities`,
{
method: "GET",
params: {
...params,
},
...(options || {}),
}
);
}
/**
* 获取抽奖活动详情
* GET /v1/admin/lottery/activities/detail
* @param params - 活动 ID 参数
* @param options - 可选的请求配置
* @returns 抽奖活动详情
*/
export async function getLotteryActivityDetail(
params: API.GetLotteryActivityDetailParams,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.LotteryActivity }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities/detail`,
{
method: "GET",
params: {
...params,
},
...(options || {}),
}
);
}
/**
* 上架抽奖活动(draft → running
* POST /v1/admin/lottery/activities/publish
* @param body - 上架活动请求参数
* @param options - 可选的请求配置
* @returns 上架结果
*/
export async function publishLotteryActivity(
body: API.PublishLotteryActivityRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: any }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities/publish`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 暂停抽奖活动
* POST /v1/admin/lottery/activities/pause
* @param body - 暂停活动请求参数
* @param options - 可选的请求配置
* @returns 暂停结果
*/
export async function pauseLotteryActivity(
body: API.PauseLotteryActivityRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: any }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities/pause`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 更新抽奖活动规则(eligibility + chance_sources
* PUT /v1/admin/lottery/activities/rules
* @param body - 更新活动规则请求参数
* @param options - 可选的请求配置
* @returns 更新结果
*/
export async function updateLotteryActivityRules(
body: API.UpdateLotteryActivityRulesRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: any }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/activities/rules`,
{
method: "PUT",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 创建抽奖奖品
* POST /v1/admin/lottery/prizes
* @param body - 创建奖品请求参数
* @param options - 可选的请求配置
* @returns 创建结果
*/
export async function createLotteryPrize(
body: API.CreateLotteryPrizeRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.LotteryPrize }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/prizes`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 更新抽奖奖品
* PUT /v1/admin/lottery/prizes
* @param body - 更新奖品请求参数
* @param options - 可选的请求配置
* @returns 更新结果
*/
export async function updateLotteryPrize(
body: API.UpdateLotteryPrizeRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.LotteryPrize }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/prizes`,
{
method: "PUT",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 删除抽奖奖品
* DELETE /v1/admin/lottery/prizes
* @param body - 删除奖品请求参数
* @param options - 可选的请求配置
* @returns 删除结果
*/
export async function deleteLotteryPrize(
body: API.DeleteLotteryPrizeRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: any }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/prizes`,
{
method: "DELETE",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
/**
* 获取抽奖奖品列表
* GET /v1/admin/lottery/prizes
* @param params - 活动 ID 筛选参数
* @param options - 可选的请求配置
* @returns 奖品列表
*/
export async function getLotteryPrizeList(
params: API.GetLotteryPrizeListParams,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: API.GetLotteryPrizeListResponse }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/prizes`,
{
method: "GET",
params: {
...params,
},
...(options || {}),
}
);
}
/**
* 手动发放抽奖次数
* POST /v1/admin/lottery/chances/grant
* @param body - 发放次数请求参数(source_ref 为幂等键)
* @param options - 可选的请求配置
* @returns 发放结果
*/
export async function grantLotteryChances(
body: API.GrantLotteryChancesRequest,
options?: { [key: string]: any }
) {
return request<API.Response & { data?: any }>(
`${import.meta.env.VITE_API_PREFIX || ""}/v1/admin/lottery/chances/grant`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
},
data: body,
...(options || {}),
}
);
}
+115
View File
@@ -3300,4 +3300,119 @@ declare namespace API {
};
type AdminWithdrawalLog = WithdrawalLog;
type LotteryPrizeType =
| 'vpn_duration'
| 'commission'
| 'none'
| 'crypto'
| 'physical'
| 'manual_other'
| 'coupon'
| 'points';
type LotteryActivityStatus = 'draft' | 'running' | 'paused' | 'ended';
type LotteryChanceSourceType =
| 'daily_signin'
| 'new_subscription'
| 'invite_success'
| 'manual_grant';
type LotteryEligibilityNode = {
op?: 'AND' | 'OR';
children?: LotteryEligibilityNode[];
type?: string;
params?: Record<string, any>;
};
type LotteryChanceSource = {
source: LotteryChanceSourceType;
amount: number;
daily_limit?: number;
};
type LotteryPrize = {
id: number;
activity_id: number;
slot: number;
type: LotteryPrizeType;
name: string;
icon_url: string;
config: Record<string, any>;
weight: number;
total_stock: number | null;
is_fallback: boolean;
sold_out?: boolean;
};
type LotteryActivity = {
id: number;
title: string;
description: string;
start_at: number; // Unix 秒
end_at: number; // Unix 秒
status: LotteryActivityStatus;
grid_size: number;
eligibility?: LotteryEligibilityNode | Record<string, never> | null;
chance_sources?: LotteryChanceSource[];
unmet_action?: string;
prizes?: LotteryPrize[];
};
type CreateLotteryActivityRequest = {
title: string;
description: string;
start_at: number;
end_at: number;
grid_size: number;
eligibility: LotteryEligibilityNode | Record<string, never> | null;
chance_sources: LotteryChanceSource[];
unmet_action: string;
};
type UpdateLotteryActivityRequest = CreateLotteryActivityRequest & { id: number };
type GetLotteryActivityListParams = { page: number; size: number; status?: string };
type GetLotteryActivityListResponse = { total: number; list: LotteryActivity[] };
type GetLotteryActivityDetailParams = { id: number };
type PublishLotteryActivityRequest = { id: number };
type PauseLotteryActivityRequest = { id: number };
type UpdateLotteryActivityRulesRequest = {
id: number;
eligibility: LotteryEligibilityNode | Record<string, never> | null;
chance_sources: LotteryChanceSource[];
};
type CreateLotteryPrizeRequest = {
activity_id: number;
slot: number;
type: LotteryPrizeType;
name: string;
icon_url: string;
config: Record<string, any>;
weight: number;
total_stock: number | null;
is_fallback: boolean;
};
type UpdateLotteryPrizeRequest = CreateLotteryPrizeRequest & { id: number };
type DeleteLotteryPrizeRequest = { id: number };
type GetLotteryPrizeListParams = { activity_id: number };
type GetLotteryPrizeListResponse = { total?: number; list: LotteryPrize[] };
type GrantLotteryChancesRequest = {
activity_id: number;
user_id: number;
amount: number;
source_ref: string;
};
}