Screen MapDashboard
Users
Dashboard: every screen, state and flow in Users.
18 screens and overlays, 70 states, 2 flows. Frames show a real screenshot where one was captured and a wireframe card where the state needs data or conditions a device run cannot produce.
Flows
Users administration
Open a user
Edit User
Save
Wireframe
Edit User
Success
User updated
Toast then redirect to detail
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Branches and edge cases
Edgefrom step 1
Edgefrom step 1
Gatefrom step 1
Edgefrom step 1
Wireframe
Restore User
Needs data: Needs a user with status deleted
Errorfrom step 1
Wireframe
Change User Role
Edge
Self target blocked
Toast: Cannot modify your own role
Not captured yet
Edgefrom step 1
Gatefrom step 1
Edgefrom step 1
Wireframe
Bulk Edit
Success
Bulk result
Toast: N processed, M failed
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Gatefrom step 2
Gatefrom step 2
Edgefrom step 3
Wireframe
Edit User
Edge
No changes detected
Info toast when nothing changed
Not captured yet
Errorfrom step 3
Wireframe
Edit User
Error
Update failed
Failure toast or inline destructive alert
Not reachable on a device: Needs a server error, crash, race or code change
Flow diagram
Routine steps
Add Step
Wireframe
Add or Edit Routine Step
Edge
New step order
New steps get max display order + 1 per routine
Not captured yet
Save
Wireframe
Routine Steps Configuration
Success
Order updated
Toast after drag reorder
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Delete a step
Branches and edge cases
Emptyfrom step 1
Wireframe
Routine Steps Configuration
Empty
No steps configured
AM and PM tables with create CTA
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Errorfrom step 1
Wireframe
Routine Steps Configuration
Error
Reorder failed
Toast: Failed to update order
Not reachable on a device: Needs a server error, crash, race or code change
Errorfrom step 2
Wireframe
Add or Edit Routine Step
Error
Save failed
Toast via mutationErrorMessage
Not reachable on a device: Needs a server error, crash, race or code change
Errorfrom step 4
Wireframe
Delete Routine Step
Error
Step in use
Server refuses when products are tagged with the step
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Errorfrom step 4
Wireframe
Routine Steps Configuration
Error
Delete blocked
Server: products are assigned to this routine step
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Flow diagram
Screens and states
User Management
Screen
dashboard/usersUser Management
Search, filter and administer accounts.
src/app/dashboard/users/page.tsxEntry
- Sidebar Users
- Audit log target user links
- Detail back buttons
Exits
- View → /dashboard/users/id
- Edit → /dashboard/users/id/edit
- Row menu → status, role, delete dialogs
- Bulk edit → drawer
- Export → ExportDialog
States · 8
Loading
Table skeleton · loading.tsx plus table skeleton
src/features/user-management/components/user-tables/index.tsx:93Empty
No users found · Also shown for filters with no results
src/features/user-management/components/user-tables/index.tsx:105Edge
Search mode · Role, status filters applied client side; loyalty filters ignored, hint shown
src/features/user-management/components/user-listing.tsx:140Edge
Pagination · Server side via page and perPage URL params, counter badges
src/features/user-management/components/user-listing.tsx:319Edge
Loyalty sort page only · Loyalty sort re-ranks only the loaded page
src/features/user-management/components/user-listing.tsx:180Edge
Rows selected · Selection badge N selected and Bulk edit button
src/features/user-management/components/user-listing.tsx:350Edge
User with no app profile · Shown as role apps, status active, loyalty em dash
src/features/user-management/components/user-listing.tsx:188Gate
Admin required · AccessDenied below admin
src/app/dashboard/users/page.tsx:16Change User Status
Dialog
ChangeUserStatusDialogChange User Status
Confirm suspend or activate of one account.
src/features/user-management/components/user-tables/cell-action.tsx:396Entry
- Row menu Change Status (admin)
Exits
- Confirm → ban or unban
- Cancel
States · 3
Success
Status changed · Toast: name is now status
src/features/user-management/components/user-tables/cell-action.tsx:124Error
Server refused · Toast with server message; admin target needs super_admin
src/features/user-management/components/user-tables/cell-action.tsx:126Edge
Self target blocked · Toast: Cannot modify your own account status
src/features/user-management/components/user-tables/cell-action.tsx:103Change User Role
Dialog
ChangeUserRoleDialogChange User Role
Confirm a role change (super_admin only).
src/features/user-management/components/user-tables/cell-action.tsx:433Entry
- Row menu Change Role (super_admin)
Exits
- Confirm → update role
- Cancel
States · 3
Success
Role changed · Toast: name is now role
src/features/user-management/components/user-tables/cell-action.tsx:157Edge
Self target blocked · Toast: Cannot modify your own role
src/features/user-management/components/user-tables/cell-action.tsx:139Error
Server refused · Only super_admin may grant admin tiers or edit admin targets
packages/backend/convex/auth/mutations.ts:2166Delete User
Dialog
DeleteUserDialogDelete User
Soft delete an account (super_admin in UI).
src/features/user-management/components/user-tables/cell-action.tsx:461Entry
- Row menu Delete (super_admin)
Exits
- Confirm → soft delete
- Cancel
States · 2
Success
User deleted · Toast: name has been deleted
src/features/user-management/components/user-tables/cell-action.tsx:187Edge
Self target blocked · Toast: Cannot delete your own account
src/features/user-management/components/user-tables/cell-action.tsx:172Permanently Delete User
Dialog
HardDeleteUserDialogPermanently Delete User
Irreversible delete (super_admin only).
src/features/user-management/components/user-tables/cell-action.tsx:519Entry
- Row menu Permanently Delete
Exits
- Confirm → hard delete
- Cancel
States · 2
Success
Permanently deleted · Toast: has been permanently deleted
src/features/user-management/components/user-tables/cell-action.tsx:217Edge
Self target blocked · Toast: Cannot delete your own account
src/features/user-management/components/user-tables/cell-action.tsx:202Restore User
Wireframe
Restore User
Needs data: Needs a user with status deleted
Dialog
RestoreUserDialogRestore User
Restore a deleted account.
src/features/user-management/components/user-tables/cell-action.tsx:489Entry
- Row menu Restore (status deleted)
Exits
- Confirm → restore
- Cancel
States · 2
Success
User restored · Toast: has been restored
src/features/user-management/components/user-tables/cell-action.tsx:249Edge
Self target blocked · Toast: Cannot restore your own account
src/features/user-management/components/user-tables/cell-action.tsx:234Bulk Edit
Sheet
BulkActionsSheetBulk Edit
Apply activate, suspend, restore or delete to up to 500 users.
src/features/user-management/components/bulk-actions-sheet.tsx:130Entry
- Bulk edit button with rows selected
Exits
- Apply → Confirm Bulk Action dialog
- Cancel
States · 4
Edge
Selected users preview · List of selected users before applying
src/features/user-management/components/bulk-actions-sheet.tsx:158Success
Bulk result · Toast: N processed, M failed
src/features/user-management/components/bulk-actions-sheet.tsx:103Error
Bulk failed · Toast with server message
src/features/user-management/components/bulk-actions-sheet.tsx:115Edge
Rows skipped by server · Self, admins (non-super), super_admins, and User not found per row
packages/backend/convex/auth/mutations.ts:2686Captured states
Confirm Bulk Action
Dialog
BulkConfirmDialogConfirm Bulk Action
Required confirm for all four bulk actions.
src/features/user-management/components/bulk-actions-sheet.tsx:299Entry
- Apply in Bulk Edit drawer
Exits
- Confirm → bulk update
- Cancel
States · 1
Edge
Warning copy · Suspend and delete show a warning in the confirm
src/features/user-management/components/bulk-actions-sheet.tsx:327Captured states
User Detail
Screen
dashboard/users/[id]User Detail
Read-only 360 view of one account with five tabs.
src/app/dashboard/users/[id]/page.tsxEntry
- Users list View
- Recent Sales link
- Audit log target links
- Loyalty, voucher, stamp rows
Exits
- Back to Users → /dashboard/users
- Edit User → /dashboard/users/id/edit
- Stamp row → /dashboard/orders/id
- Campaign row → /dashboard/loyalty/campaigns/id
States · 13
Loading
Skeleton · Skeleton plus Suspense fallback
src/features/user-management/components/user-detail-client.tsx:49Error
User not found or error · Alert with Back to Users; no userProfiles row gives not found
packages/backend/convex/auth/queries.ts:812Gate
Admin required · AccessDenied: You need permission to view user details
src/features/user-management/components/user-detail-client.tsx:54Empty
No campaigns joined · Loyalty tab, Active Campaigns
src/features/user-management/components/sections/campaigns-section.tsx:67Empty
No seasonal claims yet · Loyalty tab
src/features/user-management/components/sections/seasonal-section.tsx:54Empty
No stamps earned yet · Loyalty tab, Stamp History
src/features/user-management/components/sections/stamp-history-section.tsx:68Empty
No vouchers in this filter · Vouchers Held filter tabs
src/features/user-management/components/sections/vouchers-held-section.tsx:119Empty
No purchase history · Activity tab
src/features/user-management/components/sections/purchases-tab.tsx:158Empty
No engagement activity · Activity tab
src/features/user-management/components/sections/engagement-tab.tsx:205Empty
No security information · Security tab
src/features/user-management/components/sections/security-tab.tsx:19Empty
No notifications sent yet · Settings tab
src/features/user-management/components/sections/notifications-tab.tsx:157Edge
Award bonus stamps disabled · Admin actions menu item is permanently disabled, tagged soon
src/features/user-management/components/sections/admin-actions.tsx:22Edge
Shopify link badge · Integrations shows Linked or Unlinked
src/features/user-management/components/sections/integrations-tab.tsx:49Reset campaign progress?
Dialog
ResetCampaignProgressDialogReset campaign progress?
Reset one user's stamps and position in a campaign.
src/features/user-management/components/sections/campaigns-section.tsx:272Entry
- Campaign row More actions menu
Exits
- Confirm → reset progress
- Cancel
States · 3
Success
Progress reset · Toast: Campaign progress reset
src/features/user-management/components/sections/campaigns-section.tsx:136Error
Reset failed · Failure toast
src/features/user-management/components/sections/campaigns-section.tsx:139Edge
No client role gate · Only the admin page gate protects it; server needs admin
packages/backend/convex/gamificationLoyalty/mutations.ts:2091Revoke voucher?
Dialog
RevokeVoucherDialogRevoke voucher?
Delete a voucher held by the user.
src/features/user-management/components/sections/vouchers-held-section.tsx:294Entry
- Held voucher row action
Exits
- Confirm → revoke voucher
- Cancel
States · 3
Success
Voucher revoked · Toast: Voucher revoked
src/features/user-management/components/sections/vouchers-held-section.tsx:180Error
Revoke failed · Failure toast
src/features/user-management/components/sections/vouchers-held-section.tsx:183Success
Code copied · Copy-code button toast
src/features/user-management/components/sections/vouchers-held-section.tsx:170Stamp History
Wireframe
Stamp History
Needs data: Needs a user with stamps
Sheet
StampHistorySheetStamp History
Read-only side sheet listing all stamps.
src/features/user-management/components/sections/stamp-history-section.tsx:76Entry
- Loyalty tab Stamp History View all
Exits
- Row → /dashboard/orders/id
States · 1
Empty
No stamps earned yet · No stamp rows
src/features/user-management/components/sections/stamp-history-section.tsx:68All Vouchers
Sheet
AllVouchersSheetAll Vouchers
Read-only side sheet listing all held vouchers.
src/features/user-management/components/sections/vouchers-held-section.tsx:131Entry
- Loyalty tab Vouchers Held View all
Exits
- Redeemed row → /dashboard/orders/id
States · 1
Empty
No vouchers in this filter · Filter tab has no rows
src/features/user-management/components/sections/vouchers-held-section.tsx:119Edit User
Screen
dashboard/users/[id]/editEdit User
Edit one account's profile, role, status and preferences.
src/app/dashboard/users/[id]/edit/page.tsxEntry
- Users list Edit
- Detail Edit User (admin)
Exits
- Save → /dashboard/users/id
- Cancel → detail (unsaved check)
- Back to Users → /dashboard/users
States · 9
Loading
Skeleton · Edit form skeleton
src/features/user-management/components/user-edit-client.tsx:36Error
User profile not found · Destructive alert
src/features/user-management/components/user-edit-client.tsx:58Gate
Admin required · AccessDenied: You need permission to edit users
src/features/user-management/components/user-edit-client.tsx:40Edge
Own profile locked · Role and status read-only on your own profile
src/features/user-management/components/forms/user-edit-form.tsx:141Edge
Role options limited · Admin sees all but super_admin; pending and deleted status disabled
src/features/user-management/components/forms/user-edit-form.tsx:240Edge
No changes detected · Info toast when nothing changed
src/features/user-management/components/forms/user-edit-form.tsx:87Success
User updated · Toast then redirect to detail
src/features/user-management/components/forms/user-edit-form.tsx:125Error
Update failed · Failure toast or inline destructive alert
src/features/user-management/components/forms/user-edit-form.tsx:130Edge
Unsaved changes · UnsavedChangesDialog on dirty form leave
src/features/user-management/components/forms/user-edit-form.tsx:722Create New User
Screen
dashboard/users/newCreate New User
Explainer page; dashboard does not create users.
src/app/dashboard/users/new/page.tsxEntry
- None found, URL only
Exits
- Back to Users → /dashboard/users
- Manage Existing Users → /dashboard/users
States · 4
Gate
Super admin required · AccessDenied: You need permission to create users; plain admin denied
src/app/dashboard/users/new/page.tsx:28Empty
Onboarding steps only · Page explains three steps; there is no form submit
src/features/user-management/components/forms/user-create-form.tsx:55Edge
Dead success handler · Toast and redirect code in page is unreachable
src/app/dashboard/users/new/page.tsxEdge
Unreachable inner denial · isAdmin branch text is unreachable in practice
src/features/user-management/components/forms/user-create-form.tsx:25Routine Steps Configuration
Screen
dashboard/users/routine-stepsRoutine Steps Configuration
Configure skincare routine steps used by the mobile beauty profile.
src/app/dashboard/users/routine-steps/page.tsxEntry
- Sidebar Users > Routine Steps
Exits
- Add Step → step form dialog
- Row menu Edit, enable, Delete
- Drag handle → reorder
- Active switch → toggle
States · 8
Loading
Auth loading · Loading... while auth resolves
src/app/dashboard/users/routine-steps/page.tsx:207Gate
Admin required · Route gate plus a redundant inline Access Denied block
src/app/dashboard/users/routine-steps/page.tsx:226Empty
No steps configured · AM and PM tables with create CTA
src/app/dashboard/users/routine-steps/_components/routine-table.tsx:128Empty
All tab empty · All-steps table empty text
src/app/dashboard/users/routine-steps/_components/all-steps-table.tsx:76Success
Order updated · Toast after drag reorder
src/app/dashboard/users/routine-steps/_components/routine-table.tsx:102Error
Reorder failed · Toast: Failed to update order
src/app/dashboard/users/routine-steps/_components/routine-table.tsx:104Error
Invalid routine step · Create validates the step name against a fixed list
src/app/dashboard/users/routine-steps/page.tsx:101Error
Delete blocked · Server: products are assigned to this routine step
packages/backend/convex/beauty/mutations.ts:562Add or Edit Routine Step
Dialog
StepFormDialogAdd or Edit Routine Step
Create or update one routine step.
src/app/dashboard/users/routine-steps/_components/step-form-dialog.tsx:105Entry
- Add Step button
- Row menu Edit
Exits
- Submit → create or update step
- Cancel
States · 2
Edge
New step order · New steps get max display order + 1 per routine
src/app/dashboard/users/routine-steps/page.tsx:110Error
Save failed · Toast via mutationErrorMessage
src/app/dashboard/users/routine-steps/page.tsxDelete Routine Step
Dialog
DeleteRoutineStepDialogDelete Routine Step
Confirm deleting a step; may affect tagged products.
src/app/dashboard/users/routine-steps/page.tsx:389Entry
- Row menu Delete
Exits
- Confirm → delete step
- Cancel
States · 1
Error
Step in use · Server refuses when products are tagged with the step
packages/backend/convex/beauty/mutations.ts:562