
Ένα έγγραφο απαιτήσεων εφαρμογής, ή προδιαγραφή εφαρμογής, είναι ένα σύντομο γραπτό σχέδιο μιας εφαρμογής πριν την κατασκευάσει κάποιος: ποιοι θα τη χρησιμοποιούν, ποιες οθόνες βλέπει ο καθένας, ποιες πληροφορίες διατηρεί, με ποιες υπηρεσίες συνδέεται, τι μένει εκτός προς το παρόν και ποιο μπορεί να είναι το μέγιστο κόστος κατασκευής. Το διαβάζετε, θέτετε ερωτήματα και το αλλάζετε και το εγκρίνετε μόνο όταν περιγράφει την εφαρμογή που πραγματικά θέλετε.
Την εγκρίνετε πρώτα, επειδή η προδιαγραφή είναι το φθηνότερο σημείο για να εντοπίσετε ένα λάθος. Η αλλαγή μιας γραμμής σε μια σελίδα δεν κοστίζει τίποτα. Αν διαπιστώσετε μετά την κατασκευή ότι οι καθηγητές μπορούν να δουν τον αριθμό τηλεφώνου κάθε γονέα ή ότι τα δίδακτρα δεν μπορούν να πληρωθούν σε δόσεις, απαιτείται νέα κατασκευή.
Τι είναι μια προδιαγραφή λογισμικού, με απλά λόγια;
Στο λογισμικό, μια προδιαγραφή —η οποία σε μεγαλύτερα έργα ονομάζεται συχνά έγγραφο απαιτήσεων ή SRS, δηλαδή προδιαγραφή απαιτήσεων λογισμικού— είναι η συμφωνία μεταξύ του ατόμου που χρειάζεται την εφαρμογή και εκείνου που την κατασκευάζει. Περιγράφει τι πρέπει να κάνει η εφαρμογή και όχι πώς το υλοποιεί ο κώδικας. Για ένα κατάστημα, έναν σύλλογο ή ένα σχολείο, συνήθως αρκεί μία σελίδα, αρκεί να είναι συγκεκριμένη και γραμμένη με απλά λόγια.
Η δοκιμή μιας προδιαγραφής είναι απλή: θα μπορούσαν δύο διαφορετικοί κατασκευαστές να τη διαβάσουν και να φτιάξουν περίπου την ίδια εφαρμογή; Αν η σελίδα λέει οι μαθητές μπορούν να βλέπουν τα αποτελέσματά τους, αυτό είναι μια επιθυμία. Αν λέει ο μαθητής συνδέεται με αριθμό τηλεφώνου και βλέπει τους βαθμούς των δικών του τεστ, ανά μάθημα, δίπλα στον μέσο όρο του τμήματος, αυτό είναι μια απαίτηση που κάποιος μπορεί να υλοποιήσει και εσείς να ελέγξετε.
Τι περιλαμβάνει ένα μονοσέλιδο έγγραφο απαιτήσεων εφαρμογής;
Ας πάρουμε ως παράδειγμα ένα φροντιστήριο που θέλει μια εφαρμογή για μαθήματα, παρουσίες και δίδακτρα. Μια χρήσιμη μονοσέλιδη προδιαγραφή περιλαμβάνει τα εξής μέρη:
| Μέρος της προδιαγραφής | Τι αναφέρει | Παράδειγμα για φροντιστήριο |
|---|---|---|
| Ποιοι τη χρησιμοποιούν | Κάθε τύπος χρήστη που συνδέεται και τι επιτρέπεται να κάνει | Ιδιοκτήτης, καθηγητές, μαθητές και γονείς· μόνο ο ιδιοκτήτης βλέπει τα συνολικά δίδακτρα |
| Οθόνες ανά ρόλο | Οι σελίδες που βλέπει κάθε ρόλος και τι κάνει σε αυτές | Καθηγητής: σημερινά μαθήματα, καταχώριση παρουσιών, εισαγωγή βαθμών τεστ. Γονέας: παρουσίες, βαθμοί, οφειλόμενα δίδακτρα |
| Δεδομένα που διατηρούνται | Οι εγγραφές που αποθηκεύει η εφαρμογή και τα στοιχεία που περιέχει καθεμία | Μαθητές, μαθήματα, παρουσίες ανά συνάντηση, τεστ και βαθμοί, δόσεις διδάκτρων και αποδείξεις |
| Ενσωματώσεις | Οι εξωτερικές υπηρεσίες με τις οποίες συνδέεται και ο τρόπος σύνδεσης | Ηλεκτρονικές πληρωμές διδάκτρων μέσω πύλης πληρωμών, με απόδειξη για κάθε δόση |
| Όσα μένουν εκτός προς το παρόν | Τι δεν θα κάνει αυτή η έκδοση | Δεν θα ελέγχει για επικαλύψεις στο πρόγραμμα· δεν θα εισάγει τις περσινές εγγραφές |
| Ανώτατο κόστος | Το μέγιστο κόστος της κατασκευής | Ένα ανώτατο ποσό που εμφανίζεται πριν από την έγκριση, όχι μια εκτίμηση μετά την εργασία |
Οι οθόνες ανά ρόλο είναι το μέρος που οι περισσότεροι διαβάζουν γρήγορα, αλλά και το σημαντικότερο. Μια εφαρμογή είναι ουσιαστικά πολλές εφαρμογές που μοιράζονται τα ίδια δεδομένα: η προβολή του ιδιοκτήτη, του καθηγητή και του γονέα. Διαβάζοντας τις οθόνες ανά ρόλο, θα παρατηρήσετε, για παράδειγμα, ότι ο καθηγητής μπορεί να καταχωρίσει παρουσίες, αλλά κανείς δεν μπορεί να διορθώσει ένα λάθος σε αυτές.
Η γραμμή δεν περιλαμβάνεται προς το παρόν είναι εξίσου σημαντική. Σας εξηγεί τι δεν θα λάβετε, κάτι που συνήθως προκαλεί απογοήτευση μετά την κατασκευή. Μια σύντομη και ειλικρινής λίστα εξαιρέσεων είναι ένδειξη καλής προδιαγραφής, όχι αδύναμης.
Όταν περιγράφετε μια εφαρμογή στο Deployflix, η προδιαγραφή που συντάσσει ακολουθεί αυτή τη δομή: ποιοι χρησιμοποιούν την εφαρμογή, ποιες είναι οι οθόνες της, ποια δεδομένα διατηρεί, τι δεν περιλαμβάνεται προς το παρόν και ποιο είναι το ανώτατο κόστος κατασκευής — όλα στη γλώσσα που χρησιμοποιήσατε. Αν κάτι στην περιγραφή σας δεν είναι σαφές, σας ρωτά πριν καταρτίσει το πλάνο. Η σελίδα Πώς λειτουργεί δείχνει τη θέση της προδιαγραφής στη διαδικασία.
Πώς διαβάζετε και εξετάζετε κριτικά μια προδιαγραφή εφαρμογής;
Μη διαβάζετε μια προδιαγραφή σαν σύμβαση, από την αρχή μέχρι το τέλος. Διαβάστε τη σαν μια ημέρα στην επιχείρησή σας.
- Ακολουθήστε μια πραγματική ημέρα για κάθε ρόλο. Τι πατάει, τι βλέπει και τι καταχωρίζει; Έπειτα κάντε το ίδιο για κάθε άλλο ρόλο.
- Παρακολουθήστε μία εγγραφή από την αρχή μέχρι το τέλος. Επιλέξτε έναν μαθητή, μια παραγγελία ή μια κράτηση. Ποιος τη δημιουργεί, ποιος την αλλάζει, ποιος μπορεί να τη διαγράψει και πού καταλήγει;
- Εξετάστε τι συμβαίνει όταν κάτι πάει στραβά. Μια ακυρωμένη κράτηση, μια επιστροφή χρημάτων, μια λανθασμένη καταχώριση, μια αποτυχημένη πληρωμή, ένα μέλος που αποχωρεί. Αν η προδιαγραφή περιγράφει μόνο την ομαλή λειτουργία, ρωτήστε τι συμβαίνει όταν τα πράγματα δεν πάνε καλά.
- Ελέγξτε κάθε αριθμό και λέξη που θα εκτυπώνατε. Η μορφή των τιμολογίων, οι δόσεις διδάκτρων, οι γραμμές φόρων και οι αριθμοί αποδείξεων πρέπει να συμφωνούν με τον σημερινό τρόπο λειτουργίας σας. Αν τα τιμολόγιά σας πρέπει να εμφανίζουν φόρο, όπως GST, ΦΠΑ ή φόρο επί των πωλήσεων, επιβεβαιώστε τις λεπτομέρειες με τον λογιστή σας.
- Ρωτήστε για οτιδήποτε είναι ασαφές. Λέξεις όπως διαχείριση, παρακολούθηση, εύκολο και αναφορές κρύβουν αποφάσεις. Ρωτήστε: ποια αναφορά, τι θα δείχνει και σε ποιον;
Ποια κενά πρέπει να αναζητήσετε πριν εγκρίνετε;
Οι περισσότερες προδιαγραφές που δημιουργούν προβλήματα δεν είναι λανθασμένες· είναι ελλιπείς. Αυτά είναι τα κενά που εμφανίζονται συχνότερα.
Ποιος μπορεί να βλέπει τι
Είναι εύκολο να ορίσετε τα ονόματα των ρόλων, αλλά και να αφήσετε ασαφή τα όριά τους. Ελέγξτε τι μπορεί να βλέπει κάθε ρόλος, όχι μόνο τι μπορεί να κάνει. Μπορεί ένας καθηγητής να βλέπει τα δίδακτρα; Μπορεί ένας γονέας να βλέπει τους βαθμούς του παιδιού κάποιου άλλου; Μπορεί ένας εργαζόμενος να κατεβάσει τη λίστα πελατών; Αν η εφαρμογή διατηρεί προσωπικά δεδομένα, αποφασίστε τώρα ποιος μπορεί να τα βλέπει.
Επεξεργασία, ακύρωση και αναίρεση
Κάθε εγγραφή θα χρειαστεί κάποτε διόρθωση. Ελέγξτε ότι η προδιαγραφή αναφέρει ποιος μπορεί να επεξεργαστεί ή να ακυρώσει μια καταχώριση και αν διατηρείται η παλιά τιμή.
Χρήματα
Αν η εφαρμογή δέχεται πληρωμές, η προδιαγραφή πρέπει να παρουσιάζει τα βήματα πληρωμής: με ποιους τρόπους μπορούν να πληρώσουν οι πελάτες (κάρτες και τοπικοί τρόποι πληρωμής), για τι πληρώνουν, αν επιτρέπεται μερική πληρωμή, τι λαμβάνει ο πελάτης στη συνέχεια και τι συμβαίνει όταν μια πληρωμή εκκρεμεί ή αποτυγχάνει. Οι κανόνες επιστροφής χρημάτων είναι επιχειρηματική απόφαση, οπότε καταγράψτε τους δικούς σας. Οι πύλες συνήθως χρεώνουν ένα ποσοστό ανά συναλλαγή και, σε πολλές χώρες, μια επιπλέον πάγια χρέωση, οπότε ελέγξτε τη σελίδα τιμολόγησης της πύλης σας. Οι εφαρμογές του Deployflix δέχονται πληρωμές μέσω πύλης πληρωμών όπως η Razorpay ή η Cashfree· σύντομα θα προστεθούν διεθνείς πύλες. Η σελίδα ενσωματώσεων δείχνει ποιες συνδέσεις είναι διαθέσιμες σήμερα.
Μηνύματα και υπενθυμίσεις
Αν θέλετε υπενθυμίσεις, αναφέρετε πώς πρέπει να φτάνουν στους χρήστες: μέσω email, μέσα στην εφαρμογή ή με άλλον τρόπο. Αν η προδιαγραφή δεν αναφέρει κάποιο κανάλι, θεωρήστε ότι δεν περιλαμβάνεται.
Τα υπάρχοντα δεδομένα σας
Τα υπολογιστικά φύλλα και τα παλιά μητρώα συχνά πρέπει να μεταφερθούν στη νέα εφαρμογή. Ρωτήστε αν η εισαγωγή τους περιλαμβάνεται στην προδιαγραφή ή βρίσκεται στη λίστα δεν περιλαμβάνεται.
Συσκευές και γλώσσες
Θα τη χρησιμοποιούν σε κινητό, σε υπολογιστή στον πάγκο του καταστήματος ή και στα δύο; Πρέπει να διατίθεται στα ισπανικά, τα αραβικά, τα γαλλικά ή κάποια άλλη γλώσσα εκτός από τα αγγλικά; Αυτές οι επιλογές διαμορφώνουν τις οθόνες, γι’ αυτό αποφασίστε πριν από την κατασκευή. Το Deployflix γράφει το περιεχόμενο της εφαρμογής σας στη γλώσσα που ζητάτε και το ίδιο λειτουργεί σε 41 γλώσσες.
Γιατί πρέπει να εγκρίνετε την προδιαγραφή πριν κατασκευαστεί οτιδήποτε;
Επειδή η αλλαγή μιας πρότασης κοστίζει λιγότερο από την αλλαγή μιας εφαρμογής. Πριν από την κατασκευή, η προσθήκη ενός ρόλου γονέα ή μιας δόσης διδάκτρων είναι μια επεξεργασία σελίδας. Μετά την κατασκευή, η ίδια αλλαγή μπορεί να επηρεάσει οθόνες, δεδομένα και δικαιώματα που έχουν ήδη ολοκληρωθεί.
Η έγκριση σάς δίνει επίσης κάτι με το οποίο μπορείτε να συγκρίνετε την ολοκληρωμένη εφαρμογή. Όταν τελειώσει η κατασκευή, ανοίξτε την προδιαγραφή και ελέγξτε ένα προς ένα: κάθε ρόλο, κάθε οθόνη και κάθε στοιχείο δεδομένων. Αν λείπει κάτι, δικαιολογημένα μπορείτε να το επισημάνετε.
Η προδιαγραφή καθορίζει επίσης το κόστος πριν δεσμευτείτε. Όταν το μέγιστο κόστος κατασκευής αναγράφεται στην προδιαγραφή, αποφασίζετε έχοντας το ποσό μπροστά σας. Στο Deployflix αυτό το ανώτατο όριο εμφανίζεται πριν δώσετε την έγκρισή σας και πληρώνετε μόνο για τις μονάδες που καταναλώθηκαν πραγματικά κατά την κατασκευή, όπως εξηγεί η σελίδα τιμολόγησης.
Πώς σχεδιάζονται οι αλλαγές μετά την κατασκευή της εφαρμογής;
Μια εφαρμογή σπάνια ολοκληρώνεται οριστικά. Ένα νέο μάθημα, μια δεύτερη τοποθεσία, ένας νέος τρόπος είσπραξης διδάκτρων: κάθε αλλαγή αξίζει την ίδια προσοχή με την πρώτη κατασκευή.
Σχεδιάστε μια αλλαγή σαν μια μικρή, ξεχωριστή προδιαγραφή: τι αλλάζει, ποιους ρόλους και ποιες οθόνες επηρεάζει, ποια δεδομένα προστίθενται ή τροποποιούνται, τι παραμένει ίδιο και πόσο μπορεί να κοστίσει. Διαβάστε τη θέτοντας τις ίδιες ερωτήσεις και εγκρίνετέ τη πριν αρχίσει η εργασία. Διατηρήστε την προηγούμενη έκδοση, ώστε, αν η αλλαγή αποτύχει, να μπορείτε να επιστρέψετε σε μια έκδοση που λειτουργούσε.
Έτσι χειρίζεται το Deployflix τις αλλαγές: λέτε τι θέλετε να αλλάξει, εκείνο σχεδιάζει την αλλαγή ως την επόμενη έκδοση και δεν κατασκευάζεται τίποτα μέχρι να εγκριθεί. Κάθε προηγούμενη έκδοση διατηρείται. Σε έναν οργανισμό, μπορούν να εγκρίνουν μόνο τα άτομα των οποίων ο ρόλος το επιτρέπει, όπως περιγράφει η σελίδα ασφάλειας.
Ένα πρότυπο προδιαγραφής εφαρμογής που μπορείτε να χρησιμοποιήσετε
Αν συντάσσετε τη δική σας προδιαγραφή, αντιγράψτε αυτές τις επικεφαλίδες και συμπληρώστε καθεμία με απλές προτάσεις:
- Η εφαρμογή σε μία πρόταση: για ποιον προορίζεται και ποια δουλειά κάνει.
- Ρόλοι: κάθε τύπος χρήστη και τι επιτρέπεται να βλέπει και να κάνει.
- Οθόνες ανά ρόλο: για κάθε ρόλο, οι οθόνες και τι συμβαίνει σε καθεμία.
- Δεδομένα που διατηρούνται: κάθε τύπος εγγραφής και τα στοιχεία που περιέχει.
- Ενσωματώσεις: πληρωμές, ο δικός σας τομέας, καταστήματα εφαρμογών, πού διατηρείται ο κώδικας και οτιδήποτε άλλο συνδέεται με την εφαρμογή.
- Κανόνες: χρεώσεις, όρια, προθεσμίες, ακυρώσεις και επιστροφές χρημάτων.
- Δεν περιλαμβάνονται προς το παρόν: τι δεν θα κάνει αυτή η έκδοση.
- Ανώτατο κόστος και έγκριση: το μέγιστο ποσό που μπορεί να κοστίσει και ποιος δίνει την τελική έγκριση.
Για ολοκληρωμένα παραδείγματα ρόλων, οθονών και δεδομένων, δείτε ένα σύστημα διαχείρισης τμημάτων φροντιστηρίουEN ή μια εφαρμογή κρατήσεων ραντεβού για ιατρείοEN. Ένας ιδρυτής που δοκιμάζει μια ιδέα μπορεί να κρατήσει την προδιαγραφή ακόμη συντομότερη, με έναν ρόλο, λίγες οθόνες και σαφή λίστα όσων δεν περιλαμβάνονται, όπως σε μια διαδικτυακή εφαρμογή MVP για νεοφυή επιχείρησηEN.
Ερωτήσεις
Ποια είναι η διαφορά ανάμεσα σε μια προδιαγραφή εφαρμογής και ένα έγγραφο απαιτήσεων;
Κυρίως το μήκος και ο βαθμός τυπικότητας. Ένα έγγραφο απαιτήσεων για μεγάλο έργο μπορεί να περιλαμβάνει πολλές σελίδες αριθμημένων απαιτήσεων. Μια προδιαγραφή εφαρμογής για μικρή επιχείρηση καλύπτει τα ίδια θέματα —ποιος τη χρησιμοποιεί, τι κάνει και τι διατηρεί— σε μία σελίδα και με απλά λόγια.
Ποιος πρέπει να γράψει την προδιαγραφή της εφαρμογής;
Το άτομο που γνωρίζει την επιχείρηση παρέχει το περιεχόμενο: τους ρόλους, την καθημερινή εργασία και τους κανόνες. Ένας κατασκευαστής μπορεί να το μετατρέψει σε δομημένη προδιαγραφή, αλλά μόνο εσείς μπορείτε να κρίνετε αν είναι σωστή.
Μπορώ να αλλάξω την προδιαγραφή αφού την εγκρίνω;
Ναι. Αντιμετωπίστε το ως αλλαγή: περιγράψτε τι διαφέρει, διαβάστε το ενημερωμένο πλάνο και εγκρίνετέ το ξανά. Διατηρήστε την προηγούμενη έκδοση, ώστε να μπορείτε να τις συγκρίνετε ή να επιστρέψετε σε αυτή.
Πόσο μεγάλη πρέπει να είναι μια προδιαγραφή εφαρμογής;
Αρκετά μεγάλη ώστε τίποτα σημαντικό να μην αφήνεται στην τύχη, αλλά αρκετά σύντομη ώστε να τη διαβάσετε ολόκληρη. Για τις περισσότερες εφαρμογές μικρών επιχειρήσεων, μία σελίδα είναι αρκετή· αν γίνει πολύ μεγαλύτερη, εξετάστε το ενδεχόμενο κατασκευής σε στάδια.
Περιγράψτε την εφαρμογή σας
Γράψτε με δικά σας λόγια τι χρειάζεστε. Το Deployflix συντάσσει μια μονοσέλιδη προδιαγραφή με το κόστος και ξεκινά την κατασκευή μόνο αφού την εγκρίνετε.
Αντιγράφηκε. Επικολλήστε το στο Deployflix αφού συνδεθείτε.