lablup / lablup/backend.ai-webui

Expose Fair Share Factor (FSF) to general users

Open
#7,217 0 comments 0 reactions 0 assignees View on GitHub
discussion fsf UX
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.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.