Skip to content

Getting Started — Foot Factory

This guide walks through accessing Foot Factory 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 foot-factory 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 Foot Factory

  1. On the End-User Portal (portal.dotevolve.net), you will see an App Card for Foot Factory
  2. The card shows your organisation name as a badge
  3. Click Launch — you are SSO'd directly into Foot Factory at your tenant's subdomain (e.g. acme-corp.foot-factory.dotevolve.net)
sequenceDiagram
    participant U as User
    participant P as portal.dotevolve.net
    participant F as foot-factory.dotevolve.net
    participant A as Foot Factory 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 Foot Factory is enabled
  5. Navigate to Users to invite your team

Step 4 — Configure Your Schema (Super Admin)

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

  1. Log in to foot-factory-admin.dotevolve.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 Foot Factory app and a plan, and are provisioned automatically.