Overview#

AI Workforce OS is a multi-tenant HR and workforce management platform. It combines core HR record-keeping (employees, organization structure), operational HR (attendance, leave, payroll, compensation), talent modules (recruitment, performance, learning), operational tools (tasks, assets), and an AI platform layer, behind a single web application and a public API.

The system is built as a web application (desktop, tablet, and mobile browsers) with an installable Progressive Web App (PWA) mode. There is no separate native iOS or Android app.

Purpose#

This page orients new users and administrators before they touch any other part of the documentation. Read this first, then move to Installation if you are deploying the system, or straight to your role's module (Employee, Manager, HR Admin) if the system is already running.

Prerequisites#

  • None to read this page. Later pages assume you know your role: Employee, Manager, HR Admin, or System/IT Administrator.

Step-by-Step Instructions#

Who should use each part of the system#

  1. Employees use the Employee Self-Service (ESS) portal to view their profile, clock in/out, request leave, view payslips, and complete learning assignments.
  2. Managers use the Manager Self-Service (MSS) portal to view their team, approve attendance/leave requests, and see team reports.
  3. HR Administrators use the HR Admin console for employee records, bulk operations, onboarding/offboarding, compliance, and organization-wide reporting.
  4. System/IT Administrators use the Administration area for tenant setup, org structure, security settings (MFA/SSO/SCIM), and integrations.
  5. Developers use the Public API and SDKs to integrate AI Workforce OS with other systems.

Screens Involved#

📷
[Screenshot: Login screen]
📷
[Screenshot: Main dashboard (role-dependent)]
📷
[Screenshot: Sidebar navigation]

Expected Results#

After reading this page you should know which portal to open for your role and where to find setup instructions if you are standing up a new tenant.

Common Mistakes#

  • Employees trying to use the HR Admin console instead of the ESS portal (most day-to-day self-service tasks live in ESS, not HR Admin).
  • Assuming a mobile app exists in an app store — the mobile experience is a browser-based PWA, not a native app. See Mobile App.

Troubleshooting#

I do not know which portal to log into.#

There is one login screen for all roles. After signing in, the system routes you to the dashboard that matches your assigned role and permissions. Contact your HR Administrator if your role looks wrong.

FAQ#

Is AI Workforce OS a mobile app?

It is a responsive web application with an installable Progressive Web App (PWA) mode — you can "Add to Home Screen" from a supported mobile browser. There is no separate app-store app. See Mobile App for details.

What browsers are supported?

The latest two versions of Chrome, Firefox, Safari, and Edge, plus the latest two versions of iOS Safari. Internet Explorer is not supported.

Do I need to install anything to use the system as an employee?

No. A supported web browser is enough. Installing the PWA is optional and only adds offline access and push notifications.

Best Practices#

  • Bookmark your specific portal URL (ESS, MSS, or HR Admin) once your administrator has confirmed it, rather than navigating from a generic homepage each time.
  • Keep your browser updated to one of the supported versions listed in System Requirements below.