Super Admin Guide

Audience: Platform operators (super admins). Where you work: the admin console at /admin/*. New here? Read the Platform Overview first.

A Super Admin operates the entire platform across all tenants. You can see and manage every dealer organization, buyer organization, order, and product, plus the catalog and other super admins. You are not tied to any single dealer or buyer org.

How super-admin access works: a user is a super admin when their account carries the is_super_admin flag. This is verified on every admin API call and on each admin page; non-super-admins are redirected away. Super admins are managed from the Admins page (below) — there’s no dealer/buyer membership involved.

1. Platform dashboard

Your dashboard is a platform-wide rollup: total revenue, orders (and how many are pending), dealer/buyer/project counts, a 6-month revenue trend, top dealers by revenue, an order-status breakdown, and recent orders across all dealers.

It also includes an AQ Products API card to test the platform Products API connection and pre-warm the product-info cache.

The sidebar gives you: Dashboard, Dealers, Buyers, Multi-Org Buyers, Orders, Reports, Products, and Admins.

2. Dealers

The Dealers page lists every (non-archived) dealer organization with its user, project, and buyer counts.

• New Dealer — create a dealer organization.
• Click a dealer to manage it; you can also archive a dealer from the list.

Dealer detail (manage as that dealer)

Opening a dealer gives you full administrative control of that organization. A banner makes it clear you’re operating in Super Admin Mode while viewing the dealer’s world.

From here you can:

• See the dealer’s revenue, orders, projects, buyer-org, and team stats.
• Archive / restore the dealer.
• Configure the dealer’s AutoQuotes Projects API key (set, verify, sync, clear, choose US/UK region).
• Use the tabs to manage the dealer’s Projects, Buyer Organizations, and Team Members — including inviting dealer users and changing their roles/status.
• Drill into a specific project (/admin/dealers/[id]/projects/[projectId]) to edit its name/status and manage buyer-org links, or a specific user (/admin/dealers/[id]/users/[userId]).

Note on “acting as”: the dealer detail experience lets you manage everything about a dealer from the admin console. It is a cross-tenant management view (with a “Super Admin Mode” banner) — your session always remains your own super-admin identity.

3. Buyers

A global list of every buyer organization across all dealers, with its dealer, region, district, and user count.

Open a buyer org to view its stats and dealer link, and to manage its orders and team (promote/demote/activate buyer users).

4. Multi-Org Buyers (Buyer Group Admins)

A platform-wide view of all buyer group admins across every dealer, with a built-in explainer of what they are.

Open one to edit its name/active status, and assign or remove the buyer organizations it can access (or delete the record).

5. Orders

Every order on the platform, with status tabs and search by order ID.

Open an order to see full details, change its workflow_state directly (an operator override), and add comments as an admin.

Export CSV — the Export CSV button opens an Export Orders dialog where you choose a date range (by date placed), order statuses, and dealer organizations, then download a one-row-per-order CSV. The super-admin export includes a Dealer Org column. Payment is derived from whether the order has a paid timestamp (not the legacy payment_status field).

6. Reports

The Reports page generates aggregated, one-row-per-dealer order reports that are stored securely and can be re-downloaded anytime — useful for periodic finance/ops reporting across the whole platform.

Generate a report (“Orders by Dealer”):

• Pick a date range (order placed; with quick presets), optional order statuses, and optional dealer organizations. Leave a filter empty to include everything.
• Click Generate Report. The CSV is built server-side, uploaded to secure storage (S3), and recorded in the history below.

Report History lists every previously generated report with its date range, filter summary, dealer count, and who created it. Each row has:

• Download — opens a short-lived presigned link to the stored CSV.
• Delete — removes the report and its stored file.

Difference vs. the Orders Export CSV: the export gives you raw per-order rows on demand; Reports produce saved, aggregated per-dealer summaries with a re-downloadable history.

7. Products (global catalog)

The master product catalog — hundreds of thousands of products — searchable by name/model and filterable by manufacturer.

Open a product to manage its attachments: upload images and spec sheets (via presigned S3 uploads), add external video links, delete attachments, and set the main image.

8. Admins

Manage who has super-admin access to the platform.

• Invite Admin — grant super-admin access to a new or existing user.
• Send a password reset, edit a name, or remove an admin’s access. You cannot remove your own access.

9. What super admins manage (cross-tenant summary)

Quick reference — super admin routes