🏠 Overview › 🎯 Features ›🎯 Dashboard KPIs

Dashboard KPIs

Feature Detail

medium complexity extracted Admin Dashboard Confidence: 100%
3
Components
18
Shared
0
User Stories
Yes
Analyzed

Description

The Dashboard KPIs feature provides organization administrators with a real-time overview of key performance indicators on the Admin Web Portal home screen. It aggregates data across activities, peer mentors, and expenses to surface metrics such as total activities logged, active peer mentor counts, pending approval queues, and expense totals. The screen serves as the primary landing view after login, giving admins immediate situational awareness of organizational health without navigating to individual report sections.

Sources & reasoning

Line 195 explicitly names dashboards and KPIs as a core Admin Web Portal capability. Line 158 classifies the admin panel as MUST HAVE in Fase 1 (MVP). Line 326 confirms activity overview and basic statistics are in the MVP admin scope, directly motivating a KPI-centric landing screen for immediate operational visibility without manual navigation.

Analysis

Business Value

Dashboard KPIs serve as the operational nerve center for organization administrators, delivering immediate situational awareness on login without requiring manual report generation. By surfacing aggregated metrics on the home screen, administrators can identify bottlenecks, track peer mentor engagement, and monitor expense approval queues at a glance, reducing time spent navigating disparate sections. For multi-organization deployments the KPIs are tenant-scoped, reinforcing data isolation between organizations. The feature also supports the Bufdir reporting pipeline by exposing data-completeness indicators, helping admins spot gaps before generating official reports and reducing the risk of submission errors.

Implementation Notes

Dashboard KPIs are implemented as a Next.js server-side rendered page fetching aggregated metrics from dedicated API endpoints scoped to the authenticated organization. Each KPI card queries the shared PostgreSQL database with tenant-enforced filters at the API layer. Metrics include activity counts, approval queue depths, peer mentor status breakdowns, and expense totals. React Server Components handle the initial load; selective client-side polling via SWR provides near-real-time updates on critical counters. KPI cards are modular components allowing future additions without layout changes, and role-based visibility rules ensure global admins and org admins see appropriately scoped subsets.

Quality Assurance

Organization Administrator (primary) · Global Administrator (primary, requires support access grant)
2
Scenarios
9
UAT Steps
26
A11y Annotations
3
Role Boundaries
Organization Administrator

Organization Administrator

Quick UAT

  1. Logg inn i Admin-portalen som Organisasjonsadministrator. Bekreft at dashbordet lastes som første side etter innlogging.
  2. Bekreft at dashbordet viser KPI-kort for: totalt antall registrerte aktiviteter, antall aktive likepersoner, antall ventende godkjenninger og total utleggssum.
  3. Kontroller at alle KPI-verdier kun viser data tilhørende din egen organisasjon (leietakerisolasjon).
  4. Trykk på KPI-kortet for ventende godkjenninger og bekreft at du navigeres til aktivitetsoversikte-siden med godkjenningskøen forhåndsfiltrert.
  5. GĂĄ tilbake til dashbordet og trykk Oppdater (eller last siden pĂĄ nytt). Bekreft at KPI-verdiene oppdateres uten feilmelding.

Quick UAT — Accessibility

  1. Logg inn i Admin-portalen som Organisasjonsadministrator. Bekreft at dashbordet lastes som første side etter innlogging.
    • Screen reader Sideoverskrift 'Dashbord' annonseres ved sidelasting; tab-rekkefølge starter fra topp-navigasjon.
    • Keyboard / focus Innloggingsskjema nĂĄs med Tab; Enter sender skjemaet.
    • Focus visibility Synlig fokusring pĂĄ e-post- og passordfeltet; feilmeldinger kobles til felt via aria-describedby.
  2. Bekreft at dashbordet viser KPI-kort for: totalt antall registrerte aktiviteter, antall aktive likepersoner, antall ventende godkjenninger og total utleggssum.
    • Screen reader Hvert KPI-kort annonseres med etikett og verdi, f.eks. 'Registrerte aktiviteter: 142'.
    • Keyboard / focus KPI-kortene er nĂĄbare med Tab i logisk rekkefølge fra øverst til venstre.
    • Contrast 4.5:1 for tallverdier og etiketter; trendpil formidler ikke status kun via farge — tekst eller ikon-label supplerer.
  3. Kontroller at alle KPI-verdier kun viser data tilhørende din egen organisasjon (leietakerisolasjon).
    • Zoom Alle fire KPI-kort og etikettene er lesbare ved 200% zoom uten horisontal scrolling.
    • Contrast Organisasjonsnavnet i sidetittelen har minst 4.5:1 kontrast mot bakgrunnen.
  4. Trykk på KPI-kortet for ventende godkjenninger og bekreft at du navigeres til aktivitetsoversikte-siden med godkjenningskøen forhåndsfiltrert.
    • Screen reader Kortet annonseres som klikkbar lenke med destinasjon, f.eks. 'Ventende godkjenninger: 7 – lenke til Til godkjenning'.
    • Keyboard / focus Kortet aktiveres med Enter eller Space; fokus flyttes til toppen av destinasjonssiden.
    • Focus visibility Synlig fokusring rundt hele kortarealet.
    • Touch target KPI-kortet er minst 24Ă—24 CSS px; i praksis et fullt kortareal.
  5. GĂĄ tilbake til dashbordet og trykk Oppdater (eller last siden pĂĄ nytt). Bekreft at KPI-verdiene oppdateres uten feilmelding.
    • Keyboard / focus Oppdater-knapp (om tilgjengelig) nĂĄs med Tab og aktiveres med Enter.
    • Focus visibility Fokus forblir pĂĄ Oppdater-knappen etter oppdatering, eller returnerer til første KPI-kort.
    • Live region Polite live region annonserer 'Dashbord oppdatert' nĂĄr nye verdier er lastet inn.
Global Administrator

Global Administrator

Quick UAT

  1. Logg inn i Admin-portalen som Global Administrator. Bekreft at ingen organisasjonsspesifikke KPI-er vises som standard — kun platformnivå-navigasjon er tilgjengelig.
  2. Naviger til Organisasjoner og velg en organisasjon som har gitt Global Administrator tidsbegrenset støttetilgang. Bekreft at tilgangsperioden er aktiv og synlig.
  3. Ă…pne dashbordet for den valgte organisasjonen og bekreft at KPI-kortene vises med data scoped til kun den organisasjonen.
  4. Bekreft at en revisjonshendelse for støttetilgangsøkten er opprettet i organisasjonens revisjonslogg.

Quick UAT — Accessibility

  1. Logg inn i Admin-portalen som Global Administrator. Bekreft at ingen organisasjonsspesifikke KPI-er vises som standard — kun platformnivå-navigasjon er tilgjengelig.
    • Screen reader Sideoverskrift annonseres uten organisasjonsnavn; ingen KPI-verdier annonseres i standardvisning.
    • Keyboard / focus Tab-navigasjon dekker platformnivĂĄ-menyene; ingen tomme eller usynlige fokusobjekter for skjult innhold.
    • Focus visibility Synlig fokusring pĂĄ alle tilgjengelige menyvalg.
  2. Naviger til Organisasjoner og velg en organisasjon som har gitt Global Administrator tidsbegrenset støttetilgang. Bekreft at tilgangsperioden er aktiv og synlig.
    • Screen reader Utløpsdato for støttetilgang annonseres som tekst, ikke kun visuell fargeindikator.
    • Keyboard / focus Organisasjonslisten er søkbar og navigerbar med piltaster; Enter velger organisasjon.
    • Contrast Statusindikator for aktiv tilgang formidler ikke tilstand kun via farge — ledsages av tekst.
  3. Ă…pne dashbordet for den valgte organisasjonen og bekreft at KPI-kortene vises med data scoped til kun den organisasjonen.
    • Screen reader Sideoverskrift inkluderer organisasjonsnavn, f.eks. 'Dashbord – NHF'; KPI-kort annonseres med etiketter og verdier.
    • Zoom KPI-kortgrid forblir lesbart ved 200% zoom.
    • Contrast 4.5:1 for alle KPI-etikett- og verditekster.
  4. Bekreft at en revisjonshendelse for støttetilgangsøkten er opprettet i organisasjonens revisjonslogg.
    • Screen reader Tabellkolonneoverskrifter annonseres for hver rad i revisjonsloggen.
    • Keyboard / focus Revisjonslogg-lenken nĂĄs med Tab; loggoppføringer er tabellrader med logisk tab-rekkefølge.

Role Boundaries

3 role(s) must NOT access this feature
  • Peer Mentor

    Admin-portalen finnes ikke i mobilappens navigasjon; direkte URL til admin-portalen returnerer 401/403 og viser innloggingssiden for admin uten tilgang.

  • Coordinator

    Koordinatorer logger ikke inn i Admin-portalen; direkte URL returnerer 401/403. Ingen dashbord-KPI-er er tilgjengelige fra mobilappen.

  • Prospective Organization Representative

    Ikke-autentisert bruker; all tilgang til Admin-portalen returnerer 401 og omdirigerer til innloggingssiden.

Expected End State

Dashbordet viser oppdaterte KPI-verdier scoped til riktig organisasjon. Organization Administrator ser sin egen organisasjons data. Global Administrator ser kun data for organisasjoner der tidsbegrenset støttetilgang er innvilget og aktiv.

Components (21)

User Interface (2)

ui AdminDashboardPage medium ui KpiCardWidget medium

Service Layer (1)

service DashboardKpiService medium

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.