Artiklid / Nõuded ja spetsifikatsioonid

Nõuded ja spetsifikatsioonid: kuidas korraldada otsuseid ja muudatusi

Taotlusi on lihtsam arutada, kui panete kirja, mida on vaja, miks see on oluline ja kuidas tulemust kontrollite. Nõuete ja spetsifikatsioonide haldus hoiab need otsused töö käigus kasutatavana.

Mida haldate peale dokumendi?

Dokument on vaid üks viis otsuse jäädvustamiseks. Samuti tuleb teada, millistes punktides on kokku lepitud, millised on veel ettepanekud, kes vastab küsimustele ja mis muutub punkti muutmisel. See aitab vältida olukorda, kus sama taotlust tõlgendatakse eri moodi ja selle põhjal tehakse erinevat tööd.

Sama lähenemisviis võib aidata rakenduste arendamisel, sisemiste tööriistade, tootetingimuste ja töökorraldusreeglite puhul. Alustage ühest funktsioonist või töövoost, mitte ärge püüdke kõike korraga dokumenteerida.

Ühendage eesmärk, nõue, spetsifikatsioon ja vastuvõtukriteeriumid

Meeskonnad kasutavad neid mõisteid erinevalt. Selles näites kirjeldab nõue vajalikku tulemust või piirangut, spetsifikatsioon fikseerib kokkulepitud käitumise ning vastuvõtukriteeriumid selgitavad, kuidas seda kontrollida. Leppige nende tähendustes kokku inimestega, kellega koos töötate.

Eesmärk: vähendada käsitsi ümberkirjutamist

Igakuine aruandlus hõlmab praegu kirjete käsitsi kopeerimist. Eksportimise eesmärk on seda tööd lihtsustada.

Nõue: eksportige aruande jaoks vajalikud kirjed

Töötaja peab saama eksportida valitud kuu kirjed talle lubatud juurdepääsu piires.

Spetsifikatsioon: määratlege fail ja selle käitumine

Leppige kokku veergudes, järjestuses, tekstikodeeringus, kuupäevavormingus, tühjade tulemuste käsitlemises ja vigades. Need on selle näite valikud, mitte universaalsed vaikeseaded.

Vastuvõtukriteeriumid: tehke tulemus kontrollitavaks

Valmistage ette teadaolevate kuupäevade ja õigustega kirjed, eksportige need ning võrrelge väljundit kokkulepitud tulemusega.

Eesmärgist vastuvõtukriteeriumideni Ava ReqSpec AI

Kirjuta iga punkti kohta üks kontrollitav mõte

Väljend „Muuda eksportimine mugavaks” jätab olulised valikud lahtiseks. Eralda ajavahemiku valimine, väljundväljade määramine, vastete puudumise käsitlemine ja juurdepääsu kontrollimine, kui neid saab iseseisvalt muuta või kinnitada.

Kasutage sõnade „kiire” või „lihtne” asemel konkreetseid tingimusi. Kui vastamisaja eesmärk on oluline, märkige lisaks arvule üles ka töökoormus, keskkond ja mõõtmismeetod. Märkige veel otsustamata väärtused selgelt otsustamata väärtusteks.

Enne: “Luba CSV eksport.”

Pärast: „Eksportige valitud kuu kokkulepitud veergude ja sortimisjärjestusega. Määratlege tühjad tulemused ja juurdepääsukontrollid eraldi punktides.“

Muudetud sõnastus toob välja valikud, milles tuleb kokku leppida, ning hõlbustab töö määramist ja ülevaatamist. Enne rakendamist on siiski vaja konkreetseid väljademääratlusi.

Väike väljade komplekt alustamiseks

ID, pealkiri ja kirjeldus

Anna igale üksusele püsiv ID, näiteks REQ-001. Märgi teema, tingimus ja oodatav tulemus. Püsiv ID võimaldab üksusele viidata ka pärast selle pealkirja muutmist.

Põhjus ja allikas

Märkige üles, millist probleemi element lahendab ja kust see pärineb, näiteks vestlusest, taotlusest või toetavast dokumendist.

Prioriteet ja ulatus

Erista selle väljalaske jaoks vajalikku sellest, mis võib oodata. Selgita prioriteedi põhjust; ära määra igale punktile kõrgeimat prioriteeti.

Vastutaja ja otsuse olek

Märgi üles, kes üksust täpsustab ja kas see on mustand, ülevaatamisel või kokku lepitud. Rakendamise eest vastutaja ja kinnitaja võivad olla erinevad inimesed.

Vastuvõtukriteeriumid ja seotud teave

Siduge element asjakohaste spetsifikatsioonide, kujunduste, ülesannete ja kontrollikirjetega. Hoidke need lingid nõude muutumisel ajakohasena.

Näide: kolm nõuet igakuisele CSV-ekspordile

Järgnev on näitlik näide. Väljade nimed ja käitumine tuleb kokku leppida loodava toote jaoks; näide ei ole kõigi ekspordifunktsioonide täielik spetsifikatsioon.

REQ-001: valitud kuu kirjed

Näidisspetsifikatsioon: kasutage kokkulepitud tööajavööndis valitud kuud ning eksportige ID, kirje kuupäev ja pealkiri UTF-8 vormingus, sorteerituna esmalt kuupäeva ja seejärel ID järgi. Vastuvõtukriteeriumi näide: kolm sobivat kirjet annavad ühe päiserea ja täpselt need kolm andmerida, ilma teiste kuude kirjeteta.

REQ-002: sobivaid kirjeid pole

Näidisspetsifikatsioon: eksportige kokkulepitud päiserida ka siis, kui ükski kirje ei vasta tingimustele. Vastuvõtunäide: tühi testandmestik loob faili, mis sisaldab seda päist, kuid mitte ühtegi andmerida. Kui eelistate faili asemel teadet, leppige selline teistsugune käitumine kokku ja dokumenteerige see.

REQ-003: juurdepääsu kontrollitakse enne eksportimist

Näidisspetsifikatsioon: ekspordiõiguseta kasutajad ei saa faili luua ning lubatud ulatusest väljapoole jäävaid kirjeid ei kaasata. Vastuvõtunäited peaksid hõlmama nii ekspordiõiguseta kasutajat kui ka kasutajat, kelle ligipääs kirjetele on piiratud.

Kasutage hierarhiat üksikuid otsuseid kaotamata

Rühmitage üksused eesmärgi või funktsiooni alusel ja paigutage üksikasjalikud tingimused vastava rühma alla. Näiteks: Aruandlus → Igakuine CSV-eksport → Sihtkirjed / Failivorming / Tühjad tulemused / Juurdepääs. Taustteave ja lahtised küsimused lisage märkustesse, mitte ühte pikka nõudesse.

Kui üks tingimus mõjutab mitut funktsiooni, säilitage selge viide kokkulepitud versioonile, selle asemel et kopeerida eri versioone igasse jaotisse. Enne selle muutmist kontrollige, millised järgnevad spetsifikatsioonid ja kontrollpunktid sellest sõltuvad.

Hoidke kokkulepe, teostus ja kontroll eraldi

„Kokkulepitud“ tähendab, et sisu on kavandatud ulatuse jaoks heaks kiidetud. See ei tähenda, et funktsioon oleks rakendatud. „Rakendatud“ ei kinnita, et kokkulepitud vastuvõtukriteeriumid on täidetud või funktsioon välja antud. Hoia need erinevused nähtavana ka siis, kui kasutad lihtsat olekute loendit.

Vaadake üle tavaolukord, tühjad või puuduvad sisendid, õigused ja vajaduse korral väliste süsteemide tõrked. Otsustage, milliseid tõendeid säilitada, kes neid kontrollib ja kes võib lahendamata küsimuse sulgeda.

Salvestage muudatus ja selle mõju enne, kui peate seda kokkulepituks

Uus taotlus jääb ettepanekuks, kuni vastutavad inimesed lepivad kokku, kuidas seda käsitleda. Pange kirja muudatuse põhjus, mõjutatud ID-d ning mõju tööle, kuupäevadele, spetsifikatsioonidele ja kontrollimisele. Arvestage ka sellega, kas muudatus kehtib kirjetele või kasutajatele, kes funktsiooni juba kasutavad.

Pärast otsuse tegemist uuendage kehtivat spetsifikatsiooni ja teavitage mõjutatud inimesi. Säilitage varem kokkulepitud versioon või muudatuse märkus, kui peate selgitama, mis muutus. Ärge eeldage, et tööriist salvestab kõik heakskiidud ja parandused automaatselt.

Valige koht, mida saate ajakohasena hoida

Väikese nimekirja jaoks võib piisata jagatud dokumendist või arvutustabelist. Kui arutelu, teostus ja kontroll toimuvad mitmes tööriistas, valige peamine viiteallikas ning linkige sellega seotud materjalid. Oluline on, et kõik leiaksid praegu kokkulepitud sisu.

Kasutage AI-d mustandi jaoks ja seejärel kinnitage otsused

Tehisintellekt aitab koostada võimalike nõuete loendit, korrastada mustandit ja pakkuda puuduvaid küsimusi. Eristage päringus kinnitatud faktid oletustest ning paluge jätta veel otsustamata väärtused küsimustena. Vaadake tulemus üle koos inimestega, kes tunnevad kavandatud kasutust.

ReqSpec AI-s saad nõudeid ja spetsifikatsioone hierarhiliselt korraldada ning kasutada tehisintellekti nende loomise, muutmise ja kontrollimise toetamiseks. Küsi konkreetne küsimus, näiteks „Millised tühja tulemuse tingimused on veel määratlemata?” Käsitle iga vastust soovitusena, mida tuleb kontrollida registreeritud sisu alusel, mitte heakskiidu või täielikkuse tõendina.

Alustage ühest funktsioonist ja ühest ülevaatusest

Valige üks funktsioon, loetlege vajalikud tulemused, andke punktidele ID-d ning lisage vastuvõtukriteeriumid ja lahtised küsimused. Vaadake see korra asjaomase inimesega üle ning pange seejärel kirja otsused ja järgmine vastutaja. Väike, ajakohasena hoitav kogum on kasulikum kui suur dokument, mida keegi ei uuenda.

Lisalugemist

NASA: Kuidas kirjutada hea nõue

NASA: Nõuete haldamine

Korraldage nõuded ja spetsifikatsioonid ReqSpec AI abil

ReqSpec AI pakub lihtsat viisi nõuete ja spetsifikatsioonide korraldamiseks mobiilis ja veebis. Tutvuge selle võimalustega rakenduse lehel.