JK8 System Admin Platform Guide JK8 系统管理员后台操作指南
Standard operating procedures for managing multi-tenant vendor organizations, subscription plans, email routing, platform security, and audit governance. 用于管理多租户组织、订阅套餐、系统邮件路由、全域安全防护及审计追溯的标准操作规程。
Platform Architecture: SuperAdmin vs Vendor Separation 平台架构:系统管理员与租户端严格边界划分
The JK8 platform employs strict multi-tenant isolation. System Administrators operate the central control plane (/system), managing customer accounts, billing licenses, and system email infrastructure.
Vendor organizations and brand operators never have access to this portal.
JK8 平台采用严格的多租户物理与逻辑隔离。系统管理员通过总控后台(/system)统一管理租户组织、授权计费套餐及全局邮件路由。租户团队与品牌运营人员绝无权限访问此系统管理后台。
Vendor Org Admin: Configures the Integration Config to ingest Transactions data, and the BO Credential Config to run Game Provider fees. 系统管理员职责: 创建租户组织并分配订阅套餐(在套餐中开启 Transactions 交易及 Game Providers 游戏厂商模块权限)。
租户管理员职责: 进入各品牌后台配置 Integration Config (接入配置) 获取交易流水,并配置 BO Credential (包网凭证) 同步并计算游戏厂商分成。
Security System Admin Authentication & TOTP 2FA 系统管理员认证与 TOTP 二次验证 (2FA)
/system/login | Profile Settings: /system > Operations > Profile (SystemProfile.tsx)
SuperAdmins authenticate through dedicated administrative endpoints with optional multi-factor authentication (TOTP): 超级管理员通过专属管理端入口登录,并可配置基于时间戳的动态口令(TOTP)二次验证:
-
1. SuperAdmin Login1. 管理员登录入口
Navigate to
/system/login. Enter your SuperAdmin email and password. ClickSign in as System Admin.访问/system/login。输入超级管理员邮箱与密码,点击Sign in as System Admin完成初次登录。 -
2. Enable TOTP 2FA2. 开启 TOTP 双重验证
In the System Shell sidebar, click
Profile. Under the Two-Factor Authentication card, clickEnable TOTP. The system displays a QR code and secret setup key with a 10-minute setup timer.在管理后台侧边栏点击底部Profile。在 Two-Factor Authentication 卡片中点击Enable TOTP。系统将生成 256x256 动态二维码及文本密钥,并开启 10 分钟有效倒计时。 -
3. Scan QR Code & Enter 6 Numbers3. 扫描二维码并录入 6 位验证码
Open Google Authenticator, Microsoft Authenticator, or 1Password. Scan the QR code, type the current 6-digit rolling numeric code into the input, and click
Verify and enable.打开 Google Authenticator、Microsoft Authenticator 或 1Password 等认证软件扫描二维码。输入软件中生成的 6 位数字,点击Verify and enable。 -
4. Backup Emergency Recovery Codes4. 备份紧急恢复备用码
The modal displays 10 single-use recovery codes. Click
CopyorDownloadto store them in a secure password vault.弹窗将显示 10 组一次性紧急备用恢复码。点击Copy复制或Download下载并存入离线安全保管库。 -
5. Authorization Protection5. 敏感安全操作密码二次核验
To disable 2FA or regenerate recovery codes, entering your current account password is strictly required to authorize the action.若需停用 2FA 或重新生成恢复码,必须在输入框录入当前账号的登录密码,方可授权执行变更。
Procedure S1 Tenant Organization Management & Sub-panels 租户组织管理与多子面板配置
/system > Directory > Organizations (OrganizationsScreen.tsx)
Manage vendor tenant organizations, assign subscription plans, attach operational brands, and configure dedicated domain hosts: 管理租户组织完整生命周期,绑定计费订阅套餐、挂载初始运营品牌并配置专属独立域名:
-
Create Organization创建新租户组织
In the top card form, enter
Organization Name(e.g.Organization 1),Organization Slug(e.g.org-1), and optionalEmail host override(e.g.tenant.example.com, bare host only). Click+ Add. The toast confirms: "Organization created".在顶部卡片表单录入Organization Name(如Organization 1)、Organization Slug(如org-1)及选填的Email host override(如tenant.example.com,仅填纯主机名)。点击+ Add,系统提示:"Organization created"。 -
Assign Subscription Plan (Sub-panel)分配订阅套餐 (Subscription 子面板)
In the organization row, click
Subscription. The lower drawer opens. Select the target tier fromPlandropdown, select anExpires atcalendar date, and clickSave subscription. Toast: "Subscription updated".在组织表格行点击Subscription打开下方子面板。在Plan下拉菜单选择目标套餐,选择Expires at到期日期,点击Save subscription。系统提示:"Subscription updated"。 -
Assign Root Owner (Org Members Sub-panel)指派租户根负责人 (Org Members 子面板)
In the organization row, click
Org Members. Input the executive'sEmail, optionalNew password, setRoletoOwner, ensureAll brands (*)is checked, and clickInvite Member. Toast: "Member assigned".在组织表格行点击Org Members打开成员子面板。录入负责人Email、可选New password,将Role设为Owner,勾选All brands (*),点击Invite Member。系统提示:"Member assigned"。 -
Attach Initial Brands (Brands Sub-panel)预配运营品牌 (Brands 子面板)
Click
Brandson the organization row. EnterBrand Key(e.g.brand-1) andBrand Name(e.g.Brand 1). Click+ Add. The brand is immediately provisioned under the tenant.在表格行点击Brands。输入Brand Key(如brand-1)与品牌名称(如Brand 1),点击+ Add即可直接为该租户挂载品牌。 -
Configure Custom Domain (Email host Sub-panel)配置独立访问域名 (Email host 子面板)
Click
Email hoston the organization row. Enter the tenant's custom portal hostname (e.g.app.organization.com). ClickSave host. All invite and setup emails dispatched for this organization will now route to this custom domain.在表格行点击Email host。输入租户专属前端域名(如app.organization.com,不含 https:// 协议头与路径)。点击Save host。该组织后续发送的所有激活邀请邮件均会自动解析并指向该域名。
Procedure S2 Subscription Plans & Feature Gating 订阅套餐定制与功能权限开关
/system > Operations > Plans (SystemPlans.tsx)
Define customer subscription plans, quotas, and granular module access control: 定制客户订阅层级、资源配额以及细粒度功能模块访问权限:
-
Input Tier Parameters录入套餐基础参数
Enter
Name(e.g.Enterprise Plan),Description,Max Brands(e.g.10, or0for unlimited), andMax Users(e.g.50, or0for unlimited).输入套餐名称Name(如Enterprise Plan)、说明Description、最大品牌数Max Brands(填0代表无上限)及最大用户数Max Users(填0代表无上限)。 -
Configure Module Checklist配置功能模块勾选清单
Use
Select all/Deselect allor toggle individual module checkboxes:可使用Select all/Deselect all快速批量操作,或单独勾选各功能模块:Module Key Display Label Description performancePerformance KPI summary dashboard & cash flow charts membersMembers Player CRM, FTD metrics, and VIP tier tracking transactionsTransactions Ingested deposit/withdrawal transactional ledger channelsChannels Traffic referrer codes, CPA, and ROAS attribution trendsTrends Player recency cohorts and retention analytics game_providersGame Providers Provider turnover, win/loss, and fee share calculation method_feesMethod Fees Payment gateway merchant deduction fees compare_brandsCompare Brands Cross-brand comparative metrics benchmarking exportExport Downloadable Excel (XLSX) and CSV reporting -
Save Plan保存套餐生效
Click
Create plan(orUpdate planwhen editing). The toast confirms: "Plan created" / "Plan updated". All organizations subscribed to this plan immediately inherit the module permissions.点击Create plan(编辑时为Update plan)。系统确认 "Plan created"。所有绑定该套餐的租户组织将即刻继承对应的模块访问权限。
Procedure S3 Organization Lifecycle & License Suspension (402 Shield) 组织生命周期管理与授权熔断拦截屏障 (HTTP 402)
/system > Directory > Organizations (OrganizationsScreen.tsx)
Enforce license compliance and execute instant emergency suspension for non-paying or compromised tenants: 执行授权合规监控并在租户欠费或出现异常时执行即时熔断冻结:
-
Check Organization Status查看组织当前状态
Locate the target tenant row in the table. Verify the current badge: active (green) or disabled (gray).在组织列表中定位目标租户。查看状态徽章:正常时显示绿色 active,冻结时为灰色 disabled。
-
Execute Suspension (Killswitch)执行停用熔断 (Killswitch)
Under the Actions column, click the red
Removebutton. The backend instantly updates organization status todisabled.在对应租户右侧操作栏点击红色Remove按钮。后端数据库立即将其状态置为disabled。 -
Instant 402 Shield Enforcement即时生效 402 屏障拦截
All connected vendor sessions under this organization immediately receive HTTP 402 (Payment Required) on their subsequent API requests. The client fires
auth:license-blockedand displays the full-screenLicenseBlocked.tsxmodal: "License Suspended — Please contact your system administrator", completely locking the tenant out of all screens.该组织名下所有在线的租户操作员在发起下一次 API 请求时将立即收到 HTTP 402 响应。前端即刻派发auth:license-blocked事件并渲染全屏拦截遮罩(LicenseBlocked.tsx,提示:"License Suspended — Please contact your system administrator"),完全阻止继续查看或操作任何数据。
Procedure S4 Executive Owner Setup Invitations 租户负责人专属激活邀请 (Owner Setup)
/system > Directory > Invitations (SystemInvites.tsx)
Generate cryptographic onboarding links to invite the primary owner of a new customer tenant: 生成加密入驻注册链接,邀请新客户团队的总负责人完成账户初始化:
-
Input Target Email & Validity输入受邀邮箱与有效期限
In the Create owner invite card, enter the executive's
Target email(e.g.owner@customer.com) and setExpires in days(1 to 30 days, default7).在 Create owner invite 卡片中输入负责人邮箱Target email(如owner@customer.com),设定有效期Expires in days(1 至 30 天,默认为7天)。 -
Generate Invitation Token生成安全邀请凭证
Click
Create owner invite. If SMTP/Resend is configured, the invite email is dispatched automatically. If manual mode is active, the secure URL (https://app.example.com/owner-setup?token=tok_...) is automatically copied to your clipboard. Toast: "Invite created — copy link to share".点击Create owner invite。若系统已配置 SMTP/Resend,系统将自动投递邮件;若为 manual 模式,系统将自动将完整安全链接(https://app.example.com/owner-setup?token=tok_...)复制到剪贴板,提示:"Invite created — copy link to share"。 -
Owner Onboarding Experience负责人入驻初始化体验
The owner opens the link, lands on
/owner-setup, sets their executive password and display name, and claims the organization with full Owner permissions.客户负责人点击链接打开专属/owner-setup页面,设置个人密码与显示昵称后,即可一键认领该组织并获得全部管理权限。 -
Resend or Revoke Invites重新发送或撤回作废邀请
In the Invitations table, click
Resendto refresh the link or re-dispatch the email, or clickRevoketo immediately invalidate a pending invitation.在邀请记录列表中,点击Resend可重新投递或刷新链接;点击Revoke可立即撤销并作废未使用的邀请凭证。
Procedure S5 Global Mail Transport & System Routing 系统邮件网关与全局域名路由配置
/system > Operations > Settings (SystemSettings.tsx)
Configure platform outbound email delivery engines and default web domain routing: 配置全平台外发邮件投递引擎与默认前端域名路由:
-
Select Email Provider选择邮件服务驱动
Choose from
manual(API token only, no emails sent),smtp, orresend.点击切换manual(纯手动链接模式)、smtp或resend。 -
Configure Credentials录入网关认证凭证
For SMTP: Input
Host,Port(e.g. 587 or 465),Username,Password, andFrom address.
For Resend: InputAPI keyandFrom address(must be a verified custom domain on resend.com/domains; public domains like gmail/yahoo are rejected with a warning).SMTP 模式: 输入Host、Port(如 587 或 465)、Username、Password及From address发信地址。
Resend 模式: 输入API key与From address(发信域名必须在 resend.com/domains 完成验证;公共邮箱后缀如 gmail/yahoo 会被警告拦截)。 -
Test Deliverability (Send Test Email)投递测试 (Send test email)
Click
Send test emailin the card header. SpecifyRecipient,Subject, andBody, then clickSend test emailto confirm inbox delivery before saving settings.点击卡片顶部的Send test email按钮。输入收件人Recipient、主题与正文,点击发送以测试实际邮箱送达率。 -
Set Default Invite Host设置默认邀请访问域名 (Default invite host)
In the bottom field, enter the primary system web hostname (e.g.
app.example.com, bare host only; HTTPS is added automatically). This domain is used for all invitation links when a tenant does not have a custom email host override. ClickSave.在底部Default invite host输入框录入系统默认前端访问域名(如app.example.com,仅输入纯主机名,系统会自动补全 HTTPS)。当租户未设置专属域名覆盖时,所有激活链接均以此域名构建。点击Save保存。
Procedure S6 Platform Broadcast Announcements 全系统公告发布与轮播广播
/system > Operations > Announcements (SystemAnnouncements.tsx)
Publish platform maintenance notices, release notes, and real-time banners across all vendor dashboards and the login screen: 向全平台租户后台及登录页面广播系统维护通告、版本更新及突发通知:
-
Open Announcement Editor打开公告编辑器
Click
+ New Announcement. The rich editor modal opens.点击右上角+ New Announcement按钮打开富文本编辑弹窗。 -
Draft Content & Schedule编辑内容与排期
Input
Titleand draft the HTML body using bold, lists, and links. Optionally setStart atandEnd atlocal timestamps to automate campaign rotation.输入公告标题Title,在富文本编辑器中编排图文格式。可按需指定Start at开始时间与End at截止时间以实现定时生效。 -
Configure Rotation & Display Settings配置轮播间隔与全局开关
Under General settings on the page, set
Slideshow interval(between 3 and 120 seconds, default 5s) and clickSave interval. ToggleAnnouncements activeandDisplay brand logoswitches as needed.在页面顶部常规设置中,输入轮播间隔Slideshow interval(3 至 120 秒之间,默认为 5 秒),点击Save interval。按需开启Announcements active全局总开关及Display brand logo品牌图标显示开关。
Procedure S7 SuperAdmin Staff & Granular Permission Grants 管理员团队管理与权限授权机制
/system > Operations > Admins (SystemAdmins.tsx)
Manage internal administrative operators and delegate granular permissions: 管理运维与技术团队管理员账号,按最小权限原则进行职责切分与授权:
-
Add New System Admin创建新系统管理员
Click
+ New Admin. EnterEmail,Display Name, and initial password (minimum 8 characters). Select Role:main(unrestricted superadmin) orstaff(permission-constrained).点击+ New Admin。输入管理员邮箱、显示昵称及初始密码(至少 8 位)。选择角色:main(完全主管理员)或staff(受权限限制的运维人员)。 -
Grant Granular Permissions (Staff Role)勾选细粒度管理权限 (Staff 角色)
For staff administrators, check the specific permissions required for their duty:针对 staff 角色,可按需勾选分配如下具体管理权限:
Permission Key Scope Description sys:orgs:manageView & modify tenant organizations sys:orgs:createCreate new tenant organizations sys:plans:manageCreate and edit subscription tiers sys:subscriptions:manageBind subscription plans to tenants sys:invites:manageGenerate owner onboarding invitation tokens sys:org_users:manageManage vendor users & perform password resets sys:settings:manageSystem settings (email, templates, announcements) sys:audit:viewView system-wide security audit logs sys:audit:exportExport audit logs as compliance CSV -
Lock or Disable Compromised Accounts紧急冻结异常管理员账户
In the Admins table, click
Disableto immediately lock a staff administrator account and terminate their active sessions.在管理员列表中,点击目标账号的Disable按钮即可即刻冻结其登录权限并阻断其已有会话。
Procedure S8 Forensic Security Audit Trail & CSV Export 全局安全审计日志与 CSV 合规导出
/system > Security > Audit Log (SystemAudit.tsx, requires sys:audit:view)
Inspect immutable audit logs capturing every administrative event across the entire platform: 审查全平台不可篡改的超级管理行为审计日志,实现全链路合规追溯:
-
Filter by Action, Actor & Date多维条件组合检索
Filter events by
Action filter(e.g.plan.created,organization.created,subscription.updated), or specifyFromandTocalendar dates. ClickClearto reset filters.在顶部检索栏输入Action filter(如plan.created、organization.created、subscription.updated),或选择From与To日期区间进行精确筛选。点击Clear可一键重置。 -
Inspect Event Payloads & IP Address审查变更详情与客户端 IP
Each log record displays the GMT+8 timestamp, actor email, target resource ID, and full JSON metadata payload capturing exact field mutations.每条记录均详细显示 GMT+8 操作时间、执行管理员邮箱、目标资源标识以及完整的变更前后 JSON 差异快照。
-
Export Compliance CSV导出合规 CSV 审计报表
Click
Export CSVin the page header. The system streams a CSV file namedsystem_audit_YYYY-MM-DD.csvcontaining all filtered records for archival and regulatory compliance.点击页面右上角Export CSV按钮。系统将自动生成并下载名为system_audit_YYYY-MM-DD.csv的数据报表,便于合规归档与内部复盘。