feat(api, agents): add agent node profile retrieval and update functionality

Implemented new API functions to fetch and update agent node profiles, enhancing the management capabilities for agent data. This addition improves the overall functionality of the admin agents console, allowing for better user interaction with agent profiles. Updated related types for improved type safety and clarity in the codebase.

src/i18n/locales/zh/adminUsers.json

@@ -1,7 +1,7 @@
 {
-  "title": "管理员",
-  "listTitle": "管理员用户列表",
-  "createAdmin": "新建管理员",
+  "title": "平台账号",
+  "listTitle": "平台账号列表",
+  "createAdmin": "新建平台账号",
   "searchPlaceholder": "按用户名 / 昵称 / 邮箱搜索",
   "loadFailed": "加载管理员列表失败",
   "roleLoadFailed": "加载角色列表失败",
@@ -15,8 +15,8 @@
   "saveAccountFailed": "保存账号失败",
   "deleteSuccess": "已删除 {{name}}",
   "deleteFailed": "删除失败",
-  "roleListTitle": "角色管理",
-  "createRole": "新增角色",
+  "roleListTitle": "平台角色管理",
+  "createRole": "新增平台角色",
   "roleCreateSuccess": "已创建角色 {{name}}",
   "roleUpdateSuccess": "已更新角色 {{name}}",
   "roleSaveFailed": "保存角色失败",
@@ -103,8 +103,11 @@
     "editTitle": "编辑角色",
     "description": "角色用于归拢后台功能权限，再分配给管理员账号。",
     "slug": "角色编码",
+    "slugPlaceholder": "请输入角色标识，如 super_admin",
     "name": "角色名称",
+    "namePlaceholder": "请输入角色名称",
     "descriptionLabel": "角色说明",
+    "descriptionPlaceholder": "请输入角色说明",
     "status": "状态"
   },
   "accountDialog": {

src/i18n/locales/zh/agents.json

@@ -1,15 +1,46 @@
 {
-  "title": "代理管理",
+  "title": "代理线路",
+  "sitesTitle": "站点列表",
+  "sitesListHint": "完整站点表格（密钥、回调等）请前往",
+  "sitesListLink": "站点列表",
+  "subnav": {
+    "label": "代理线路导航",
+    "noPermission": "无权限",
+    "operations": "代理经营",
+    "provision": "开通线路",
+    "sites": "站点列表",
+    "settlementBills": "代理账单"
+  },
+  "includeRoots": "包含根节点",
+  "includeRootsHint": "根节点用于表示站点边界，默认不计入经营代理列表。",
+  "directoryStatus": {
+    "all": "全部状态",
+    "enabled": "仅启用",
+    "disabled": "仅停用"
+  },
   "treeTitle": "代理树",
-  "detailTitle": "节点详情",
-  "selectNode": "请从左侧选择代理节点",
-  "loadFailed": "加载代理树失败",
+  "tabs": {
+    "subordinates": "下级管理",
+    "accounts": "主账号",
+    "players": "玩家管理",
+    "overview": "概况",
+    "roles": "角色",
+    "users": "账号",
+    "delegation": "授权上限"
+  },
+  "filterParent": "上级代理",
+  "filterParentAll": "全部下级",
+  "listFlatHint": "列表平铺展示所有经营代理；添加下级请使用行内「添加下级代理」。",
+  "addChildNeedParent": "请先在「上级代理」中选择要为谁添加下级",
+  "detailTitle": "代理详情",
+  "selectNode": "请选择代理",
+  "loadFailed": "加载代理列表失败",
   "siteLabel": "站点",
   "createChild": "添加下级代理",
-  "editNode": "编辑节点",
-  "deleteNode": "删除节点",
-  "deleteNodeConfirm": "删除后不可恢复，请确认该节点无下级、无账号、无角色绑定。",
-  "deleteNodeBlockedHint": "请先删除下级代理、角色与账号后再删除本节点",
+  "editNode": "编辑代理",
+  "deleteNode": "删除代理",
+  "deleteNodeConfirm": "删除后不可恢复，请确认该代理无下级、无账号、无角色绑定。",
+  "deleteNodeBlockedHint": "请先删除下级代理、角色与账号后再删除该代理",
   "deleteNodeBlockedPrefix": "暂不可删除：",
   "deleteBlocked": {
     "children": "仍有 {{count}} 个下级代理",
@@ -18,6 +49,7 @@
   },
   "code": "编码",
   "name": "名称",
+  "namePlaceholder": "请输入代理名称",
   "depth": "层级",
   "path": "路径",
   "status": "状态",
@@ -26,13 +58,63 @@
   "updateSuccess": "已更新 {{name}}",
   "deleteSuccess": "已删除代理 {{name}}",
   "saveFailed": "保存失败",
-  "codeRequired": "请填写编码与名称",
+  "codeRequired": "请填写代理名称和登录名",
   "modelGuide": "代理层负责数据范围（Scope）与授权上限（Ceiling），账号权限请通过角色分配。",
-  "tabs": {
-    "overview": "概况",
-    "roles": "角色",
-    "users": "账号",
-    "delegation": "授权上限"
+  "pageGuide": "这里统一管理代理树、代理角色、代理账号与下放上限。平台账号和平台角色请到各自的平台治理页面维护。",
+  "summary": {
+    "currentSiteNodes": "当前站点节点总数",
+    "currentSiteAgents": "当前站点经营代理数",
+    "visibleList": "当前平铺列表条数",
+    "visibleAgents": "当前可见经营代理数",
+    "globalNodes": "全部站点节点总数",
+    "globalAgents": "全部站点经营代理数",
+    "enabledAgents": "启用中的经营代理数",
+    "rootNodes": "根节点数量"
+  },
+  "profile": {
+    "section": "占成与授信",
+    "totalShareRate": "占成比例 (%)",
+    "creditLimit": "授信额度",
+    "rebateLimit": "回水上限",
+    "defaultPlayerRebate": "默认玩家回水",
+    "settlementCycle": "结算周期",
+    "canGrantExtraRebate": "允许额外回水",
+    "canCreatePlayer": "允许创建玩家",
+    "canCreateChildAgent": "允许创建下级代理",
+    "cycleDaily": "日结",
+    "cycleWeekly": "周结",
+    "cycleMonthly": "月结"
+  },
+  "settlementBills": {
+    "title": "代理账单",
+    "description": "账期关闭后生成的玩家/代理账单",
+    "columns": {
+      "id": "ID",
+      "type": "类型",
+      "net": "净额",
+      "unpaid": "未结",
+      "status": "状态"
+    }
+  },
+  "lineProvision": {
+    "title": "开通代理线路",
+    "description": "一次创建站点、根代理与后台账号（site_code 与代理 code 一致）。",
+    "code": "站点 code",
+    "name": "线路名称",
+    "username": "代理账号",
+    "password": "初始密码",
+    "walletUrl": "钱包 API URL",
+    "submit": "开通线路",
+    "success": "线路已开通",
+    "secretsOnce": "密钥仅显示一次，请妥善保存",
+    "link": "开通线路"
+  },
+  "noAccess": "您没有代理经营相关权限，请联系管理员开通。",
+  "playersPanel": {
+    "create": "创建玩家",
+    "scopedTo": "直属玩家：{{agent}}",
+    "allUnderSite": "当前站点下可见玩家",
+    "filterHint": "可按上级代理查看其直属玩家。"
   },
   "delegation": {
     "title": "下放权限上限",
@@ -66,11 +148,15 @@
     "title": "代理账号",
     "create": "创建账号",
     "username": "登录名",
+    "email": "邮箱",
     "password": "密码",
     "roles": "角色",
     "createSuccess": "已创建账号 {{name}}",
     "roleSaveSuccess": "已更新 {{name}} 的角色",
     "deleteConfirm": "删除后该管理员将无法登录，且不可恢复。",
     "deleteSuccess": "已删除账号 {{name}}"
-  }
+  },
+  "usernamePlaceholder": "请输入登录名",
+  "passwordPlaceholder": "请输入8位数密码",
+  "passwordOptionalHint": "留空则不修改，修改请输入8位数密码"
 }

src/i18n/locales/zh/common.json

@@ -160,8 +160,8 @@
     "audit": "审计日志",
     "settings": "系统设置",
     "account": "账号设置",
-    "integration": "接入站点",
-    "agents": "代理管理",
+    "integration": "接入配置",
+    "agents": "代理线路",
     "config": "运营配置"
   },
   "sidebar": {

src/i18n/locales/zh/config.json

@@ -99,6 +99,16 @@
       "notes": "备注",
       "ssoSecret": "SSO 密钥",
       "walletApiKey": "钱包 API 密钥"
+    },
+    "placeholders": {
+      "code": "请输入站点标识，如 partner-a",
+      "name": "请输入站点名称",
+      "currency": "请输入币种代码，如 NPR",
+      "walletApiUrl": "请输入钱包接口地址",
+      "lotteryH5BaseUrl": "请输入 H5 地址",
+      "iframeOrigins": "请输入允许的来源地址，如 https://www.example.com",
+      "notes": "请输入备注说明",
+      "connectivityPlayerId": "请输入玩家 ID，如 10001"
     }
   },
   "versionStatus": {
@@ -211,6 +221,17 @@
       "playRulesHtml": "玩法规则 HTML（多语言）",
       "playRulesHtmlDesc": "该内容将直接在玩家端的玩法规则页面作为 HTML 渲染。按语言分别配置；留空则回退其它语言或显示默认提示。"
     },
+    "placeholders": {
+      "defaultCurrency": "请输入默认币种代码，如 NPR",
+      "drawIntervalMinutes": "请输入开奖间隔分钟数",
+      "drawBettingWindowSeconds": "请输入投注窗口秒数",
+      "drawCloseBeforeDrawSeconds": "请输入封盘提前秒数",
+      "drawBufferDrawsAhead": "请输入预生成期数",
+      "cooldownMinutes": "请输入冷却分钟数",
+      "currencyDisplayDecimals": "请输入显示小数位数，如 2",
+      "currencyDecimalSeparator": "请输入小数分隔符，如 .",
+      "currencyThousandsSeparator": "请输入千分位分隔符，如 ,"
+    },
     "hints": {
       "manualReview": "开启后，RNG 开奖结果会先进入待审核，必须由后台人工发布。",
       "cooldownMinutes": "结果发布后等待多久再进入 settling。填 0 表示发布后直接进入结算。",
@@ -277,6 +298,9 @@
       "code": "币种代码",
       "name": "币种名称",
       "decimals": "小数位",
+      "codePlaceholder": "请输入币种代码，如 NPR",
+      "namePlaceholder": "请输入币种名称",
+      "decimalsPlaceholder": "请输入小数位数，如 2",
       "enabled": "启用状态",
       "enabledHint": "关闭后，新业务不应继续使用该币种。",
       "bettable": "允许下注",
@@ -347,6 +371,11 @@
       "maxBet": "最大下注",
       "actions": "操作"
     },
+    "placeholders": {
+      "displayOrder": "顺序",
+      "minBetAmount": "最小金额",
+      "maxBetAmount": "最大金额"
+    },
     "states": {
       "enabled": "开启",
       "disabled": "关闭",
@@ -411,6 +440,10 @@
     "missingScopeRow": "缺少 {{scope}} 对应行，请检查种子或版本数据。",
     "rebateRate": "回水比例 (%)",
     "rebateRateHint": "会把 rebate_rate 写入该玩法下所有奖级范围。",
+    "placeholders": {
+      "multiplier": "请输入赔率倍数",
+      "rebateRate": "请输入返点比例"
+    },
     "publishFailed": "发布失败",
     "createDraftSuccess": "已创建草稿 v{{version}}",
     "createDraftFailed": "创建草稿失败",
@@ -457,6 +490,11 @@
       "d3": "3D 回水比例 (%)",
       "d4": "4D 回水比例 (%)"
     },
+    "placeholders": {
+      "d2": "请输入 2D 返点",
+      "d3": "请输入 3D 返点",
+      "d4": "请输入 4D 返点"
+    },
     "winEnjoy": {
       "label": "中奖注单结算时再扣回水",
       "description": "对应系统参数 settlement.apply_rebate_to_payout：开启后中奖派彩在毛赢基础上再乘 (1 - 回水率快照)。",
@@ -467,6 +505,11 @@
     "effectiveTime": "生效时间（当前赔率生效版本）"
   },
   "riskCap": {
+    "placeholders": {
+      "defaultCap": "请输入默认限额",
+      "number": "4位号码",
+      "capAmount": "请输入限额"
+    },
     "validation": {
       "requireAtLeastOne": "至少需要一条封顶配置",
       "defaultGreaterThanZero": "默认封顶金额必须大于 0",

src/i18n/locales/zh/draws.json

@@ -11,6 +11,7 @@
     "title": "手动创建期号",
     "description": "日期与时间按 {{tz}} 填写（勿用浏览器本地时区）。仅填开奖时间时，开始/封盘按系统配置自动推算。",
     "hint": "开始 < 封盘 < 开奖。期号可留空，将按 UTC 业务日自动生成流水号。",
+    "drawNoPlaceholder": "请输入期号，如 20260526-008",
     "drawTimeRequired": "请填写开奖时间",
     "submit": "创建",
     "saving": "创建中…",
@@ -34,6 +35,7 @@
     "action": "编辑",
     "title": "编辑期号",
     "description": "期号 {{drawNo}} · 时间按 {{tz}} 编辑",
+    "drawNoPlaceholder": "请输入期号，如 20260526-008",
     "submit": "保存",
     "saving": "保存中…",
     "success": "期号已更新",
@@ -55,6 +57,14 @@
   "invalidDrawId": "无效的期号 ID",
   "loadFailed": "加载失败，请检查登录与 API 配置",
   "drawDetail": "开奖详情",
+  "detailSubtitle": "{{date}} · 第 {{seq}} 期",
+  "scheduleTitle": "时间安排",
+  "resultBatchesTitle": "开奖批次",
+  "batchSummaryTotal": "共 {{count}} 批",
+  "batchSummaryPending": "待审 {{count}}",
+  "batchSummaryPublished": "已发 {{count}}",
+  "noResultBatchesYet": "尚无开奖批次。",
+  "goToReviewTab": "去审核与发布",
   "businessDate": "业务日",
   "sequenceNo": "流水序号",
   "plannedDraw": "计划开奖",

src/i18n/locales/zh/jackpot.json

@@ -20,7 +20,9 @@
   "adjustmentIncrease": "增加",
   "adjustmentDecrease": "减少",
   "adjustmentAmount": "调整金额（主币单位）",
+  "adjustmentAmountPlaceholder": "请输入调整金额",
   "adjustmentReason": "调整原因（必填）",
+  "adjustmentReasonPlaceholder": "请输入调整原因",
   "submitAdjustment": "提交余额调整",
   "adjustmentSuccess": "余额调整已入账",
   "adjustmentFailed": "余额调整失败",
@@ -30,11 +32,17 @@
   "confirmAdjustmentDescription": "将写入调整流水并更新当前池余额，请确认金额与原因无误。",
   "recentAdjustments": "最近调整记录",
   "contributionRate": "蓄水比例 0–1",
+  "contributionRatePlaceholder": "请输入贡献比例，如 0.02",
   "triggerThreshold": "爆池阈值（最小单位）",
+  "triggerThresholdPlaceholder": "请输入触发阈值",
   "payoutRate": "爆池派彩比例 0–1",
+  "payoutRatePlaceholder": "请输入派彩比例，如 0.05",
   "forceTriggerGap": "强制爆池间隔（已结算期数）",
+  "forceTriggerGapPlaceholder": "请输入强制触发间隔期数",
   "minBetAmount": "最低下注额（最小单位）",
+  "minBetAmountPlaceholder": "请输入最低下注金额",
   "comboTriggerPlays": "组合触发玩法（逗号分隔）",
+  "comboTriggerPlaysPlaceholder": "请输入玩法编码，多个用逗号分隔，如 straight,ibox",
   "status": "开关",
   "disabled": "关闭",
   "enabled": "开启",

src/i18n/locales/zh/players.json

@@ -1,6 +1,22 @@
 {
   "title": "玩家",
+  "detailTitle": "玩家详情",
   "listTitle": "玩家列表",
+  "viewDetail": "查看详情",
+  "backToList": "返回玩家列表",
+  "detailSubtitle": "{{site}} · {{sitePlayerId}} · ID {{playerId}}",
+  "tabOverview": "概览",
+  "tabTickets": "注单",
+  "tabWalletTxns": "钱包流水",
+  "tabTransferOrders": "转账单",
+  "profileSection": "基本资料",
+  "walletsSection": "钱包余额",
+  "createdAt": "注册时间",
+  "agent": "代理",
+  "frozen": "冻结",
+  "txnAmount": "变动金额",
+  "balanceAfterTxn": "变动后余额",
+  "invalidPlayerId": "无效的玩家 ID",
   "createPlayer": "新建玩家",
   "searchPlaceholder": "按玩家 ID / 用户名 / 昵称搜索",
   "filterSite": "主站站点",
@@ -11,6 +27,10 @@
   "siteCodeRequired": "请填写主站编号",
   "sitePlayerIdRequired": "请填写主站玩家 ID",
   "createFailed": "创建玩家失败",
+  "createAgentRequired": "当前账号未绑定代理，无法创建玩家。请使用代理账号登录，或由超管选择有效主站及代理节点。",
+  "createAgentNode": "归属代理",
+  "createAgentNodePlaceholder": "选择代理节点",
+  "createAgentAutoHint": "将归属到您绑定的代理：{{name}}（{{code}}）",
   "createSuccess": "已创建玩家 {{name}}",
   "noChanges": "没有变更",
   "updateFailed": "更新玩家失败",