Kravdokument for apper: hva en appspesifikasjon er og hvorfor du godkjenner den

Spesifikasjonen på én side du godkjenner først: forsidebilde til Deployflix-blogginnlegget

Et kravdokument for en app, eller en appspesifikasjon, er en kort skriftlig plan for en app før noen bygger den: hvem som skal bruke den, skjermbildene hver av dem ser, informasjonen den tar vare på, tjenestene den kobles til, hva som er utelatt foreløpig og hva byggingen maksimalt kan koste. Du leser den, stiller spørsmål ved den og endrer den, og først når den beskriver appen du faktisk vil ha, godkjenner du den.

Du godkjenner den først fordi en spesifikasjon er det billigste stedet å finne en feil. Å flytte en linje på en side koster ingenting. Å finne ut etter byggingen at lærerne kan se alle foreldrenes telefonnumre, eller at avgifter ikke kan betales i avdrag, betyr å bygge på nytt.

Hva er en programvarespesifikasjon, forklart enkelt?

I programvare er en spesifikasjon (i større prosjekter ofte kalt et kravdokument, eller SRS, for software requirements specification) avtalen mellom den som trenger appen og den som bygger den. Den sier hva appen skal gjøre, ikke hvordan koden gjør det. For en butikk, en klubb eller en skole er én side som regel nok, så lenge den er konkret og skrevet med enkle ord.

Testen av en spesifikasjon er enkel: kunne to ulike byggere lest den og laget omtrent samme app? Hvis siden sier elevene kan se resultatene sine, er det et ønske. Hvis den sier en elev logger inn med telefonnummer og ser karakterene fra sine egne prøver, etter fag, ved siden av gjennomsnittet for gruppen, er det et krav noen kan bygge og du kan sjekke.

Hva står i et kravdokument på én side for en app?

Tenk deg et leksehjelpsenter som vil ha en app for timer, oppmøte og avgifter. En nyttig spesifikasjon på én side for det har disse delene:

Del av spesifikasjonenHva den sierEksempel for et leksehjelpsenter
Hvem som bruker denHver type person som logger inn, og hva de har lov til å gjøreEier, lærere, elever og foreldre; bare eieren ser avgiftssummene
Skjermbilder per rolleSidene hver rolle ser og hva de gjør derLærer: dagens timer, registrere oppmøte, legge inn prøveresultater. Forelder: oppmøte, resultater, avgifter som forfaller
Data som lagresRegistrene appen lagrer og hva hvert av dem inneholderElever, klasser, oppmøte per økt, prøver og resultater, avdrag og kvitteringer
IntegrasjonerEksterne tjenester den kobles til, og hvordanBetaling av avgifter på nett via en betalingsløsning, med kvittering for hvert avdrag
Utelatt foreløpigHva denne versjonen ikke skal gjøreIngen kontroll av kollisjoner i timeplanen; ingen import av fjorårets registre
KostnadstakDet meste byggingen kan kosteEt maksimum som vises før godkjenning, ikke et anslag etter arbeidet

Skjermbilder per rolle er delen folk skummer, og den er viktigst. En app er egentlig flere apper som deler ett sett med data: eierens visning, lærerens visning og forelderens visning. Når du leser skjermbildene rolle for rolle, merker du at en lærer kan registrere oppmøte, men at ingen kan rette en feil i det.

Linjen utelatt foreløpig er like viktig. Den forteller hva du ikke får, og det er den vanlige kilden til skuffelse etter en bygging. En kort, ærlig liste over unntak er et tegn på en god spesifikasjon, ikke en svak.

Når du beskriver en app for Deployflix, følger spesifikasjonen den skriver denne formen: hvem som bruker appen, skjermbildene, dataene den tar vare på, hva som er utelatt foreløpig og hva byggingen maksimalt kan koste, på språket du skrev på. Hvis noe i beskrivelsen din er uklart, spør den før den planlegger. Slik fungerer det viser hvor spesifikasjonen kommer inn blant stegene.

Hvordan leser du en appspesifikasjon og stiller spørsmål ved den?

Ikke les en spesifikasjon som en kontrakt, fra topp til bunn. Les den som en dag i bedriften din.

  1. Gå gjennom en ekte dag som hver rolle. Hva trykker de på, hva ser de, hva legger de inn? Gjør så det samme for hver av de andre rollene.
  2. Følg ett register fra start til slutt. Velg én elev, én bestilling eller én time. Hvem oppretter den, hvem endrer den, hvem kan slette den, og hvor havner den?
  3. Se etter det som kan gå galt. En avlyst time, en refusjon, en feil registrering, en betaling som mislykkes, et medlem som slutter. Hvis spesifikasjonen bare beskriver at ting går bra, spør hva som skjer når de ikke gjør det.
  4. Sjekk hvert tall og ord du ville skrevet ut. Fakturaformater, avdrag, avgiftslinjer og kvitteringsnumre bør stemme med hvordan du jobber i dag. Hvis fakturaene dine må vise en avgift som GST, merverdiavgift eller omsetningsavgift, bør du sjekke detaljene med regnskapsføreren din.
  5. Spør om alt som er vagt. Ord som administrere, følge opp, enkelt og rapporter skjuler beslutninger. Spør: hvilken rapport, som viser hva, for hvem?

Hvilke hull bør du se etter før du godkjenner?

De fleste spesifikasjoner som går galt, er ikke feil; de er ufullstendige. Dette er hullene som dukker opp oftest.

Hvem som kan se hva

Roller er lette å navngi og lette å la være vage. Sjekk hva hver rolle kan se, ikke bare hva den kan gjøre. Kan en lærer se avgifter? Kan én forelder se karakterene til et annet barn? Kan en ansatt laste ned kundelisten? Hvis appen tar vare på personopplysninger, bestem nå hvem som kan se dem.

Redigere, avlyse og angre

Hvert register må rettes en dag. Sjekk at spesifikasjonen sier hvem som kan redigere eller avlyse en registrering, og om den gamle verdien tas vare på.

Penger

Hvis appen tar imot betaling, bør spesifikasjonen vise betalingstrinnene: hvordan kundene kan betale (kort og lokale betalingsmåter), hva de betaler for, om delbetaling er tillatt, hva kunden mottar etterpå, og hva som skjer hvis betalingen uteblir eller mislykkes. Refusjonsreglene er en forretningsbeslutning, så skriv ned dine. Betalingsleverandører tar vanligvis en prosentandel per transaksjon, og i mange land også et fast gebyr. Sjekk derfor prissiden til betalingsleverandøren din. Apper fra Deployflix tar imot betaling gjennom en betalingsløsning som Razorpay eller Cashfree. Internasjonale betalingsløsninger kommer snart. På integrasjonssiden vår ser du hva som kan kobles til i dag.

Meldinger og påminnelser

Hvis du forventer påminnelser, si hvordan de skal nå folk: på e-post, inne i appen eller på en annen måte. Hvis spesifikasjonen ikke nevner en kanal, kan du gå ut fra at den ikke er med.

Dataene du allerede har

Regneark og gamle protokoller må ofte flyttes inn i den nye appen. Spør om det å hente dem inn er en del av spesifikasjonen eller står på listen over det som er utelatt.

Enheter og språk

Skal folk bruke den på en telefon, en datamaskin ved butikkdisken eller begge deler? Må den være på spansk, arabisk, fransk eller et annet språk i tillegg til engelsk? Dette påvirker skjermbildene, så avklar det før byggingen starter. Deployflix skriver teksten i appen din på språket du ber om, og er selv tilgjengelig på 41 språk.

Hvorfor godkjenne spesifikasjonen før noe bygges?

Fordi det er billigere å endre en setning enn å endre en app. Før byggingen er det å legge til en foreldrerolle eller et avdrag en endring på en side. Etter byggingen kan den samme endringen berøre skjermbilder, data og tilganger som allerede var ferdige.

Når du godkjenner, får du også noe å sjekke den ferdige appen mot. Når byggingen er ferdig, åpner du spesifikasjonen og krysser av punkt for punkt: hver rolle, hvert skjermbilde, hver del av dataene. Alt som mangler, er rimelig å ta opp.

Spesifikasjonen avklarer også kostnaden før du forplikter deg. Når det står i spesifikasjonen hva byggingen maksimalt kan koste, tar du beslutningen med tallet foran deg. Hos Deployflix vises denne øvre grensen før du godkjenner, og du betaler bare for det byggingen faktisk brukte, slik det forklares på prissiden.

Hvordan planlegges endringer etter at appen er bygd?

En app blir sjelden ferdig. Et nytt kurs, et sted til, en ny måte å kreve inn avgifter på: hver av dem fortjener samme omtanke som den første byggingen.

Planlegg en endring som en liten spesifikasjon for seg selv: hva som endres, hvilke roller og skjermbilder den berører, hvilke data som legges til eller endres, hva som forblir det samme, og hva den kan koste. Les den med de samme spørsmålene og godkjenn den før arbeidet starter. Ta vare på den tidligere versjonen, så du kan gå tilbake til en som fungerte hvis endringen går galt.

Slik håndterer Deployflix endringer: du sier hva som skal endres, den planlegger endringen som neste versjon, og ingenting bygges før den er godkjent. Hver tidligere versjon tas vare på. I en organisasjon kan bare de som har en rolle som tillater det, godkjenne, slik sikkerhetssiden beskriver.

En mal for appspesifikasjon du kan bruke

Hvis du skriver din egen spesifikasjon, kan du kopiere disse overskriftene og fylle hver med enkle setninger:

  • Appen i én setning: hvem den er for og jobben den gjør.
  • Roller: hver type bruker og hva de kan se og gjøre.
  • Skjermbilder per rolle: for hver rolle, skjermbildene og hva som skjer på hvert av dem.
  • Data som lagres: hver type register og opplysningene det inneholder.
  • Integrasjoner: betaling, domenet ditt, appbutikker, hvor koden oppbevares, og alt annet den kobles til.
  • Regler: avgifter, grenser, frister, avbestillinger og refusjoner.
  • Utelatt foreløpig: hva denne versjonen ikke skal gjøre.
  • Kostnadstak og godkjenning: det meste den kan koste, og hvem som godkjenner.

For gjennomarbeidede eksempler på roller, skjermbilder og data kan du se på et system for gruppeadministrasjon i kursinstitutterEN eller en bookingapp for klinikkEN. En gründer som tester en idé, kan holde spesifikasjonen enda kortere, med én rolle, noen få skjermbilder og en fast liste over det som er utelatt, som for en MVP-nettapp for oppstartsbedrifterEN.

Spørsmål

Hva er forskjellen på en appspesifikasjon og et kravdokument?

Hovedsakelig lengde og formalitet. Et kravdokument for et stort prosjekt kan bli mange sider med nummererte krav. En appspesifikasjon for en liten bedrift dekker det samme (hvem som bruker den, hva den gjør, hva den tar vare på) på én side, med enkle ord.

Hvem bør skrive appspesifikasjonen?

Den som kjenner bedriften, står for innholdet: rollene, det daglige arbeidet og reglene. En bygger kan gjøre det om til en strukturert spesifikasjon, men bare du kan avgjøre om den er riktig.

Kan jeg endre spesifikasjonen etter at jeg har godkjent den?

Ja. Behandle det som en endring: beskriv hva som er annerledes, les den oppdaterte planen og godkjenn den på nytt. Ta vare på den tidligere versjonen, så du kan sammenligne eller gå tilbake.

Hvor lang bør en appspesifikasjon være?

Lang nok til at ingenting viktig overlates til gjetning, kort nok til at du leser hele. For de fleste apper for små bedrifter er én side riktig; blir den mye lengre, bør du vurdere å bygge i etapper.

Beskriv appen din

Skriv hva du trenger med dine egne ord. Deployflix skriver en plan på én side med kostnaden, og bygger bare etter at du har godkjent den.