Ko jūs pārvaldāt papildus dokumentam?
Dokuments ir tikai viens veids, kā fiksēt lēmumu. Jāzina arī, par kuriem punktiem ir panākta vienošanās, kuri vēl ir priekšlikumi, kurš atbildēs uz jautājumiem un kas mainīsies, ja punkts tiks pārskatīts. Tas palīdz izvairīties no darba, kura pamatā ir atšķirīga viena un tā paša pieprasījuma interpretācija.
Tā pati pieeja var palīdzēt lietotņu izstrādē, iekšējos rīkos, produkta nosacījumos un darbības noteikumos. Sāciet ar vienu funkciju vai darbplūsmu, nevis mēģiniet visu dokumentēt uzreiz.
Savienojiet mērķi, prasību, specifikāciju un pieņemšanas kritērijus
Komandas šos terminus lieto dažādi. Šajā piemērā prasība apraksta nepieciešamo rezultātu vai ierobežojumu, specifikācija fiksē saskaņoto darbību, bet pieņemšanas kritēriji izskaidro, kā to pārbaudīt. Vienojieties par šo terminu nozīmi ar cilvēkiem, ar kuriem strādājat kopā.
Mērķis: samazināt manuālu datu pārrakstīšanu
Pašlaik ikmēneša pārskatu sagatavošana ietver ierakstu kopēšanu ar roku. Eksportēšanas mērķis ir atvieglot šo darbu.
Prasība: eksportēt pārskatam nepieciešamos ierakstus
Darbiniekam ir jāeksportē izvēlētā mēneša ieraksti, nepārsniedzot viņam atļauto piekļuves apjomu.
Specifikācija: definējiet failu un tā darbību
Vienojieties par kolonnām, to secību, teksta kodējumu, datumu formātu, rīcību tukšu rezultātu gadījumā un kļūdu apstrādi. Šīs ir izvēles šim piemēram, nevis universāli noklusējuma iestatījumi.
Pieņemšanas kritēriji: padariet rezultātu pārbaudāmu
Sagatavojiet ierakstus ar zināmiem datumiem un atļaujām, veiciet eksportēšanu un salīdziniet rezultātu ar saskaņoto rezultātu.
Katram punktam rakstiet vienu pārbaudāmu domu
Frāze, piemēram, „Padarīt eksportēšanu ērtu”, atstāj svarīgas izvēles neatrisinātas. Atsevišķi norādiet perioda izvēli, izvades lauku atlasi, gadījumu bez atbilstībām apstrādi un piekļuves pārbaudi, ja šos elementus iespējams mainīt vai pārbaudīt neatkarīgi.
Izmantojiet konkrētus nosacījumus, nevis tādus vārdus kā “ātri” vai “viegli”. Ja svarīgs ir atbildes laika mērķis, līdz ar skaitli pierakstiet arī darba slodzi, vidi un mērīšanas metodi. Vēl nenoteiktās vērtības skaidri atzīmējiet kā neizlemtas.
Pirms: “Atļaut CSV eksportēšanu.”
Pēc: “Eksportējiet izvēlēto mēnesi, izmantojot saskaņotās kolonnas un kārtošanas secību. Tukšus rezultātus un piekļuves pārbaudes definējiet atsevišķos punktos.”
Pārskatītais formulējums norāda izvēles, par kurām jāvienojas, un atvieglo darbu sadali un pārskatīšanu. Pirms ieviešanas joprojām vajadzīgas konkrētas lauku definīcijas.
Daži lauki sākumam
ID, nosaukums un apraksts
Piešķiriet katram elementam pastāvīgu ID, piemēram, REQ-001. Norādiet tematu, nosacījumu un gaidāmo rezultātu. Pastāvīgs ID ļauj atsaukties uz elementu arī pēc nosaukuma maiņas.
Iemesls un avots
Pierakstiet problēmu, ko elements risina, un tā izcelsmi, piemēram, sarunu, pieprasījumu vai apliecinošu dokumentu.
Prioritāte un tvērums
Nošķiriet šim laidienam vajadzīgo no tā, kas var pagaidīt. Izskaidrojiet prioritātes iemeslu; nepiešķiriet visiem vienumiem augstāko prioritāti.
Atbildīgā persona un lēmuma statuss
Pierakstiet, kurš precizēs elementu un vai tas ir melnraksts, tiek pārskatīts vai ir saskaņots. Par īstenošanu atbildīgā persona un apstiprinātājs var būt dažādi cilvēki.
Pieņemšanas kritēriji un saistītā informācija
Saistiet elementu ar attiecīgajām specifikācijām, dizainiem, uzdevumiem un pārbaudes ierakstiem. Kad prasība mainās, atjauniniet šīs saites.
Piemērs: trīs prasības ikmēneša CSV eksportam
Tālāk sniegts tikai ilustratīvs piemērs. Lauku nosaukumi un darbība ir jāsaskaņo atbilstoši izstrādājamajam produktam; šis piemērs nav pilnīga visu eksportēšanas funkciju specifikācija.
REQ-001: izvēlētā mēneša ieraksti
Specifikācijas piemērs: izmantojiet izvēlēto mēnesi saskaņotajā uzņēmējdarbības laika joslā un eksportējiet ID, ieraksta datumu un nosaukumu UTF-8 formātā, kārtojot vispirms pēc datuma, pēc tam pēc ID. Pieņemšanas piemērs: trim atbilstošiem ierakstiem jāizveido viena galvenes rinda un tieši trīs datu rindas, bez citu mēnešu ierakstiem.
REQ-002: nav atbilstošu ierakstu
Specifikācijas piemērs: eksportējiet saskaņoto galvenes rindu pat tad, ja nav neviena atbilstoša ieraksta. Pieņemšanas piemērs: tukši testa dati izveido failu tikai ar šo galveni, bez datu rindām. Ja faila vietā vēlaties ziņojumu, vienojieties par šo atšķirīgo darbību un dokumentējiet to.
REQ-003: piekļuve tiek pārbaudīta pirms eksportēšanas
Specifikācijas piemērs: lietotāji bez eksportēšanas atļaujas nevar izveidot failu, un ieraksti ārpus atļautā tvēruma netiek iekļauti. Pieņemšanas piemēros jāietver gan lietotājs bez eksportēšanas atļaujas, gan lietotājs ar ierobežotu piekļuvi ierakstiem.
Izmantojiet hierarhiju, nezaudējot atsevišķus lēmumus
Grupējiet vienumus pēc mērķa vai funkcijas un pēc tam izvietojiet detalizētos nosacījumus attiecīgajā grupā. Piemēram: Pārskati → Ikmēneša CSV eksports → Atlasāmie ieraksti / Faila formāts / Tukši rezultāti / Piekļuve. Pamatinformāciju un neatrisinātos jautājumus ievietojiet piezīmēs, nevis apvienojiet vienā garā prasībā.
Ja viens nosacījums ietekmē vairākas funkcijas, saglabājiet skaidru atsauci uz saskaņoto versiju, nevis kopējiet dažādas versijas katrā sadaļā. Pirms izmaiņām pārbaudiet, kuras turpmākās specifikācijas un pārbaudes punkti ir no tā atkarīgi.
Nošķiriet vienošanos, īstenošanu un pārbaudi
„Saskaņots” nozīmē, ka saturs ir pieņemts paredzētajam tvērumam. Tas nenozīmē, ka funkcija ir ieviesta. „Ieviests” arī neapliecina, ka saskaņotie pieņemšanas kritēriji ir izpildīti vai funkcija ir izlaista. Saglabājiet šīs atšķirības skaidri redzamas, pat ja izmantojat vienkāršu statusu sarakstu.
Pārskatiet parasto gadījumu, tukšu vai trūkstošu ievadi, atļaujas un, ja nepieciešams, ārējo sistēmu kļūmes. Izlemiet, kādus pierādījumus saglabāt, kurš tos pārbaudīs un kurš varēs slēgt neatrisinātu jautājumu.
Fiksējiet izmaiņu un tās ietekmi, pirms uzskatāt to par saskaņotu
Jauns pieprasījums ir priekšlikums, līdz atbildīgās personas vienojas par tā apstrādi. Fiksējiet izmaiņu iemeslu, skartos ID un ietekmi uz darbu, datumiem, specifikācijām un pārbaudi. Apsveriet arī, vai izmaiņas attiecas uz ierakstiem vai lietotājiem, kuri jau izmanto šo funkciju.
Pēc lēmuma pieņemšanas atjauniniet pašreizējo specifikāciju un informējiet skartās personas. Saglabājiet iepriekš saskaņoto versiju vai piezīmi par izmaiņām, ja nepieciešams izskaidrot, kas mainījies. Neuzskatiet par pašsaprotamu, ka rīks automātiski reģistrē visus apstiprinājumus un labojumus.
Izvēlieties vietu, kuru varat regulāri atjaunināt
Nelielam sarakstam var pietikt ar koplietojamu dokumentu vai izklājlapu. Ja apspriešana, ieviešana un pārbaude notiek vairākos rīkos, izvēlieties vienu galveno atsauces vietu un no tās sasaistiet saistītos materiālus. Svarīgi, lai ikviens spētu noteikt pašlaik saskaņoto saturu.
Izmantojiet AI melnrakstam un pēc tam apstipriniet lēmumus
MI var palīdzēt uzskaitīt iespējamās prasības, sakārtot melnrakstu un ieteikt trūkstošos jautājumus. Uzvednē nošķiriet apstiprinātus faktus no pieņēmumiem un lūdziet vēl neizlemtās vērtības atstāt jautājumu veidā. Pārskatiet rezultātu kopā ar cilvēkiem, kuri pārzina paredzēto lietojumu.
Lietotnē ReqSpec AI varat hierarhiski sakārtot prasības un specifikācijas un izmantot AI, lai palīdzētu tās izveidot, rediģēt un pārbaudīt. Uzdodiet konkrētu jautājumu, piemēram, “Kuri tukša rezultāta nosacījumi vēl nav definēti?” Uztveriet katru atbildi kā ieteikumu, kas jāpārbauda pret reģistrēto saturu, nevis kā apstiprinājuma vai pilnīguma pierādījumu.
Sāciet ar vienu funkciju un vienu pārskatīšanu
Izvēlieties vienu funkciju, uzskaitiet nepieciešamos rezultātus, piešķiriet vienumiem ID un pievienojiet pieņemšanas kritērijus un atvērtos jautājumus. Vienreiz pārskatiet tos kopā ar iesaistīto personu, pēc tam pierakstiet lēmumus un nākamo atbildīgo. Neliels, regulāri uzturēts kopums ir noderīgāks par lielu dokumentu, kuru neviens neatjaunina.
Sakārtojiet prasības un specifikācijas ar ReqSpec AI
ReqSpec AI piedāvā vienkāršu veidu, kā organizēt prasības un specifikācijas mobilajā ierīcē un tīmeklī. Izpētiet funkcijas lietotnes lapā.