Invite Staff

🎬 Simulate:

Search and Filter

Search Email

Status

Institution

Clear Filters

Invitation List 7 invitations

Email	Role	Institution	Status	Invited At	Action
khamla.v@skillslao.la	Central Review	—	Pending	25/06/2026 09:15
navaphone.k@skillslao.la	Super Administrator	—	Pending	25/06/2026 10:00
bounmy.s@ptc.edu.la	Program Administrator	Pakse Technical College	Pending	24/06/2026 14:30
somsak.i@skillslao.la	Central Review	—	Activated	10/06/2026 11:00	—
bounpheng.l@skillslao.la	Tag Administrator	—	Activated	15/06/2026 14:20	—
phongsan.k@ptc.edu.la	Program Administrator	Pakse Technical College	Expired	25/05/2026 08:45	—
sengphet.v@skillslao.la	Sale Administrator	—	Expired	20/05/2026 09:30	—

Screen Flow (from flow.puml):

📝 Spec notes — UC-IDP.04 / SCR-IDP.54 (fields, actions, requirements)

Identity

Screen: SCR-IDP.54 — Provision Staff (entry page)
Use case: UC-IDP.04 — Provision Staff Account
Zone rendering: Global Zone (Super Administrator) — all institutions; Program Administrator / Super Administrator / Central Review / Tag Administrator / Sale Administrator (no Instructor) — toggle via ?zone=pa|sa
Embedded dialogs: SCR-IDP.17 — Invite Staff Form · SCR-IDP.18 — Invitation Results

Brief description

Main page for managing staff invitations — Admin views all invitations (Pending / Activated / Expired). Program Administrator (My Institute zone) sees only invitations for their own institution; Super Administrator (Global zone) sees all institutions. Page title and invite button label adapt to the navigation zone (AR-5). Rows with status Pending show a "Copy Link" button so the Admin can obtain the activation link via another channel. The invite button opens the multi-recipient form (SCR-IDP.17).

Regions

Page actions — page title (adapts per zone) + primary invite button
Search and filter — keyword (email) + status filter + institution filter (SA Global zone only)
Invitation list — table; Institution column shown in SA view only; Copy Link per-row for Pending rows
Empty state — visible when list_count == 0; two variants: (a) no invitations in scope, (b) search / filter returns no results

Fields

keyword "Search Email" — text · always
filter_status "Status" — enum [all, pending, activated, expired] · UserInvitation.status · default: all · always
filter_institution "Institution" — enum · Institute.name · visible only when zone == global (SA); hidden entirely for PA — institution context is active Working Institute, applied server-side [refs: SS-IDP.31]
col_email "Email" — UserInvitation.email · read-only · always
col_role "Role" — Role.name via UserInvitationRole · read-only
col_institution "Institution" — Institute.name via UserInvitation.institution_id · read-only · column visible in SA view; hidden in PA view (institution implicit from scope)
col_status "Status" — enum [pending, activated, expired] · UserInvitation.status · read-only
col_invited_at "Invited At" — datetime · UserInvitation.invited_at · read-only
empty_message — text · visible when list_count == 0

Actions

invite_staff "Invite Staff" — enabled always · triggers UC-IDP.04-M-2 · opens SCR-IDP.17 dialog
search "Search" — enabled always
clear_filters "Clear Filters" — enabled when any_filter_active
copy_link "Copy Link" — per-row · enabled when row.status == pending · clipboard action · no navigation

Additional requirements

Program Administrator: invitations scoped to active Working Institute (server-side); filter_institution hidden entirely in My Institute zone. Super Administrator: all institutions; filter_institution visible and selectable. [refs: SS-IDP.31]
"Copy Link" shown and enabled only for rows where col_status == pending; Activated / Expired rows show no action in the Action column.
Empty state variants: (a) no invitations in scope → "No staff invitations in this scope" + invite CTA; (b) search / filter no results → "No invitations match the search criteria" + Clear Filters button.
List auto-refreshes when Admin returns from invitation creation (UC-IDP.04-M-6).
Page title and button label adapt to zone — My Institute (PA): "Invite Instructors"; Global Zone (SA): "Invite Staff". [refs: SS-IDP.31]

↳ Embedded dialog: SCR-IDP.17 — Invite Staff Form (type: dialog)

Brief: Dialog to invite multiple back-office staff at once. Shared Settings (Role + Institution) apply to every email in the batch. PA zone: Role pre-selected as Instructor (read-only); Institution pre-filled as own institution (read-only). SA zone: Role = chip-multiselect across all 5 roles; Institution conditional — visible + required for institute-scoped roles (Instructor, Program Administrator); hidden for system-wide roles (Super Administrator, Tag Administrator, Sale Administrator). Inline per-row warning only for a pending invitation on the same email (AF-5B) — an email already belonging to an existing account is invited silently (no warning), handled by UC-IDP.03.

Regions: Shared settings · Email list · Form actions

Fields:

roles "Role(s)" — enum multi-select chip · required · PA: Instructor pre-selected, read-only; SA: Program Administrator, Super Administrator, Central Review, Tag Administrator, Sale Administrator (Instructor excluded — PA-only) · UserInvitationRole.role_id
institution "Institution(s)" — enum · PA: own institution pre-filled, read-only; SA: conditional chip-multiselect — visible + required for institute-scoped roles; hidden for system-wide roles · UserInvitation.institution_id
email "Email" — text per row · required · format: email · max 255 · UserInvitation.email

Actions:

add_email "Add Email" — always
remove_email "Remove" — enabled when email_count > 1; disabled at 1 row (minimum)
send_invitation "Send Invitation" — enabled when required_fields_valid · triggers UC-IDP.04-M-4
cancel "Cancel" — always · closes dialog
revoke_and_resend "Revoke Previous Invitation and Resend" — visible on AF-5B flagged rows
skip_recipient "Skip This Recipient" — visible on AF-5B flagged rows

Additional requirements:

Role options filtered by actor authority: PA → Instructor only (read-only); SA → Program Administrator, Super Administrator, Central Review, Tag Administrator, Sale Administrator (Instructor is PA-only — not shown in Global Zone).
Institution: PA → own institution pre-filled, read-only, single value; SA → conditional multi-select per selected role type.
An email that already belongs to an existing account is invited without any warning here — the outcome (already has this role vs. role added to existing account) is handled downstream by UC-IDP.03 AF 1B / AF 1C. A pending (not yet activated) invitation for the same email still triggers a separate warning (next item).
Inline warning "A pending invitation already exists for this email" + choice buttons (AF-5B).
Minimum 1 email row; Remove disabled when email_count == 1. Max rows: TBD.
Keyboard focus order: Role(s) → Institution(s) → email rows → Add Email → Send Invitation → Cancel. [refs: NFR-09]

↳ Embedded dialog: SCR-IDP.18 — Invitation Results (type: dialog)

Brief: Read-only results dialog "Invitation Results" shown after submitting SCR-IDP.17. Summary header shows batch context (role, institution when institute-scoped, count "X of Y invitations created successfully" in warning style when X < Y). Per-row: Email, Status (sent / email_delivery_failed / error), Activation Link with Copy button (for sent + failed rows) or Reason text (for error rows). Expiry notice when any row is sent or email_delivery_failed. Close returns to SCR-IDP.54 with refreshed list.

Fields:

summary_count — "X of Y invitations created successfully"; warning style when X < Y
batch_role "Role" — Role.name via UserInvitationRole · always
batch_institution "Institution" — visible when batch role is institute-scoped (Instructor, Program Administrator) · Institution.name
batch_expiry_notice — "All activation links expire at [datetime] (48 hours)" · visible when any row ∈ [sent, email_delivery_failed] · AuthToken.expires_at · default TTL 48 hours [SS-IDP.34]
result_recipient_email, result_email_status, result_activation_link, result_error_reason — per-row columns

Actions + additional requirements:

copy_link "Copy" — per-row · enabled when status ∈ [sent, email_delivery_failed] · aria-label="Copy activation link for [email]" · toast "Link copied" (aria-live="polite") [refs: NFR-09]
close "Close" — triggers UC-IDP.04-M-6; list refreshes
email_delivery_failed rows must show note "Email delivery failed" alongside the link. [refs: none]
Back-office web portal only — mobile not applicable. [refs: NFR-12]

Shared Settings (applied to all recipients)

Role(s) *

Institution(s) (institute-scoped roles only)

Hidden for system-wide roles (Super Administrator, Central Review, Tag Administrator, Sale Administrator)

Email Addresses

Email *

Remove

2 of 2 invitations created successfully. Activation emails have been sent to all recipients.

Role: Central Review

Email	Status	Activation Link / Reason
somsak.v@@skillslao.la	Sent
khamla.v@@skillslao.la	Sent

Link copied