Administrator Management

The Administrator Management Module (/admin) in Work Clock HQ provides workspace executives and super-administrators with complete authority over executive personnel, management permissions, and department delegation.

---

🧭 Navigating Administrator Management

Access Admin from the primary navigation sidebar. The management panel provides real-time visibility into your organization's administrative roster, active security roles, and department oversight assignments.

---

👑 1. Administrator Directory Overview

The directory presents all workspace managers and administrative personnel in a clean tabular view (or responsive mobile card grid):

Table Data Columns

• Administrator Name & Email: Full name and verified email address, with visual avatar initials fallback.
• Admin Classification Badge:
  • 👑 Owner: Primary workspace creator / organization owner.
  • 🛡️ Admin: Executive team member with administrative privileges.
• Assigned Security Role: Custom administrative role assigned to the user (e.g., System Admin, HR Manager, Operations Director). General Staff accounts are excluded from this directory.
• Assigned Department: Specific department over which the administrator exercises management oversight.
• Status Indicator:
  • 🟢 Active: Account is fully activated with active management access.
  • 🔴 Inactive / Pending: Account invitation is pending acceptance or management access is temporarily suspended.
• Actions Menu (...): Quick management options (Edit Admin, Assign Department, Activate / Deactivate, Resend Invitation).

---

🛡️ Core Administrative Governance Rules

Work Clock HQ enforces strict administrative protection policies directly in the interface:

1. Owner Account Protection: Standard administrators cannot modify, edit, or deactivate the primary workspace Owner (admin_type === "owner").
2. Self-Disable Protection: To prevent accidental locked-out states, administrators cannot deactivate their own active accounts.

---

🔍 2. Search & Multi-Filtering Controls

To manage large enterprise teams efficiently, the toolbar provides real-time filtering options:

• Search Bar: Instant filtering by administrator first name, last name, or email address.
• Role Filter Dropdown: Filter administrators by specific custom security roles (e.g. filter only HR Managers or Operations Leads).
• Status Filter Toggles: Switch between Active, Inactive, and All Status views.

---

➕ 3. Provisioning & Editing Administrators

Clicking + Add Administrator opens the provisioning sheet:

Administrative Form Fields

1. First Name & Last Name: Personal identity details of the manager.
2. Email Address: Corporate email address used for workspace authentication and automated alert delivery.
3. Phone Number: Direct contact line for SMS/whatsapp notifications or urgent security alerts.
4. Custom Security Role (role_id): Select an administrative role configured in Roles & Permissions (System Admin, HR Manager, etc.).

---

🏢 4. Delegating Department Oversight

To decentralize management while maintaining security compliance, administrators can delegate oversight for specific departments to individual managers:

1. Click the actions menu (...) on an administrator row and select Assign Department.
2. Select the designated target department (e.g., Operations, Engineering).
3. Once assigned, the administrator receives focused monitoring access and attendance reports specifically for that department's personnel.

---

✉️ 5. Managing Invitations & Status Activation

✉️ Resending Administrative Invitations

If an invited administrator has not accepted their onboarding email or if their link expired, click Resend Invite from the row actions menu to immediately dispatch a fresh activation link.

---

⚡ Instant Access Revocation

Administrators can instantly suspend or reinstate administrative access without deleting the user's account:

• Click Deactivate to transition an account to Inactive status. The user is immediately logged out and prevented from accessing administrative tools.
• Click Activate to instantly restore full management access.

---

🔐 Permission & RBAC Code Reference

Administrative Action	Required Administrative Permission Code
View Administrator Directory	ORGANIZATION_ADMINS.VIEW
Provision New Administrators	ORGANIZATION_ADMINS.CREATE
Edit Administrator Profiles	ORGANIZATION_ADMINS.UPDATE
Toggle Status / Delete Admins	ORGANIZATION_ADMINS.DELETE

---

❓ Frequently Asked Questions

What is the difference between an Owner and an Admin?

The Owner is the primary account creator holding root billing and workspace authority. Standard Admins are executive team members assigned custom security roles by the Owner. Standard Admins cannot modify or deactivate Owner profiles.

Why can't I see general staff in the Administrator Management table?

The /admin module is strictly reserved for executive and managerial accounts. General workforce personnel are managed under the Users / Employees module (/employees).