
Et kravdokument til en app, eller en appspecifikation, er en kort skriftlig plan for en app, før nogen bygger den: hvem der skal bruge den, de skærme hver af dem ser, de oplysninger den gemmer, de tjenester den forbindes med, hvad der er udeladt indtil videre, og det højeste beløb bygningen kan koste. Du læser den, stiller spørgsmål til den og ændrer den, og først når den beskriver den app du faktisk vil have, godkender du den.
Du godkender den først, fordi en specifikation er det billigste sted at finde en fejl. Det koster ingenting at flytte en linje på en side. At opdage efter bygningen, at underviserne kan se alle forældres telefonnumre, eller at betalinger ikke kan deles op i rater, betyder, at der skal bygges om.
Hvad er en softwarespecifikation med almindelige ord?
I software er en specifikation (i større projekter ofte kaldet et kravdokument eller SRS, software requirements specification) aftalen mellem den der har brug for appen, og den der bygger den. Den siger hvad appen skal gøre, ikke hvordan koden gør det. For en butik, en klub eller en skole er én side som regel nok, så længe den er konkret og skrevet med almindelige ord.
Testen af en specifikation er enkel: kunne to forskellige byggere læse den og lave nogenlunde den samme app? Hvis der står eleverne kan se deres resultater, er det et ønske. Hvis der står en elev logger ind med et telefonnummer og ser karaktererne fra sine egne prøver, fordelt på fag, ved siden af holdets gennemsnit, er det et krav som nogen kan bygge, og som du kan tjekke.
Hvad står der i et kravdokument på én side til en app?
Tag et lektiehjælpscenter, der vil have en app til hold, fremmøde og betalinger. En nyttig specifikation på én side til det har disse dele:
| Del af specifikationen | Hvad den siger | Eksempel for et lektiehjælpscenter |
|---|---|---|
| Hvem der bruger den | Hver type person der logger ind, og hvad de må | Ejer, undervisere, elever og forældre; kun ejeren ser de samlede betalinger |
| Skærme efter rolle | De sider hver rolle ser, og hvad de gør der | Underviser: dagens hold, registrér fremmøde, indtast karakterer. Forælder: fremmøde, karakterer, betalinger der forfalder |
| Gemte data | De oplysninger appen gemmer, og hvad hver af dem indeholder | Elever, hold, fremmøde pr. time, prøver og karakterer, rater og kvitteringer |
| Integrationer | Eksterne tjenester den forbindes med, og hvordan | Betaling online via en betalingsløsning, med en kvittering for hver rate |
| Udeladt indtil videre | Hvad denne version ikke vil gøre | Intet tjek for overlap i skemaet; ingen import af sidste års oplysninger |
| Prisloft | Det højeste beløb bygningen kan koste | Et maksimum vist før godkendelse, ikke et overslag efter arbejdet |
Skærme efter rolle er den del, folk skimmer, og den betyder mest. En app er i virkeligheden flere apps, der deler ét sæt data: ejerens visning, underviserens visning og forælderens visning. Når du læser skærmene rolle for rolle, opdager du, at en underviser kan registrere fremmøde, men at ingen kan rette en fejl i det.
Linjen udeladt indtil videre er lige så vigtig. Den fortæller dig hvad du ikke får, og det er den almindeligste kilde til skuffelse efter en bygning. En kort, ærlig liste over det der er udeladt, er et tegn på en god specifikation, ikke en svag.
Når du beskriver en app for Deployflix, følger den specifikation den skriver, denne form: hvem der bruger appen, dens skærme, de data den gemmer, hvad der er udeladt indtil videre, og det højeste beløb bygningen kan koste, på det sprog du skrev på. Hvis noget i din beskrivelse er uklart, spørger den, før den planlægger. Sådan virker det viser hvor specifikationen ligger blandt trinene.
Hvordan læser du en appspecifikation og stiller spørgsmål til den?
Læs ikke en specifikation som en kontrakt, fra top til bund. Læs den som en dag i din virksomhed.
- Gå en rigtig dag igennem som hver rolle. Hvad trykker de på, hvad ser de, hvad indtaster de? Gør så det samme for hver af de andre roller.
- Følg én oplysning fra start til slut. Vælg en enkelt elev, ordre eller booking. Hvem opretter den, hvem ændrer den, hvem kan slette den, og hvor ender den?
- Kig efter de ulykkelige forløb. En aflyst booking, en refusion, en forkert indtastning, en betaling der fejler, et medlem der stopper. Hvis specifikationen kun beskriver at tingene går godt, så spørg hvad der sker, når de ikke gør.
- Tjek hvert tal og ord, du ville udskrive. Fakturaformater, rater, skattelinjer og kvitteringsnumre skal passe med den måde, du arbejder på i dag. Hvis dine fakturaer skal vise en skat som GST, moms eller salgsafgift, så tjek detaljerne med din revisor.
- Spørg ind til alt der er uklart. Ord som styre, følge, nemt og rapporter skjuler beslutninger. Spørg: hvilken rapport, der viser hvad, til hvem?
Hvilke huller skal du lede efter, før du godkender?
De fleste specifikationer der går galt, er ikke forkerte; de er ufuldstændige. Det er de huller der oftest dukker op.
Hvem der kan se hvad
Roller er lette at navngive og lette at lade være uklare. Tjek, hvad hver rolle kan se, ikke kun hvad den kan gøre. Kan en underviser se betalinger? Kan en forælder se et andet barns karakterer? Kan en medarbejder downloade kundelisten? Hvis appen gemmer personoplysninger, så bestem nu, hvem der kan se dem.
Redigere, aflyse og fortryde
Alle oplysninger skal en dag rettes. Tjek at specifikationen siger hvem der kan redigere eller annullere en indtastning, og om den gamle værdi gemmes.
Penge
Hvis appen tager imod betaling, skal specifikationen vise betalingstrinnene: hvordan kunderne kan betale (kort og lokale betalingsmetoder), hvad der betales for, om delbetaling er tilladt, hvad kunden modtager bagefter, og hvad der sker hvis betalingen udebliver eller mislykkes. Regler for refusion er en forretningsbeslutning, så skriv dine ned. Betalingsudbydere tager normalt en procentdel af hver transaktion og i mange lande også et fast gebyr, så tjek din udbyders prisside. Apps bygget med Deployflix modtager betaling via en betalingsløsning som Razorpay eller Cashfree. Internationale betalingsløsninger kommer snart. Vores integrationsside viser hvad du kan forbinde til i dag.
Beskeder og påmindelser
Hvis du forventer påmindelser, så sig hvordan de skal nå frem til folk: via e-mail, inde i appen eller på en anden måde. Hvis specifikationen ikke nævner en kanal, så gå ud fra at den ikke er der.
Dine eksisterende data
Regneark og gamle protokoller skal ofte flyttes ind i den nye app. Spørg om det er en del af specifikationen at få dem overført, eller om det står på listen over det der er udeladt.
Enheder og sprog
Skal folk bruge den på en telefon, en computer ved butiksdisken eller begge dele? Skal den findes på spansk, arabisk, fransk eller et andet sprog ud over engelsk? Disse valg former skærmene, så afklar dem før byggeriet. Deployflix skriver teksten i din app på det sprog du beder om, og fungerer selv på 41 sprog.
Hvorfor godkende specifikationen, før noget bliver bygget?
Fordi det er billigere at ændre en sætning end at ændre en app. Før bygningen er det en redigering af en side at tilføje en forælderrolle eller en rate. Efter bygningen kan den samme ændring berøre skærme, data og rettigheder, der allerede var færdige.
Godkendelsen giver dig også noget at tjekke den færdige app op imod. Når bygningen er færdig, så åbn specifikationen og sæt flueben ved hvert punkt: hver rolle, hver skærm, hver oplysning. Alt der mangler, er rimeligt at tage op.
Specifikationen afklarer også prisen før du binder dig. Når den højeste pris for et build står i specifikationen, kan du træffe din beslutning med beløbet foran dig. Hos Deployflix vises dette loft før du godkender, og du betaler kun for det faktiske forbrug under buildet, som forklaret på prissiden.
Hvordan planlægges ændringer, når appen er bygget?
En app bliver sjældent færdig. Et nyt kursus, en lokation nummer to, en ny måde at opkræve betaling på: Hver af dem fortjener samme omhu som det første build.
Planlæg en ændring som en lille specifikation for sig: hvad der ændres, hvilke roller og skærme den berører, hvilke data der tilføjes eller ændres, hvad der forbliver det samme, og hvad det kan koste. Læs den med de samme spørgsmål, og godkend den, før arbejdet går i gang. Gem den tidligere version, så du kan gå tilbage til en der virkede, hvis ændringen går galt.
Sådan håndterer Deployflix ændringer: du siger hvad der skal ændres, den planlægger ændringen som den næste version, og intet bliver bygget, før det er godkendt. Alle tidligere versioner gemmes. I en organisation kan kun de personer, hvis rolle tillader det, godkende, som beskrevet på siden om sikkerhed.
En skabelon til en appspecifikation, som du kan bruge
Hvis du skriver din egen specifikation, så kopiér disse overskrifter, og udfyld hver med almindelige sætninger:
- Appen i én sætning: hvem den er til, og hvilken opgave den løser.
- Roller: hver type bruger, og hvad de må se og gøre.
- Skærme efter rolle: for hver rolle skærmene, og hvad der sker på hver af dem.
- Gemte data: hver type oplysning og de detaljer den indeholder.
- Integrationer: betalinger, dit domæne, app-butikker, hvor koden opbevares, og alt andet den forbindes med.
- Regler: priser, grænser, frister, afbestillinger og refusioner.
- Udeladt indtil videre: hvad denne version ikke vil gøre.
- Prisloft og godkendelse: det højeste beløb det kan koste, og hvem der godkender.
Se eksempler på roller, skærme og data i et system til at styre hold på et undervisningsinstitutEN eller en bookingapp til klinikkerEN. En iværksætter der afprøver en idé, kan holde specifikationen endnu kortere, med én rolle, nogle få skærme og en fast liste over det der er udeladt, som for en MVP-webapp til en startupEN.
Spørgsmål
Hvad er forskellen på en appspecifikation og et kravdokument?
Mest længde og formalitet. Et kravdokument til et stort projekt kan fylde mange sider med nummererede krav. En appspecifikation til en lille virksomhed dækker det samme (hvem der bruger den, hvad den gør, hvad den gemmer) på én side med almindelige ord.
Hvem skal skrive appspecifikationen?
Den person der kender virksomheden, leverer indholdet: rollerne, det daglige arbejde og reglerne. En bygger kan gøre det til en struktureret specifikation, men kun du kan vurdere om den er rigtig.
Kan jeg ændre specifikationen, efter jeg har godkendt den?
Ja. Behandl det som en ændring: beskriv hvad der er anderledes, læs den opdaterede plan, og godkend den igen. Gem den tidligere version, så du kan sammenligne eller gå tilbage.
Hvor lang skal en appspecifikation være?
Lang nok til at intet vigtigt overlades til gætteri, og kort nok til at du læser det hele. For de fleste apps til små virksomheder er én side passende; hvis den bliver meget længere, så overvej at bygge i etaper.
Beskriv din app
Skriv, hvad du har brug for, med dine egne ord. Deployflix skriver en plan på én side med prisen og bygger først, når du har godkendt den.
Kopieret. Indsæt det i Deployflix, når du har logget ind.