Documentul cu cerințele aplicației: ce este specificația și de ce o aprobați

Specificația de o pagină pe care o aprobați mai întâi: coperta articolului de pe blogul Deployflix

Un document cu cerințele aplicației, numit și specificația aplicației, este un plan scris și scurt, întocmit înainte ca aplicația să fie construită: cine o va folosi, ce ecrane vede fiecare utilizator, ce informații păstrează, la ce servicii se conectează, ce nu este inclus deocamdată și cât poate costa cel mult construirea. Îl citiți, îl analizați și îl modificați, iar abia când descrie aplicația pe care o doriți cu adevărat îl aprobați.

Îl aprobați mai întâi deoarece specificația este locul în care o greșeală poate fi depistată cu cel mai mic cost. Mutarea unui rând pe o pagină nu costă nimic. Dacă aflați după construire că tutorii pot vedea numărul de telefon al fiecărui părinte sau că taxele nu pot fi plătite în rate, aplicația trebuie reconstruită.

Ce este, pe înțelesul tuturor, o specificație software?

În domeniul software, o specificație — numită adesea, în proiectele mai mari, document cu cerințe sau SRS, de la specificația cerințelor software — este acordul dintre persoana care are nevoie de aplicație și cel care o construiește. Aceasta precizează ce trebuie să facă aplicația, nu cum realizează codul acele lucruri. Pentru un magazin, un club sau o școală, o pagină este de obicei suficientă, dacă informațiile sunt precise și formulate simplu.

Testul unei specificații este simplu: ar putea doi dezvoltatori diferiți să o citească și să creeze aproximativ aceeași aplicație? Dacă pagina spune elevii își pot vedea rezultatele, aceasta este o dorință. Dacă spune un elev se conectează cu numărul de telefon și vede notele la propriile teste, grupate pe materii, alături de media grupei, aceasta este o cerință care poate fi construită și verificată.

Ce conține un document de o pagină cu cerințele aplicației?

Să luăm exemplul unui centru de meditații care dorește o aplicație pentru cursuri, prezență și taxe. O specificație utilă de o pagină are următoarele părți:

Partea specificațieiCe precizeazăExemplu pentru un centru de meditații
Cine o foloseșteFiecare tip de persoană care se conectează și ce are voie să facăProprietar, profesori, elevi și părinți; numai proprietarul vede totalurile taxelor
Ecrane pentru fiecare rolPaginile pe care le vede fiecare rol și ce poate face acoloProfesor: cursurile de azi, înregistrarea prezenței, introducerea notelor la teste. Părinte: prezență, note, taxe datorate
Date păstrateÎnregistrările stocate de aplicație și informațiile din fiecareElevi, cursuri, prezența la fiecare ședință, teste și note, rate ale taxelor și chitanțe
IntegrăriServiciile externe la care se conectează și modul de conectarePlata online a taxelor printr-un procesator de plăți, cu o chitanță pentru fiecare rată
Lăsate pe mai târziuCe nu va face această versiuneFără verificarea suprapunerilor din orar; fără importarea evidențelor de anul trecut
Plafon de costCostul maxim al versiunii construiteO sumă maximă afișată înainte de aprobare, nu o estimare după încheierea lucrării

Secțiunea cu ecranele pentru fiecare rol este cea pe care oamenii tind să o parcurgă în grabă, dar este și cea mai importantă. O aplicație este, de fapt, formată din mai multe aplicații care folosesc aceleași date: interfața proprietarului, cea a profesorului și cea a părintelui. Citind ecranele rol cu rol, puteți observa că un profesor poate înregistra prezența, dar nimeni nu poate corecta o greșeală.

Rândul exclus pentru moment este la fel de important. Vă spune ce nu veți primi, aceasta fiind cauza obișnuită a dezamăgirilor de după construire. O listă scurtă și sinceră a lucrurilor excluse este semnul unei specificații bune, nu al uneia slabe.

Când descrieți o aplicație pentru Deployflix, specificația creată include: cine folosește aplicația, ecranele sale, datele păstrate, ce este exclus pentru moment și costul maxim al construirii, toate în limba în care ați scris. Dacă ceva din descrierea dvs. nu este clar, vă pune întrebări înainte de planificare. Pagina Cum funcționează arată locul specificației în întregul proces.

Cum citiți și verificați critic specificația unei aplicații?

Nu citiți specificația ca pe un contract, de sus până jos. Citiți-o ca pe o zi obișnuită din afacerea dvs.

  1. Parcurgeți o zi reală din perspectiva fiecărui rol. Ce apasă persoana respectivă, ce vede și ce introduce? Apoi procedați la fel pentru toate celelalte roluri.
  2. Urmăriți o înregistrare de la început până la sfârșit. Alegeți un singur elev, o comandă sau o rezervare. Cine o creează, cine o modifică, cine o poate șterge și unde ajunge în final?
  3. Căutați situațiile în care lucrurile nu merg bine. O rezervare anulată, o rambursare, o înregistrare greșită, o plată nereușită sau un membru care pleacă. Dacă specificația descrie numai situațiile în care totul merge bine, întrebați ce se întâmplă când apar probleme.
  4. Verificați fiecare număr și termen pe care l-ați tipări. Formatele facturilor, ratele taxelor, rubricile fiscale și numerele chitanțelor trebuie să corespundă modului în care lucrați în prezent. Dacă facturile dvs. trebuie să afișeze o taxă precum GST, TVA sau impozitul pe vânzări, verificați detaliile împreună cu contabilul dvs.
  5. Cereți lămuriri pentru orice formulare vagă. Cuvinte precum gestionează, urmărește, ușor și rapoarte ascund decizii. Întrebați: ce raport, ce afișează și pentru cine?

Ce lipsuri trebuie să căutați înainte de aprobare?

Majoritatea specificațiilor care duc la probleme nu sunt greșite, ci incomplete. Acestea sunt lipsurile întâlnite cel mai des.

Cine poate vedea și ce

Rolurile sunt ușor de numit și la fel de ușor de lăsat neclare. Verificați ce poate vedea fiecare rol, nu doar ce poate face. Poate un profesor să vadă taxele? Poate un părinte să vadă notele altui copil? Poate un angajat să descarce lista de clienți? Dacă aplicația păstrează date cu caracter personal, stabiliți acum cine le poate vedea.

Modificare, anulare și revenire

Fiecare înregistrare va trebui corectată la un moment dat. Verificați dacă specificația precizează cine poate modifica sau anula o înregistrare și dacă valoarea veche este păstrată.

Bani

Dacă aplicația acceptă plăți, specificația trebuie să prezinte pașii de plată: cum pot plăti clienții (carduri și metode de plată locale), pentru ce plătesc, dacă este permisă plata parțială, ce primește clientul după plată și ce se întâmplă dacă plata nu este efectuată sau eșuează. Regulile de rambursare sunt o decizie a afacerii, așa că notați-le pe ale dumneavoastră. Procesatorii percep de obicei un procent din fiecare tranzacție, plus un comision fix în multe țări, așa că verificați pagina de tarife a procesatorului ales. Aplicațiile Deployflix acceptă plăți printr-un procesator precum Razorpay sau Cashfree; procesatorii internaționali vor fi disponibili în curând. Pagina noastră de integrări arată ce conexiuni sunt disponibile în prezent.

Mesaje și mementouri

Dacă doriți mementouri, precizați cum trebuie să ajungă la destinatari: prin e-mail, în aplicație sau pe altă cale. Dacă specificația nu menționează un canal, presupuneți că acesta nu este inclus.

Datele dvs. existente

Foile de calcul și registrele vechi trebuie adesea transferate în noua aplicație. Întrebați dacă importarea lor face parte din specificație sau apare în lista cu elemente excluse.

Dispozitive și limbi

Aplicația va fi folosită pe telefon, pe computerul de la tejghea sau pe ambele? Trebuie să fie disponibilă și în spaniolă, arabă, franceză sau altă limbă, pe lângă engleză? Aceste alegeri influențează ecranele, așa că stabiliți-le înainte de construire. Deployflix scrie textele aplicației dvs. în limba solicitată, iar propria sa interfață este disponibilă în 41 de limbi.

De ce trebuie aprobată specificația înainte de construire?

Pentru că este mai ieftin să schimbați o propoziție decât o aplicație. Înainte de construire, adăugarea rolului de părinte sau a unei rate pentru taxe înseamnă modificarea unei pagini. După construire, aceeași schimbare poate afecta ecrane, date și permisiuni deja finalizate.

Aprobarea vă oferă și un reper pentru verificarea aplicației finalizate. Când construirea este gata, deschideți specificația și verificați pe rând: fiecare rol, fiecare ecran și fiecare tip de date. Orice element lipsă este un motiv întemeiat pentru a cere o corectare.

Specificația stabilește și costul înainte să vă luați un angajament. Când costul maxim al construirii este trecut în specificație, luați decizia având suma în față. La Deployflix, acest plafon este afișat înainte de aprobare și plătiți doar pentru resursele consumate efectiv la construire, așa cum explică pagina de tarife.

Cum sunt planificate schimbările după construirea aplicației?

O aplicație este rareori terminată definitiv. Un curs nou, o a doua locație sau o nouă metodă de încasare a taxelor: fiecare schimbare merită aceeași atenție ca prima versiune construită.

Planificați o schimbare ca pe o mică specificație separată: ce se schimbă, ce roluri și ecrane sunt afectate, ce date sunt adăugate sau modificate, ce rămâne la fel și cât poate costa. Citiți-o folosind aceleași întrebări și aprobați-o înainte de începerea lucrului. Păstrați versiunea anterioară, astfel încât să puteți reveni la una funcțională dacă schimbarea creează probleme.

Așa gestionează Deployflix schimbările: spuneți ce doriți să modificați, schimbarea este planificată ca versiunea următoare și nimic nu este construit înainte de aprobare. Toate versiunile anterioare sunt păstrate. Într-o organizație, pot aproba numai persoanele al căror rol le permite acest lucru, după cum descrie pagina despre securitate.

Un șablon de specificație pentru aplicație

Dacă vă redactați singur specificația, copiați aceste titluri și completați fiecare secțiune cu propoziții simple:

  • Aplicația într-o singură propoziție: cui îi este destinată și ce sarcină îndeplinește.
  • Roluri: fiecare tip de utilizator și ce poate vedea și face.
  • Ecrane pentru fiecare rol: ecranele fiecărui rol și ce se întâmplă pe fiecare dintre ele.
  • Date păstrate: fiecare tip de înregistrare și informațiile pe care le conține.
  • Integrări: plăți, domeniul dvs., magazinele de aplicații, locul unde este păstrat codul și orice alte servicii la care se conectează.
  • Reguli: taxe, limite, termene, anulări și rambursări.
  • Exclus pentru moment: ce nu va face această versiune.
  • Plafon de cost și aprobare: costul maxim și persoana care își dă acordul final.

Pentru exemple complete de roluri, ecrane și date, consultați un sistem de gestionare a grupelor de cursanțiEN sau o aplicație pentru programări la clinicăEN. Un fondator care testează o idee poate păstra specificația și mai scurtă, cu un singur rol, câteva ecrane și o listă clară a elementelor excluse, ca în cazul unei aplicații web MVP pentru un startupEN.

Întrebări

Care este diferența dintre specificația unei aplicații și un document de cerințe?

În principal, lungimea și gradul de formalitate. Documentul de cerințe pentru un proiect mare poate avea multe pagini de cerințe numerotate. Specificația unei aplicații pentru o afacere mică acoperă aceleași aspecte — cine o folosește, ce face și ce date păstrează — pe o singură pagină, în cuvinte simple.

Cine trebuie să scrie specificația aplicației?

Persoana care cunoaște afacerea furnizează conținutul: rolurile, activitatea zilnică și regulile. Un dezvoltator poate transforma aceste informații într-o specificație structurată, dar numai dvs. puteți spune dacă este corectă.

Pot modifica specificația după ce o aprob?

Da. Tratați modificarea ca pe o schimbare: descrieți ce este diferit, citiți planul actualizat și aprobați-l din nou. Păstrați versiunea anterioară pentru a le putea compara sau pentru a reveni la ea.

Cât de lungă trebuie să fie specificația unei aplicații?

Suficient de lungă încât nimic important să nu rămână de ghicit și suficient de scurtă încât să o citiți în întregime. Pentru majoritatea aplicațiilor destinate afacerilor mici, o pagină este potrivită; dacă devine mult mai lungă, luați în calcul construirea în etape.

Descrieți aplicația

Descrieți cu propriile cuvinte ce vă trebuie. Deployflix redactează un plan de o pagină care include costul și începe construirea numai după ce îl aprobați.