Skip to content

Getting Started — Floorix

This guide walks through accessing Floorix as a new tenant user.

Prerequisites

  • Your organisation has been onboarded by a DotEvolve Super Admin, or you have completed self-signup
  • You have received an invitation email from the Admin Portal
  • Your tenant has been assigned the floorix app

Step 1 — Accept Your Invitation

  1. Open the invitation email from noreply@dotevolve.net
  2. Click Accept Invitation
  3. Set your password on the Supabase Auth page
  4. You are redirected to portal.dotevolve.net

Step 2 — Launch Floorix

  1. On the End-User Portal (portal.dotevolve.net), you will see an App Card for Floorix
  2. The card shows your organisation name as a badge
  3. Click Launch — you are SSO'd directly into Floorix at your tenant's subdomain (e.g. acme-corp.floorix.net)
sequenceDiagram
    participant U as User
    participant P as portal.dotevolve.net
    participant F as floorix.net
    participant A as Floorix API

    U->>P: Click Launch on App Card
    P->>P: Build SSO link with JWT + tenantId
    P->>F: Redirect to /auth/sso?token=JWT&tenantId=ID
    F->>A: Validate JWT via Supabase
    A-->>F: Session established
    F-->>U: Redirect to dashboard

Step 3 — First Login as Tenant Admin

If you are the Tenant Admin for your organisation:

  1. Go to admin.dotevolve.net
  2. Log in with your credentials
  3. Select your tenant from the Tenant Picker
  4. Navigate to App Assignments to verify Floorix is enabled
  5. Navigate to Users to invite your team

Step 4 — Configure Your Schema (Super Admin)

Before your team can use Floorix, a Super Admin must configure the tenant schema:

  1. Log in to admin.floorix.net
  2. Select your tenant
  3. Open Schema Builder
  4. Define Job Steps (e.g. Bottom, Upper, Lower, Polish) with order and pay status
  5. Define Article Attributes (e.g. color, sole, material) with types
  6. Save — the client app picks up the new schema immediately

Roles

Role Access
super-admin Full platform access — tenant provisioning, schema management, plan management
tenant-admin Manage users and view all data within their tenant
user Day-to-day operations — create jobs, update steps, view ledger

Tenant Settings (Admin Portal)

Tenant Admins and Super Admins can manage tenant settings from admin.dotevolve.net → Tenant Detail → Settings tab:

  • Identity — organisation name (slug is read-only after creation)
  • Billing & Status — plan, status (active, suspended, trial)
  • Limits — override maxUsers and maxWorkers per-tenant (takes precedence over plan defaults)
  • Contact Info — admin email, phone, address

Self-Signup

New organisations can sign up directly at portal.dotevolve.net/signup — no admin intervention required. They select the Floorix app and a plan, and are provisioned automatically.