Artikkelit / Vaatimukset ja määrittelyt

Vaatimukset ja määrittelyt: miten päätökset ja muutokset järjestetään

Pyynnöistä on helpompi keskustella, kun kirjaat, mitä tarvitaan, miksi se on tärkeää ja miten tarkistat tuloksen. Vaatimusten ja määrittelyjen hallinta pitää päätökset käyttökelpoisina työn edetessä.

Mitä hallinnoit asiakirjan lisäksi?

Asiakirja on vain yksi tapa kirjata päätös. Lisäksi on tiedettävä, mistä kohdista on sovittu, mitkä ovat vielä ehdotuksia, kuka vastaa kysymyksiin ja mikä muuttuu, kun kohtaa tarkistetaan. Näin vältetään työskentely saman pyynnön erilaisten tulkintojen pohjalta.

Sama lähestymistapa voi auttaa sovelluskehityksessä, sisäisissä työkaluissa, tuote-ehdoissa ja toimintatavoissa. Aloita yhdestä ominaisuudesta tai työnkulusta sen sijaan, että yrittäisit dokumentoida kaiken kerralla.

Yhdistä tavoite, vaatimus, määrittely ja hyväksymiskriteerit

Tiimit käyttävät näitä termejä eri tavoin. Tässä esimerkissä vaatimus kuvaa tarvittavaa tulosta tai rajoitetta, määrittely kirjaa sovitun toiminnan ja hyväksymiskriteerit selittävät, miten se tarkistetaan. Sopikaa näistä merkityksistä yhdessä työskentelevien ihmisten kesken.

Tavoite: vähentää manuaalista kopiointia

Kuukausiraportoinnissa tietueita kopioidaan tällä hetkellä käsin. Viennin tarkoituksena on helpottaa tätä työtä.

Vaatimus: vie raporttiin tarvittavat tietueet

Työntekijän on vietävä valitun kuukauden tietueet niiden tietojen osalta, joihin hänellä on käyttöoikeus.

Määrittely: määritä tiedosto ja sen toiminta

Sopikaa sarakkeista, järjestyksestä, tekstin merkistökoodauksesta, päivämäärämuodosta, tyhjien tulosten käsittelystä ja virheistä. Nämä ovat tätä esimerkkiä koskevia valintoja, eivät yleispäteviä oletusasetuksia.

Hyväksymiskriteerit: tee tuloksesta todennettava

Valmistele tietueet, joiden päivämäärät ja käyttöoikeudet ovat tiedossa, vie ne ja vertaa tulosta sovittuun lopputulokseen.

Tavoitteesta hyväksymiskriteereihin Avaa ReqSpec AI

Kirjoita yksi tarkistettava ajatus kuhunkin kohtaan

Ilmaus kuten ”Tee viennistä kätevää” jättää tärkeitä valintoja avoimiksi. Erota ajanjakson valinta, tulostekenttien määrittely, tilanteet ilman osumia ja käyttöoikeuksien tarkistaminen, kun näitä voidaan muuttaa tai tarkistaa toisistaan riippumatta.

Käytä konkreettisia ehtoja sanojen ”nopea” tai ”helppo” sijaan. Jos tavoitevasteaika on tärkeä, kirjaa numeron lisäksi työkuorma, ympäristö ja mittausmenetelmä. Merkitse päättämättömät arvot selvästi päättämättömiksi.

Ennen: “Salli CSV-vienti.”

Jälkeen: ”Vie valittu kuukausi sovituilla sarakkeilla ja lajittelujärjestyksellä. Määrittele tyhjät tulokset ja käyttöoikeustarkistukset erillisinä kohtina.”

Tarkennettu sanamuoto osoittaa päätökset, joista on sovittava, ja helpottaa työn jakamista ja tarkistamista. Ennen toteutusta tarvitaan silti konkreettiset kenttien määritelmät.

Pieni joukko kenttiä alkuun

ID, otsikko ja kuvaus

Anna jokaiselle kohteelle pysyvä ID, kuten REQ-001. Ilmoita aihe, ehto ja odotettu tulos. Pysyvä ID helpottaa kohteeseen viittaamista myös otsikon muuttumisen jälkeen.

Syy ja lähde

Kirjaa, minkä ongelman kohde ratkaisee ja mistä se on peräisin, esimerkiksi keskustelusta, pyynnöstä tai tausta-asiakirjasta.

Prioriteetti ja laajuus

Erota, mikä on tarpeen tässä julkaisussa ja mikä voi odottaa. Perustele prioriteetti; älä anna kaikille kohdille korkeinta prioriteettia.

Vastuuhenkilö ja päätöksen tila

Kirjaa, kuka tarkentaa kohdetta ja onko se luonnos, tarkistettavana vai hyväksytty. Toteutuksesta vastaava ja hyväksyjä voivat olla eri henkilöitä.

Hyväksymiskriteerit ja niihin liittyvät tiedot

Linkitä kohde olennaisiin määrittelyihin, suunnitelmiin, tehtäviin ja tarkistustietoihin. Pidä linkit ajan tasalla vaatimuksen muuttuessa.

Esimerkki: kolme vaatimusta kuukausittaiselle CSV-viennille

Seuraava on havainnollistava esimerkki. Kenttien nimistä ja toiminnasta on sovittava kehitettävän tuotteen mukaan; esimerkki ei ole kaikkien vientitoimintojen täydellinen määrittely.

REQ-001: valitun kuukauden tietueet

Esimerkkimääritys: käytä valittua kuukautta sovitulla liiketoiminnan aikavyöhykkeellä ja vie ID, tietueen päivämäärä ja otsikko UTF-8-muodossa lajiteltuna ensin päivämäärän ja sitten ID:n mukaan. Hyväksymisesimerkki: kolme vastaavaa tietuetta tuottaa yhden otsikkorivin ja täsmälleen nämä kolme tietoriviä ilman muiden kuukausien tietueita.

REQ-002: ei vastaavia tietueita

Esimerkkimäärittely: vie sovittu otsikkorivi tiedostoon, vaikka yhtään vastaavaa tietuetta ei löytyisi. Hyväksymisesimerkki: tyhjä testiaineisto tuottaa tiedoston, jossa on kyseinen otsikko mutta ei tietorivejä. Jos haluat tiedoston sijaan viestin, sovi tästä poikkeavasta toiminnasta ja dokumentoi se.

REQ-003: käyttöoikeus tarkistetaan ennen vientiä

Esimerkkimäärittely: käyttäjät, joilla ei ole vientioikeutta, eivät voi luoda tiedostoa, eikä sallittuun alueeseen kuulumattomia tietueita sisällytetä siihen. Hyväksymisesimerkkien tulee kattaa sekä käyttäjä, jolla ei ole vientioikeutta, että käyttäjä, jonka pääsy tietueisiin on rajoitettu.

Käytä hierarkiaa kadottamatta yksittäisiä päätöksiä

Ryhmittele kohteet tarkoituksen tai ominaisuuden mukaan ja sijoita yksityiskohtaiset ehdot asianomaisen ryhmän alle. Esimerkiksi: Raportointi → Kuukausittainen CSV-vienti → Kohdetietueet / Tiedostomuoto / Tyhjät tulokset / Käyttöoikeus. Kirjaa taustatiedot ja avoimet kysymykset muistiinpanoihin sen sijaan, että yhdistäisit ne yhdeksi pitkäksi vaatimukseksi.

Jos yksi ehto vaikuttaa useisiin ominaisuuksiin, säilytä selkeä viittaus sovittuun versioon sen sijaan, että kopioisit eri versioita jokaiseen osioon. Tarkista ennen muutosta, mitkä myöhemmät määrittelyt ja tarkistuskohdat riippuvat siitä.

Pidä sopiminen, toteutus ja varmistus erillään

”Sovittu” tarkoittaa, että sisältö on hyväksytty suunniteltuun laajuuteen. Se ei tarkoita, että ominaisuus olisi toteutettu. ”Toteutettu” ei osoita, että sovitut hyväksymiskriteerit on täytetty tai että ominaisuus on julkaistu. Pidä nämä erot selvästi näkyvillä, vaikka käyttäisit yksinkertaista tilaluetteloa.

Tarkista normaali tilanne, tyhjät tai puuttuvat syötteet, käyttöoikeudet ja tarvittaessa ulkoiset virheet. Päätä, mitkä todisteet säilytetään, kuka ne tarkistaa ja kuka voi sulkea ratkaisemattoman kysymyksen.

Kirjaa muutos ja sen vaikutukset ennen kuin pidät sitä hyväksyttynä

Uusi pyyntö on ehdotus, kunnes vastuuhenkilöt sopivat, miten se käsitellään. Kirjaa muutoksen syy, muutoksen kohteena olevat ID:t sekä vaikutukset työhön, päivämääriin, määrittelyihin ja todentamiseen. Harkitse myös, koskeeko muutos tietueita tai käyttäjiä, jotka jo käyttävät ominaisuutta.

Päivitä päätöksen jälkeen nykyinen määrittely ja ilmoita muutoksesta niille, joita se koskee. Säilytä aiemmin sovittu versio tai muutosmerkintä, kun sinun on selitettävä, mikä muuttui. Älä oleta, että työkalu tallentaa automaattisesti jokaisen hyväksynnän ja tarkistuksen.

Valitse paikka, jonka voit pitää ajan tasalla

Pieneen listaan voi riittää jaettu asiakirja tai laskentataulukko. Jos keskustelu, toteutus ja varmistus jakautuvat useisiin työkaluihin, valitse ensisijainen viite ja linkitä siihen liittyvät materiaalit. Tärkeintä on, että kaikki voivat tunnistaa kulloinkin sovitun sisällön.

Tee luonnos AI:n avulla ja vahvista sitten päätökset

Tekoäly voi auttaa listaamaan mahdollisia vaatimuksia, jäsentämään luonnosta ja ehdottamaan puuttuvia kysymyksiä. Erota kehotteessa vahvistetut tosiasiat oletuksista ja pyydä jättämään vielä päättämättömät arvot kysymyksiksi. Käy tulos läpi niiden kanssa, jotka tuntevat suunnitellun käyttötarkoituksen.

ReqSpec AI:ssa voit järjestää vaatimukset ja määrittelyt hierarkkisesti sekä hyödyntää tekoälyä niiden luomisen, muokkaamisen ja tarkistamisen tukena. Esitä tarkennettu kysymys, kuten ”Mitkä tyhjien tulosten ehdot ovat vielä määrittelemättä?” Käsittele jokaista vastausta ehdotuksena, joka on tarkistettava tallennettua sisältöä vasten, ei todisteena hyväksynnästä tai täydellisyydestä.

Aloita yhdestä ominaisuudesta ja yhdestä tarkistuksesta

Valitse yksi ominaisuus, luettele tarvittavat tulokset, anna kohdille ID:t ja lisää hyväksymiskriteerit sekä avoimet kysymykset. Käy kokonaisuus kerran läpi asianomaisen henkilön kanssa ja kirjaa sitten päätökset sekä seuraava vastuuhenkilö. Pieni, ylläpidetty kokonaisuus on hyödyllisempi kuin suuri asiakirja, jota kukaan ei päivitä.

Lisälukemista

NASA: Näin kirjoitat hyvän vaatimuksen

NASA: Vaatimustenhallinta

Järjestä vaatimukset ja määrittelyt ReqSpec AI:n avulla

ReqSpec AI tarjoaa helpon tavan järjestää vaatimuksia ja määrittelyjä mobiilissa ja verkossa. Tutustu ominaisuuksiin sovelluksen sivulla.