Introduce accounts page

CHANGELOG.md

@@ -15,6 +15,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     on a job running on a node (#663).
   - Add support for running under a subfolder prefix on HTTP server.
   - Add catch-all route to report page not found with button to clusters.
+  - Support requesting accounts and users associations with their limits.
+  - Add page to list account tree from Slurm accounting (#262).
+  - Add entry in left menu to access accounts page.
+  - Add page to get details of a specific account with all its user
+    associations.
+  - Add page to get details of a specific user with all its accounts
+    associations.
+  - Add links to user and account pages in job details page.
 - agent:
   - Automatically discover latest Slurm REST API version supported by
     `slurmrestd` among the list of Slurm-web supported versions declared in
@@ -26,9 +34,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Implement Slurm REST API adapter from v0.0.41 to v0.0.42.
   - Implement Slurm REST API adapter from v0.0.42 to v0.0.43.
   - Implement Slurm REST API adapter from v0.0.43 to v0.0.44.
+  - Add `/associations` route to get list of accounts, users and limits.
 - gateway:
   - Add `/agent/{cluster}/ping` route to reverse-proxy request to agent `/ping`
     endpoint.
+  - Add `/agent/{cluster}/associations` route to reverse-proxy request to agent
+    `/associations` endpoint.
   - Possibility to validate agent SSL/TLS certificate with custom CA certificate
     as an alternative to system default CA certificates (#254).
   - Replace at runtime base path placeholder in pre-built UI assets by URL path
@@ -42,6 +53,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     supported Slurm REST API versions.
   - Introduce `[agents]` > `cacert` gateway parameter for custom path to CA
     certificate to validate agent SSL/TLS certificate.
+  - Introduce `associations-view` action in authorization policy.
+  - Add permission on `associations-view` to all authenticated users in default
+    authorization policy.
+  - Introduce `[filters]` > `associations` parameter in agent configuration.
+  - Introduce `[cache]` > `associations` parameter in agent configuration.
 - cli: Introduce `slurm-web` unified executable with subcommands (#655).
 - docs: Add manpage for unified `slurm-web` command.
 
@@ -89,7 +105,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   command.
 
 ### Fixed
-- front: Dark mode rendering of info and error messages in clusters list (#661).
+- front:
+  - Dark mode rendering of info and error messages in clusters list (#661).
+  - Re-initialize all jobs filters in runtime store as soon as a filter is
+    present in query.
 - gateway: Use agent provided version instead of agent minimal version from
   settings to reverse proxy the requests (#656).
 - front: Update dependencies to fix CVE-2025-64718 (js-yaml), CVE-2025-64756

README.md

@@ -34,7 +34,7 @@ Many features in a reactive & responsive web UI:
 * Colored badges to visualize job status at a glance
 * GPU resources utilization monitoring
 * Advanced visualization of node status with racking topology
-* Intuitive visualization of QOS and advanced reservations
+* Intuitive visualization of account tree, QOS and advanced reservations
 * Dark mode support
 * Multi-clusters support
 * LDAP authentication (including Active Directory support)

assets/screenshots/build.yaml

@@ -32,4 +32,6 @@ shadowed:
 - screenshot_cores_tablet.png
 - screenshot_qos.png
 - screenshot_reservations.png
+- screenshot_accounts_tree.png
+- screenshot_account_page.png
 - screenshot_perms.png

conf/vendor/agent.yml

@@ -340,6 +340,17 @@ filters:
     doc: |
       List of accounts fields selected in slurmrestd API, all other fields are
       filtered out.
+  associations:
+    type: list
+    content: str
+    default:
+    - account
+    - max
+    - parent_account
+    - qos
+    - user
+    doc: |
+      List of associations fields selected in slurmrestd API, all other fields are filtered out.
 
 policy:
   definition:
@@ -483,6 +494,10 @@ cache:
     type: int
     default: 60
     doc: Expiration delay in seconds for accounts in cache
+  associations:
+    type: int
+    default: 120
+    doc: Expiration delay in seconds for associations in cache
 
 metrics:
   enabled:

conf/vendor/policy.yml

@@ -14,6 +14,9 @@ actions:
     Get _QOS_ entry in main menu and permission to view the list of defined QOS.
   view-accounts: |
     Permission to filter jobs by account.
+  associations-view: |
+    Get _Accounts_ entry in main menu and permission to view the list of
+    associations (accounts, users and limits).
   view-reservations: |
     Get _Reservations_ entry in main menu and permission to view the list of
     defined reservations.

dev/conf/policy.ini.j2

@@ -18,7 +18,7 @@ special={{ users[3].login }}
 actions=view-stats,view-jobs
 
 [admin]
-actions=view-stats,view-jobs,view-nodes,view-partitions,view-qos,view-accounts,view-reservations,cache-view,cache-reset
+actions=view-stats,view-jobs,view-nodes,view-partitions,view-qos,view-accounts,associations-view,view-reservations,cache-view,cache-reset
 
 [special]
 actions=view-qos

dev/crawler/agent.py

@@ -52,6 +52,7 @@ def __init__(
             Asset("qos", "qos", self._crawl_qos),
             Asset("reservations", "reservations", self._crawl_reservations),
             Asset("accounts", "accounts", self._crawl_accounts),
+            Asset("associations", "associations", self._crawl_associations),
             Asset(
                 "metrics-nodes-hour",
                 "metrics-nodes-hour",
@@ -159,6 +160,12 @@ def _crawl_accounts(self):
             "accounts",
         )
 
+    def _crawl_associations(self):
+        self.dump_component_query(
+            f"/v{get_version()}/associations",
+            "associations",
+        )
+
     def _crawl_metrics_nodes_hour(self):
         if self.metrics:
             self.dump_component_query(

dev/crawler/gateway.py

@@ -226,6 +226,7 @@ def __init__(
             Asset("qos", "qos", self._crawl_qos),
             Asset("reservations", "reservations", self._crawl_reservations),
             Asset("accounts", "accounts", self._crawl_accounts),
+            Asset("associations", "associations", self._crawl_associations),
             Asset("racksdb", "racksdb-draw-coordinates", self._crawl_racksdb),
             Asset(
                 "metrics",
@@ -803,6 +804,12 @@ def _crawl_accounts(self):
             "accounts",
         )
 
+    def _crawl_associations(self):
+        self.dump_component_query(
+            f"/api/agents/{self.cluster.name}/associations",
+            "associations",
+        )
+
     def _crawl_racksdb(self):
         # RacksDB infrastructure diagram
         self.dump_component_query(

dev/crawler/slurmrestd.py

@@ -188,6 +188,7 @@ def __init__(
             Asset("qos", "slurm-qos", self._crawl_qos),
             Asset("accounts", "slurm-accounts", self._crawl_accounts),
             Asset("reservations", "slurm-reservations", self._crawl_reservations),
+            Asset("associations", "slurmdb-associations", self._crawl_associations),
         }
 
         super().__init__(
@@ -840,3 +841,10 @@ def _crawl_reservations(self):
             f"/slurm/v{self.api_version}/reservations",
             "slurm-reservations",
         )
+
+    def _crawl_associations(self):
+        # Download associations
+        self.dump_component_query(
+            f"/slurmdb/v{self.api_version}/associations",
+            "slurmdb-associations",
+        )

docs/modules/conf/examples/agent.ini

@@ -434,6 +434,22 @@ reservations=
 accounts=
   name
 
+# List of associations fields selected in slurmrestd API, all other fields are
+# filtered out.
+#
+# Default value:
+# - account
+# - max
+# - parent_account
+# - qos
+# - user
+associations=
+  account
+  max
+  parent_account
+  qos
+  user
+
 [policy]
 
 # Path to RBAC policy definition file with available actions
@@ -588,6 +604,11 @@ reservations=60
 # Default value: 60
 accounts=60
 
+# Expiration delay in seconds for associations in cache
+#
+# Default value: 120
+associations=120
+
 [metrics]
 
 # Determine if metrics feature and integration with Prometheus (or

docs/modules/conf/partials/conf-agent.adoc

@@ -685,6 +685,30 @@ filtered out.
 * `name`
 
 
+|-
+
+|associations
+|list[str]
+|List of associations fields selected in slurmrestd API, all other fields are filtered out.
+
+
+
+
+
+*Default:*
+
+
+* `account`
+
+* `max`
+
+* `parent_account`
+
+* `qos`
+
+* `user`
+
+
 |-
 
 
@@ -1055,6 +1079,17 @@ _No default value_
 
 |-
 
+|associations
+|int
+|Expiration delay in seconds for associations in cache
+
+
+
+
+*Default:* `120`
+
+|-
+
 
 |===
 

docs/modules/conf/partials/policy-actions.adoc

@@ -36,6 +36,11 @@ compute nodes in cluster with their status in Slurm.
 |Permission to filter jobs by account.
 
 
+|associations-view
+|Get _Accounts_ entry in main menu and permission to view the list of
+associations (accounts, users and limits).
+
+
 |view-reservations
 |Get _Reservations_ entry in main menu and permission to view the list of
 defined reservations.

docs/modules/overview/images/screenshot_account_page.png

@@ -0,0 +1 @@
+../../../../assets/screenshots/shadowed/screenshot_account_page.png

docs/modules/overview/images/screenshot_accounts_tree.png

@@ -0,0 +1 @@
+../../../../assets/screenshots/shadowed/screenshot_accounts_tree.png

docs/modules/overview/pages/overview.adoc

@@ -103,6 +103,27 @@ job-specific GPU usage, and troubleshoot — without needing deep knowledge of
 Slurm's CLI commands. This streamlined visibility significantly improves
 productivity and resource efficiency in GPU-accelerated workloads.
 
+== Account Hierarchy
+
+Slurm-web provides an interactive accounts page that displays the account
+hierarchy for each cluster. This feature enables users and administrators to:
+
+- **Visualize Account Structure:** Display parent/child account relationships in
+  a tree view, helping users and admins understand project or organizational
+  hierarchies at a glance.
+- **Intuitive Insights:** Inspect account-specific information, such as resource
+  limits with visual representation of their overrides, associated users, and
+  QOS assignments, directly from the interface.
+- **Easy Navigation:** Links allow you to traverse account structures, with
+  users and their associations.
+
+image::screenshot_accounts_tree.png[width=80%]
+
+image::screenshot_account_page.png[width=80%]
+
+The accounts interface streamlines account management, improves clarity into
+Slurm account policies, and reduces the need for complex CLI queries.
+
 == Advanced Reservations
 
 Resources can be pre-allocated for a particular usage in Slurm with *advanced

frontend/src/components/MainMenu.vue

@@ -16,7 +16,8 @@ import {
   PlayCircleIcon,
   CpuChipIcon,
   SwatchIcon,
-  XMarkIcon
+  XMarkIcon,
+  UserGroupIcon
 } from '@heroicons/vue/24/outline'
 import { TagIcon } from '@heroicons/vue/16/solid'
 
@@ -41,6 +42,12 @@ const navigation = [
     route: 'reservations',
     icon: CalendarIcon,
     permission: 'view-reservations'
+  },
+  {
+    name: 'Accounts',
+    route: 'accounts',
+    icon: UserGroupIcon,
+    permission: 'associations-view'
   }
 ]
 </script>