Статии / Барања и спецификации

Барања и спецификации: како да ги организирате одлуките и промените

Барањата полесно се разгледуваат кога ќе запишете што е потребно, зошто е важно и како ќе го проверите резултатот. Управувањето со барањата и спецификациите ги одржува тие одлуки употребливи додека напредува работата.

Со што управувате освен со документот?

Документот е само еден начин да се забележи одлука. Исто така треба да знаете кои ставки се договорени, кои сè уште се предлози, кој ќе одговара на прашања и што се менува кога некоја ставка ќе се ревидира. Ова помага да се избегне работа врз основа на различни толкувања на истото барање.

Истиот пристап може да помогне при развој на апликации, внатрешни алатки, услови за производи и оперативни правила. Започнете со една функција или работен тек, наместо да се обидувате да документирате сè одеднаш.

Поврзете ги целта, барањето, спецификацијата и критериумите за прифаќање

Тимовите ги користат овие термини на различни начини. Во овој пример, барањето опишува потребен резултат или ограничување, спецификацијата го бележи договореното однесување, а критериумите за прифаќање објаснуваат како да се провери. Усогласете ги овие значења со луѓето со кои соработувате.

Цел: намалување на рачното препишување

Месечното известување моментално вклучува рачно препишување записи. Целта на извезувањето е да ја олесни таа работа.

Барање: извезете ги записите потребни за извештајот

Член на персоналот треба да извезе записи за избран месец, во рамките на податоците до кои има дозволен пристап.

Спецификација: дефинирајте ја датотеката и нејзиното однесување

Договорете ги колоните, редоследот, кодирањето на текстот, форматот на датумот, однесувањето при празен резултат и грешките. Ова се избори за овој пример, а не универзални стандардни поставки.

Критериуми за прифаќање: резултатот нека биде проверлив

Подгответе записи со познати датуми и дозволи, извршете го извозот и споредете го резултатот со договорениот исход.

Од цел до критериуми за прифаќање Отворете ReqSpec AI

Запишете по една проверлива идеја за секоја ставка

Фраза како „Направете го извезувањето практично“ остава важни одлуки отворени. Одделете го изборот на период, изборот на излезни полиња, постапувањето кога нема совпаѓања и проверката на пристапот, ако тие ставки можат независно да се менуваат или проверуваат.

Користете конкретни услови наместо зборови како „брзо“ или „лесно“. Ако е важна целта за време на одговор, запишете ги оптоварувањето, околината и методот на мерење, како и бројката. Недефинираните вредности оставете ги јасно означени како недефинирани.

Пред: „Овозможете извоз во CSV.“

Потоа: „Извезете го избраниот месец со договорените колони и редослед на сортирање. Дефинирајте ги празните резултати и проверките за пристап како одделни ставки.“

Ревидираната формулација ги посочува изборите за кои треба да се постигне договор и го олеснува распределувањето и прегледувањето на работата. Пред имплементацијата сè уште се потребни конкретни дефиниции на полињата.

Мал сет полиња за почеток

ID, наслов и опис

Доделете му на секој елемент постојан ID, како REQ-001. Наведете ги предметот, условот и очекуваниот резултат. Постојаниот ID овозможува повикување на елементот и по промена на насловот.

Причина и извор

Запишете го проблемот што го решава ставката и од каде потекнува, како разговор, барање или придружен документ.

Приоритет и опсег

Разликувајте што е потребно за ова издание од она што може да почека. Објаснете ја причината за приоритетот; не доделувајте највисок приоритет на секоја ставка.

Одговорно лице и статус на одлука

Запишете кој ќе го разјасни елементот и дали е нацрт, во преглед или усогласен. Лицето задолжено за имплементација и одобрувачот може да бидат различни.

Критериуми за прифаќање и поврзани информации

Поврзете ја ставката со соодветните спецификации, дизајни, задачи и записи од проверки. Ажурирајте ги тие врски кога ќе се сменат барањата.

Пример: три барања за месечен извоз во CSV

Следново е илустративен пример. За имињата на полињата и однесувањето треба да се договорите според производот што го развивате; примерот не е целосна спецификација за секоја функција за извоз.

REQ-001: записи за избраниот месец

Пример за спецификација: користете го избраниот месец во договорената деловна временска зона и извезете ги ID, датумот на записот и насловот во UTF-8, подредени прво по датум, а потоа по ID. Пример за прифаќање: три соодветни записи даваат еден ред со заглавија и точно три реда со податоци, без записи од други месеци.

REQ-002: нема соодветни записи

Пример за спецификација: извезете го договорениот ред со заглавија дури и кога нема записи што одговараат. Пример за прифаќање: празниот тестен сет создава датотека со тоа заглавие и без редови со податоци. Ако претпочитате порака наместо датотека, договорете го и документирајте го тоа различно однесување.

REQ-003: пристапот се проверува пред извоз

Пример за спецификација: корисниците без дозвола за извоз не можат да ја создадат датотеката, а записите надвор од дозволениот опсег не се вклучуваат. Примерите за прифаќање треба да опфатат корисник без дозвола за извоз и корисник со ограничен пристап до записи.

Користете хиерархија без да ги изгубите поединечните одлуки

Групирајте ги ставките според цел или функција, а потоа ставете ги деталните услови под соодветната група. На пример: Извештаи → Месечен извоз во CSV → Целни записи / Формат на датотека / Празни резултати / Пристап. Ставете ги контекстот и отворените прашања во белешки, наместо да ги мешате во едно долго барање.

Ако еден услов влијае врз повеќе функции, задржете јасна референца до договорената верзија наместо да копирате различни верзии во секој дел. Пред да го промените, проверете кои последователни спецификации и ставки за проверка зависат од него.

Одвојте ги договорот, имплементацијата и проверката

„Договорено“ значи дека содржината е прифатена за предвидениот опсег. Тоа не значи дека функционалноста е имплементирана. „Имплементирано“ не потврдува дека договорените критериуми за прифаќање се исполнети или дека функционалноста е објавена. Задржете ги овие разлики видливи дури и ако користите едноставна листа на статуси.

Проверете ги нормалните случаи, празните или недостасувачки влезни податоци, дозволите и, каде што е релевантно, надворешните грешки. Одлучете кои докази ќе ги зачувате, кој ќе ги провери и кој може да затвори нерешено прашање.

Забележете ја промената и нејзиното влијание пред да ја сметате за договорена

Новото барање останува предлог додека одговорните лица не се договорат како да постапат со него. Забележете ја причината за промената, засегнатите ID-ознаки и влијанието врз работата, датумите, спецификациите и проверката. Размислете и дали промената се однесува на записи или корисници што веќе ја користат функцијата.

По одлуката, ажурирајте ја тековната спецификација и известете ги засегнатите лица. Зачувајте ја претходно договорената верзија или белешка за измените кога треба да објасните што се сменило. Не претпоставувајте дека алатката автоматски ги евидентира сите одобрувања и ревизии.

Изберете место што можете да го одржувате ажурирано

За мала листа, може да биде доволен заеднички документ или табеларна пресметка. Кога дискусијата, имплементацијата и проверката се распределени низ повеќе алатки, изберете главен извор и поврзете ги сродните материјали со него. Важно е сите да можат да ја препознаат тековната договорена содржина.

Користете AI за нацрт, а потоа потврдете ги одлуките

ВИ може да помогне да се наведат можните барања, да се организира нацрт и да се предложат прашања што недостасуваат. Во инструкцијата одвојте ги потврдените факти од претпоставките и побарајте неодлучените вредности да останат како прашања. Прегледајте го резултатот со луѓето што ја познаваат наменетата употреба.

Во ReqSpec AI можете хиерархиски да ги организирате барањата и спецификациите и да користите AI за помош при создавање, уредување и проверка. Поставете конкретно прашање, како „Кои услови за празен резултат сè уште не се дефинирани?“ Секој одговор сметајте го за предлог што треба да се провери според внесената содржина, а не како доказ за одобрување или целосност.

Започнете со една функција и еден преглед

Изберете една функција, наведете ги потребните резултати, доделете ID-ознаки на ставките и додајте критериуми за прифаќање и отворени прашања. Разгледајте го тоа еднаш со соодветно лице, а потоа забележете ги одлуките и следното одговорно лице. Мал збир што редовно се одржува е покорисен од голем документ што никој не го ажурира.

Дополнително читање

NASA: Како да напишете добро барање

NASA: Управување со барања

Организирајте барања и спецификации со ReqSpec AI

ReqSpec AI нуди едноставен начин за организирање барања и спецификации на мобилен и на веб. Истражете ги функциите на страницата на апликацијата.