feat(api, agents, i18n): enhance settlement features and multi-language support

Added new types and API functions for settlement period summaries and credit ledgers, improving the management of agent settlements. Updated the admin console to reflect these changes, enhancing user experience with better navigation and data presentation. Additionally, expanded multi-language support by incorporating new translations in English, Nepali, and Chinese for settlement-related terms, ensuring consistency across the platform.

src/i18n/locales/zh/agents.json

@@ -164,7 +164,7 @@
     "periodPlaceholder": "选择账期",
     "allPeriods": "全部账期",
     "filteredByPeriodRange": "账期 {{range}} 的账单",
-    "emptyNoPeriodsManage": "尚无账期与账单。请在下方「账期管理」点「本周」开期，到期后关账，账单会自动出现在这里。",
+    "emptyNoPeriodsManage": "尚无账单。请在结算中心完成「关账出账」后，账单会出现在此处。",
     "emptyNoPeriodsAgent": "尚无账单。账期由上级或平台关账后自动生成，无需您手动筛选时间。",
     "emptyNoClosed": "当前没有已关账的账期，账单尚未生成。请等待负责人关账后再查看。",
     "typePlayer": "玩家账单",
@@ -273,7 +273,7 @@
     "range": "账期",
     "statusOpen": "进行中",
     "statusClosed": "已关账",
-    "empty": "尚无账期。点「本周」等快捷账期后开期，到期后在此关账。",
+    "empty": "尚无账期，请选择快捷账期开期。",
     "start": "开始",
     "end": "结束",
     "status": "状态",

src/i18n/locales/zh/config.json

@@ -17,6 +17,7 @@
     "rulesPlaysTitle": "投注规则",
     "rulesOddsTitle": "赔率与回水",
     "rulesOddsDescription": "赔率矩阵与回水比例在同一页维护，共用赔率版本线。",
+    "rulesOddsDescriptionShort": "左侧选玩法，右侧改赔率与回水；修改后记得保存草稿并发布。",
     "riskCapTitle": "限额版本"
   },
   "hub": {
@@ -420,6 +421,16 @@
       "oddsConfig": "赔率配置"
     },
     "currentSelection": "当前选择：{{category}} / {{play}}",
+    "playSelectPlaceholder": "选择玩法",
+    "readOnlyBanner": "当前版本只读，需先创建草稿才能修改赔率与回水。",
+    "table": {
+      "prizeScope": "奖级范围",
+      "multiplier": "赔率倍数"
+    },
+    "draftBar": {
+      "unsaved": "有未保存的修改",
+      "saved": "修改已同步到本地草稿"
+    },
     "playGroups": {
       "bigSmall": "大小类",
       "combo4": "组合类",
@@ -429,10 +440,13 @@
     },
     "summary": {
       "title": "配置摘要",
-      "version": "版本",
+      "contextTitle": "版本与提示",
+      "version": "当前编辑版本",
+      "activeVersion": "线上生效版本",
       "statusLabel": "状态",
       "readOnlyTag": "只读",
       "readOnlyHint": "当前为只读版本，如需修改请先创建草稿。",
+      "draftHint": "草稿中的修改需保存后才会写入版本；发布后对后续新注单生效。",
       "activeHint": "当前版本已生效，新注单将按此配置计算。"
     },
     "tabs": {

src/i18n/locales/zh/reconcile.json

@@ -27,6 +27,7 @@
   "playerAllPlayersHint": "不选择玩家时，会按日期范围对全量玩家做一次人工对账。",
   "createSummaryAll": "将对 {{from}} 至 {{to}} 的全量玩家发起人工对账。",
   "createSummaryPlayer": "将对玩家 {{player}} 在 {{from}} 至 {{to}} 的数据发起人工对账。",
+  "createSummaryPending": "请选择完整的对账日期范围后，再创建任务。",
   "jobsTitle": "对账任务",
   "jobsDesc": "在右侧操作中查看差异明细与分页。",
   "refresh": "刷新",

src/i18n/locales/zh/settlementCenter.json

@@ -1,26 +1,55 @@
 {
   "title": "结算中心",
-  "header": {
-    "subtitle": "信用占成账务",
-    "statusRunning": "账期进行中",
-    "statusIdle": "等待开期",
-    "statusCompleted": "账期已结清"
+  "subtitle": "账期关账、账单确认与收付登记",
+  "subtitleList": "账期列表：开账、关账；列表已含账期汇总，行内「查看详情」进入账单与下注流水。",
+  "period": {
+    "title": "账期",
+    "statusCompleted": "已结清",
+    "pipelineShare": "流水 {{count}} 笔",
+    "billTodo": "待确认 {{p}} · 待收付 {{a}}",
+    "openTitle": "开账",
+    "openBtn": "开账",
+    "closeNeedLedger": "本期暂无流水，请先完成开奖结算。",
+    "closeDialogTitle": "确认关账",
+    "closeDialogDesc": "将汇总 {{range}} 内的流水并生成账单。",
+    "closeDialogShare": "流水 {{count}} 笔",
+    "closeDialogEmpty": "本期暂无占成流水，关账后不会生成账单。",
+    "closeDialogUnsettled": "仍有 {{count}} 笔注单未结算",
+    "closeDialogIrreversible": "关账后不可撤销，差错请通过调账或冲正处理。",
+    "closeDialogConfirm": "确认关账"
   },
-  "subnav": {
-    "label": "结算中心导航"
+  "periodDetail": {
+    "back": "返回账期列表",
+    "notFound": "账期不存在或已切换站点，请返回列表。"
+  },
+  "periodTable": {
+    "title": "账期管理",
+    "statusFilter": "状态",
+    "range": "账期",
+    "ledgerCount": "流水",
+    "pending": "待确认",
+    "awaiting": "待收付",
+    "shareLedger": "占成流水",
+    "gameWinLoss": "输赢合计",
+    "platformWinLoss": "平台输赢",
+    "agentWinLoss": "代理输赢",
+    "basicRebate": "退水合计",
+    "unsettledTickets": "未结算注单",
+    "openReportHint": "进行中账期：占成/输赢来自账期内流水；账单数在关账后更新。",
+    "viewDetail": "查看详情",
+    "close": "关账",
+    "closeNow": "立即关账",
+    "hasOpen": "已有进行中账期 {{range}}，须先关账才能开新期。",
+    "emptyOpenHint": "暂无账期，请点击工具栏「开账」创建。",
+    "emptyReadOnly": "暂无账期记录。",
+    "emptyFiltered": "筛选结果为空，请重置筛选。",
+    "emptyFilteredOpen": "当前筛选未包含进行中的账期，请选「全部」或「进行中」。",
+    "readOnlyHint": "绑定代理账号不可开/关账期，仅可查看与收付。"
   },
   "nav": {
-    "aria": "结算中心导航",
-    "group": {
-      "hub": "工作台",
-      "finance": "账务",
-      "ledger": "账务流水",
-      "bills": "账单管理"
-    },
-    "overview": "概览",
-    "periods": "账期管理",
-    "ledger": "账务流水",
+    "periods": "账期",
     "bills": "账单",
+    "ledger": "账务流水",
     "creditLedger": "信用流水",
     "playerBills": "玩家账单",
     "agentBills": "代理账单",
@@ -33,6 +62,7 @@
   },
   "filters": {
     "period": "账期范围",
+    "statusAll": "全部",
     "allPeriods": "全部账期",
     "statusOpen": "进行中",
     "statusClosed": "已关账",
@@ -54,7 +84,9 @@
     "badDebtIntro": "坏账核销产生的调账流水，关联原账单。"
   },
   "creditLedger": {
-    "intro": "账期内信用占用、账单收付、调账与坏账等流水；行内「⋯」可确认账单、登记收付、调账、冲正或坏账（需关联账单）。",
+    "periodIntro": "待开奖显示「下注冻结」（非扣款）；已开奖每注单仅一条「开奖结算」输赢，不会与冻结重复出现。",
+    "emptyPeriod": "本账期暂无下注流水。请确认信用盘玩家已在账期内下注并完成开奖结算。",
+    "intro": "查询账期内的额度变动、收付与调账记录。",
     "columns": {
       "txn": "流水号",
       "player": "玩家",
@@ -82,15 +114,30 @@
     },
     "reason": {
       "payment_record": "账单收付",
-      "bet_hold": "下注占用",
+      "bet_hold": "下注冻结",
+      "freezeAmount": "冻结 {{amount}}",
+      "game_settlement": "开奖结算",
+      "game_settlement_win": "开奖结算入账",
       "bet_hold_release": "占用释放",
       "game_settlement_loss": "开奖结算扣款",
-      "settlement_confirm": "账期结算确认"
+      "settlement_payout": "结算收付入账",
+      "settlement_confirm": "账期结算确认",
+      "adjustment": "补差",
+      "reversal": "冲正",
+      "bad_debt": "坏账核销",
+      "share_ledger": "占成流水"
     }
   },
   "columns": {
+    "billId": "账单 ID",
     "period": "账期",
     "type": "类型",
+    "playerAccount": "玩家账号",
+    "playerId": "玩家 ID",
+    "directAgent": "直属代理",
+    "superiorAgent": "上级代理",
+    "play": "玩法",
+    "drawNo": "期号",
     "owner": "本方",
     "counterparty": "对方",
     "gross": "输赢",
@@ -132,6 +179,51 @@
     "viewBill": "查看账单",
     "billDetail": "账单详情"
   },
+  "billDisplay": {
+    "settlementFlow": "谁付谁",
+    "settlementAmount": "结算金额",
+    "pays": "应付",
+    "paysShort": "应付",
+    "howAmountWorks": "金额怎么来的",
+    "playerBreakdownIntro": "玩家只与直属代理结算，净额 = 输赢 − 回水。",
+    "agentBreakdownIntro": "代理只与直属上级结算，净额 = 团队净额 − 本级占成。",
+    "playerGross": "游戏输赢",
+    "playerLostHint": "玩家输了，应付代理",
+    "playerWonHint": "玩家赢了，代理应付玩家",
+    "playerNet": "玩家应付净额",
+    "playerNetReceive": "代理应付玩家",
+    "teamGross": "团队游戏输赢",
+    "teamGrossHint": "含本级及下级玩家的合计",
+    "teamGrossShort": "团队",
+    "playerGrossShort": "玩家",
+    "teamRebate": "团队回水",
+    "teamNet": "团队净额",
+    "rebate": "回水",
+    "agentShareKeep": "{{agent}} 本级占成",
+    "agentShareKeepHint": "本级按占成比例留下的利润",
+    "agentNet": "{{agent}} 应付上级",
+    "agentNetReceive": "上级应付 {{agent}}",
+    "billOwner": "账单主体",
+    "billCounterparty": "结算对手",
+    "unpaidPendingConfirm": "确认账单后可登记收付",
+    "unpaidAwaitingPayment": "请登记线下收付",
+    "fullySettled": "本期已结清",
+    "recordReceiptFrom": "登记收款（{{payer}} 付给 {{payee}}）",
+    "recordPayoutTo": "登记付款（{{payer}} 付给 {{payee}}）",
+    "rebateAllocationsHint": "各层级代理对回水的承担明细。",
+    "payment": "收付",
+    "flowHint": {
+      "playerPayAgent": "玩家应向直属代理结算",
+      "agentPayPlayer": "直属代理应向玩家结算",
+      "agentPayUpstream": "本级代理应向上级 / 平台结算",
+      "upstreamPayAgent": "上级 / 平台应向本级代理结算",
+      "adjustment": "补差单独结转，不改变原账单主体关系",
+      "badDebt": "核销未结金额，并生成坏账归档记录",
+      "reversal": "冲正原账单影响，按冲正规则回退",
+      "generic": "按账单结算关系执行收付或调账"
+    },
+    "hierarchyHint": "同一账期会生成多笔账单：玩家先与直属代理结，代理扣除本级占成后再向上级缴纳。因此「输赢」可能相同，但「结算金额」会逐级减少。"
+  },
   "ledgerPanel": {
     "search": "搜索",
     "searchBtn": "搜索",
@@ -144,30 +236,67 @@
     "optional": "可选",
     "billStatus": "账单状态",
     "dateRange": "时间范围",
-    "rowPosted": "已记账",
-    "category": {
-      "all": "全部",
-      "credit": "信用占用",
-      "payment": "收付",
-      "adjustment": "调账 / 冲正",
-      "badDebt": "坏账",
-      "actionable": "待操作"
-    }
+    "rowPosted": "已记账"
   },
   "billsPanel": {
-    "intro": "关账后生成的占成账单；可按类型与状态筛选，打开详情进行确认与收付。",
+    "billId": "账单 ID",
+    "ownerKeyword": "本方 / 对方",
+    "ownerKeywordPh": "玩家账号、代理名称",
+    "status": "账单状态",
+    "billType": "账单类型",
+    "filterAll": "全部状态",
+    "filterAllTypes": "全部类型",
+    "filterAdjustment": "调账 / 冲正",
+    "optional": "可选",
+    "searchBtn": "搜索",
+    "reset": "重置",
+    "refresh": "刷新",
+    "clientFilterHint": "本方筛选：显示 {{shown}} / {{total}} 条",
     "category": {
-      "all": "全部",
       "player": "玩家账单",
       "agent": "代理账单",
       "pendingConfirm": "待确认",
       "awaitingPayment": "待收付"
-    }
+    },
+    "quickFilter": {
+      "title": "当前想看哪一层结算",
+      "desc": "先区分结玩家还是结代理，再做状态和账单检索会更直观。",
+      "allTitle": "全部账单",
+      "allHint": "同时查看玩家、代理、补差和坏账单据",
+      "playerTitle": "结玩家",
+      "playerHint": "玩家与直属代理之间的信用结算",
+      "agentTitle": "结代理",
+      "agentHint": "代理与上级 / 平台之间的层级结算"
+    },
+    "activeHint": {
+      "all": "当前聚焦：账期内全部结算单据",
+      "player": "当前聚焦：玩家与直属代理的信用结算",
+      "agent": "当前聚焦：代理向上级 / 平台缴纳或收取结算"
+    },
+    "layer": {
+      "player": "玩家与直属代理结算",
+      "agent": "代理与上级 / 平台结算",
+      "adjustment": "结算差异调账",
+      "badDebt": "坏账核销归档",
+      "reversal": "历史账单冲正",
+      "generic": "结算辅助单据"
+    },
+    "rowHint": {
+      "playerOwner": "玩家主体",
+      "agentOwner": "本级代理",
+      "adjustmentOwner": "调账归属方",
+      "badDebtOwner": "坏账归属方",
+      "reversalOwner": "冲正归属方",
+      "playerUpline": "直属代理的上级",
+      "agentUpline": "本单结算上级"
+    },
+    "hierarchyHint": "同一账期会生成多笔账单：玩家先与直属代理结，代理扣除本级占成后再向上级缴纳。因此「输赢」可能相同，但「结算金额」会逐级减少。"
   },
   "panels": {
+    "workbench": { "title": "工作台" },
     "overview": { "title": "结算概览" },
     "ledger": { "title": "账务流水" },
-    "bills": { "title": "账单" },
+    "bills": { "title": "全部账单" },
     "creditLedger": { "title": "信用流水" },
     "playerBills": { "title": "玩家账单" },
     "agentBills": { "title": "代理账单" },
@@ -178,13 +307,17 @@
     "reports": { "title": "账期报表" },
     "badDebt": { "title": "坏账核销" }
   },
+  "billsPanel": {
+    "emptyFiltered": "当前筛选下暂无账单，请改为「全部状态」或重置筛选。",
+    "emptyClosed": "本期已关账但暂无账单。常见原因：账期内无信用盘玩家的已结算注单，或占成流水不在本账期时间范围内。"
+  },
   "empty": {
-    "noSite": "请选择接入站点。",
-    "noPeriods": "请先在「账期管理」开期并关账。",
+    "noSite": "请选择站点。",
+    "noPeriods": "请先关账当前账期。",
     "noClosed": "请先关账生成账单。",
-    "noBadDebt": "暂无坏账核销记录。",
-    "noCreditLedger": "所选账期内暂无信用流水。请确认信用盘玩家已下注且账期时间范围正确。",
-    "billsNeedClose": "占成账单须先关账才会出现；若上方「信用流水」有数据而账单为空，请完成开奖结算后执行关账。"
+    "noBadDebt": "暂无坏账记录。",
+    "noCreditLedger": "该账期内暂无流水。",
+    "billsNeedClose": "账单在关账后生成。请返回账期列表，对本期执行「关账」后再查看。"
   },
   "periods": {
     "loadFailed": "账期列表加载失败"

src/i18n/locales/zh/wallet.json

@@ -3,9 +3,9 @@
   "subnavLabel": "钱包子页",
   "subnavTransactions": "主站钱包流水",
   "subnavTransferOrders": "主站转账单",
-  "scopeHint": "本模块为主站钱包模式：钱包流水与主站转账单。信用盘玩家的下注占用、结算记账请查看",
-  "scopeHintSettlementLink": "结算中心 → 信用流水",
-  "scopeHintSettlement": "结算中心 → 信用流水",
+  "scopeHint": "本模块为主站钱包模式：钱包流水与主站转账单。信用盘玩家的账期结账请查看",
+  "scopeHintSettlementLink": "结算中心",
+  "scopeHintSettlement": "结算中心",
   "ledgerChannel": "账本",
   "ledgerCredit": "信用流水",
   "ledgerWallet": "钱包流水",