Account – Settings – Organizations

Route

• Path: /account/settings/organizations (TBD)
• Parent: settings.md

Purpose (business goal)

Manage org-level information and governance across multiple workspaces/brands.

User roles & permissions

• Org Admin
• Permissions: org.manage (TBD)

Reference: Roles & Permissions Model

Layout structure

• Org profile (name, billing owner, policies)
• Workspace list overview (link)

Components used

TBD

States

• Empty: TBD
• Loading: fetch org profile
• Error: unauthorized / org not found
• Complete: org profile view/edit

Business logic (high-level)

• Org policies constrain workspace settings and app behavior.

Domain refs:

• Domain: Workspaces
• Roles & Permissions Model

API dependencies

• GET /org
• PUT /org

Enterprise constraints

• Org settings apply across multiple workspaces; enforce least-privilege access and strong auditing.
• Multi-workspace isolation must not be broken by org-level views (e.g., only show what the admin is authorized to access).

Edge cases

• User is a workspace admin but not an org admin → deny or render read-only (TBD).
• Org has many workspaces/users → pagination/performance constraints (TBD).

Security & compliance considerations

• Audit org policy changes

Reference: Security & Compliance

Analytics events (if applicable)

TBD

Reference: Analytics Events (MVP)