Dashboard
Overview
Operator dashboard surfaces and their purpose.
Overview
Operator Dashboard is the control plane for Mini App operations.
Current navigation
Menus are filtered by the signed-in staff member's scopes and environment. A role badge such as Operator Admin is not a substitute for the required grants. API keys are for backend requests, not dashboard sign-in.
| Group | Page | Path | Required scope | Purpose |
|---|---|---|---|---|
| Overview | Overview | / | authenticated session | Metrics for users, trade fees, 24h trade fees, and visible active markets. |
| Support | Operator Support | /support-tickets | active human staff session | Operator-shared support conversations, replies, and reopening. |
| Operations | Users | /users | users:read | Operator-linked Mini App users. |
| Operations | Trades | /trades | trades:read | Orders, generated trade fees, and operator fee share. |
| Operations | Resolutions | /resolutions | redemptions:read | Resolved market exposure and payout liability. |
| Operations | Market PnL | /market-pnl | trades:read and redemptions:read | Resolved-market confirmed user cash flow and reference-only accumulated quoted fees. |
| Operations | Cash Flow Triage | /market-pnl-issues | trades:read, redemptions:read, and balance_operations:read | Read-only source records, redacted wallet evidence, and resolution history behind PnL warnings; escalate to Polynion for reconciliation. |
| Operations | Opinion Settlement Reports | /settlement-reports | settlements:read | Operator-local monthly fees, captured principal closures, payout cash, net due, and CSV/PDF exports. |
| Operations | Balance Ops | /balance-operations | balance_operations:read | Opinion wallet debits, credits, reversals, retries, balance-after evidence, and exports by default; use Polyflight → Wallet Operations for Polyflight. |
| Polyflight | Overview | /polyflight | polyflight:read | Native activity, signed position, and outstanding liabilities. |
| Polyflight | Flights | /polyflight/flights | polyflight:read | Shared flights with this operator's participation. |
| Polyflight | Tickets | /polyflight/tickets | polyflight:read, polyflight_terms:read | Native tickets, captured terms, result, and payment state. |
| Polyflight | Wallet Operations | /polyflight/balance-operations | polyflight:read and balance_operations:read | Polyflight wallet effects and evidence. |
| Polyflight | Settlement reports | /polyflight/settlement-reports | polyflight_settlements:read | Signed statements, liabilities, exports, and payments. |
| Polyflight | Terms | /polyflight/terms | polyflight_terms:read | Read-only current, scheduled, and historical terms. |
| API Playground | Session through Staffs | /api-playground/{group} | matching request scope | Allowlisted Operator API workspace with inherited staff auth, confirmations, and response inspection. |
| Operations | Markets | /markets | markets:read | Market visibility, YES percentage, trading cutoff, and operator 24h volume. |
| Operations | Market Requests | /market-requests | human staff with markets:read | Unreleased: review submitted private-market terms and approval/rejection history. |
| Operations | Request Create Market | /market-requests/create | human staff with markets:read and markets:write | Unreleased: submit exact private-market terms and accept operator underwriting risk; does not publish. |
| Simulator | Simulator | /simulator | simulator:read | Staging-only launch drill page for simulator users. |
| Simulator | Simulator Users | /simulator/users | simulator:read | Staging-only simulator user and balance management. |
| Integrations | Integration UAT | /integrations/uat | at least one relevant integration/operations scope; actions need their own grants | Guided integration evidence checklist. |
| Integrations | Wallet Adapter | /settings/wallet-adapter | wallet_adapter:read | REST v1 wallet adapter config and validation tests. |
| Integrations | API Keys | /settings/api-keys | api_keys:read | Operator API key creation, rotation, and revocation. |
| Integrations | Staffs | /settings/staffs | staffs:read | Human dashboard staff accounts and dashboard permissions. |
| Integrations | Callback Settings | /settings/callbacks | webhooks:read | Webhook endpoint configuration and recent delivery actions. |
| Integrations | Webhook Deliveries | /webhooks-deliveries | webhooks:read | Delivery audit trail and replay workflow. |
Availability: this table describes repository capabilities, not a deployment or acceptance record. Private Market Requests are marked Unreleased in the changelog; do not rely on them until Polynion confirms availability for your environment. Integration UAT appears with any of wallet_adapter:read, wallet_adapter:write, launch:write, webhooks:read, trades:read, or balance_operations:read; access to the page does not authorize every action.
Overview cards summarize users, generated fees (all time and last 24 hours), and visible open markets. They are not a wallet balance, operator earnings statement, or proof of settlement. For restricted staff, use the detailed pages for which access is granted rather than interpreting an unavailable metric as zero activity.
Suggested setup order
- confirm staff access and assign least-privilege staff scopes
- create backend API keys for launch/reporting workloads
- configure and test REST v1 wallet adapter
- configure webhook endpoint, events, attempts, timeout, and secret
- if enabled, verify Polyflight terms/timezone and explicitly assign its read scopes
- review market visibility before public rollout
- run staging simulator, wallet adapter, and webhook drills
- verify Opinion and Polyflight operation/event/report evidence before requesting production approval
What dashboard changes do
- API key changes affect operator API access immediately.
- Staff changes affect human dashboard access and revoke changed staff sessions.
- Wallet adapter changes affect balance reads and wallet mutation callbacks.
- Webhook endpoint changes affect subsequent delivery attempts. Replay redelivers the same event identity and event time, but Opinion payloads are reconstructed from current order data on each send; JSON fields such as order status need not match an earlier attempt.
- Market visibility changes affect which markets appear to operator users.
- Polyflight operator pages are read-only; only Polynion administration can change terms, finalize/pay statements, or resolve ambiguous operations.
- Simulator changes affect staging/local simulator-tagged users only.
- Support tickets create conversations with Polynion Support; they do not change wallet, trade, or settlement state.
- Market Requests, when available, submit immutable terms for Polynion review. Submission is not market publication.
What dashboard does not change
- public operator API path structure
- wallet adapter path structure
- webhook event names
- shared integration contract described in these docs
- production users when a simulator-only user is edited
- Operator pages do not mark cash outcomes completed/failed, send compensating money, waive unpaid payouts, or finalize/pay Opinion settlements. The Polynion Admin link in Cash Flow Triage requires separate authorized Admin access; dashboard staff access does not grant it.
Related pages
- users:
/docs/dashboard/users - trades:
/docs/dashboard/trades - resolutions:
/docs/dashboard/resolutions - Market PnL:
/docs/dashboard/market-pnl - Cash Flow Triage:
/docs/dashboard/cash-flow-triage - Market Requests (unreleased):
/docs/dashboard/market-requests - Operator Support:
/docs/dashboard/operator-support - balance operations:
/docs/dashboard/balance-operations - Polyflight:
/docs/polyflight/overview-and-launch - markets:
/docs/dashboard/market-visibility - API keys:
/docs/dashboard/api-keys - wallet adapter settings:
/docs/dashboard/wallet-adapter-settings - webhook endpoints:
/docs/dashboard/webhook-endpoints - webhook deliveries:
/docs/dashboard/webhook-deliveries - staffs:
/docs/dashboard/staffs - simulator:
/docs/dashboard/simulator - API Playground:
/docs/dashboard/api-playground