Some checks failed
lotteryadmin CI / build (push) Has been cancelled
- 在赔率行数据结构和接口中新增 provider_code 字段支持多开注商 - 管理后台赔率配置页新增开注商筛选,支持查看和编辑指定开注商赔率 - 未指定专属赔率时,自动继承通用(Global)赔率并显示继承标识 - 新增赔率快照展示组件,显示票据下注时锁定的开注商赔率快照 - 优化赔率保存流程,支持基于开注商区分并批量更新赔率数据 - 更新多语言文案,增加开注商与赔率来源标识翻译 - 调整环境配置文档和默认域名为新的开注商域名地址 - 优化界面标签样式,清晰区分通用、专属和继承赔率来源 - Tickets模块新增赔率快照数据类型及详细展示表格 - 修复管理后台及票据详情页部分链接和操作按钮,提升用户体验
4.6 KiB
4.6 KiB
This is NOT the Next.js you know
This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ before writing any code. Heed deprecation notices.
玩家双模式(钱包 / 信用)
后端字段(players 表):
| 字段 | 值 | 含义 |
|---|---|---|
funding_mode |
wallet / credit |
主站钱包 vs 信用盘 |
auth_source |
main_site_sso / lottery_native |
主站 SSO vs 彩票端账号 |
后台统一用法(不要各页手写 funding_mode === "credit"):
isCreditFundingPlayer(row)/playerUsesCredit(row)— 是否信用盘playerShowsTransferOrders(row)— 是否展示主站转账单playerFundingModeLabel/playerAuthSourceLabel— 文案playerBalanceCells— 列表余额列(信用用 major 额度,钱包用 minor)<PlayerFundingModeBadge />/<PlayerLedgerSourceBadge />— 表格徽章
模块边界:
/admin/wallet/*:仅主站钱包流水与转账单/admin/settlement-center→ 账务流水单页(筛选 + 分类 + 表格 + ⋯ 操作),合并信用/收付/调账/坏账;账单单页用分类筛选待确认/待收付等- 玩家详情:按
funding_mode切换 Tab(信用流水 / 钱包流水;信用盘隐藏转账单)
新增涉及玩家资金的页面时,先读 src/lib/admin-player-display.ts。
Learned User Preferences
- 排障/上线评估时用 MCP(postgres)直查库验证数据与权限,勿仅凭代码推断生产态。
- 占成/授信/回水/上限等数值字段用
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 三语全套。
- 金额展示须防大额截断:卡片/摘要用
AdminMoneyDisplay(自适应字号 +break-all,禁止truncate);表格金额列用.admin-money-value。
Learned Workspace Facts
- 无接入站时依赖站点的页面展示
<AdminNoIntegrationSiteState />;仅profile.is_super_admin显示创建入口。 - 超管判定用登录态
is_super_admin,勿用站点角色或admin_user_site_roles绑定推断。 - 站点运营内置角色
site_admin|site_finance|site_cs(admin_user_site_roles,无代理绑定);识别用isSiteOperator/isSiteAdminOperator(admin-session-variants.ts)。仪表盘按account_kind分流:SiteDashboardConsole/SiteFinanceDashboardConsole/SiteCsDashboardConsole。 - 站点管理员(
isSiteAdminOperator)代理 UI 绕过选中代理的can_create_*门控,按自身 manage 权限展示 Tab/操作;在代理下创建玩家须传agent_node_id,勿默认挂根代理。 - 客户对外文档:
/docs、/docs/integration、/docs/admin公开免登录;读者为接入方与站点运营/代理;顶栏「管理后台」链/admin;SSO 无登录换票、JWT+player/me、iframedata.token;Docs 侧栏--docs-sticky-top;静态校验用document.body.innerText。 SettlementBillRow无currency_code;账单金额展示用玩家default_currency。- 浏览器
/api/v1/*由 Next 转发到LOTTERY_API_UPSTREAM;与本地 Postgres 对账前须确认 upstream 与所查库一致。 - 当前联调/生产默认:H5
https://lottery-front.cjdhr.top、APIhttps://lottery-api.cjdhr.top、管理端/文档https://lottery-admin.cjdhr.top。 - 风控页默认:风险池仅显示有占用/高风险;单号详情可看占用来源;组合明细在注单详情页。
- 模块边界:对账中心=主站↔彩票钱包划转;报表中心=钱包盘经营分析;结算中心=信用账期占成/收付。
- 报表中心:默认近 30 天;盈亏类按
draws.business_date;金额读 APIcurrency_code;导出仅后端report-jobs全量(按筛选,无需先预览);注单盈亏≠信用账期结算。 - 对账中心:校验
transfer_ordersvs 彩票wallet_txns;差异 B 侧引用=彩票wallet_txns流水号;补单/冲正在钱包转账单页。