meta {
  name: List Roles
  type: http
  seq: 2
}

get {
  url: {{appview_url}}/api/admin/roles
}

assert {
  res.status: eq 200
  res.body: isArray
}

docs {
  List all available roles for the forum.

  **Requires:** Authentication (any authenticated user can view roles)

  Query params: None

  Returns:
  [
    {
      "id": "1",
      "name": "Owner",
      "description": "Forum owner with full control",
      "permissions": ["*"],
      "priority": 0
    },
    {
      "id": "2",
      "name": "Admin",
      "description": "Can manage forum structure and users",
      "permissions": [
        "space.atbb.permission.manageCategories",
        "space.atbb.permission.manageRoles",
        ...
      ],
      "priority": 10
    },
    ...
  ]

  Roles are sorted by priority (Owner first, Member last).

  Error codes:
  - 401: Not authenticated
  - 500: Database error

  Notes:
  - Wildcard permission ("*") grants all permissions (Owner role)
  - Lower priority value = higher authority
}