SA JK8 System Admin Platform Handbook JK8 系统管理员后台操作指南
Confidential · SuperAdmin Only 机密 · 仅限超级管理员

JK8 System Admin Platform Guide JK8 系统管理员后台操作指南

Standard operating procedures for managing multi-tenant vendor organizations, subscription plans, email routing, platform security, and audit governance. 用于管理多租户组织、订阅套餐、系统邮件路由、全域安全防护及审计追溯的标准操作规程。

01 Organizations 租户组织 Create tenants, assign subscriptions, attach brands, and manage domain hosts. 创建租户、分配订阅套餐、绑定运营品牌与独立域名。
02 Plans & Limits 套餐与配额 Define brand/user quotas and enforce modular feature flags per tier. 定义品牌与用户限额,并按套餐配置各功能模块启用状态。
03 Owner Invites 负责人激活 Generate cryptographic onboarding tokens for vendor tenant owners. 为租户团队负责人发放加密激活链接与注册邀请。
04 System Audit 安全审计 Immutable log records for all administrative actions with CSV export. 记录全系统管理员操作,支持多维过滤与 CSV 审计导出。

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)统一管理租户组织、授权计费套餐及全局邮件路由。租户团队与品牌运营人员绝无权限访问此系统管理后台。

ℹ️ Role Delegation Summary: ℹ️ 职责分工备忘: System Admin: Creates the Tenant Organization and assigns the Subscription Plan (enabling Transactions and Game Providers modules).
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)

Target Route: /system/login  |  Profile Settings: /system > Operations > Profile (SystemProfile.tsx)

SuperAdmins authenticate through dedicated administrative endpoints with optional multi-factor authentication (TOTP): 超级管理员通过专属管理端入口登录,并可配置基于时间戳的动态口令(TOTP)二次验证:

  1. 1. SuperAdmin Login1. 管理员登录入口

    Navigate to /system/login. Enter your SuperAdmin email and password. Click Sign in as System Admin.访问 /system/login。输入超级管理员邮箱与密码,点击 Sign in as System Admin 完成初次登录。

  2. 2. Enable TOTP 2FA2. 开启 TOTP 双重验证

    In the System Shell sidebar, click Profile. Under the Two-Factor Authentication card, click Enable 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. 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. 4. Backup Emergency Recovery Codes4. 备份紧急恢复备用码

    The modal displays 10 single-use recovery codes. Click Copy or Download to store them in a secure password vault.弹窗将显示 10 组一次性紧急备用恢复码。点击 Copy 复制或 Download 下载并存入离线安全保管库。

  5. 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 租户组织管理与多子面板配置

Target Route: /system > Directory > Organizations (OrganizationsScreen.tsx)

Manage vendor tenant organizations, assign subscription plans, attach operational brands, and configure dedicated domain hosts: 管理租户组织完整生命周期,绑定计费订阅套餐、挂载初始运营品牌并配置专属独立域名:

  1. Create Organization创建新租户组织

    In the top card form, enter Organization Name (e.g. Organization 1), Organization Slug (e.g. org-1), and optional Email 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"。

  2. Assign Subscription Plan (Sub-panel)分配订阅套餐 (Subscription 子面板)

    In the organization row, click Subscription. The lower drawer opens. Select the target tier from Plan dropdown, select an Expires at calendar date, and click Save subscription. Toast: "Subscription updated".在组织表格行点击 Subscription 打开下方子面板。在 Plan 下拉菜单选择目标套餐,选择 Expires at 到期日期,点击 Save subscription。系统提示:"Subscription updated"。

  3. Assign Root Owner (Org Members Sub-panel)指派租户根负责人 (Org Members 子面板)

    In the organization row, click Org Members. Input the executive's Email, optional New password, set Role to Owner, ensure All brands (*) is checked, and click Invite Member. Toast: "Member assigned".在组织表格行点击 Org Members 打开成员子面板。录入负责人 Email、可选 New password,将 Role 设为 Owner,勾选 All brands (*),点击 Invite Member。系统提示:"Member assigned"。

  4. Attach Initial Brands (Brands Sub-panel)预配运营品牌 (Brands 子面板)

    Click Brands on the organization row. Enter Brand Key (e.g. brand-1) and Brand Name (e.g. Brand 1). Click + Add. The brand is immediately provisioned under the tenant.在表格行点击 Brands。输入 Brand Key(如 brand-1)与品牌名称(如 Brand 1),点击 + Add 即可直接为该租户挂载品牌。

  5. Configure Custom Domain (Email host Sub-panel)配置独立访问域名 (Email host 子面板)

    Click Email host on the organization row. Enter the tenant's custom portal hostname (e.g. app.organization.com). Click Save 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 订阅套餐定制与功能权限开关

Target Route: /system > Operations > Plans (SystemPlans.tsx)

Define customer subscription plans, quotas, and granular module access control: 定制客户订阅层级、资源配额以及细粒度功能模块访问权限:

  1. Input Tier Parameters录入套餐基础参数

    Enter Name (e.g. Enterprise Plan), Description, Max Brands (e.g. 10, or 0 for unlimited), and Max Users (e.g. 50, or 0 for unlimited).输入套餐名称 Name(如 Enterprise Plan)、说明 Description、最大品牌数 Max Brands(填 0 代表无上限)及最大用户数 Max Users(填 0 代表无上限)。

  2. Configure Module Checklist配置功能模块勾选清单

    Use Select all / Deselect all or toggle individual module checkboxes:可使用 Select all / Deselect all 快速批量操作,或单独勾选各功能模块:

    Module KeyDisplay LabelDescription
    performancePerformanceKPI summary dashboard & cash flow charts
    membersMembersPlayer CRM, FTD metrics, and VIP tier tracking
    transactionsTransactionsIngested deposit/withdrawal transactional ledger
    channelsChannelsTraffic referrer codes, CPA, and ROAS attribution
    trendsTrendsPlayer recency cohorts and retention analytics
    game_providersGame ProvidersProvider turnover, win/loss, and fee share calculation
    method_feesMethod FeesPayment gateway merchant deduction fees
    compare_brandsCompare BrandsCross-brand comparative metrics benchmarking
    exportExportDownloadable Excel (XLSX) and CSV reporting
  3. Save Plan保存套餐生效

    Click Create plan (or Update plan when 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)

Target Route: /system > Directory > Organizations (OrganizationsScreen.tsx)

Enforce license compliance and execute instant emergency suspension for non-paying or compromised tenants: 执行授权合规监控并在租户欠费或出现异常时执行即时熔断冻结:

  1. Check Organization Status查看组织当前状态

    Locate the target tenant row in the table. Verify the current badge: active (green) or disabled (gray).在组织列表中定位目标租户。查看状态徽章:正常时显示绿色 active,冻结时为灰色 disabled。

  2. Execute Suspension (Killswitch)执行停用熔断 (Killswitch)

    Under the Actions column, click the red Remove button. The backend instantly updates organization status to disabled.在对应租户右侧操作栏点击红色 Remove 按钮。后端数据库立即将其状态置为 disabled。

  3. 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-blocked and displays the full-screen LicenseBlocked.tsx modal: "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)

Target Route: /system > Directory > Invitations (SystemInvites.tsx)

Generate cryptographic onboarding links to invite the primary owner of a new customer tenant: 生成加密入驻注册链接,邀请新客户团队的总负责人完成账户初始化:

  1. Input Target Email & Validity输入受邀邮箱与有效期限

    In the Create owner invite card, enter the executive's Target email (e.g. owner@customer.com) and set Expires in days (1 to 30 days, default 7).在 Create owner invite 卡片中输入负责人邮箱 Target email(如 owner@customer.com),设定有效期 Expires in days(1 至 30 天,默认为 7 天)。

  2. 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"。

  3. 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 页面,设置个人密码与显示昵称后,即可一键认领该组织并获得全部管理权限。

  4. Resend or Revoke Invites重新发送或撤回作废邀请

    In the Invitations table, click Resend to refresh the link or re-dispatch the email, or click Revoke to immediately invalidate a pending invitation.在邀请记录列表中,点击 Resend 可重新投递或刷新链接;点击 Revoke 可立即撤销并作废未使用的邀请凭证。

Procedure S5 Global Mail Transport & System Routing 系统邮件网关与全局域名路由配置

Target Route: /system > Operations > Settings (SystemSettings.tsx)

Configure platform outbound email delivery engines and default web domain routing: 配置全平台外发邮件投递引擎与默认前端域名路由:

  1. Select Email Provider选择邮件服务驱动

    Choose from manual (API token only, no emails sent), smtp, or resend.点击切换 manual(纯手动链接模式)、smtp 或 resend。

  2. Configure Credentials录入网关认证凭证

    For SMTP: Input Host, Port (e.g. 587 or 465), Username, Password, and From address.
    For Resend: Input API key and From 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 会被警告拦截)。

  3. Test Deliverability (Send Test Email)投递测试 (Send test email)

    Click Send test email in the card header. Specify Recipient, Subject, and Body, then click Send test email to confirm inbox delivery before saving settings.点击卡片顶部的 Send test email 按钮。输入收件人 Recipient、主题与正文,点击发送以测试实际邮箱送达率。

  4. 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. Click Save.在底部 Default invite host 输入框录入系统默认前端访问域名(如 app.example.com,仅输入纯主机名,系统会自动补全 HTTPS)。当租户未设置专属域名覆盖时,所有激活链接均以此域名构建。点击 Save 保存。

Procedure S6 Platform Broadcast Announcements 全系统公告发布与轮播广播

Target Route: /system > Operations > Announcements (SystemAnnouncements.tsx)

Publish platform maintenance notices, release notes, and real-time banners across all vendor dashboards and the login screen: 向全平台租户后台及登录页面广播系统维护通告、版本更新及突发通知:

  1. Open Announcement Editor打开公告编辑器

    Click + New Announcement. The rich editor modal opens.点击右上角 + New Announcement 按钮打开富文本编辑弹窗。

  2. Draft Content & Schedule编辑内容与排期

    Input Title and draft the HTML body using bold, lists, and links. Optionally set Start at and End at local timestamps to automate campaign rotation.输入公告标题 Title,在富文本编辑器中编排图文格式。可按需指定 Start at 开始时间与 End at 截止时间以实现定时生效。

  3. Configure Rotation & Display Settings配置轮播间隔与全局开关

    Under General settings on the page, set Slideshow interval (between 3 and 120 seconds, default 5s) and click Save interval. Toggle Announcements active and Display brand logo switches as needed.在页面顶部常规设置中,输入轮播间隔 Slideshow interval(3 至 120 秒之间,默认为 5 秒),点击 Save interval。按需开启 Announcements active 全局总开关及 Display brand logo 品牌图标显示开关。

Procedure S7 SuperAdmin Staff & Granular Permission Grants 管理员团队管理与权限授权机制

Target Route: /system > Operations > Admins (SystemAdmins.tsx)

Manage internal administrative operators and delegate granular permissions: 管理运维与技术团队管理员账号,按最小权限原则进行职责切分与授权:

  1. Add New System Admin创建新系统管理员

    Click + New Admin. Enter Email, Display Name, and initial password (minimum 8 characters). Select Role: main (unrestricted superadmin) or staff (permission-constrained).点击 + New Admin。输入管理员邮箱、显示昵称及初始密码(至少 8 位)。选择角色:main(完全主管理员)或 staff(受权限限制的运维人员)。

  2. Grant Granular Permissions (Staff Role)勾选细粒度管理权限 (Staff 角色)

    For staff administrators, check the specific permissions required for their duty:针对 staff 角色,可按需勾选分配如下具体管理权限:

    Permission KeyScope 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
  3. Lock or Disable Compromised Accounts紧急冻结异常管理员账户

    In the Admins table, click Disable to immediately lock a staff administrator account and terminate their active sessions.在管理员列表中,点击目标账号的 Disable 按钮即可即刻冻结其登录权限并阻断其已有会话。

Procedure S8 Forensic Security Audit Trail & CSV Export 全局安全审计日志与 CSV 合规导出

Target Route: /system > Security > Audit Log (SystemAudit.tsx, requires sys:audit:view)

Inspect immutable audit logs capturing every administrative event across the entire platform: 审查全平台不可篡改的超级管理行为审计日志,实现全链路合规追溯:

  1. Filter by Action, Actor & Date多维条件组合检索

    Filter events by Action filter (e.g. plan.created, organization.created, subscription.updated), or specify From and To calendar dates. Click Clear to reset filters.在顶部检索栏输入 Action filter(如 plan.created、organization.created、subscription.updated),或选择 From 与 To 日期区间进行精确筛选。点击 Clear 可一键重置。

  2. 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 差异快照。

  3. Export Compliance CSV导出合规 CSV 审计报表

    Click Export CSV in the page header. The system streams a CSV file named system_audit_YYYY-MM-DD.csv containing all filtered records for archival and regulatory compliance.点击页面右上角 Export CSV 按钮。系统将自动生成并下载名为 system_audit_YYYY-MM-DD.csv 的数据报表,便于合规归档与内部复盘。