
Een document met appvereisten, of appspecificatie, is een kort schriftelijk plan van een app voordat iemand deze bouwt: wie de app gaat gebruiken, welke schermen iedere gebruiker ziet, welke informatie wordt bewaard, met welke diensten de app verbinding maakt, wat voorlopig buiten de app blijft en wat de bouw maximaal mag kosten. U leest en beoordeelt het en laat het aanpassen. Pas wanneer het de app beschrijft die u echt wilt, keurt u het goed.
U keurt de specificatie eerst goed omdat dit de goedkoopste fase is om een fout te ontdekken. Een regel op een pagina verplaatsen kost niets. Als u pas na de bouw ontdekt dat docenten het telefoonnummer van elke ouder kunnen zien of dat kosten niet in termijnen kunnen worden betaald, moet de app opnieuw worden gebouwd.
Wat is een softwarespecificatie in gewone woorden?
Bij software is een specificatie — in grotere projecten vaak een vereistendocument of SRS, een specificatie van softwarevereisten, genoemd — de overeenkomst tussen degene die de app nodig heeft en degene die deze bouwt. Er staat in wat de app moet doen, niet hoe de code dat uitvoert. Voor een winkel, club of school is één pagina meestal genoeg, zolang de tekst specifiek en duidelijk is.
De test voor een specificatie is eenvoudig: kunnen twee verschillende bouwers die lezen en ongeveer dezelfde app maken? Als er staat leerlingen kunnen hun resultaten zien, is dat een wens. Als er staat een leerling logt in met een telefoonnummer en ziet per vak de cijfers van zijn of haar eigen toetsen naast het groepsgemiddelde, is dat een vereiste die iemand kan bouwen en die u kunt controleren.
Wat staat er in een appvereistendocument van één pagina?
Neem een bijlesinstituut dat een app wil voor lessen, aanwezigheid en lesgeld. Een bruikbare specificatie van één pagina bevat deze onderdelen:
| Onderdeel van de specificatie | Wat erin staat | Voorbeeld voor een bijlesinstituut |
|---|---|---|
| Wie gebruikt de app? | Elk type persoon dat inlogt en wat die persoon mag doen | Eigenaar, docenten, leerlingen en ouders; alleen de eigenaar ziet de totalen van het lesgeld |
| Schermen per rol | De pagina’s die elke rol ziet en wat die persoon daar kan doen | Docent: lessen van vandaag, aanwezigheid registreren, toetscijfers invoeren. Ouder: aanwezigheid, cijfers, openstaand lesgeld |
| Opgeslagen gegevens | De gegevens die de app opslaat en wat elk gegeven bevat | Leerlingen, lessen, aanwezigheid per les, toetsen en cijfers, termijnen van het lesgeld en betalingsbewijzen |
| Integraties | Externe diensten waarmee de app verbinding maakt en hoe | Online betaling van lesgeld via een betaalgateway, met een betalingsbewijs voor elke termijn |
| Voorlopig weggelaten | Wat deze versie niet doet | Geen controle op roosterconflicten; geen import van de gegevens van vorig jaar |
| Kostenlimiet | Het maximale bedrag dat de bouw mag kosten | Een maximumbedrag dat vóór goedkeuring wordt getoond, niet een schatting na het werk |
Schermen per rol is het onderdeel dat mensen vaak vluchtig lezen, terwijl het juist het belangrijkst is. Een app bestaat eigenlijk uit meerdere apps die dezelfde gegevens delen: de weergave van de eigenaar, die van de docent en die van de ouder. Door de schermen per rol te bekijken, merkt u bijvoorbeeld dat een docent aanwezigheid kan registreren, maar dat niemand een fout daarin kan corrigeren.
De regel voorlopig niet inbegrepen is net zo belangrijk. Die vertelt wat u niet krijgt, en dat is na een bouw vaak de oorzaak van teleurstelling. Een korte, eerlijke lijst met uitsluitingen is een teken van een goede specificatie, niet van een zwakke.
Wanneer u uw app aan Deployflix beschrijft, volgt de specificatie deze opbouw: wie de app gebruikt, welke schermen er zijn, welke gegevens worden opgeslagen, wat voorlopig niet is inbegrepen en wat de bouw maximaal mag kosten, in de taal waarin u schreef. Als iets in uw beschrijving onduidelijk is, stelt Deployflix eerst een vraag voordat het plan wordt gemaakt. Zo werkt het laat zien waar de specificatie binnen de stappen past.
Hoe leest en beoordeelt u een appspecificatie?
Lees een specificatie niet van boven naar beneden alsof het een contract is. Lees die als een werkdag in uw bedrijf.
- Doorloop een echte dag voor elke rol. Waar tikken mensen op, wat zien ze en wat voeren ze in? Doe daarna hetzelfde voor alle andere rollen.
- Volg één gegeven van begin tot eind. Kies één leerling, bestelling of boeking. Wie maakt het aan, wie wijzigt het, wie kan het verwijderen en waar komt het uiteindelijk terecht?
- Bekijk wat er gebeurt als iets misgaat. Een geannuleerde boeking, een terugbetaling, een verkeerde invoer, een mislukte betaling of een lid dat vertrekt. Als de specificatie alleen beschrijft wat er gebeurt als alles goed gaat, vraag dan wat er gebeurt als dat niet zo is.
- Controleer elk getal en elk woord dat u zou afdrukken. Factuuropmaak, termijnen van lesgeld, belastingregels en nummers van betalingsbewijzen moeten aansluiten op uw huidige werkwijze. Moeten uw facturen een belasting zoals GST, VAT of omzetbelasting vermelden, controleer de details dan met uw accountant.
- Vraag door als iets vaag is. Woorden als beheren, bijhouden, eenvoudig en rapporten verhullen beslissingen. Vraag: welk rapport, met welke informatie en voor wie?
Op welke ontbrekende onderdelen moet u letten voordat u goedkeurt?
De meeste specificaties die verkeerd uitpakken, zijn niet fout maar onvolledig. Dit zijn de onderdelen die het vaakst ontbreken.
Wie wat mag zien
Rollen zijn gemakkelijk te benoemen, maar blijven ook gemakkelijk vaag. Controleer wat elke rol mag zien, niet alleen wat die mag doen. Mag een docent het lesgeld zien? Mag een ouder de cijfers van het kind van een ander zien? Mag een medewerker de klantenlijst downloaden? Als de app persoonsgegevens opslaat, bepaal dan nu wie die mag zien.
Bewerken, annuleren en ongedaan maken
Elk gegeven moet op een dag worden gecorrigeerd. Controleer of in de specificatie staat wie een invoer mag bewerken of annuleren en of de oude waarde wordt bewaard.
Geld
Als de app betalingen accepteert, moet de specificatie de betaalstappen tonen: hoe klanten kunnen betalen (betaalkaarten en lokale betaalmethoden), waarvoor ze betalen, of deelbetalingen zijn toegestaan, wat de klant daarna ontvangt en wat er gebeurt als een betaling uitblijft of mislukt. Terugbetalingsregels zijn een zakelijke keuze, dus leg uw regels vast. Betaalproviders rekenen doorgaans een percentage per transactie en in veel landen ook een vast bedrag. Bekijk daarom de tarievenpagina van uw betaalprovider. Apps van Deployflix accepteren betalingen via een betaalprovider zoals Razorpay of Cashfree; internationale betaalproviders volgen binnenkort. Op onze integratiepagina ziet u welke koppelingen er nu beschikbaar zijn.
Berichten en herinneringen
Als u herinneringen verwacht, geef dan aan hoe mensen die moeten ontvangen: per e-mail, in de app of op een andere manier. Als de specificatie geen kanaal noemt, ga er dan van uit dat het niet is inbegrepen.
Uw bestaande gegevens
Gegevens uit spreadsheets en oude registers moeten vaak naar de nieuwe app worden overgezet. Vraag of de import daarvan deel uitmaakt van de specificatie of op de lijst met voorlopig niet inbegrepen staat.
Apparaten en talen
Gebruiken mensen de app op een telefoon, een computer aan de winkelbalie of op beide? Moet de app naast het Engels ook beschikbaar zijn in het Spaans, Arabisch, Frans of een andere taal? Dit bepaalt mede hoe de schermen eruitzien, dus leg het vóór de bouw vast. Deployflix schrijft de teksten van uw app in de taal die u vraagt en is zelf beschikbaar in 41 talen.
Waarom keurt u de specificatie goed voordat er iets wordt gebouwd?
Omdat een zin wijzigen goedkoper is dan een app wijzigen. Vóór de bouw is het toevoegen van een ouderrol of een termijnbetaling een aanpassing op een pagina. Na de bouw kan dezelfde wijziging gevolgen hebben voor schermen, gegevens en toegangsrechten die al waren afgerond.
Door de specificatie goed te keuren, hebt u ook iets waarmee u de voltooide app kunt controleren. Open na de bouw de specificatie en vink alles af: elke rol, elk scherm en elk gegeven. Als er iets ontbreekt, kunt u dat terecht aankaarten.
De specificatie geeft ook duidelijkheid over de kosten voordat u zich vastlegt. Als de maximale bouwkosten in de specificatie staan, kunt u beslissen met dat bedrag voor ogen. Bij Deployflix ziet u dat maximum voordat u goedkeurt en betaalt u alleen voor wat er tijdens het bouwen daadwerkelijk is verbruikt, zoals uitgelegd op de prijzenpagina.
Hoe worden wijzigingen gepland nadat de app is gebouwd?
Een app is zelden echt af. Een nieuwe cursus, een tweede locatie of een nieuwe manier om lesgeld te innen: elke wijziging verdient dezelfde zorg als de eerste bouw.
Plan een wijziging met een eigen kleine specificatie: wat er verandert, welke rollen en schermen worden geraakt, welke gegevens worden toegevoegd of gewijzigd, wat hetzelfde blijft en wat het maximaal mag kosten. Lees die specificatie met dezelfde vragen en keur haar goed voordat het werk begint. Bewaar de eerdere versie, zodat u kunt teruggaan naar een werkende versie als de wijziging niet goed uitpakt.
Zo verwerkt Deployflix wijzigingen: u vertelt wat er moet veranderen, Deployflix plant de wijziging als de volgende versie en er wordt niets gebouwd voordat die is goedgekeurd. Elke eerdere versie blijft bewaard. Binnen een organisatie kunnen alleen mensen met een rol die dit toestaat goedkeuring geven, zoals beschreven op de beveiligingspagina.
Een sjabloon voor uw appspecificatie
Schrijft u zelf een specificatie, neem deze koppen dan over en vul bij elke kop duidelijke zinnen in:
- De app in één zin: voor wie de app is en wat die doet.
- Rollen: elk type gebruiker en wat die mag zien en doen.
- Schermen per rol: voor elke rol de schermen en wat er op elk scherm gebeurt.
- Opgeslagen gegevens: elk type gegeven en de details die het bevat.
- Integraties: betalingen, uw domeinnaam, appwinkels, waar de code wordt bewaard en alle andere koppelingen.
- Regels: kosten, limieten, deadlines, annuleringen en terugbetalingen.
- Voorlopig niet inbegrepen: wat deze versie niet doet.
- Kostenlimiet en goedkeuring: het maximale bedrag en wie de definitieve goedkeuring geeft.
Bekijk voor uitgewerkte voorbeelden van rollen, schermen en gegevens een systeem voor het beheer van lesgroepenEN of een app voor het boeken van afspraken bij een kliniekEN. Een oprichter die een idee test, kan de specificatie nog korter houden, met één rol, enkele schermen en een duidelijke lijst van wat niet is inbegrepen, zoals bij een MVP-webapp voor een startupEN.
Vragen
Wat is het verschil tussen een appspecificatie en een vereistendocument?
Vooral de lengte en mate van formaliteit. Een vereistendocument voor een groot project kan uit vele pagina’s met genummerde vereisten bestaan. Een appspecificatie voor een klein bedrijf behandelt dezelfde onderwerpen (wie de app gebruikt, wat de app doet en welke gegevens worden opgeslagen) in duidelijke woorden op één pagina.
Wie moet de appspecificatie schrijven?
De persoon die het bedrijf kent, levert de inhoud: de rollen, het dagelijkse werk en de regels. Een bouwer kan daarvan een gestructureerde specificatie maken, maar alleen u kunt beoordelen of die klopt.
Kan ik de specificatie wijzigen nadat ik die heb goedgekeurd?
Ja. Behandel het als een wijziging: beschrijf wat anders moet, lees het bijgewerkte plan en keur het opnieuw goed. Bewaar de eerdere versie, zodat u de versies kunt vergelijken of kunt teruggaan.
Hoe lang moet een appspecificatie zijn?
Lang genoeg om niets belangrijks aan giswerk over te laten, maar kort genoeg om helemaal te lezen. Voor de meeste apps voor kleine bedrijven is één pagina voldoende. Wordt de specificatie veel langer, overweeg dan de app in fasen te bouwen.
Beschrijf uw app
Beschrijf in uw eigen woorden wat u nodig hebt. Deployflix schrijft een plan van één pagina met de kosten en begint pas met bouwen nadat u het hebt goedgekeurd.
Gekopieerd. Plak het in Deployflix zodra u bent ingelogd.