Welcome to the RootAuth console! This chapter will guide you through the basic operations after logging in, including workspace management, application management, team collaboration, and personal account settings. Whether you are a first-time user or a daily user, you will find clear instructions here.

Path: After logging in to the RootAuth console, you will be directed to the console home page.

1. Console Overview

After successfully logging in to the RootAuth console, you will see the following main areas:

Top Navigation Bar: A two-layer design. The upper layer is used to switch between workspaces and applications. The lower layer is used to switch between the functional pages of the current workspace (Applications, Team, Settings).
Main Content Area: By default, the "Applications" page is displayed, showing all application cards under your current workspace.
Upper Right Corner: Your avatar and email. Click to access your personal center, switch the language, or log out.

2. Workspace and Demo Application

2.1 Default Workspace

When you register for a RootAuth account for the first time, the system automatically creates a "Personal Workspace" for you (the name can be modified at any time). A workspace is the basic unit for managing your applications and team members; all applications and configurations belong to a specific workspace.

2.2 Demo Application

Each new workspace automatically includes a built-in "Demo Application" to help you quickly experience the core features of RootAuth. This application:

Comes with default application name, logo, and application type (standard web application).
Has a unique App ID that you can click to copy.
Initially has a "Development" environment label. If you switch it to production, the label updates to "Production".
You can configure, modify, or even delete this application as needed.

Note: The environment label is only a marker. RootAuth does not currently provide isolated development and production environments.

3. Applications

3.1 Application List

On the "Applications" page, you can view all applications under the current workspace in a card view.

Sorting Rule: Sorted in reverse chronological order by creation time, with the most recently created application appearing first.
Pagination Display: 9 application cards are displayed per page, with support for loading more by scrolling.

Each card includes:

Application logo, name, and type (standard web application)
Environment label (Development / Production)
App ID (clickable to copy)

Click anywhere on a card to "Enter Configuration" and quickly navigate to that application's detailed settings page.

Search Applications: A search box in the upper-left corner of the list supports fuzzy searching by application name, allowing you to quickly locate a target application.

3.2 Creating an Application

Click the "Create Application" button in the upper-right corner of the page to open the creation form.

Fill in the information:

Application Name (required): Give your new application an easily identifiable name.
Login Callback URL (required): The address to redirect to after successful user authentication. To configure multiple URLs, separate them with commas.

Submit: After clicking "Create", the system generates the application immediately, and a new card appears at the top of the list. If creation fails, a corresponding prompt will be shown.

Cancel: Click "Cancel" to return to the list page without saving any changes.

4. Top Navigation Bar Explained

4.1 First-Level Navigation (Global Navigation)

Upper Left Corner: Displays the current workspace name (e.g., "Personal Workspace"). Click to expand a dropdown menu:
- Switch Workspace: Lists all workspaces you own. Click to switch.
- Create New Workspace: Quickly create a new workspace.
Application Dropdown Menu (after breadcrumb separator): Appears only when you are on the configuration page of a specific application. Click to expand:
- Current Application Name (displayed at the top)
- Other Applications List: Allows you to quickly switch to another application within the same workspace.
- Create New Application: A shortcut that directly opens the create application form.

4.2 Second-Level Navigation (Workspace Function Tabs)

Located below the first-level navigation, it contains three tabs:

Tab	Description
Applications	The default home page, displaying all application cards under the current workspace.
Team	Manage team members and invitation records.
Settings	Configure the basic information of the current workspace.

5. Team Management

The team feature helps you collaborate with colleagues to jointly manage the applications under the current workspace. On the "Team" page, you can invite members, assign roles, and remove members.

5.1 Member List

Path: Team → Members tab

Field	Description
Email	The team member's login email.
Role	Currently only the "Admin" role is available; more role types will be supported in the future.
Actions	"Delete" button (displayed only for non-creators).

List Features:

Paginated display, 10 entries per page by default.
Supports fuzzy searching by email.
The workspace creator (super admin) cannot delete themselves.

5.2 Deleting a Member

Click "Delete" in the actions column of a member row. A confirmation dialog appears. After clicking "Delete", the member is removed from the workspace and no longer has any permissions.

5.3 Inviting a Member

Path: "+ Invite Member" button in the upper-right corner of the Team page.

Steps:

Enter the email address of the person you are inviting (required).
The role defaults to "Admin" (currently not changeable).
Click "Invite". The system sends an invitation email to that email address.
After the invitee clicks the link in the email and completes registration or login, they successfully join the workspace, and their information automatically appears in the "Members" list.

Invitation Validity: 48 hours from the time of sending. Prompts are shown for successful or failed sending.

5.4 Invitation List

Path: Team → Invitations tab

Displays all sent invitations that have not yet been accepted.

Field	Description
Email	The email address of the invitee.
Role	Admin
Invitation Time	The specific time the invitation was sent.
Actions	"Cancel Invitation", "Re-invite"

List Features:

Paginated display, 10 entries per page by default.
Expired invitations remain in the list and are only removed when manually canceled.
If an invitation has expired and you invite the same email again, the system reuses the existing record, updates the invitation time, and shows a prompt.

Cancel Invitation: Click "Cancel Invitation" to immediately remove the invitation record. The invitee will no longer be able to accept the invitation via the original link.

Re-invite: If the user did not receive the email or the email has expired, you can click "Re-invite". The system will resend the invitation email, and the validity period will be recalculated from the new send time (48 hours). Success or failure of the re-invitation will be indicated.

6. Workspace Settings

Path: Second-level navigation → Settings

Here you can view and modify the basic information of the current workspace.

Field	Description
Name	The display name of the workspace. Editable.
Workspace ID	The system-generated unique identifier. Read-only, cannot be modified.

7. Personal Center

7.1 Access

Click your avatar (or the default avatar icon) in the upper-right corner of the console to expand the dropdown menu:

Account Management: Go to the personal center to manage your account information.
Language: Switch the console interface language (Simplified Chinese / English).
Logout: Log out of your current account.

7.2 Account Management Page

Page Structure:

Top: The workspace name in the upper-left corner is clickable to quickly return to the workspace home page. The "Console" button in the upper-right corner serves the same purpose.
Left Side: A fixed menu with "Account Information".
Right Side: Displays your account details, including:
- Avatar: Supports uploading a new image. Recommended aspect ratio 1:1, maximum size 10 MB. A placeholder icon is provided by default.
- Email: The email used for registration. Cannot be modified.
- Name: Editable. After saving, the display updates.
- Actions: Click the "Edit" button in the upper-right corner to enter edit mode. The buttons then change to "Cancel" and "Save". After making changes, click "Save" to apply them. Success or failure of the operation will be indicated.

7.3 Logout

Select "Logout" from the dropdown menu in the upper-right corner. A confirmation dialog appears. After clicking "Confirm", you will be logged out, redirected to the login page, and your local login state will be cleared.

User Guide