Dette er det kapittelet som gir best avkastning per skrevet linje. Det tar en halv time, det er ikke vanskelig, og det fjerner en hel kategori av problemer som ellers først dukker opp under akseptansetesten — når de er dyre å rette.
Hvorfor det går galt
Fagord virker presise fordi de er presise internt. Hos dere er en «sak» kanskje én søknad. Hos leverandøren, som har levert til fire andre kommuner, er en sak kanskje en mappe som kan inneholde flere søknader. Begge har rett i sin verden. Kravet «systemet skal vise antall åpne saker per saksbehandler» betyr dermed to forskjellige ting, og ingen oppdager det før tallet står på skjermen og er feil.
Det samme gjelder ord som «bruker», «enhet», «avdeling», «kunde», «prosjekt», «dokument» og «vedlegg». De ser uskyldige ut. De er ikke det.
Definer et begrep hvis to fornuftige mennesker kan forstå det ulikt, eller hvis det brukes i et krav der forskjellen får konsekvenser. Ikke definer ord som står i ordboken og betyr det de betyr.
Hvordan en god definisjon ser ut
Sak: En sak i systemet.
Sak: Én byggesøknad med tilhørende dokumenter, fra mottak til endelig vedtak. Klage på vedtak regnes som ny sak med referanse til den opprinnelige. En eiendom kan ha flere saker samtidig.
Aktiv bruker: Ansatt som har logget inn minst én gang de siste 90 dagene. Brukes som grunnlag for lisenstelling.
Frist: Lovpålagt saksbehandlingsfrist etter plan- og bygningsloven, beregnet fra det tidspunktet søknaden er komplett — ikke fra mottak.
Legg merke til at hver definisjon avklarer en kant: hva som skjer med klager, hva «aktiv» betyr i praksis, hvilket tidspunkt fristen løper fra. Det er kantene som koster penger, ikke kjernen.
Ta med forkortelsene også
Interne systemnavn, prosjektnavn, avdelingskoder og bransjeforkortelser. Alt som er selvsagt for dere og uleselig for andre. Det gjør dokumentet lettere å lese for leverandøren, for den nye kollegaen som overtar om to år, og for AI-verktøyene som stadig oftere er første leser.
Definisjonene er bindende
Kravspesifikasjonen blir som regel vedlegg til kontrakten. Da blir definisjonene også bindende, og de leses av noen som leter etter tolkningsrom. Det er en fordel: en klar definisjon er et av de sterkeste virkemidlene du har når det oppstår uenighet om hva som skulle leveres. Se kravtekst som tåler å bli kontrakt.
Bruk derfor definisjonene konsekvent i resten av dokumentet. Har du definert «sak», ikke skriv «henvendelse» tre kapitler senere og mene det samme. Se ordene som ødelegger et krav.
Vanlige feil
- Kapittelet er en ordliste over allmennord. «System: en samling av programvare og maskinvare» hjelper ingen. Definer det som er spesifikt for dere.
- Definisjonene brukes ikke i kravene. Da er de dekorasjon. Søk gjennom dokumentet på hvert definerte ord til slutt.
- Synonymbruk. Sak, henvendelse, søknad og oppgave om hverandre er den vanligste kilden til feil i akseptansetest.
- Definisjoner som skjuler et krav. «Frist: beregnes automatisk av systemet» er ikke en definisjon, det er et krav. Flytt det til kapittel 7.
Dette kapittelet handler om deres ord. De alminnelige begrepene i kravarbeid og anskaffelse — konkurransegrunnlag, SSA, akseptansetest, forvaltning — finner du forklart i ordboken.