🏠 Overview â€ș 🎯 Features â€ș🎯 Team Reports

Team Reports

Feature Detail

medium complexity extracted Reporting & Export Confidence: 100%
7
Components
2
Shared
0
User Stories
Yes
Analyzed

Description

Team Reports provide organization administrators with aggregated views of activity, peer mentor performance, and operational metrics across their teams. The reports support filtering by date range, local association, role, and activity type, and present the data in tabular and chart form for in-portal review. This area underpins day-to-day oversight before any external (Bufdir) export is generated, giving Org Admins a single place to verify data quality, spot gaps, and follow up with coordinators where activity logging has lagged or looks inconsistent.

Sources & reasoning

The area taxonomy lists Team Reports as a feature of admin-reporting, and the MVP scope for the Admin Web Portal explicitly includes activity overview and basic statistics - Team Reports is the in-portal aggregation surface that delivers this.

Analysis

Business Value

Team Reports give organization administrators the operational oversight they need to manage peer mentor programs effectively. Coordinators and Org Admins today rely on Word/Excel aggregation; the in-portal reporting view removes that manual step and gives them a current-state picture of activity volume, distribution across local associations, and gaps in reporting. The feature is foundational for Bufdir reporting (same underlying data) and for spotting issues - under-reporting, inactive mentors, uneven workload - early enough to intervene. Without it the admin portal cannot deliver its core promise of replacing spreadsheet-based oversight.

Implementation Notes

Implementation aggregates data from activities, peer_mentors, coordinators, and member_associations tables with tenant-scoped queries (organization_id filter enforced at the API layer). Server-side aggregation in the Next.js API avoids shipping raw activity rows to the browser. Use parameterized SQL with indexes on activity date and organization_id for performance on larger orgs. Charting via a lightweight client library (e.g. Recharts) keeps bundle size manageable. Reports must respect the multi-organization hierarchy and surface only data the admin is scoped to. Filters and date ranges are URL-bound for shareability.

Quality Assurance

Organization Administrator (primary) · Global Administrator (subject view, only when time-bounded support access is granted)
2
Scenarios
11
UAT Steps
30
A11y Annotations
4
Role Boundaries
Organization Administrator

Organization Administrator

Quick UAT

  1. Logg inn i Admin-portalen som Organisasjonsadministrator og Ă„pne Rapportering → Team Reports.
  2. Sett tidsperiode til 'Siste 30 dager', filtrer pÄ rolle 'Koordinator' og velg en spesifikk lokal forening.
  3. Bekreft at dashbordet viser oppdaterte aggregerte tall for aktiviteter, utlegg og engasjement for valgte filtre.
  4. Trykk pÄ en koordinator i listen for Ä Äpne drill-down med individuelle ytelsesdata.
  5. GĂ„ tilbake til oversikten og trykk Eksporter → CSV.
  6. Bekreft at CSV-filen lastes ned og inneholder de samme aggregerte tallene som vises pÄ skjermen.
  7. Gjenta eksporten med valg PDF og bekreft at PDF-en Ă„pnes med dashboard-visningen.

Quick UAT — Accessibility

  1. Logg inn i Admin-portalen som Organisasjonsadministrator og Ă„pne Rapportering → Team Reports.
    • Screen reader Sideoverskrift 'Team Reports' annonseres ved sideinnlasting; tab-rekkefĂžlge: hovedmeny → sidetittel → filterpanel → dashboard.
    • Keyboard / focus Navigasjonsmenyen nĂ„s via Tab; Enter Ă„pner Rapportering-undermenyen; piltaster navigerer mellom rapporttyper.
    • Focus visibility Synlig fokusring (≄ 3:1 kontrast) pĂ„ alle menyelementer; aktiv side markert med bĂ„de farge og symbol.
  2. Sett tidsperiode til 'Siste 30 dager', filtrer pÄ rolle 'Koordinator' og velg en spesifikk lokal forening.
    • Screen reader Hver filter-kontroll annonseres med label og valgt verdi; endringer leses opp som 'Filter oppdatert'.
    • Keyboard / focus Filterpanel nĂ„s med Tab; dropdowns Ă„pnes med Enter eller mellomrom; piltaster velger; Esc lukker.
    • Focus visibility Tydelig fokusring pĂ„ alle filterkontroller; valgt verdi vises bĂ„de med farge og tekst.
    • Live region 'Filter oppdatert. Viser data for siste 30 dager, rolle Koordinator, lokal forening valgt.'
  3. Bekreft at dashbordet viser oppdaterte aggregerte tall for aktiviteter, utlegg og engasjement for valgte filtre.
    • Screen reader KPI-kort annonseres med 'Aktiviteter: <antall>', 'Utlegg: <belĂžp>', 'Engasjement: <verdi>'; diagrammer har tekstalternativ.
    • Zoom Dashboard er brukbart ved 200 % zoom; tabeller og diagrammer reflower uten horisontal scrolling under 320 CSS px.
    • Contrast Tall og labels har minst 4.5:1 kontrast; status/trender er ikke kommunisert kun gjennom farge (ogsĂ„ ikon eller +/- tekst).
  4. Trykk pÄ en koordinator i listen for Ä Äpne drill-down med individuelle ytelsesdata.
    • Screen reader Radene annonseres som 'klikkbar rad, koordinatornavn, antall aktiviteter'; ny side annonseres med oppdatert sideoverskrift.
    • Keyboard / focus Tab navigerer til tabellen; piltaster flytter mellom rader; Enter Ă„pner drill-down.
    • Focus visibility Synlig fokusring pĂ„ aktiv rad; ved retur til oversikten flyttes fokus tilbake til den Ă„pnede raden.
    • Touch target Radenes klikkflate er ≄ 24×24 CSS px.
  5. GĂ„ tilbake til oversikten og trykk Eksporter → CSV.
    • Screen reader Eksporter-knapp annonseres som 'Eksporter, knapp, har undermeny'; CSV-alternativet leses opp ved navigasjon.
    • Keyboard / focus Eksporter Ă„pnes med Enter eller mellomrom; piltaster navigerer i undermenyen; Esc lukker.
    • Focus visibility Fokus settes pĂ„ fĂžrste menyelement nĂ„r undermenyen Ă„pnes; returnerer til knappen nĂ„r menyen lukkes.
  6. Bekreft at CSV-filen lastes ned og inneholder de samme aggregerte tallene som vises pÄ skjermen.
    • Screen reader Status annonseres: 'CSV-eksport ferdig. Filen er lastet ned.'
    • Live region 'CSV-eksport ferdig. Filen team-reports.csv er lastet ned.'
  7. Gjenta eksporten med valg PDF og bekreft at PDF-en Ă„pnes med dashboard-visningen.
    • Screen reader Status annonseres: 'PDF-eksport ferdig. Filen er lastet ned.'
    • Focus visibility Etter eksport returneres fokus til Eksporter-knappen.
    • Live region 'PDF-eksport ferdig. Filen team-reports.pdf er lastet ned.'
Global Administrator subject view

Global Administrator

Quick UAT

  1. Logg inn i Admin-portalen som Global Administrator uten aktiv stĂžttetilgang og bekreft at Team Reports for en spesifikk organisasjon IKKE er tilgjengelig.
  2. FÄ Organisasjonsadministrator til Ä aktivere tidsbegrenset stÞttetilgang i Organisasjonsinnstillinger og last siden pÄ nytt.
  3. Åpne organisasjonens Rapportering → Team Reports og bekreft at dashbordet vises med samme data som Organisasjonsadministrator ser.
  4. Bekreft at handlingen er logget i organisasjonens revisjonsspor som 'Global Admin viste Team Reports'.

Quick UAT — Accessibility

  1. Logg inn i Admin-portalen som Global Administrator uten aktiv stĂžttetilgang og bekreft at Team Reports for en spesifikk organisasjon IKKE er tilgjengelig.
    • Screen reader Tilgang-nektet-side annonserer 'Ingen tilgang til denne organisasjonens data. StĂžttetilgang ikke aktivert.'
    • Focus visibility Fokus settes pĂ„ feilmelding ved sideinnlasting; lenke 'Tilbake til oversikt' har synlig fokusring.
  2. FÄ Organisasjonsadministrator til Ä aktivere tidsbegrenset stÞttetilgang i Organisasjonsinnstillinger og last siden pÄ nytt.
    • Keyboard / focus Reload via tastatur (F5) bevarer fokus i hovedinnholdet.
    • Live region 'StĂžttetilgang aktivert til <dato>. Organisasjonens data er nĂ„ tilgjengelig.'
  3. Åpne organisasjonens Rapportering → Team Reports og bekreft at dashbordet vises med samme data som Organisasjonsadministrator ser.
    • Screen reader Sideoverskrift annonseres med organisasjonsnavn og 'StĂžttetilgang aktiv til <dato>'.
    • Contrast Banner som indikerer aktiv stĂžttetilgang har 4.5:1 kontrast og bruker bĂ„de farge og ikon.
  4. Bekreft at handlingen er logget i organisasjonens revisjonsspor som 'Global Admin viste Team Reports'.
    • Screen reader Revisjonslogg-oppfĂžring annonseres med tidsstempel, brukernavn og handling.
    • Keyboard / focus Revisjonsloggens tabell er navigerbar med piltaster; rad Ă„pnes med Enter.

Role Boundaries

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

    Logger kun inn i mobilappen; Admin Web Portal har ingen pÄloggingsmulighet for rollen. Deep-link til /admin/reporting/team-reports returnerer 403 / omdirigeres til mobil-info-side.

  • Coordinator (Koordinator)

    Logger kun inn i mobilappen; har ikke admin-portal-tilgang. Deep-link til Team Reports-siden returnerer 403.

  • Global Administrator

    Uten aktiv tidsbegrenset stĂžttetilgang gir Ă„pning av en spesifikk organisasjons Team Reports 403; navigasjonsoppfĂžringen for organisasjonsdata er skjult inntil tilgang er gitt av Organisasjonsadministrator.

  • Prospective Buyer

    Har ingen brukerkonto i Admin Web Portal. PĂ„loggingsside avviser; deep-link til /admin/reporting/team-reports omdirigerer til offentlig salgsside.

Expected End State

  • Organization Administrator

    Organisasjonsadministrator ser oppdatert Team Reports-dashbord filtrert etter valgte kriterier og har lastet ned CSV- og PDF-eksport som matcher visningen. Eksporthandlingen er fĂžrt i revisjonsloggen.

  • Global Administrator

    NĂ„r tidsbegrenset stĂžttetilgang er aktiv, kan Global Admin Ă„pne Team Reports for den aktuelle organisasjonen; visningen er identisk med Org Admins, og Ă„pningen er logget i organisasjonens revisjonsspor. Uten aktiv tilgang er siden utilgjengelig.

Components (9)

User Interface (3)

ui Team Reports Screen medium ui Team Reports Page medium ui Custom Report Builder medium

Service Layer (3)

service Team Stats Service medium service Team Report Service medium service Custom Report Service medium

Data Layer (1)

data Report Definition Store medium

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.