
Ett kravdokument för en app, eller en appspec, är en kort skriftlig plan för en app innan någon bygger den: vem som ska använda den, vilka skärmar var och en ser, vilken information den sparar, vilka tjänster den kopplas till, vad som utelämnas tills vidare och det högsta bygget kan kosta. Du läser den, ifrågasätter den och ändrar den, och först när den beskriver den app du faktiskt vill ha godkänner du den.
Du godkänner den först eftersom en spec är det billigaste stället att hitta ett misstag på. Att flytta en rad på en sida kostar ingenting. Att efter bygget upptäcka att handledarna kan se varje förälders telefonnummer, eller att avgifter inte kan betalas i delbetalningar, innebär att bygga om.
Vad är en mjukvaruspecifikation, med enkla ord?
Inom mjukvara är en specifikation (i större projekt ofta kallad kravdokument, eller SRS, software requirements specification) överenskommelsen mellan den som behöver appen och den som bygger den. Den säger vad appen ska göra, inte hur koden gör det. För en butik, en förening eller en skola räcker oftast en sida, så länge den är konkret och skriven med enkla ord.
Testet för en spec är enkelt: skulle två olika byggare kunna läsa den och göra ungefär samma app? Om det står eleverna kan se sina resultat är det en önskan. Om det står en elev loggar in med ett telefonnummer och ser resultaten på sina egna prov, per ämne, bredvid gruppens genomsnitt är det ett krav som någon kan bygga och som du kan kontrollera.
Vad ska ett kravdokument för en app på en sida innehålla?
Ta ett studiecenter som vill ha en app för klasser, närvaro och avgifter. En användbar spec på en sida för det har följande delar:
| Del av specen | Vad den säger | Exempel för ett studiecenter |
|---|---|---|
| Vem som använder den | Varje typ av person som loggar in, och vad de får göra | Ägare, handledare, elever och föräldrar; bara ägaren ser avgiftssummorna |
| Skärmar per roll | Sidorna som varje roll ser och vad de gör där | Handledare: dagens klasser, registrera närvaro, för in provresultat. Förälder: närvaro, resultat, avgifter att betala |
| Data som sparas | Uppgifterna som appen lagrar och vad var och en innehåller | Elever, klasser, närvaro per lektionstillfälle, prov och resultat, delbetalningar av avgifter och kvitton |
| Integrationer | Externa tjänster som den kopplas till, och hur | Avgiftsbetalningar online via en betalningslösning, med ett kvitto för varje delbetalning |
| Utelämnat tills vidare | Vad den här versionen inte kommer att göra | Ingen kontroll av krockar i schemat; ingen import av förra årets uppgifter |
| Kostnadstak | Det högsta bygget kan kosta | Ett maxbelopp som visas före godkännandet, inte en uppskattning efter arbetet |
Skärmar per roll är den del som folk skummar, och den är viktigast. En app är egentligen flera appar som delar på samma data: ägarens vy, handledarens vy och förälderns vy. Det är genom att läsa skärmarna roll för roll som du märker att en handledare kan registrera närvaro men att ingen kan rätta ett fel i den.
Raden utelämnat tills vidare är lika viktig. Den talar om vad du inte får, vilket är den vanliga källan till besvikelse efter ett bygge. En kort, ärlig lista över undantag är ett tecken på en bra spec, inte en svag.
När du beskriver en app för Deployflix följer specen den skriver den här formen: vem som använder appen, dess skärmar, vilka uppgifter den sparar, vad som utelämnas tills vidare och det högsta bygget kan kosta, på det språk du skrev på. Om något i din beskrivning är oklart frågar den innan den planerar. Så fungerar det visar var specen kommer in bland stegen.
Hur läser du en appspec och ifrågasätter den?
Läs inte en spec som ett avtal, uppifrån och ner. Läs den som en dag i ditt företag.
- Gå igenom en riktig dag som varje roll. Vad trycker de på, vad ser de, vad matar de in? Gör sedan samma sak för varje annan roll.
- Följ en post från början till slut. Välj en enda elev, beställning eller bokning. Vem skapar den, vem ändrar den, vem kan radera den, och var hamnar den till slut?
- Leta efter de olyckliga vägarna. En avbokad tid, en återbetalning, en felaktig inmatning, en betalning som misslyckas, en medlem som slutar. Om specen bara beskriver när saker går rätt, fråga vad som händer när de inte gör det.
- Kontrollera varje siffra och ord som du skulle skriva ut. Fakturaformat, delbetalningar av avgifter, skatterader och kvittonummer ska stämma med hur du arbetar i dag. Om dina fakturor måste visa en skatt som GST, moms eller försäljningsskatt, stäm av detaljerna med din redovisningskonsult.
- Fråga om allt som är vagt. Ord som hantera, följa upp, enkelt och rapporter döljer beslut. Fråga: vilken rapport, som visar vad, för vem?
Vilka luckor ska du leta efter innan du godkänner?
De flesta specar som går fel är inte fel; de är ofullständiga. Det här är de luckor som dyker upp oftast.
Vem som får se vad
Roller är lätta att namnge och lätta att lämna vaga. Kontrollera vad varje roll får se, inte bara vad den får göra. Kan en handledare se avgifter? Kan en förälder se ett annat barns resultat? Kan en anställd ladda ner kundlistan? Om appen sparar personuppgifter, bestäm redan nu vem som får se dem.
Redigera, avboka och ångra
Varje post kommer någon gång att behöva rättas. Kontrollera att specen säger vem som kan redigera eller avbryta en post, och om det gamla värdet sparas.
Pengar
Om appen tar emot betalningar bör specen visa betalningsstegen: hur kunder kan betala (kort och lokala betalningsmetoder), vad de betalar för, om delbetalning är tillåten, vad kunden får efteråt och vad som händer om en betalning uteblir eller misslyckas. Regler för återbetalning är ett affärsbeslut, så skriv ner dina. Betalningsleverantörer tar vanligtvis en procentandel per transaktion, plus en fast avgift i många länder, så kontrollera din leverantörs prissida. Deployflix-appar tar emot betalningar via en betalningslösning som Razorpay eller Cashfree. Internationella betalningslösningar kommer snart. Vår integrationssida visar vilka anslutningar som finns idag.
Meddelanden och påminnelser
Om du förväntar dig påminnelser, säg hur de ska nå fram: via e-post, i appen eller på något annat sätt. Om specen inte nämner någon kanal, utgå från att den inte finns med.
Dina befintliga data
Kalkylark och gamla register behöver ofta flyttas in i den nya appen. Fråga om det ingår i specen att föra in dem eller om det står på listan över det som utelämnas.
Enheter och språk
Kommer appen att användas i en mobil, på en dator vid butikskassan eller på båda? Behöver den finnas på spanska, arabiska, franska eller något annat språk utöver engelska? Det påverkar skärmarna, så bestäm detta före bygget. Deployflix skriver appens texter på det språk du önskar och finns på 41 språk.
Varför godkänna specen innan något byggs?
För att det är billigare att ändra en mening än att ändra en app. Före bygget är det en redigering på en sida att lägga till en föräldraroll eller en delbetalning av avgiften. Efter bygget kan samma ändring påverka skärmar, data och behörigheter som redan var färdiga.
Godkännandet ger dig också något att kontrollera den färdiga appen mot. När bygget är klart, öppna specen och bocka av: varje roll, varje skärm, varje uppgift. Allt som saknas är rimligt att ta upp.
Specen fastställer också kostnaden innan du förbinder dig. När den högsta kostnaden för ett bygge står i specen kan du fatta beslut med beloppet framför dig. Hos Deployflix visas det kostnadstaket innan du godkänner, och du betalar bara för det som bygget faktiskt förbrukade, som vi förklarar på prissidan.
Hur planeras ändringar efter att appen är byggd?
En app blir sällan färdig. En ny kurs, en andra plats, ett nytt sätt att ta in avgifter: var och en förtjänar samma omsorg som det första bygget.
Planera en ändring som en egen liten spec: vad som ändras, vilka roller och skärmar den påverkar, vilka data som läggs till eller ändras, vad som förblir oförändrat och vad den kan kosta. Läs den med samma frågor och godkänn den innan arbetet börjar. Spara den tidigare versionen, så att du kan gå tillbaka till en som fungerade om ändringen blir fel.
Det är så Deployflix hanterar ändringar: du säger vad som ska ändras, den planerar ändringen som nästa version, och ingenting byggs förrän den är godkänd. Varje tidigare version sparas. I en organisation kan bara de vars roll tillåter det godkänna, som sidan om säkerhet beskriver.
En mall för appspec som du kan använda
Om du skriver din egen spec, kopiera de här rubrikerna och fyll i var och en med enkla meningar:
- Appen i en mening: vem den är till för och vilken uppgift den gör.
- Roller: varje typ av användare och vad de får se och göra.
- Skärmar per roll: för varje roll, skärmarna och vad som händer på var och en.
- Data som sparas: varje typ av post och vilka uppgifter den innehåller.
- Integrationer: betalningar, din domän, appbutiker, var koden förvaras och allt annat som den kopplas till.
- Regler: avgifter, gränser, tidsfrister, avbokningar och återbetalningar.
- Utelämnat tills vidare: vad den här versionen inte kommer att göra.
- Kostnadstak och godkännande: det högsta den kan kosta, och vem som godkänner.
För genomarbetade exempel på roller, skärmar och data, titta på ett system för att hantera grupper på ett studiecenterEN eller en bokningsapp för klinikerEN. En grundare som testar en idé kan hålla specen ännu kortare, med en roll, några skärmar och en bestämd lista över det som utelämnas, som för en MVP-webbapp för startupsEN.
Frågor
Vad är skillnaden mellan en appspec och ett kravdokument?
Främst längd och formalitet. Ett kravdokument för ett stort projekt kan omfatta många sidor numrerade krav. En appspec för ett småföretag täcker samma saker (vem som använder den, vad den gör, vad den sparar) på en sida, med enkla ord.
Vem ska skriva appspecen?
Den som känner verksamheten står för innehållet: rollerna, det dagliga arbetet och reglerna. En byggare kan göra om det till en strukturerad spec, men bara du kan avgöra om den stämmer.
Kan jag ändra specen efter att jag har godkänt den?
Ja. Behandla det som en ändring: beskriv vad som är annorlunda, läs den uppdaterade planen och godkänn den igen. Spara den tidigare versionen så att du kan jämföra eller gå tillbaka.
Hur lång ska en appspec vara?
Tillräckligt lång för att inget viktigt ska lämnas åt gissningar, tillräckligt kort för att du ska läsa hela. För de flesta appar för småföretag är en sida lagom; om den blir mycket längre, överväg att bygga i etapper.
Beskriv din app
Skriv vad du behöver med egna ord. Deployflix skriver en plan på en sida med kostnaden och bygger först när du har godkänt den.
Kopierat. Klistra in det i Deployflix när du har loggat in.