lablup / lablup/backend.ai-webui
Expose Fair Share Factor (FSF) to general users
- Dominant language
- TypeScript
- Stars
- 133
- Forks
- 81
- Avg merge
- 1d 11h
- Merged PRs (30d)
- 344
Description
## Background
Discussion about whether to expose FSF (Fair Share Factor) to general (non-admin) users in the WebUI. The intent is to help users understand where they can get resources allocated faster.
## Problem
The current WebUI session creation flow uses a **Project → Resource Group** selection hierarchy. However, FSF is calculated per resource group, so the meaningful comparison hierarchy is the inverse: **Resource Group → Project**.
For FSF to be actually useful to a user, they need to answer the question:
> **"Within a given resource group, which project should I pick to get my session allocated faster?"**
This requires comparing FSF values **across projects within a single resource group**, which doesn't fit the existing session-creation UI.
## Proposed approach
Because the comparison axis doesn't match the existing UI, FSF cannot be cleanly embedded into the session-creation flow. Instead, expose it as a **separate, dedicated view**.
### 1. "My FSF by Resource Group" view (modal or page)
- Matrix layout: **Resource Groups (rows) × Projects (columns)**, or vice versa.
- Each cell shows the user/project's current FSF value within that resource group.
- Cells include a brief explanation of what the value means (e.g., higher = higher scheduling priority within fair-share comparisons).
- Helps the user answer: **"Which (resource group, project) combination gives me the best scheduling position right now?"**
### 2. FSF detail view
- Drill-down from a cell to a per-(user/project) detail view.
- Shows the **bucket history** that contributed to the current FSF.
- Shows the **calculation logic** (or a simplified representation of it) so the user can understand **why** the value is what it is, not just what it is.
## Open questions
- Where should the entry point live? (User dashboard? Resource group detail page? Top-level menu?)
- How frequently should the matrix refresh?
- Do we need to show only the resource groups/projects the user belongs to, or all visible ones?
- Backend: is there an existing API to fetch FSF per (user, resource group, project) tuple, or does this require a new endpoint?
## Origin
Internal Teams discussion — see attached web link.
JIRA Issue: FR-2799
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.