feat(dashboard, i18n): enhance agent dashboard and localization support
Updated the agent dashboard to include new metrics for today's bets and payouts, improving visibility for users. Enhanced localization files with additional hints and labels for better user experience across English, Nepali, and Chinese. Introduced new functions for formatting business dates and improved the handling of analytics permissions in the dashboard components.
This commit is contained in:
13
AGENTS.md
13
AGENTS.md
@@ -34,18 +34,19 @@ This version has breaking changes — APIs, conventions, and file structure may
|
||||
- 占成/授信/回水/上限等数值字段用 `AdminNumericStepper`（± 步进 + 可手输），勿单独裸 `input[type=number]`。
|
||||
- 对外文档（接入 + 后台运营手册）禁用 RBAC slug（如 `prd.settlement.agent.manage`）；对客户称「贵司」；排版忌 AI 感，正文对比度与字号可读优先。
|
||||
- 文档 i18n：`useTranslation` 须显式 `ns`；`returnObjects` 列表用 `Array.isArray` 守卫；避免节名与表头 key 冲突（如 `billStatus`）。
|
||||
- 运营页少堆 `text-xs` 说明与多层免责条；口径/默认范围合并进各模块一行 `summary`，勿叠加 filterPanel/queryHint/disclaimer 等小字（对账、报表中心已按此精简）。
|
||||
- i18n 按语言懒加载，不要一次 import 三语全套。
|
||||
|
||||
## Learned Workspace Facts
|
||||
|
||||
- 无接入站时依赖站点的页面展示 `<AdminNoIntegrationSiteState />`；仅 `profile.is_super_admin` 显示创建入口。
|
||||
- 超管判定用登录态 `is_super_admin`，勿用站点角色或 `admin_user_site_roles` 绑定推断。
|
||||
- 站点管理员（`profile.site != null`）代理 UI 绕过选中代理的 `can_create_*` 门控，按自身 manage 权限展示 Tab/操作。
|
||||
- 站点管理员在代理下创建玩家须传 `agent_node_id`（与超管同逻辑），勿默认挂根代理。
|
||||
- 客户对外文档：`/docs`（首页）、`/docs/integration`（API 接入）、`/docs/admin`（后台运营手册），均公开免 `/admin` 登录；读者为接入方技术与站点运营/代理，非内部运维；旧 `/admin/docs/integration-guide` 重定向 `/docs/integration`；顶栏「管理后台」链 `/admin`（勿 `/admin/login`）。
|
||||
- 站点管理员（`profile.site != null`）代理 UI 绕过选中代理的 `can_create_*` 门控，按自身 manage 权限展示 Tab/操作；在代理下创建玩家须传 `agent_node_id`，勿默认挂根代理。
|
||||
- 客户对外文档：`/docs`、`/docs/integration`、`/docs/admin` 公开免登录；读者为接入方与站点运营/代理；顶栏「管理后台」链 `/admin`；SSO 无登录换票、JWT+`player/me`、iframe `data.token`；Docs 侧栏 `--docs-sticky-top`；静态校验用 `document.body.innerText`。
|
||||
- `SettlementBillRow` 无 `currency_code`；账单金额展示用玩家 `default_currency`。
|
||||
- 浏览器 `/api/v1/*` 由 Next 转发到 `LOTTERY_API_UPSTREAM`；与本地 Postgres 对账前须确认 upstream 与所查库一致。
|
||||
- 接入文档页静态内容校验用 `document.body.innerText`；`DocCode` 非裸 `<pre>/<code>`，勿只查 code 选择器。
|
||||
- Docs 侧栏粘性定位用 CSS 变量 `--docs-sticky-top`（含顶栏/header 偏移）。
|
||||
- Tanumo 联调/生产默认：H5 `https://front.tanumo.com`、API `https://lotterylaravel.tanumo.com`、管理端/文档 `https://lotteryadmin.tanumo.com`。
|
||||
- 接入文档 SSO：无「登录换票」；主站 JWT 直传 H5/iframe，`GET /api/v1/player/me` 自动建档；iframe 约定 token 在顶层 `data.token`；勿引用 main-site/monorepo 等内部仓库路径。
|
||||
- 风控页默认：风险池仅显示有占用/高风险；单号详情可看占用来源；组合明细在注单详情页。
|
||||
- 模块边界：对账中心=主站↔彩票钱包划转；报表中心=钱包盘经营分析；结算中心=信用账期占成/收付。
|
||||
- 报表中心：默认近 30 天；盈亏类按 `draws.business_date`；金额读 API `currency_code`；导出仅后端 `report-jobs` 全量（按筛选，无需先预览）；注单盈亏≠信用账期结算。
|
||||
- 对账中心：校验 `transfer_orders` vs 彩票 `wallet_txns`；差异 B 侧引用=彩票 `wallet_txns` 流水号；补单/冲正在钱包转账单页。
|
||||
|
||||
Reference in New Issue
Block a user