Förstudie

Start / Statistikverktyg_(Vklass_analys) / Förstudie

Förstudie: Statistikverktyg (Vklass Analys)

Nuläge

Vklass har idag ett proof of concept, src/VklassAnalys, som portar legacy WebReports-rapporter till en fristående webbyta: frånvaro (organisation/skola/elev), omdömen, betyg, nationella prov och kartläggningsmaterial. POC:ns UI är tabelltungt, navigationen är en enkel rapportlista och filterpanelen är inte anpassad till produktens fulla rapportmängd. Intent-specen (dokument 178) slår fast att POC:ns skärmbilder inte är designfacit — UI, navigation och komponentval ska designas om. En tidigare mockupkörning (Statistikverktyg_(Vklass_analys)/2) visade rätt innehåll men fick feedbacken att menysystem och filter inte skalar till antalet rapporter och att datavisualiseringen behöver lyftas rejält.

Problem

Skolchefer, rektorer och mentorer behöver följa upp verksamheten enligt skollagens krav på systematiskt kvalitetsarbete, men dagens rapporter är utspridda, tabelltunga och saknar sammanhang. Det går inte att på ett ställe se frånvaro, omdömen, betyg och nationella prov tillsammans, jämföra mot organisationssnitt eller förstå om ett tomt resultat beror på verklighet eller på saknad registrering. Antalet rapportfamiljer (17 st i produktens målbild) gör att en platt rapportlista och en generisk filterpanel inte räcker.

Önskat läge (varför mockupen)

Mockupen visar hela Vklass Analys som en dashboardlik analysportal — den bästa learning analytics-ytan bland konkurrenterna (Unikum Kvalitet, IST Analyse, InfoMentor, SchoolSoft, PowerSchool, Arbor). Den demonstrerar: (1) en grupperad, rollstyrd rapportnavigation som skalar till hela rapportlistan, (2) en kontextfilterrad som anpassar sig per rapport, (3) KPI-kort, trenddiagram, fördelningsstaplar, heatmaps, sparklines och benchmark-markörer som kompletterar tabellerna, (4) flerdomänsvyer där närvaro, omdömen, betyg och nationella prov möts i samma vy, och (5) transparens som differentiering: måttkatalog/rapportfaktablad, analysmognadsetiketter, datakälla + synktid och diagnostiska tomma lägen på varje rapport.

Avgränsning

I scope: rollvyerna organisationsadministratör (admin.html), rektor (rektor.html), mentor/ämneslärare (teacher.html) samt åtkomstgräns-/transparensvyer för elev (student.html) och vårdnadshavare (custodian.html); rapportfamiljerna frånvaro, omdömen, betyg, nationella prov, kartläggning, inloggning/adoption, early warning (Bilaga B), saknade omdömen, oregistrerade lektioner, tvärdomänsanalys, förskola/fritids, samtycken, kvalitetsarbete/årsjämförelser/benchmark samt export, måttkatalog och datakvalitetslägen.

Out of scope: stöd-/riskaggregat, uppgifter/prov, överlämningar, planeringar/dokumentation (kräver källspike/produktbeslut — visas endast som låsta navigationsposter), ClickHouse-/synk-backend, auth, prediktiv AI, automatiska utskick samt all form av små-urvalsskydd/suppression (uttryckligen borttagen ur produkten i intent-specens revision).

Personas

  • Organisationsadministratör: Anders Bergman (T5000-001), Nordängens kommun (org 217, alla 7 skolenheter)
  • Rektor/skoladmin: Magnus Widén (T5004-007), biträdande rektor Proximaskolan (5004)
  • Lärare/mentor: Kerstin Berg (T5004-002), lärare och mentor för 7A, Proximaskolan
  • Elev: Anna Andersson (S5004-701), åk 7, klass 7A, Proximaskolan
  • Vårdnadshavare: Eva Andersson (C5004-701A), vårdnadshavare för Anna

Kira-grundning

Kira MCP är inte tillgängligt i denna runtime; grundningen tas från intent-specens verifierade preflights (dokument 178 avsnitt 0, Bilaga A avsnitt 2, Bilaga B avsnitt 2–3):

  • Rapportlogik och beräkningar finns verifierade i src/VklassAnalys (controllers/services per domän) — mockupens rapportinnehåll speglar dessa.
  • Betyg: "snittbetyg" och "meritvärde" hålls isär; meritvärde kräver 16-ämnesregeln (GradeSummary.MeritRating, chunk 97bc2df4).
  • Omdömesnivåer: 1 = behov av stödinsatser, 2 = godtagbara kunskaper, 3+ = mer än godtagbara (chunk d9a50ad6).
  • Frånvarovarningar: skolkonfigurerade trösklar (20 h ogiltig, 40 % total som standard), nattlig uppdatering, ingen automatik (Bilaga B 3.3).
  • Kartläggning: årskurser F/1/3, progress 1–7 → röd/gul/grön (Bilaga A 6.8).
  • Datakvalitetsstatusar: ok, no_source_data, module_not_used, sync_missing, partial, unknown_mapping (Bilaga A 9.3, utan small_sample som utgår).
  • Att verifiera senare (ej blockerande för mockup): NP-formulärmappning per provtyp (visas som unknown_mapping/partial-läge i mockupen).

Extern research (websök i denna körning)

  • Max 4 headline-KPI:er + 8–12 KPI:er totalt på första skärmen; trendpil + delta per kort; alert-panel "att agera på" överst (Asataura Services; Customer Science "5-second rule").
  • Diagramval per fråga: linje för trend, staplar för jämförelse/fördelning, heatmap för mönster, sparkline för kompakt trend, benchmark-markörer mot snitt; undvik paj för jämförelser (InetSoft Visualization Selection Tree; tardy.xyz).
  • Visa alltid datumfönster, nämnare/underlag och datakälla nära varje sektion — bygger förtroende (findanomaly.ai; Springer 2025 EasyVis: "clearly display the source of the data within each section … to build trust").
  • Jämför mot egen föregående period först, sedan organisationssnitt; undvik skampåle-rankingar (tardy.xyz; intent-spec 5.20).
  • Rollpaketering slår generisk BI: separata vyer för lärare/mentor, rektor, huvudman (SAGA-research; konkurrentbenchmark §4).