455 lines
21 KiB
JavaScript
455 lines
21 KiB
JavaScript
import { API_OPERATIONS, apiEndpointPath } from "@/shared/api/generated/endpoints";
|
||
import { apiRequest } from "@/shared/api/request";
|
||
|
||
export const OPS_API_PREFIX = "/api/v1/admin/ops-center";
|
||
export const DEFAULT_POOL_ID = "default";
|
||
|
||
export async function fetchOpsDashboard(query = {}) {
|
||
// Ops Center 是跨 App 的运营面板：先拉应用主数据，再按 app_code 扇出拉取奖池配置、余额和抽奖汇总。
|
||
// lucky-gift-service 的所有后台接口都以 app_code 作为租户维度过滤，没有"全部应用"一次拉取的入口。
|
||
const appsPayload = await opsRequest("/apps", { query });
|
||
const apps = normalizeItems(appsPayload);
|
||
const appCodes = uniqueAppCodes(apps);
|
||
|
||
const perApp = await Promise.all(
|
||
appCodes.map(async (appCode) => {
|
||
const [luckyGifts, poolBalances, drawSummary] = await Promise.all([
|
||
fetchAppLuckyGiftConfigs(appCode),
|
||
opsRequest("/lucky-gifts/pools", { query: { app_code: appCode } }).then(normalizeItems),
|
||
opsRequest("/lucky-gifts/summary", { query: { app_code: appCode } }),
|
||
]);
|
||
return { appCode, drawSummary, luckyGifts, poolBalances };
|
||
}),
|
||
);
|
||
|
||
return normalizeDashboard({ apps, perApp });
|
||
}
|
||
|
||
async function fetchAppLuckyGiftConfigs(appCode) {
|
||
// 必须用复数 /configs：它返回该应用每个奖池的最新已发布规则版本。
|
||
// 单数 /config 只回默认奖池（无配置时是服务端草稿），会把 lalu 的 lucky/super_lucky 等已发布奖池整体漏掉。
|
||
const published = normalizeItems(await opsRequest("/lucky-gifts/configs", { query: { app_code: appCode } }))
|
||
.map((config) => normalizeLuckyGiftConfig(config, appCode))
|
||
.filter((config) => config.app_code);
|
||
if (published.length) {
|
||
return published;
|
||
}
|
||
// 一个已发布配置都没有的应用仍要展示一行可编辑草稿，让运营从这里发布第一版；
|
||
// 草稿的默认参数（RTP、回收率、结算窗口）以服务端 DefaultRuleConfig 为准，不在前端伪造。
|
||
const draft = normalizeLuckyGiftConfig(
|
||
await opsRequest("/lucky-gifts/config", { query: { app_code: appCode } }),
|
||
appCode,
|
||
);
|
||
return draft.app_code ? [draft] : [];
|
||
}
|
||
|
||
export async function fetchLuckyGiftDraws({
|
||
appCode,
|
||
page = 1,
|
||
pageSize = 20,
|
||
poolId = "",
|
||
status = "",
|
||
userId = "",
|
||
} = {}) {
|
||
const query = {
|
||
app_code: appCode,
|
||
page,
|
||
page_size: pageSize,
|
||
pool_id: poolId,
|
||
status,
|
||
};
|
||
// 同一个输入框同时支持内部数字 UID 和外部接入方的字符串 ID：纯数字走 user_id 精确匹配，
|
||
// 其余走 external_user_id，避免运营要先分辨用户来源再选字段。
|
||
const trimmedUserID = String(userId || "").trim();
|
||
if (/^\d+$/.test(trimmedUserID)) {
|
||
query.user_id = trimmedUserID;
|
||
} else if (trimmedUserID) {
|
||
query.external_user_id = trimmedUserID;
|
||
}
|
||
|
||
const payload = await opsRequest("/lucky-gifts/draws", { query });
|
||
return {
|
||
items: normalizeItems(payload),
|
||
page: numberValue(payload.page) || page,
|
||
pageSize: numberValue(payload.pageSize ?? payload.page_size) || pageSize,
|
||
total: numberValue(payload.total),
|
||
};
|
||
}
|
||
|
||
export async function saveLuckyGiftConfig(config = {}) {
|
||
const payload = luckyGiftConfigPayload(config);
|
||
return opsRequest("/lucky-gifts/config", {
|
||
body: payload,
|
||
method: "PUT",
|
||
query: {
|
||
app_code: payload.app_code,
|
||
pool_id: payload.pool_id,
|
||
},
|
||
});
|
||
}
|
||
|
||
export async function adjustLuckyGiftPool({
|
||
adjustmentId,
|
||
amountCoins,
|
||
appCode,
|
||
direction,
|
||
poolId,
|
||
reason,
|
||
strategyVersion,
|
||
} = {}) {
|
||
if (direction !== "in" && direction !== "out") {
|
||
throw new Error("奖池水位调整方向不正确");
|
||
}
|
||
const operation = direction === "out" ? API_OPERATIONS.debitLuckyGiftPool : API_OPERATIONS.creditLuckyGiftPool;
|
||
const operationPath = apiEndpointPath(operation);
|
||
|
||
// adjustment_id 是 owner 侧资金变更的幂等键，同一个弹窗失败重试必须原样复用；request_id 只做链路追踪，
|
||
// 不能替代业务幂等。方向映射到两条独立路由，使前后端权限也能按补水、扣水分别收敛。
|
||
const payload = await opsRequest(opsRelativePath(operationPath), {
|
||
body: {
|
||
adjustment_id: String(adjustmentId || "").trim(),
|
||
amount_coins: numberValue(amountCoins),
|
||
reason: String(reason || "").trim(),
|
||
},
|
||
method: "POST",
|
||
query: {
|
||
app_code: String(appCode || "")
|
||
.trim()
|
||
.toLowerCase(),
|
||
pool_id: String(poolId || DEFAULT_POOL_ID).trim() || DEFAULT_POOL_ID,
|
||
strategy_version: normalizeStrategyVersion(strategyVersion),
|
||
},
|
||
});
|
||
return normalizePoolAdjustmentResult(payload);
|
||
}
|
||
|
||
export async function opsRequest(path, { body, method = body ? "POST" : "GET", query } = {}) {
|
||
const normalizedPath = path.startsWith("/") ? path : `/${path}`;
|
||
// 复用主后台请求层才能共享 refreshOnce：运行期间 token 过期时先刷新再重放一次请求。
|
||
// 水位写接口携带稳定 adjustment_id，因此认证重放仍由 owner 幂等收敛；409 文案继续原样抛给弹窗保留表单。
|
||
return apiRequest(`/v1/admin/ops-center${normalizedPath}`, {
|
||
body,
|
||
method,
|
||
query,
|
||
});
|
||
}
|
||
|
||
export function buildOpsUrl(path, query = {}) {
|
||
const normalizedPath = path.startsWith("/") ? path : `/${path}`;
|
||
const url = new URL(`${OPS_API_PREFIX}${normalizedPath}`, window.location.origin);
|
||
|
||
Object.entries(query || {}).forEach(([key, value]) => {
|
||
if (value !== undefined && value !== null && value !== "") {
|
||
url.searchParams.set(key, String(value));
|
||
}
|
||
});
|
||
|
||
return url.toString();
|
||
}
|
||
|
||
export function normalizeDashboard({ apps = [], perApp = [] } = {}) {
|
||
const luckyGifts = perApp.flatMap((entry) => entry.luckyGifts || []);
|
||
const normalizedPoolBalances = perApp
|
||
.flatMap((entry) => (entry.poolBalances || []).map((item) => normalizePoolBalance(item, entry.appCode)))
|
||
.filter((item) => item.app_code);
|
||
const appSummaries = perApp
|
||
.map((entry) => normalizeDrawSummary(entry.drawSummary, entry.appCode))
|
||
.filter((summary) => summary.app_code);
|
||
|
||
const publishedConfigs = luckyGifts.filter((config) => !config.is_default);
|
||
const currentConfigByPool = new Map();
|
||
luckyGifts.forEach((config) => {
|
||
const familyKey = luckyGiftPoolFamilyKey(config);
|
||
const ruleVersion = numberValue(config.rule_version ?? config.ruleVersion);
|
||
const current = currentConfigByPool.get(familyKey);
|
||
// 正常接口只返回每个奖池的最新版本；这里仍按最大 rule_version 收敛，避免兼容接口返回多版本时
|
||
// 由数组顺序把旧策略误判为当前。版本相同则保留首条，确保结果不随返回顺序抖动。
|
||
if (!current || ruleVersion > current.ruleVersion) {
|
||
currentConfigByPool.set(familyKey, {
|
||
ruleVersion,
|
||
strategyVersion: normalizeStrategyVersion(config.strategy_version ?? config.strategyVersion),
|
||
});
|
||
}
|
||
});
|
||
// 账本接口会同时返回同一 app+pool 的 V2/V3 独立水位；最新规则配置才决定哪口是当前奖池。
|
||
// 没有配置可关联的孤立账本继续按当前展示，避免前端误把仍需运营处理的资金静默藏进历史筛选。
|
||
const poolBalances = normalizedPoolBalances.map((pool) => {
|
||
const currentStrategy = currentConfigByPool.get(luckyGiftPoolFamilyKey(pool))?.strategyVersion;
|
||
return {
|
||
...pool,
|
||
is_historical: Boolean(currentStrategy && currentStrategy !== pool.strategy_version),
|
||
};
|
||
});
|
||
const currentPoolBalances = poolBalances.filter((pool) => !pool.is_historical);
|
||
|
||
// KPI 一律跨应用聚合；奖池金额只汇总当前策略，避免历史 V2 与当前 V3 的独立账本重复计入运营水位。
|
||
const summary = {
|
||
activeApps: apps.length,
|
||
configuredPools: publishedConfigs.length,
|
||
enabledPools: publishedConfigs.filter((config) => config.enabled).length,
|
||
failedDraws: sumBy(appSummaries, "failed_draws"),
|
||
grantedDraws: sumBy(appSummaries, "granted_draws"),
|
||
pendingDraws: sumBy(appSummaries, "pending_draws"),
|
||
poolAvailableTotal: sumBy(currentPoolBalances, "available_balance", "availableBalance"),
|
||
poolBalanceTotal: sumBy(currentPoolBalances, "balance", "Balance"),
|
||
poolReserveTotal: sumBy(currentPoolBalances, "reserve_floor", "reserveFloor"),
|
||
totalDraws: sumBy(appSummaries, "total_draws"),
|
||
totalRewardCoins: sumBy(appSummaries, "total_reward_coins"),
|
||
totalSpentCoins: sumBy(appSummaries, "total_spent_coins"),
|
||
};
|
||
|
||
return { apps, appSummaries, luckyGifts, poolBalances, summary };
|
||
}
|
||
|
||
export function normalizePoolBalance(pool = {}, fallbackAppCode = "") {
|
||
return {
|
||
...pool,
|
||
app_code: String(pool.app_code || pool.appCode || fallbackAppCode)
|
||
.trim()
|
||
.toLowerCase(),
|
||
available_balance: numberValue(pool.available_balance ?? pool.availableBalance),
|
||
balance: numberValue(pool.balance ?? pool.Balance),
|
||
manual_credit_total: numberValue(pool.manual_credit_total ?? pool.manualCreditTotal),
|
||
manual_debit_total: numberValue(pool.manual_debit_total ?? pool.manualDebitTotal),
|
||
materialized: Boolean(pool.materialized),
|
||
pool_id: String(pool.pool_id || pool.poolId || DEFAULT_POOL_ID).trim() || DEFAULT_POOL_ID,
|
||
reserve_floor: numberValue(pool.reserve_floor ?? pool.reserveFloor),
|
||
strategy_version: normalizeStrategyVersion(pool.strategy_version ?? pool.strategyVersion),
|
||
total_in: numberValue(pool.total_in ?? pool.totalIn),
|
||
total_out: numberValue(pool.total_out ?? pool.totalOut),
|
||
updated_at_ms: numberValue(pool.updated_at_ms ?? pool.updatedAtMs),
|
||
};
|
||
}
|
||
|
||
export function luckyGiftPoolKey(item = {}) {
|
||
const appCode = String(item.app_code || item.appCode || "")
|
||
.trim()
|
||
.toLowerCase();
|
||
const poolID = String(item.pool_id || item.poolId || DEFAULT_POOL_ID).trim() || DEFAULT_POOL_ID;
|
||
const strategyVersion = normalizeStrategyVersion(item.strategy_version ?? item.strategyVersion);
|
||
// V2/V3 资金由 owner 按策略版本隔离；任何列表关联或 React rowKey 都必须包含 strategy_version，
|
||
// 否则同一 app+pool 的两口奖池会在前端被覆盖成一行。
|
||
return `${appCode}:${poolID}:${strategyVersion}`;
|
||
}
|
||
|
||
function luckyGiftPoolFamilyKey(item = {}) {
|
||
const appCode = String(item.app_code || item.appCode || "")
|
||
.trim()
|
||
.toLowerCase();
|
||
const poolID = String(item.pool_id || item.poolId || DEFAULT_POOL_ID).trim() || DEFAULT_POOL_ID;
|
||
return `${appCode}:${poolID}`;
|
||
}
|
||
|
||
function normalizeDrawSummary(summary = {}, appCode = "") {
|
||
return {
|
||
actual_rtp_ppm: numberValue(summary.actual_rtp_ppm ?? summary.actualRtpPpm),
|
||
app_code: String(appCode || summary.app_code || "")
|
||
.trim()
|
||
.toLowerCase(),
|
||
failed_draws: numberValue(summary.failed_draws ?? summary.failedDraws),
|
||
granted_draws: numberValue(summary.granted_draws ?? summary.grantedDraws),
|
||
pending_draws: numberValue(summary.pending_draws ?? summary.pendingDraws),
|
||
total_draws: numberValue(summary.total_draws ?? summary.totalDraws),
|
||
total_reward_coins: numberValue(summary.total_reward_coins ?? summary.totalRewardCoins),
|
||
total_spent_coins: numberValue(summary.total_spent_coins ?? summary.totalSpentCoins),
|
||
unique_rooms: numberValue(summary.unique_rooms ?? summary.uniqueRooms),
|
||
unique_users: numberValue(summary.unique_users ?? summary.uniqueUsers),
|
||
};
|
||
}
|
||
|
||
function uniqueAppCodes(apps) {
|
||
const seen = new Set();
|
||
const codes = [];
|
||
apps.forEach((item) => {
|
||
const code = String(item?.app_code || item?.appCode || "")
|
||
.trim()
|
||
.toLowerCase();
|
||
if (!code || seen.has(code)) {
|
||
return;
|
||
}
|
||
seen.add(code);
|
||
codes.push(code);
|
||
});
|
||
return codes;
|
||
}
|
||
|
||
function normalizeLuckyGiftConfig(config = {}, fallbackAppCode = "") {
|
||
const appCode = String(config.app_code || config.appCode || fallbackAppCode)
|
||
.trim()
|
||
.toLowerCase();
|
||
const ruleVersion = numberValue(config.rule_version ?? config.ruleVersion);
|
||
return {
|
||
...config,
|
||
app_code: appCode,
|
||
// rule_version <= 0 表示服务端返回的未发布草稿：列表要标成"默认草稿"并禁止当作已生效规则解读。
|
||
is_default: ruleVersion <= 0,
|
||
pool_id: config.pool_id || config.poolId || DEFAULT_POOL_ID,
|
||
rule_version: ruleVersion,
|
||
// 升级前规则没有 strategy_version，lucky-gift owner 明确按 fixed_v2 解释；列表和编辑表单必须沿用该兼容语义。
|
||
strategy_version: normalizeStrategyVersion(config.strategy_version ?? config.strategyVersion),
|
||
};
|
||
}
|
||
|
||
function normalizePoolAdjustmentResult(payload = {}) {
|
||
const adjustment = payload.adjustment || {};
|
||
return {
|
||
...payload,
|
||
adjustment: {
|
||
...adjustment,
|
||
amount_coins: numberValue(adjustment.amount_coins ?? adjustment.amountCoins),
|
||
balance_after: numberValue(adjustment.balance_after ?? adjustment.balanceAfter),
|
||
balance_before: numberValue(adjustment.balance_before ?? adjustment.balanceBefore),
|
||
strategy_version: normalizeStrategyVersion(adjustment.strategy_version ?? adjustment.strategyVersion),
|
||
},
|
||
pool: normalizePoolBalance(payload.pool || {}),
|
||
};
|
||
}
|
||
|
||
function opsRelativePath(operationPath) {
|
||
const prefix = "/v1/admin/ops-center";
|
||
if (!operationPath.startsWith(prefix)) {
|
||
throw new Error(`运营接口不属于 ops-center: ${operationPath}`);
|
||
}
|
||
return operationPath.slice(prefix.length);
|
||
}
|
||
|
||
function normalizeStrategyVersion(value) {
|
||
return String(value || "fixed_v2")
|
||
.trim()
|
||
.toLowerCase();
|
||
}
|
||
|
||
function luckyGiftConfigPayload(config = {}) {
|
||
const appCode = String(config.app_code || config.appCode || "")
|
||
.trim()
|
||
.toLowerCase();
|
||
const poolID = String(config.pool_id || config.poolId || DEFAULT_POOL_ID).trim() || DEFAULT_POOL_ID;
|
||
const strategyVersion = String(config.strategy_version || config.strategyVersion || "fixed_v2")
|
||
.trim()
|
||
.toLowerCase();
|
||
|
||
// 规则版本是不可变快照，PUT 必须完整回传 owner GET 返回的策略字段。只提交旧版 RTP/奖档字段会让
|
||
// 空 strategy_version 被服务端按 fixed_v2 发布，或让 dynamic_v3 因资金、水位、大奖字段归零而拒绝发布。
|
||
return {
|
||
anchor_daily_payout_cap: numberValue(config.anchor_daily_payout_cap ?? config.anchorDailyPayoutCap),
|
||
anchor_rate_percent: numberValue(config.anchor_rate_percent ?? config.anchorRatePercent),
|
||
app_code: appCode,
|
||
control_band_percent: numberValue(config.control_band_percent ?? config.controlBandPercent),
|
||
device_daily_payout_cap: numberValue(config.device_daily_payout_cap ?? config.deviceDailyPayoutCap),
|
||
effective_from_ms: numberValue(config.effective_from_ms ?? config.effectiveFromMs ?? config.effectiveFromMS),
|
||
enabled: Boolean(config.enabled),
|
||
gift_price_reference: numberValue(config.gift_price_reference ?? config.giftPriceReference),
|
||
high_water_nonzero_factor_percent: numberValue(
|
||
config.high_water_nonzero_factor_percent ?? config.highWaterNonzeroFactorPercent,
|
||
),
|
||
high_watermark_coins: numberValue(config.high_watermark_coins ?? config.highWatermarkCoins),
|
||
// dynamic_v3 已改为通过带审计的 pool credit 接口注资；即使旧表单快照仍带 1m，也不能在发布新版本时继续隐式 seed。
|
||
initial_pool_coins:
|
||
strategyVersion === "dynamic_v3" ? 0 : numberValue(config.initial_pool_coins ?? config.initialPoolCoins),
|
||
jackpot_global_rtp_max_percent: numberValue(
|
||
config.jackpot_global_rtp_max_percent ?? config.jackpotGlobalRTPMaxPercent,
|
||
),
|
||
jackpot_multipliers: numberArray(config.jackpot_multipliers ?? config.jackpotMultipliers),
|
||
jackpot_spend_threshold_coins: numberValue(
|
||
config.jackpot_spend_threshold_coins ?? config.jackpotSpendThresholdCoins,
|
||
),
|
||
jackpot_user_48h_rtp_max_percent: numberValue(
|
||
config.jackpot_user_48h_rtp_max_percent ??
|
||
config.jackpotUser48hRTPMaxPercent ??
|
||
config.jackpotUser48hRtpMaxPercent ??
|
||
config.jackpot_user_72h_rtp_max_percent ??
|
||
config.jackpotUser72hRTPMaxPercent ??
|
||
config.jackpotUser72hRtpMaxPercent,
|
||
),
|
||
jackpot_user_round_rtp_max_percent: numberValue(
|
||
config.jackpot_user_round_rtp_max_percent ??
|
||
config.jackpotUserRoundRTPMaxPercent ??
|
||
config.jackpotUserRoundRtpMaxPercent ??
|
||
config.jackpot_user_day_rtp_max_percent ??
|
||
config.jackpotUserDayRTPMaxPercent ??
|
||
config.jackpotUserDayRtpMaxPercent,
|
||
),
|
||
loss_streak_guarantee: numberValue(config.loss_streak_guarantee ?? config.lossStreakGuarantee),
|
||
low_water_nonzero_factor_percent: numberValue(
|
||
config.low_water_nonzero_factor_percent ?? config.lowWaterNonzeroFactorPercent,
|
||
),
|
||
low_watermark_coins: numberValue(config.low_watermark_coins ?? config.lowWatermarkCoins),
|
||
max_jackpot_hits_per_user_day: numberValue(
|
||
config.max_jackpot_hits_per_user_day ?? config.maxJackpotHitsPerUserDay,
|
||
),
|
||
max_single_payout: numberValue(config.max_single_payout ?? config.maxSinglePayout),
|
||
normal_max_equivalent_draws: numberValue(config.normal_max_equivalent_draws ?? config.normalMaxEquivalentDraws),
|
||
novice_max_equivalent_draws: numberValue(config.novice_max_equivalent_draws ?? config.noviceMaxEquivalentDraws),
|
||
pool_id: poolID,
|
||
pool_rate_percent: numberValue(config.pool_rate_percent ?? config.poolRatePercent),
|
||
profit_rate_percent: numberValue(config.profit_rate_percent ?? config.profitRatePercent),
|
||
recharge_boost_factor_percent: numberValue(
|
||
config.recharge_boost_factor_percent ?? config.rechargeBoostFactorPercent,
|
||
),
|
||
recharge_boost_window_ms: numberValue(
|
||
config.recharge_boost_window_ms ?? config.rechargeBoostWindowMs ?? config.rechargeBoostWindowMS,
|
||
),
|
||
room_hourly_payout_cap: numberValue(config.room_hourly_payout_cap ?? config.roomHourlyPayoutCap),
|
||
settlement_window_wager: numberValue(config.settlement_window_wager ?? config.settlementWindowWager),
|
||
stages: normalizeStages(config.stages),
|
||
strategy_version: strategyVersion,
|
||
user_daily_payout_cap: numberValue(config.user_daily_payout_cap ?? config.userDailyPayoutCap),
|
||
user_hourly_payout_cap: numberValue(config.user_hourly_payout_cap ?? config.userHourlyPayoutCap),
|
||
target_rtp_percent: numberValue(config.target_rtp_percent ?? config.targetRtpPercent),
|
||
};
|
||
}
|
||
|
||
function normalizeItems(value) {
|
||
if (Array.isArray(value)) {
|
||
return value;
|
||
}
|
||
if (Array.isArray(value?.items)) {
|
||
return value.items;
|
||
}
|
||
if (Array.isArray(value?.list)) {
|
||
return value.list;
|
||
}
|
||
return [];
|
||
}
|
||
|
||
function sumBy(items, key, fallbackKey) {
|
||
return items.reduce(
|
||
(total, item) => total + numberValue(item?.[key] ?? (fallbackKey ? item?.[fallbackKey] : 0)),
|
||
0,
|
||
);
|
||
}
|
||
|
||
function numberValue(value) {
|
||
const parsed = Number(value);
|
||
return Number.isFinite(parsed) ? parsed : 0;
|
||
}
|
||
|
||
function numberArray(values) {
|
||
if (!Array.isArray(values)) {
|
||
return [];
|
||
}
|
||
// 不在传输层静默删除 0/负倍率；表单负责拦截，若有遗漏也应让 owner 返回明确校验错误，
|
||
// 否则数组位置变化会掩盖运营实际提交的错误值。
|
||
return values.map(numberValue);
|
||
}
|
||
|
||
function normalizeStages(stages) {
|
||
if (!Array.isArray(stages)) {
|
||
return [];
|
||
}
|
||
return stages.map((stage) => ({
|
||
min_recharge_30d_coins: numberValue(stage.min_recharge_30d_coins ?? stage.minRecharge30DCoins),
|
||
min_recharge_7d_coins: numberValue(stage.min_recharge_7d_coins ?? stage.minRecharge7DCoins),
|
||
stage: stage.stage || stage.Stage || "",
|
||
tiers: Array.isArray(stage.tiers)
|
||
? stage.tiers.map((tier) => ({
|
||
enabled: tier.enabled !== false,
|
||
high_water_only: Boolean(tier.high_water_only ?? tier.highWaterOnly),
|
||
multiplier: numberValue(tier.multiplier),
|
||
probability_percent: numberValue(tier.probability_percent ?? tier.probabilityPercent),
|
||
tier_id: tier.tier_id || tier.tierId || "",
|
||
}))
|
||
: [],
|
||
}));
|
||
}
|