Čo je to špecifikácia softvérových požiadaviek?

Tvorba softvéru nespočíva len vo vývoji. Pred začatím práce na softvéri musia vývojári presne vedieť, čo vytvoriť. Preto sa vývoj zvyčajne začína prípravou množstva dokumentov, ktoré podrobne popisujú budúci projekt. Dokumenty obsahujú množstvo výskumov, analýz a špecifikácií, z ktorých jedna je špecifikácia softvérových požiadaviek (SRS).





Tento článok je venovaný SRS, jeho dôležitosti pre váš projekt a krokom na vytvorenie vysokokvalitnej špecifikácie softvéru. Poďme sa ponoriť do témy definovaním SRS.

Bol som na konci, koľko by som sa mal uspokojiť

Čo je dokumentácia softvérových požiadaviek a prečo ju potrebujete?

Dokumentácia požiadaviek na softvér je dokument, ktorý popisuje funkčné a nefunkčné špecifikácie softvéru, spôsob jeho vývoja a prípady použitia – spôsoby interakcie používateľov so softvérom, keď bude pripravený. Správa SRS sa zvyčajne pripravuje počas objaviteľská fáza projektu . Majitelia firiem môžu štruktúrovať všetky špecifikácie sami alebo túto úlohu zveriť profesionálom, ktorí majú skúsenosti s vývojom softvéru a definovaním špecifikácií.

Niektorí majitelia firiem môžu chcieť preskočiť fázu zisťovania vrátane prípravy dokumentácie. Zanedbanie tejto fázy však môže viesť k neúspechu projektu. Podľa prieskumu Pulse of the Profession PMI, 35 % projektov zlyhá v dôsledku nepresných požiadaviek. Odmietol by ktorýkoľvek vlastník firmy uskutočniť zhromaždenie SRS, keby tieto štatistiky poznal už predtým? Pochybujeme. Takto teda váš tím profituje z toho, že máte všetky softvérové ​​požiadavky na jednom mieste:



  • Vývojári rozhodnúť o technickom balíku, ktorý budú potrebovať na vytvorenie back-endu a front-endu softvéru
  • Dizajnéri získať predstavu o tom, ako môžu odrážať funkčnosť v softvérovom rozhraní
  • Testeri porozumieť testovacím prípadom, ktoré budú musieť pripraviť, a zabezpečiť, aby softvér spĺňal obchodné požiadavky
  • Majitelia firiem získať zoznam funkcií potrebných pre ich produkt a môžu robiť informované rozhodnutia o investíciách

Celkovo vzaté, dokumentácia softvérových požiadaviek je usmernením, ktoré zabezpečuje, že každý zapojený do procesu vývoja softvéru má jasnú víziu procesu a rovnaké očakávania. Správa SRS tak umožňuje vyhnúť sa nedorozumeniam a nesprávnej komunikácii vo vnútri tímu.

Ak sa rozhodnete pracovať na vytváraní špecifikácií sami, môžete využiť niektoré zo špecifikácií softvéru príklady nájdete na internete. Ak chcete delegovať túto úlohu na profesionálov, uistite sa, že nájdete spoľahlivú spoločnosť, ktorá má silný tím obchodných analytikov, projektových manažérov, vývojárov a testerov, ktorí dokážu poskytnúť vysokokvalitné špecifikácie.

Veci, ktoré by ste mali vedieť pred napísaním správy SRS

Na správnu identifikáciu softvérových požiadaviek je dôležité vedieť, akú hodnotu by mal softvér priniesť podnikom a používateľom softvéru. Je tiež dôležité poznať vlastnosti vysokej kvality špecifikácie softvéru .



Obchodné a užívateľské požiadavky

Obchodné a užívateľské požiadavky odzrkadľujú podstatu softvéru, ktorý sa bude budovať. Obchodné požiadavky popisujú ciele, ktoré chcú majitelia firiem dosiahnuť konkrétnym softvérom. Ciele môžu byť rôzne: automatizácia procesov, minimalizácia počtu zamestnancov a hardvéru atď. Požiadavky používateľov sa líšia v závislosti od typu softvéru. Vo väčšine prípadov však používatelia požadujú aplikácie, ktoré fungujú rýchlo a ktorých používanie je intuitívne. Pri napísaní podrobných špecifikácií je dôležité vziať do úvahy tieto požiadavky.

Charakteristika vysokokvalitného SRS

Aby bola správa špecifikácie softvérových požiadaviek pre projekt a tím maximálne užitočná, je dôležité, aby:

  • Dokončiť aby každý člen tímu zapojený do projektu našiel potrebné informácie v správe. Vývojári by tam mali nájsť technické požiadavky, zatiaľ čo dizajnéri UI/UX by mali mať všeobecné pokyny na dizajn. Testeri by mali pochopiť, ako softvér musí fungovať, aby ho správne otestovali. Majitelia produktov potrebujú tento dokument, aby mali jasnú víziu svojho projektu.
  • Merateľné aby ste mohli porovnať pripravený produkt so špecifikáciami, ktoré ste pripravili na začiatku. Nemá zmysel hovoriť, že váš softvér by mal spĺňať všetky požiadavky.
  • Flexibilné. Správa SRS nie je niečo, čo napíšete raz a nemôžete to zmeniť až do konca projektu. Naopak, požiadavky sa môžu v priebehu práce na projekte meniť. Formát vašej správy by teda mal byť pohodlný na úpravu, kedykoľvek to potrebujete.
  • Jasné a presné. Je dôležité vyhnúť sa nadbytočným frázam a nejednoznačnosti. Každý proces by mal byť opísaný jednoduchými slovami so zoznamom technológií potrebných na vytvorenie softvéru.

Teraz, keď viete, aké veci sú kľúčové pre kvalitnú dokumentáciu požiadaviek na softvér, je čas zistiť, z čoho pozostáva.

požiadať o hotovostnú zálohu online

Komponenty špecifikácie softvérových požiadaviek

Správa SRS by mala byť konzistentná, preto je dôležité držať sa špecifickej štruktúry, ktorá pomáha jej čitateľom ľahko vnímať informácie. Nižšie popíšeme hlavné časti, ktoré by mal slušný SRS obsahovať.

Úvod

Úvod by mal v krátkosti vysvetliť, aký softvér sa bude vytvárať, aby každý člen tímu celkovo pochopil projekt, na ktorom pracuje.

Určené publikum

V tejto časti autori správy uvádzajú všetkých členov tímu, ktorí majú prístup k dokumentu. Spravidla ide o softvérových inžinierov, testerov, dizajnérov a projektových manažérov. Vlastník produktu, ktorý si objedná vývoj softvéru, by mal byť tiež zahrnutý v tomto zozname a mal by mať možnosť kedykoľvek zobraziť dokument, aby sa uistil, že všetko ide podľa plánu.

Celkový popis

Táto časť popisuje funkcie, ktoré musí softvér vykonávať. Nájdete tu aj roly používateľov a prípady použitia. V tejto časti je možné opísať predpoklady a závislosti, aby ste mohli predpovedať možné problémy a spôsoby, ako ich prekonať. V tejto časti môžu byť zahrnuté aj konštrukčné obmedzenia.

Požiadavky na externé rozhranie

Táto časť správy SRS popisuje, ako majú používatelia, hardvér a softvér interagovať. Sekciu je možné rozdeliť na štyri časti:

  1. The používateľské rozhrania časť popisuje, ako budú používatelia interagovať so softvérom.
  2. The hardvérové ​​rozhrania časť je o interakcii medzi hardvérom a softvérom.
  3. The softvérové ​​rozhrania časť vysvetľuje, ako softvér koreluje so svojimi komponentmi vrátane operačných systémov, knižníc, databáz atď.
  4. The komunikačné rozhrania časť popisuje komunikačné kanály používané vo vnútri softvéru: e-maily, prehliadače, serverové protokoly atď.

Funkčné požiadavky

Táto časť je o tom, ako bude softvér fungovať. Popisuje každú funkciu, aby všetci členovia tímu pochopili rozsah práce. Funkčné požiadavky by mali pozostávať z popisu pracovného toku systému, správania ak/potom, logiky spracovania údajov a vstupov a výstupov údajov.

Čím podrobnejší popis funkčnosti, tým menšia šanca na prepracovanie v budúcnosti. Podrobný popis funkčných požiadaviek tiež umožňuje odhadnúť čas a náklady na vývoj.

Nefunkčné požiadavky

Táto časť popisuje požadovaný výkon softvéru, ktorý je vyjadrený jeho vlastnosťami. Hlavnými nefunkčnými požiadavkami sú spravidla bezpečnosť, použiteľnosť, testovateľnosť, škálovateľnosť atď.

dostanem šek na 2000 stimulov

Dodatky

V tejto časti by ste mali zhromaždiť všetky informácie, ktoré vám pomôžu lepšie pochopiť hlavné špecifikácie. Táto sekcia je miestom pre skratky, pojmy a ich definície, schémy, schémy atď.

Vyššie uvedený obrys je možné zmeniť v závislosti od projektu, typu aplikácie, ktorú je potrebné vytvoriť, zložitosti aplikácie atď. Môžete zmeniť obrys spôsobom, ktorý je pre váš tím výhodnejší, ale mali by ste zahrnúť všetky hlavné časti, aby ste mali úplné informácie o projekte.

Nástroje na vytváranie správ SRS

Bez ohľadu na to, aký nástroj si vyberiete na vytvorenie špecifikácií softvérových požiadaviek pre svoj projekt, dokument by mal byť vhodný na používanie a zdieľanie všetkými členmi zapojenými do projektu. Nižšie uvádzame niekoľko populárnych spôsobov a nástrojov na generovanie správy SRS.

Google Dokumenty

Mnoho obchodných analytikov sa rozhodne pre služby Google, ako sú dokumenty Google alebo tabuľky Google, pretože sa ľahko používajú a upravujú. Okrem toho môžu autori zostáv experimentovať so zobrazeniami dokumentov, aby boli pre ostatných čitateľnejšie. Keďže ide o cloudové služby, dokumenty a tabuľky Google sú tiež pohodlnejšie na zdieľanie v porovnaní s Microsoft Docs alebo inými offline textovými editormi.

Pearl

Pearl je nástroj na správu požiadaviek, ktorý maximálne uľahčuje spracovanie všetkých úloh súvisiacich so špecifikáciou. Všetko, čo musíte urobiť, je definovať prípady použitia, roly používateľov, podmienky a toky. Keď to urobíte, môžete vygenerovať prehľad jedným kliknutím. Ďalšia dobrá vec na nástroji Pearl je, že umožňuje upozornenia a komentáre pre pohodlnú tímovú prácu.

Helix RM

Helix RM je ďalším nástrojom, ktorý uľahčuje prácu so špecifikáciami. Jeho rozsiahla funkčnosť umožňuje tímom pracovať so špecifikáciami s maximálnym pohodlím. Helix RM poskytuje svojim používateľom najmä grafické nástroje, sledovateľnosť požiadaviek, funkcie spolupráce v reálnom čase a ďalšie. Veľkou výhodou nástroja je jeho integrácia s rôznym softvérom, ako je Slack, Jira, GitHub atď.

Záver

Správne vytvorená dokumentácia požiadaviek na softvér tvorí ⅓ úspechu vášho projektu, preto je dôležité venovať pozornosť tejto časti pri vývoji softvéru. Na správe SRS je možné pracovať samostatne alebo s tímom obchodných analytikov a softvérových inžinierov spoločnosti, ktorú si vyberiete na spoluprácu.

Bez ohľadu na to, kto napíše špecifikácie a aké programy na to použije, mali by ste sa uistiť, že dokumentácia vašich softvérových požiadaviek je jasná, konzistentná, merateľná, flexibilná a úplná.

Odporúčaná