Team — Staff Directory & Onboarding | Client App Specification

Employee Onboarding & Invitation Flow

graph TD
    A[Team Roster] --> B[Click Add Employee]
    B --> C[Fill Name, Role & Wage Rate]
    C --> D[Generate 4-Digit Kiosk PIN]
    D --> E[Send SMS Invite Link]
    E --> F[Employee Completes Profile & eSign]

Sitemap Location & Position

Client App → People Workspace

Team (/client-app/team.html)

• Linked Parent: /today.html

• Linked Child: /documents.html

Page Guardrails & Constraints

Unique PIN Collision Check

Ensures no two active employees share the same 4-digit terminal PIN within an org.

Page Backend Sequence

sequenceDiagram
    autonumber
    actor Owner
    participant UI as Team UI
    participant API as Supabase API
    participant DB as PostgreSQL

    Owner->>UI: Submit Invite Form
    UI->>API: POST /api/v2/team/invite
    API->>DB: Create User Profile & Generate Unique PIN
    DB-->>API: 201 Created
    API-->>UI: Return Invite SMS Dispatch Status

Component Inventory Entry

Component	Type	Design System Token
Team Member Avatar List	Avatar Grid	components/data-display/17-avatars.html
Add Staff Drawer	Modal Sheet	components/feedback/29-modals.html

Team — Staff Directory & Onboarding

Page Visual Switcher

Employee Onboarding & Invitation Flow

Sitemap Location & Position

Page Guardrails & Constraints

Page Backend Sequence

Component Inventory Entry