Onboarding Flow¶

Trigger¶

New employee or pilot customer needs access to SmartKitten.

Flow¶

sequenceDiagram
  participant U as User
  participant FE as Frontend
  participant ACC as Account
  participant ORG as Organization
  participant BIL as Billing

  U->>FE: Open register
  FE->>ACC: POST register
  ACC-->>U: Verification email
  U->>ACC: Verify email
  U->>FE: Login
  FE->>ACC: POST login
  ACC-->>FE: JWT
  alt Create org
    U->>ORG: Create organisation
  else Join org
    U->>ORG: Join by tagline
  end
  FE->>BIL: Load subscription
  BIL-->>FE: Plan and entitlements
  FE-->>U: Workspace home

Steps¶

1. User opens registration; provides credentials and organisation tagline (join) or creates new org.
2. Account service stores user; sends verification email (Resend).
3. User verifies email via link.
4. User logs in; receives JWT with sub, org, role.
5. Organization service confirms membership (or creates org + owner).
6. Frontend loads subscription from Billing; displays plan on profile.
7. User lands in workspace (playground / user hub).

Outcome¶

Active user inside exactly one organisation with verified email and visible entitlements.

Plan constraints¶

Free tier may limit tokens, devices, and vision from first login.

Failure modes¶