Account – Settings – Users
- Path:
/account/settings/users(TBD) - Parent:
settings.md
Purpose (business goal)
Section titled “Purpose (business goal)”Manage organization-wide users and invitations.
User roles & permissions
Section titled “User roles & permissions”- Org Admin
- Permissions:
users.manage(TBD)
Reference: Roles & Permissions Model
Layout structure
Section titled “Layout structure”- User directory list
- Invite user flow
- Status (active/invited/suspended)
Components used
Section titled “Components used”TBD
States
Section titled “States”- Empty: TBD (no users / no invitations)
- Loading: fetch users
- Error: unauthorized
- Complete: user directory displayed
Business logic (high-level)
Section titled “Business logic (high-level)”- Invitations and membership drive workspace access.
Domain refs:
API dependencies
Section titled “API dependencies”GET /usersPOST /users/invite
Enterprise constraints
Section titled “Enterprise constraints”- Org-scoped directory; enforce least-privilege access and auditability.
- Large enterprises require pagination, filtering, and safe search (TBD).
Edge cases
Section titled “Edge cases”- User already invited; duplicate invite behavior is TBD.
- User belongs to multiple orgs; ensure correct org context (TBD).
Security & compliance considerations
Section titled “Security & compliance considerations”- Audit invites, suspensions, role changes
Reference: Security & Compliance
Analytics events (if applicable)
Section titled “Analytics events (if applicable)”TBD
Reference: Analytics Events (MVP)