feat(admin, i18n): enhance reports, draws, config, and player workflows

This commit is contained in:
2026-06-08 17:41:55 +08:00
parent af982bb9f7
commit 7e65c53732
55 changed files with 1986 additions and 804 deletions

View File

@@ -1,11 +1,18 @@
"use client";
import { Eye, Pencil, Plus, Trash2 } from "lucide-react";
import { Eye, Pencil, Plus, ReceiptText, Trash2 } from "lucide-react";
import { useCallback, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { getAgentNodeProfile } from "@/api/admin-agents";
import {
getSettlementBills,
postSettlementBillBadDebtWriteOff,
postSettlementBillConfirm,
postSettlementBillPayment,
type SettlementBillRow,
} from "@/api/admin-agent-settlement";
import {
deleteAdminPlayer,
getAdminPlayer,
@@ -15,7 +22,7 @@ import {
} from "@/api/admin-player";
import { formatCredit } from "@/modules/agents/agent-line-sidebar";
import { AdminRowActionsMenu } from "@/components/admin/admin-row-actions-menu";
import { AdminNoResourceState, AdminTableNoResourceRow } from "@/components/admin/admin-no-resource-state";
import { AdminTableNoResourceRow } from "@/components/admin/admin-no-resource-state";
import { AdminListPaginationFooter } from "@/components/admin/admin-list-pagination-footer";
import { AdminLoadingState } from "@/components/admin/admin-loading-state";
import { AdminStatusBadge } from "@/components/admin/admin-status-badge";
@@ -48,7 +55,7 @@ import { useAsyncEffect } from "@/hooks/use-async-effect";
import { useConfirmAction } from "@/hooks/use-confirm-action";
import { useAdminDateTimeFormatter } from "@/hooks/use-admin-datetime-formatter";
import { PlayerFundingModeBadge } from "@/components/admin/player-funding-badges";
import { playerBalanceCells } from "@/lib/admin-player-display";
import { formatPlayerCreditAmount, playerBalanceCells } from "@/lib/admin-player-display";
import { formatAdminMinorUnits } from "@/lib/money";
import { parsePercentUi, percentUiToRatio, ratioToPercentUi } from "@/lib/admin-rate-percent";
import { adminPlayerDetailPath } from "@/lib/admin-player-paths";
@@ -79,6 +86,15 @@ function playerStatusLabel(
return String(status);
}
function creditAdjustModeLabel(
mode: "increase" | "decrease",
t: (key: string, opts?: { defaultValue?: string }) => string,
): string {
return mode === "increase"
? t("playersPanel.creditIncrease", { defaultValue: "增加授信" })
: t("playersPanel.creditDecrease", { defaultValue: "减少授信" });
}
function resolvePlayerRebateRate(row: AdminPlayerRow): number | null {
if (row.rebate_rate != null) {
return row.rebate_rate;
@@ -108,7 +124,7 @@ function fillEditFormFromPlayer(row: AdminPlayerRow): {
nickname: string;
currency: string;
status: number;
creditLimit: string;
creditLimit: number;
rebateRate: string;
riskTags: string;
} {
@@ -119,7 +135,7 @@ function fillEditFormFromPlayer(row: AdminPlayerRow): {
nickname: row.nickname ?? "",
currency: row.default_currency ?? "",
status: row.status,
creditLimit: row.credit_limit != null ? String(row.credit_limit) : "",
creditLimit: row.credit_limit ?? 0,
rebateRate: rebate != null ? ratioToPercentUi(rebate) : "",
riskTags: (row.risk_tags ?? []).join(", "),
};
@@ -143,6 +159,15 @@ export function AgentsPlayersPanel({
}: AgentsPlayersPanelProps): React.ReactElement {
const { t } = useTranslation(["agents", "players", "common"]);
const formatDt = useAdminDateTimeFormatter();
const createPlayerLabel = embedded
? t("playersPanel.createDirect", { defaultValue: "创建直属玩家" })
: t("playersPanel.create", { defaultValue: "创建玩家" });
const viewPlayerLabel = t("players:viewDetail", { defaultValue: "查看玩家详情" });
const editPlayerLabel = t("players:editPlayer", { defaultValue: "编辑玩家" });
const deletePlayerLabel = t("players:deletePlayer", { defaultValue: "删除玩家" });
const settlementCenterLabel = t("playersPanel.gotoSettlementCenter", {
defaultValue: "去结算中心",
});
const profile = useAdminProfile();
const boundAgent = profile?.agent ?? null;
const isSuperAdmin = profile?.is_super_admin === true;
@@ -175,7 +200,6 @@ export function AgentsPlayersPanel({
const [dialogOpen, setDialogOpen] = useState(false);
const [saving, setSaving] = useState(false);
const [sitePlayerId, setSitePlayerId] = useState("");
const [username, setUsername] = useState("");
const [password, setPassword] = useState("");
const [nickname, setNickname] = useState("");
@@ -189,10 +213,22 @@ export function AgentsPlayersPanel({
const [editNickname, setEditNickname] = useState("");
const [editDefaultCurrency, setEditDefaultCurrency] = useState("");
const [editStatus, setEditStatus] = useState(0);
const [editCreditLimit, setEditCreditLimit] = useState("");
const [editCreditBase, setEditCreditBase] = useState(0);
const [editCreditAdjustMode, setEditCreditAdjustMode] = useState<"increase" | "decrease">("increase");
const [editCreditDelta, setEditCreditDelta] = useState("");
const [editRebateRate, setEditRebateRate] = useState("");
const [editRiskTags, setEditRiskTags] = useState("");
const [editDetailLoading, setEditDetailLoading] = useState(false);
const [billingDialogOpen, setBillingDialogOpen] = useState(false);
const [billingPlayer, setBillingPlayer] = useState<AdminPlayerRow | null>(null);
const [billingBills, setBillingBills] = useState<SettlementBillRow[]>([]);
const [billingLoading, setBillingLoading] = useState(false);
const [billingBusy, setBillingBusy] = useState(false);
const [selectedBillId, setSelectedBillId] = useState<number | null>(null);
const [payAmount, setPayAmount] = useState("");
const [payMethod, setPayMethod] = useState("");
const [payProof, setPayProof] = useState("");
const [badDebtReason, setBadDebtReason] = useState("");
const load = useCallback(async () => {
if (siteCode.trim() === "") {
@@ -241,7 +277,6 @@ export function AgentsPlayersPanel({
try {
await postAdminPlayer({
site_code: siteCode.trim(),
...(sitePlayerId.trim() !== "" ? { site_player_id: sitePlayerId.trim() } : {}),
username: username.trim(),
password: password,
nickname: nickname.trim() || null,
@@ -259,7 +294,6 @@ export function AgentsPlayersPanel({
}),
);
setDialogOpen(false);
setSitePlayerId("");
setUsername("");
setPassword("");
setNickname("");
@@ -290,7 +324,9 @@ export function AgentsPlayersPanel({
setEditNickname(form.nickname);
setEditDefaultCurrency(form.currency);
setEditStatus(form.status);
setEditCreditLimit(form.creditLimit);
setEditCreditBase(form.creditLimit);
setEditCreditAdjustMode("increase");
setEditCreditDelta("");
setEditRebateRate(form.rebateRate);
setEditRiskTags(form.riskTags);
};
@@ -339,10 +375,13 @@ export function AgentsPlayersPanel({
if (editStatus !== editingPlayer.status) {
body.status = editStatus;
}
const nextCredit =
editCreditLimit.trim() === "" ? 0 : Number.parseInt(editCreditLimit, 10);
if (!Number.isNaN(nextCredit) && nextCredit !== (editingPlayer.credit_limit ?? 0)) {
body.credit_limit = Math.max(0, nextCredit);
const creditDelta = editCreditDelta.trim() === "" ? 0 : Number.parseInt(editCreditDelta, 10);
if (!Number.isNaN(creditDelta) && creditDelta > 0) {
const signedDelta = editCreditAdjustMode === "increase" ? creditDelta : -creditDelta;
const nextCredit = Math.max(0, (editingPlayer.credit_limit ?? 0) + signedDelta);
if (nextCredit !== (editingPlayer.credit_limit ?? 0)) {
body.credit_limit = nextCredit;
}
}
const prevRebate = resolvePlayerRebateRate(editingPlayer);
const nextPercent = parsePercentUi(editRebateRate);
@@ -390,7 +429,141 @@ export function AgentsPlayersPanel({
setTotal((current) => Math.max(0, current - 1));
toast.success(t("deleteSuccess", { name: row.username ?? row.site_player_id }));
} catch (e) {
toast.error(e instanceof LotteryApiBizError ? e.message : t("deleteFailed"));
if (e instanceof LotteryApiBizError) {
const needsSettlement = e.message.includes("已占用信用额度");
toast.error(
needsSettlement
? t("playersPanel.deleteBlockedByCreditHint", {
defaultValue: "该玩家仍有已占用信用额度,请先到结算中心结清或核销相关账单后再删除。",
})
: e.message,
);
return;
}
toast.error(t("deleteFailed"));
}
}
const selectedBill = useMemo(
() => billingBills.find((bill) => bill.id === selectedBillId) ?? null,
[billingBills, selectedBillId],
);
const projectedCreditLimit = useMemo(() => {
const delta = editCreditDelta.trim() === "" ? 0 : Number.parseInt(editCreditDelta, 10);
if (Number.isNaN(delta) || delta <= 0) {
return editCreditBase;
}
return Math.max(0, editCreditBase + (editCreditAdjustMode === "increase" ? delta : -delta));
}, [editCreditAdjustMode, editCreditBase, editCreditDelta]);
function resetBillingForm(): void {
setPayAmount("");
setPayMethod("");
setPayProof("");
setBadDebtReason("");
}
async function openBillingDialog(row: AdminPlayerRow): Promise<void> {
setBillingDialogOpen(true);
setBillingPlayer(row);
setBillingBills([]);
setSelectedBillId(null);
resetBillingForm();
setBillingLoading(true);
try {
const data = await getSettlementBills({
bill_type: "player",
keyword: row.site_player_id,
per_page: 20,
});
const items = (data.items ?? []).filter(
(bill) =>
bill.bill_type === "player" &&
bill.owner_id === row.id &&
(bill.status === "pending_confirm" || Number(bill.unpaid_amount ?? 0) > 0),
);
setBillingBills(items);
const first = items[0] ?? null;
setSelectedBillId(first?.id ?? null);
setPayAmount(first ? String(first.unpaid_amount ?? 0) : "");
} catch (e) {
toast.error(
e instanceof LotteryApiBizError
? e.message
: t("playersPanel.billingLoadFailed", { defaultValue: "加载账单失败" }),
);
} finally {
setBillingLoading(false);
}
}
async function handleConfirmBill(): Promise<void> {
if (selectedBill === null) return;
setBillingBusy(true);
try {
await postSettlementBillConfirm(selectedBill.id);
toast.success(
t("playersPanel.billConfirmed", { defaultValue: "账单已确认,请继续登记收付或核销" }),
);
if (billingPlayer) {
await openBillingDialog(billingPlayer);
}
} catch (e) {
toast.error(
e instanceof LotteryApiBizError
? e.message
: t("playersPanel.billConfirmFailed", { defaultValue: "确认账单失败" }),
);
} finally {
setBillingBusy(false);
}
}
async function handlePayBill(): Promise<void> {
if (selectedBill === null) return;
setBillingBusy(true);
try {
await postSettlementBillPayment(selectedBill.id, {
amount: Number(payAmount || selectedBill.unpaid_amount || 0),
method: payMethod.trim() || undefined,
proof: payProof.trim() || undefined,
});
toast.success(t("playersPanel.billPaid", { defaultValue: "已登记收付" }));
await load();
if (billingPlayer) {
await openBillingDialog(billingPlayer);
}
} catch (e) {
toast.error(
e instanceof LotteryApiBizError
? e.message
: t("playersPanel.billPayFailed", { defaultValue: "登记收付失败" }),
);
} finally {
setBillingBusy(false);
}
}
async function handleWriteOffBill(): Promise<void> {
if (selectedBill === null) return;
setBillingBusy(true);
try {
await postSettlementBillBadDebtWriteOff(selectedBill.id, {
reason: badDebtReason.trim() || undefined,
});
toast.success(t("playersPanel.billWrittenOff", { defaultValue: "已核销坏账" }));
await load();
if (billingPlayer) {
await openBillingDialog(billingPlayer);
}
} catch (e) {
toast.error(
e instanceof LotteryApiBizError
? e.message
: t("playersPanel.billWriteOffFailed", { defaultValue: "核销坏账失败" }),
);
} finally {
setBillingBusy(false);
}
}
@@ -415,7 +588,7 @@ export function AgentsPlayersPanel({
{canCreatePlayer ? (
<Button type="button" size="sm" className="shrink-0" onClick={openCreateDialog}>
<Plus className="mr-1.5 size-3.5" />
{t("playersPanel.create", { defaultValue: "创建玩家" })}
{createPlayerLabel}
</Button>
) : null}
</div>
@@ -434,6 +607,9 @@ export function AgentsPlayersPanel({
<TableHead className="whitespace-nowrap">
{t("playersPanel.usernameNickname", { defaultValue: "用户名 / 昵称" })}
</TableHead>
<TableHead className="whitespace-nowrap">
{t("players:riskTags", { defaultValue: "风控标签" })}
</TableHead>
<TableHead className="whitespace-nowrap">
{t("players:fundingMode", { defaultValue: "资金模式" })}
</TableHead>
@@ -455,11 +631,12 @@ export function AgentsPlayersPanel({
</TableHeader>
<TableBody>
{items.length === 0 ? (
<AdminTableNoResourceRow colSpan={embedded ? 8 : 9} cellClassName="py-12 text-center" />
<AdminTableNoResourceRow colSpan={embedded ? 9 : 10} cellClassName="py-12 text-center" />
) : (
items.map((row) => {
const balances = playerBalanceCells(row, formatAdminMinorUnits);
const rebate = resolvePlayerRebateRate(row);
const riskTags = row.risk_tags ?? [];
return (
<TableRow key={row.id}>
<TableCell className="tabular-nums text-xs font-medium">#{row.id}</TableCell>
@@ -471,6 +648,22 @@ export function AgentsPlayersPanel({
<span className="text-muted-foreground"> / </span>
<span className="text-muted-foreground">{row.nickname ?? "—"}</span>
</TableCell>
<TableCell className="max-w-[14rem]">
{riskTags.length > 0 ? (
<div className="flex flex-wrap gap-1" title={riskTags.join(", ")}>
{riskTags.map((tag) => (
<span
key={`${row.id}-${tag}`}
className="inline-flex items-center rounded-full border border-amber-200 bg-amber-50 px-2 py-0.5 text-[11px] font-medium leading-4 text-amber-900"
>
{tag}
</span>
))}
</div>
) : (
<span className="text-xs text-muted-foreground"></span>
)}
</TableCell>
<TableCell>
<PlayerFundingModeBadge row={row} />
</TableCell>
@@ -509,21 +702,33 @@ export function AgentsPlayersPanel({
actions={[
{
key: "detail",
label: t("players:viewDetail", { defaultValue: "查看详情" }),
label: viewPlayerLabel,
icon: Eye,
href: adminPlayerDetailPath(row.id),
},
...(row.funding_mode === "credit" || row.uses_credit === true
? [
{
key: "settlement",
label: t("playersPanel.manageSettlement", {
defaultValue: "处理账单",
}),
icon: ReceiptText,
onClick: () => void openBillingDialog(row),
},
]
: []),
...(canManagePlayerRows
? [
{
key: "edit",
label: t("players:edit", { defaultValue: "编辑" }),
label: editPlayerLabel,
icon: Pencil,
onClick: () => openEditPlayer(row),
},
{
key: "delete",
label: t("players:delete", { defaultValue: "删除" }),
label: deletePlayerLabel,
icon: Trash2,
destructive: true,
onClick: () =>
@@ -572,24 +777,12 @@ export function AgentsPlayersPanel({
<Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
<DialogContent>
<DialogHeader>
<DialogTitle>{t("playersPanel.create", { defaultValue: "创建玩家" })}</DialogTitle>
<DialogTitle>{createPlayerLabel}</DialogTitle>
</DialogHeader>
<div className="space-y-2">
<Label>{t("agents:lineProvision.code", { defaultValue: "代理编码" })}</Label>
<Input value={siteCode} readOnly disabled />
</div>
<div className="space-y-2">
<Label htmlFor="agent-player-site-id">
{t("playersPanel.externalIdOptional", { defaultValue: "外部 ID可选" })}
</Label>
<Input
id="agent-player-site-id"
value={sitePlayerId}
onChange={(e) => setSitePlayerId(e.target.value)}
autoComplete="off"
placeholder={t("playersPanel.externalIdHint", { defaultValue: "留空则系统自动生成" })}
/>
</div>
<div className="space-y-2">
<Label htmlFor="agent-player-username">
{t("playersPanel.loginUsername", { defaultValue: "登录账号" })}
@@ -669,6 +862,138 @@ export function AgentsPlayersPanel({
</DialogContent>
</Dialog>
<Dialog
open={billingDialogOpen}
onOpenChange={(open) => {
setBillingDialogOpen(open);
if (!open) {
setBillingPlayer(null);
setBillingBills([]);
setSelectedBillId(null);
resetBillingForm();
}
}}
>
<DialogContent>
<DialogHeader>
<DialogTitle>
{t("playersPanel.manageSettlement", { defaultValue: "处理账单" })}
</DialogTitle>
</DialogHeader>
<div className="space-y-4">
{billingLoading ? (
<p className="text-sm text-muted-foreground">
{t("playersPanel.billingLoading", { defaultValue: "正在加载账单…" })}
</p>
) : billingBills.length === 0 ? (
<p className="text-sm text-muted-foreground">
{t("playersPanel.noPendingBills", { defaultValue: "当前没有可处理的未结账单。" })}
</p>
) : (
<>
<div className="space-y-2">
<Label>{t("playersPanel.selectBill", { defaultValue: "选择账单" })}</Label>
<Select
value={selectedBillId ? String(selectedBillId) : ""}
onValueChange={(value) => {
const next = billingBills.find((bill) => bill.id === Number(value)) ?? null;
setSelectedBillId(next?.id ?? null);
setPayAmount(next ? String(next.unpaid_amount ?? 0) : "");
setPayMethod("");
setPayProof("");
setBadDebtReason("");
}}
>
<SelectTrigger>
<SelectValue placeholder={t("playersPanel.selectBill", { defaultValue: "选择账单" })} />
</SelectTrigger>
<SelectContent>
{billingBills.map((bill) => (
<SelectItem key={bill.id} value={String(bill.id)}>
{`#${bill.id} · ${bill.status} · ${bill.player_site_player_id ?? bill.owner_id} · ${bill.unpaid_amount ?? 0}`}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
{selectedBill ? (
<div className="space-y-4 rounded-xl border border-border/70 p-4">
<div className="grid gap-2 text-sm sm:grid-cols-2">
<div>
<span className="text-muted-foreground">
{t("playersPanel.billStatus", { defaultValue: "状态" })}:
</span>{" "}
{selectedBill.status}
</div>
<div>
<span className="text-muted-foreground">
{t("playersPanel.billUnpaid", { defaultValue: "未结" })}:
</span>{" "}
{selectedBill.unpaid_amount ?? 0}
</div>
</div>
{selectedBill.status === "pending_confirm" ? (
<Button type="button" className="w-full" disabled={billingBusy} onClick={() => void handleConfirmBill()}>
{t("agents:settlementBills.confirm", { defaultValue: "确认账单" })}
</Button>
) : null}
{selectedBill.status !== "pending_confirm" && Number(selectedBill.unpaid_amount ?? 0) > 0 ? (
<div className="space-y-3">
<div className="space-y-1">
<Label>{t("agents:settlementBills.paymentAmount", { defaultValue: "收付金额" })}</Label>
<Input value={payAmount} onChange={(e) => setPayAmount(e.target.value)} />
</div>
<div className="space-y-1">
<Label>{t("agents:settlementBills.paymentMethod", { defaultValue: "收付方式" })}</Label>
<Input
value={payMethod}
onChange={(e) => setPayMethod(e.target.value)}
placeholder={t("agents:settlementBills.paymentMethodPlaceholder", {
defaultValue: "例如:现金 / 银行转账",
})}
/>
</div>
<div className="space-y-1">
<Label>{t("agents:settlementBills.paymentProof", { defaultValue: "凭证/备注" })}</Label>
<Input
value={payProof}
onChange={(e) => setPayProof(e.target.value)}
placeholder={t("agents:settlementBills.paymentProofPlaceholder", {
defaultValue: "可填写流水号、截图说明或备注",
})}
/>
</div>
<Button type="button" className="w-full" disabled={billingBusy} onClick={() => void handlePayBill()}>
{t("agents:settlementBills.paid", { defaultValue: "登记收付" })}
</Button>
<div className="space-y-1 pt-2">
<Label>{t("agents:settlementBills.badDebtReason", { defaultValue: "核销原因" })}</Label>
<Input
value={badDebtReason}
onChange={(e) => setBadDebtReason(e.target.value)}
placeholder={t("agents:settlementBills.badDebtReasonPlaceholder", {
defaultValue: "例如:客户失联、确认坏账",
})}
/>
</div>
<Button type="button" variant="destructive" className="w-full" disabled={billingBusy} onClick={() => void handleWriteOffBill()}>
{t("agents:settlementBills.confirmBadDebt", { defaultValue: "确认核销" })}
</Button>
</div>
) : null}
</div>
) : null}
</>
)}
</div>
</DialogContent>
</Dialog>
<Dialog open={editDialogOpen} onOpenChange={handleEditDialogOpenChange}>
<DialogContent>
<DialogHeader>
@@ -713,13 +1038,60 @@ export function AgentsPlayersPanel({
<Label htmlFor="agent-player-edit-credit">
{t("playersPanel.creditLimit", { defaultValue: "授信额度" })}
</Label>
<Input
id="agent-player-edit-credit"
type="number"
min={0}
value={editCreditLimit}
onChange={(e) => setEditCreditLimit(e.target.value)}
/>
<div className="rounded-xl border border-border/70 bg-muted/20 p-3">
<div className="flex flex-wrap items-center justify-between gap-2 text-sm">
<span className="text-muted-foreground">
{t("playersPanel.currentCredit", { defaultValue: "当前授信" })}
</span>
<span className="font-semibold">
{formatPlayerCreditAmount(editCreditBase, editDefaultCurrency || "NPR")}
</span>
</div>
<div className="mt-3 grid gap-3 sm:grid-cols-[9rem_minmax(0,1fr)]">
<div className="space-y-1">
<Label htmlFor="agent-player-edit-credit-mode">
{t("playersPanel.creditAdjustType", { defaultValue: "调整方式" })}
</Label>
<Select
value={editCreditAdjustMode}
onValueChange={(value) => setEditCreditAdjustMode(value as "increase" | "decrease")}
>
<SelectTrigger id="agent-player-edit-credit-mode">
<SelectValue>
{creditAdjustModeLabel(editCreditAdjustMode, t)}
</SelectValue>
</SelectTrigger>
<SelectContent>
<SelectItem value="increase">
{creditAdjustModeLabel("increase", t)}
</SelectItem>
<SelectItem value="decrease">
{creditAdjustModeLabel("decrease", t)}
</SelectItem>
</SelectContent>
</Select>
</div>
<div className="space-y-1">
<Label htmlFor="agent-player-edit-credit-delta">
{t("playersPanel.creditAdjustAmount", { defaultValue: "调整额度" })}
</Label>
<Input
id="agent-player-edit-credit-delta"
type="number"
min={0}
value={editCreditDelta}
onChange={(e) => setEditCreditDelta(e.target.value)}
placeholder="0"
/>
</div>
</div>
<p className="mt-3 text-xs text-muted-foreground">
{t("playersPanel.creditProjected", {
defaultValue: "调整后授信:{{amount}}",
amount: formatPlayerCreditAmount(projectedCreditLimit, editDefaultCurrency || "NPR"),
})}
</p>
</div>
</div>
<div className="space-y-2">
<Label htmlFor="agent-player-edit-rebate">