> For the complete documentation index, see [llms.txt](https://docs.xenoraa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xenoraa.com/xenoraa-super-admin-operations-manual/welcome-to-the-super-admin-operations-manual.md).

# Welcome to the Super Admin Operations Manual

## Welcome to the Xenoraa Super Admin Operations Manual

This manual serves as the single source of truth for platform administrators managing the Xenoraa SaaS CRM/ERP ecosystem. Xenoraa is a multi-tenant application designed to scale with your tenants, providing them with robust tools for CRM, POS, Accounts, and AI assistance. As a Super Admin, you have full control over tenant lifecycles, billing, subscription plans, custom domains, global platform settings, and AI training hubs.

🧭 The Super Admin Workspace

The Super Admin panel is accessible exclusively to users with the `superadmin` role at `https://xenoraa.com/superadmin`. The dashboard aggregates platform-wide telemetry, providing real-time visibility into the health and commercial metrics of the ecosystem.

```
+-------------------------------------------------------------------------+
| [XENORAA SUPERADMIN] Search Platform... (Admin: Gopi)                   |
+-------------------------------------------------------------------------+
| (•) Dashboard      | Platform Health: 99.9% Uptime                      |
| [≡] Tenants        | +-------------------+ +---------------------------+ |
| [≡] Subscriptions  | |   Total Tenants   | |   Monthly Recurring Rev   | |
| [≡] Billing        | |      **18**       | |      **Rs. 2,45,000**     | |
| [≡] Custom Domains | +-------------------+ +---------------------------+ |
| [≡] Xena AI Mgmt   | |                                                 | |
| [≡] Staff & Roles  | [ Recent Signups ]                                | |
| [≡] SEO & Settings | - Tenant "Go Esscay Solutions" created (Pro Plan) | |
| [≡] System Logs    | - Tenant "Apex Retail" custom domain approved     | |
+-------------------------------------------------------------------------+
```

***

### Core Telemetry & KPI Cards

When you log in, the top of the dashboard displays six critical metrics that represent the commercial and operational health of the platform:

| Metric                        | Description                                                   | Importance                                                 |
| ----------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------- |
| **Total Users**               | Total number of registered accounts across the platform.      | Tracks overall platform growth and signup velocity.        |
| **Active Subscribers**        | Number of tenants currently in `active` status.               | Represents the core paying customer base.                  |
| **Monthly Recurring Revenue** | Computed MRR based on active subscription values.             | The primary commercial metric for platform sustainability. |
| **Custom Domains**            | Number of tenants with approved custom domain mappings.       | Indicates enterprise-tier adoption and configuration.      |
| **Plan Distribution**         | Breakdown of tenants across Starter, Pro, and Business plans. | Guides pricing optimization and feature-tiering decisions. |
| **Activity Telemetry**        | Total posts, leads, chats, and POS orders across all tenants. | Measures actual platform engagement and usage depth.       |

***

### Super Admin Quick-Start Checklist

For daily operations, we recommend reviewing the following checklist in order:

1. **Review Tenant Signups:** Verify new tenant accounts and ensure their databases are properly initialized.
2. **Audit Billing & Subscriptions:** Monitor payment receipts, outstanding invoices, and subscription renewals.
3. **Approve Custom Domains:** Review pending custom domain mapping requests and update Nginx configurations.
4. **Monitor Xena AI Credits:** Ensure tenants have sufficient AI credits and monitor global OpenAI token usage.
5. **Inspect System Logs:** Audit application error logs and Slack error channels (`#xenoraa-errors`) for system health.
6. **Manage Staff Permissions:** Review internal administrative staff roles and access privileges.

In the following chapters, we will dive deep into each administrative module with step-by-step operational workflows.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xenoraa.com/xenoraa-super-admin-operations-manual/welcome-to-the-super-admin-operations-manual.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.