Straipsniai / Reikalavimai ir specifikacijos

Reikalavimai ir specifikacijos: kaip tvarkyti sprendimus ir pakeitimus

Prašymus lengviau aptarti, kai užrašote, ko reikia, kodėl tai svarbu ir kaip tikrinsite rezultatą. Reikalavimų ir specifikacijų valdymas padeda šiuos sprendimus išlaikyti naudingus darbams vykstant.

Ką valdote be dokumento?

Dokumentas yra tik vienas būdas užfiksuoti sprendimą. Taip pat reikia žinoti, dėl kurių punktų susitarta, kurie dar yra pasiūlymai, kas atsakys į klausimus ir kas pasikeis, kai punktas bus peržiūrėtas. Tai padeda išvengti darbo remiantis skirtingomis tos pačios užklausos interpretacijomis.

Tas pats metodas gali padėti kuriant programėles, vidinius įrankius, produkto sąlygas ir veiklos taisykles. Pradėkite nuo vienos funkcijos ar darbo eigos, užuot bandę viską dokumentuoti iš karto.

Susiekite tikslą, reikalavimą, specifikaciją ir priėmimo kriterijus

Komandos šiuos terminus vartoja skirtingai. Šiame pavyzdyje reikalavimas nusako reikalingą rezultatą ar apribojimą, specifikacija užfiksuoja sutartą veikimą, o priėmimo kriterijai paaiškina, kaip jį patikrinti. Su kartu dirbančiais žmonėmis susitarkite dėl šių reikšmių.

Tikslas: sumažinti rankinį duomenų perrašymą

Šiuo metu rengiant mėnesines ataskaitas įrašus tenka kopijuoti rankomis. Eksportavimo tikslas – palengvinti šį darbą.

Reikalavimas: eksportuoti ataskaitai reikalingus įrašus

Darbuotojui reikia eksportuoti pasirinkto mėnesio įrašus neviršijant jam suteiktų prieigos teisių.

Specifikacija: apibrėžkite failą ir jo veikimą

Susitarkite dėl stulpelių, jų eiliškumo, teksto koduotės, datos formato, elgesio, kai rezultatų nėra, ir klaidų tvarkymo. Tai šio pavyzdžio pasirinkimai, o ne visuotinės numatytosios nuostatos.

Priėmimo kriterijai: padarykite rezultatą patikrinamą

Paruoškite įrašus su žinomomis datomis ir leidimais, atlikite eksportavimą ir palyginkite rezultatą su sutartu rezultatu.

Nuo tikslo iki priėmimo kriterijų Atidaryti ReqSpec AI

Kiekvienam punktui parašykite po vieną patikrinamą mintį

Tokia frazė kaip „Padaryti eksportavimą patogų“ palieka svarbius sprendimus neapibrėžtus. Atskirkite laikotarpio pasirinkimą, išvesties laukų parinkimą, atvejų be atitikmenų tvarkymą ir prieigos tikrinimą, jei šiuos dalykus galima keisti ar tikrinti nepriklausomai.

Vietoj tokių žodžių kaip „greitas“ ar „lengvas“ naudokite konkrečias sąlygas. Jei svarbus atsako laiko tikslas, kartu su skaičiumi nurodykite darbo krūvį, aplinką ir matavimo metodą. Dar nenuspręstas reikšmes aiškiai pažymėkite kaip nenustatytas.

Prieš: „Leisti eksportuoti CSV.“

Po: „Eksportuokite pasirinktą mėnesį naudodami sutartus stulpelius ir rūšiavimo tvarką. Tuščius rezultatus ir prieigos patikras apibrėžkite atskirais punktais.“

Patikslinta formuluotė įvardija pasirinkimus, dėl kurių reikia susitarti, ir palengvina užduočių paskirstymą bei peržiūrą. Prieš įgyvendinimą dar reikia konkrečių laukų apibrėžčių.

Keli laukai pradžiai

ID, pavadinimas ir aprašymas

Kiekvienam elementui suteikite pastovų ID, pavyzdžiui, REQ-001. Nurodykite temą, sąlygą ir laukiamą rezultatą. Pastovus ID leidžia į elementą kreiptis net pakeitus jo pavadinimą.

Priežastis ir šaltinis

Užfiksuokite problemą, kurią sprendžia elementas, ir jo kilmę, pavyzdžiui, pokalbį, prašymą ar patvirtinantį dokumentą.

Prioritetas ir apimtis

Atskirkite tai, ko reikia šiai versijai, nuo to, kas gali palaukti. Paaiškinkite prioritetų priežastis; nesuteikite viskam aukščiausio prioriteto.

Atsakingas asmuo ir sprendimo būsena

Užrašykite, kas patikslins elementą ir ar jis yra juodraštis, peržiūrimas, ar jau suderintas. Už įgyvendinimą atsakingas asmuo ir tvirtintojas gali būti skirtingi žmonės.

Priėmimo kriterijai ir susijusi informacija

Susiekite elementą su atitinkamomis specifikacijomis, projektais, užduotimis ir tikrinimo įrašais. Pasikeitus reikalavimui, atnaujinkite šias nuorodas.

Pavyzdys: trys mėnesinio CSV eksporto reikalavimai

Toliau pateikiamas tik iliustracinis pavyzdys. Laukų pavadinimus ir veikimą reikia suderinti pagal kuriamą produktą; šis pavyzdys nėra išsami visų eksportavimo funkcijų specifikacija.

REQ-001: pasirinkto mėnesio įrašai

Specifikacijos pavyzdys: naudokite pasirinktą mėnesį pagal sutartą verslo laiko juostą ir eksportuokite ID, įrašo datą bei pavadinimą UTF-8 formatu, surikiuotus pirmiausia pagal datą, o tada pagal ID. Priėmimo pavyzdys: trys tinkami įrašai turi sudaryti vieną antraštės eilutę ir tiksliai tris duomenų eilutes, be kitų mėnesių įrašų.

REQ-002: atitinkančių įrašų nėra

Specifikacijos pavyzdys: eksportuokite sutartą antraštės eilutę net tada, kai nėra atitinkančių įrašų. Priėmimo pavyzdys: tušti bandomieji duomenys sukuria failą su ta antrašte ir be duomenų eilučių. Jei vietoj failo pageidaujate pranešimo, susitarkite dėl tokio kitokio veikimo ir jį dokumentuokite.

REQ-003: prieiga patikrinama prieš eksportuojant

Specifikacijos pavyzdys: eksporto leidimo neturintys naudotojai negali sukurti failo, o įrašai, nepatenkantys į leistiną sritį, neįtraukiami. Priėmimo pavyzdžiai turėtų apimti naudotoją be eksporto leidimo ir naudotoją, kurio prieiga prie įrašų ribota.

Naudokite hierarchiją neprarasdami atskirų sprendimų

Sugrupuokite elementus pagal paskirtį ar funkciją, tada išsamias sąlygas pateikite atitinkamoje grupėje. Pavyzdžiui: Ataskaitos → Mėnesinis CSV eksportas → Tiksliniai įrašai / Failo formatas / Tušti rezultatai / Prieiga. Kontekstą ir neišspręstus klausimus rašykite pastabose, o ne suplakite į vieną ilgą reikalavimą.

Jei viena sąlyga veikia kelias funkcijas, išlaikykite aiškią nuorodą į suderintą versiją, užuot kopijavę skirtingas versijas į kiekvieną skyrių. Prieš ją keisdami patikrinkite, kurios vėlesnės specifikacijos ir tikrinimo punktai nuo jos priklauso.

Atskirkite susitarimą, įgyvendinimą ir patikrinimą

„Sutarta“ reiškia, kad turinys priimtas numatytai apimčiai. Tai nereiškia, kad funkcija įgyvendinta. „Įgyvendinta“ taip pat nepatvirtina, kad sutarti priėmimo kriterijai įvykdyti arba funkcija išleista. Šiuos skirtumus aiškiai parodykite net ir naudodami paprastą būsenų sąrašą.

Patikrinkite įprastą atvejį, tuščią arba trūkstamą įvestį, leidimus ir, jei aktualu, išorinių sistemų klaidas. Nuspręskite, kokius įrodymus saugoti, kas juos tikrins ir kas gali užbaigti neišspręstą klausimą.

Užfiksuokite pakeitimą ir jo poveikį prieš laikydami jį suderintu

Nauja užklausa laikoma pasiūlymu, kol atsakingi asmenys sutaria, kaip ją tvarkyti. Užfiksuokite pakeitimo priežastį, paveiktus ID ir poveikį darbui, datoms, specifikacijoms bei tikrinimui. Taip pat apsvarstykite, ar pakeitimas taikomas įrašams arba naudotojams, kurie jau naudojasi šia funkcija.

Priėmę sprendimą, atnaujinkite dabartinę specifikaciją ir informuokite susijusius žmones. Išsaugokite ankstesnę suderintą versiją arba pakeitimų pastabą, kai reikės paaiškinti, kas pasikeitė. Nemanykite, kad įrankis automatiškai užfiksuoja kiekvieną patvirtinimą ir pataisą.

Pasirinkite vietą, kurią galėsite nuolat atnaujinti

Nedideliam sąrašui gali pakakti bendrinamo dokumento ar skaičiuoklės. Jei aptarimas, įgyvendinimas ir tikrinimas vyksta keliuose įrankiuose, pasirinkite pagrindinį informacijos šaltinį ir iš jo pateikite nuorodas į susijusią medžiagą. Svarbiausia, kad visi galėtų atpažinti šiuo metu suderintą turinį.

Naudokite AI juodraščiui, tada patvirtinkite sprendimus

DI gali padėti sudaryti galimų reikalavimų sąrašą, sutvarkyti juodraštį ir pasiūlyti trūkstamus klausimus. Užklausoje atskirkite patvirtintus faktus nuo prielaidų ir paprašykite neapsispręstas reikšmes palikti klausimų forma. Rezultatą peržiūrėkite su žmonėmis, išmanančiais numatytą naudojimo būdą.

„ReqSpec AI“ galite hierarchiškai tvarkyti reikalavimus ir specifikacijas, o AI naudoti kaip pagalbą juos kuriant, redaguojant ir tikrinant. Užduokite konkretų klausimą, pavyzdžiui, „Kurios tuščio rezultato sąlygos dar neapibrėžtos?“ Bet kurį atsakymą laikykite pasiūlymu, kurį reikia patikrinti pagal užregistruotą turinį, o ne patvirtinimo ar išsamumo įrodymu.

Pradėkite nuo vienos funkcijos ir vienos peržiūros

Pasirinkite vieną funkciją, išvardykite reikalingus rezultatus, suteikite punktams ID ir pridėkite priėmimo kriterijus bei neatsakytus klausimus. Kartą peržiūrėkite juos su susijusiu asmeniu, tada užfiksuokite sprendimus ir kitą atsakingą asmenį. Nedidelis, nuolat prižiūrimas rinkinys naudingesnis už didelį dokumentą, kurio niekas neatnaujina.

Papildomi skaitiniai

NASA: Kaip parašyti gerą reikalavimą

NASA: Reikalavimų valdymas

Tvarkykite reikalavimus ir specifikacijas su ReqSpec AI

ReqSpec AI siūlo paprastą būdą tvarkyti reikalavimus ir specifikacijas mobiliajame įrenginyje bei žiniatinklyje. Funkcijas rasite programėlės puslapyje.