Артыкулы / Патрабаванні і спецыфікацыі

Патрабаванні і спецыфікацыі: як арганізаваць рашэнні і змены

Запыты лягчэй абмяркоўваць, калі запісаць, што патрабуецца, чаму гэта важна і як праверыць вынік. Кіраванне патрабаваннямі і спецыфікацыямі дапамагае выкарыстоўваць гэтыя рашэнні па меры выканання працы.

Чым вы кіруеце акрамя дакумента?

Дакумент — толькі адзін са спосабаў зафіксаваць рашэнне. Таксама трэба ведаць, якія пункты ўзгоднены, якія яшчэ застаюцца прапановамі, хто адкажа на пытанні і што зменіцца пры пераглядзе пункта. Гэта дапамагае пазбегнуць працы на аснове розных тлумачэнняў аднаго і таго ж запыту.

Такі ж падыход можа дапамагчы ў распрацоўцы праграм, стварэнні ўнутраных інструментаў, вызначэнні ўмоў прадукту і правілаў працы. Пачніце з адной функцыі або працэсу, а не спрабуйце дакументаваць усё адразу.

Звяжыце мэту, патрабаванне, спецыфікацыю і крытэрыі прыёмкі

Каманды выкарыстоўваюць гэтыя тэрміны па-рознаму. У гэтым прыкладзе патрабаванне апісвае патрэбны вынік або абмежаванне, спецыфікацыя фіксуе ўзгодненыя паводзіны, а крытэрыі прыёмкі тлумачаць, як гэта праверыць. Узгадніце гэтыя значэнні з людзьмі, з якімі працуеце.

Мэта: паменшыць ручное перапісванне

Цяпер падчас штомесячнай справаздачнасці запісы капіруюцца ўручную. Мэта экспарту — палегчыць гэтую працу.

Патрабаванне: экспартаваць запісы, неабходныя для справаздачы

Супрацоўніку неабходна экспартаваць запісы за выбраны месяц у межах даных, да якіх ён мае дазволены доступ.

Спецыфікацыя: вызначце файл і яго паводзіны

Узгадніце слупкі, іх парадак, кадзіроўку тэксту, фармат даты, паводзіны пры пустым выніку і апрацоўку памылак. Гэта выбар для дадзенага прыкладу, а не ўніверсальныя налады па змаўчанні.

Крытэрыі прыёмкі: зрабіце вынік правяральным

Падрыхтуйце запісы з вядомымі датамі і дазволамі, выканайце экспарт і параўнайце вынік з узгодненым.

Ад мэты да крытэрыяў прыёмкі Адкрыць ReqSpec AI

Запісвайце адну правяральную ідэю на пункт

Фраза кшталту «Зрабіць экспарт зручным» пакідае важныя пытанні адкрытымі. Вылучыце выбар перыяду, вызначэнне палёў вываду, апрацоўку адсутнасці супадзенняў і праверку доступу ў асобныя пункты, калі іх можна змяняць або правяраць незалежна адзін ад аднаго.

Выкарыстоўвайце канкрэтныя ўмовы замест слоў накшталт «хуткі» або «просты». Калі важны мэтавы час адказу, запішыце не толькі лік, але і нагрузку, асяроддзе і метад вымярэння. Ясна пазначайце значэнні, якія яшчэ не вызначаны, як нявызначаныя.

Раней: “Дазволіць экспарт у CSV.”

Пасля: «Экспартуйце выбраны месяц з узгодненымі слупкамі і парадкам сартавання. Вызначце пустыя вынікі і праверкі доступу асобнымі пунктамі».

Удакладненая фармулёўка паказвае варыянты, якія трэба ўзгадніць, і палягчае размеркаванне і праверку працы. Перад рэалізацыяй усё яшчэ патрэбныя канкрэтныя азначэнні палёў.

Невялікі набор палёў для пачатку

ID, назва і апісанне

Прысвойце кожнаму элементу пастаянны ID, напрыклад REQ-001. Укажыце прадмет, умову і чаканы вынік. Пастаянны ID дазваляе спасылацца на элемент нават пасля змены назвы.

Прычына і крыніца

Запішыце, якую праблему вырашае элемент і адкуль ён узяўся, напрыклад з размовы, запыту ці дапаможнага дакумента.

Прыярытэт і абсяг

Аддзяліце тое, што патрэбна для гэтага выпуску, ад таго, што можа пачакаць. Растлумачце прычыны прыярытэту; не прызначайце кожнаму пункту найвышэйшы прыярытэт.

Адказны і статус рашэння

Запішыце, хто будзе ўдакладняць элемент і ці з'яўляецца ён чарнавіком, знаходзіцца на праверцы або ўжо ўзгоднены. Выканаўца і асоба, якая зацвярджае, могуць быць рознымі людзьмі.

Крытэрыі прыёмкі і звязаная інфармацыя

Звяжыце элемент з адпаведнымі спецыфікацыямі, дызайнамі, задачамі і запісамі праверкі. Абнаўляйце гэтыя спасылкі пры змене патрабаванняў.

Прыклад: тры патрабаванні да штомесячнага экспарту CSV

Ніжэй прыведзены ілюстрацыйны прыклад. Назвы палёў і іх паводзіны трэба ўзгадніць для прадукту, які вы ствараеце; гэты прыклад не з'яўляецца поўнай спецыфікацыяй кожнай функцыі экспарту.

REQ-001: запісы за выбраны месяц

Прыклад спецыфікацыі: выкарыстоўвайце выбраны месяц у ўзгодненым працоўным часавым поясе і экспартуйце ID, дату запісу і загаловак у UTF-8, адсартаваныя спачатку па даце, а потым па ID. Прыклад прыёмкі: тры адпаведныя запісы даюць адзін радок загалоўкаў і роўна тры радкі даных, без запісаў з іншых месяцаў.

REQ-002: адпаведных запісаў няма

Прыклад спецыфікацыі: экспартаваць узгоднены радок загалоўкаў, нават калі няма адпаведных запісаў. Прыклад крытэрыю прыёмкі: пусты тэставы набор стварае файл з гэтым загалоўкам і без радкоў даных. Калі вы аддаеце перавагу паведамленню замест файла, узгадніце і задокументуйце такія іншыя паводзіны.

REQ-003: перад экспартам правяраецца доступ

Прыклад спецыфікацыі: карыстальнікі без дазволу на экспарт не могуць стварыць файл, а запісы па-за дазволенымі межамі не ўключаюцца. Прыклады крытэрыяў прыёмкі павінны ахопліваць карыстальніка без дазволу на экспарт і карыстальніка з абмежаваным доступам да запісаў.

Выкарыстоўвайце іерархію, не губляючы асобных рашэнняў

Групуйце элементы паводле мэты або функцыі, а падрабязныя ўмовы размяшчайце ў адпаведнай групе. Напрыклад: Справаздачы → Штомесячны экспарт CSV → Мэтавыя запісы / Фармат файла / Пустыя вынікі / Доступ. Перадумовы і адкрытыя пытанні змяшчайце ў нататках, а не змешвайце ў адным доўгім патрабаванні.

Калі адна ўмова ўплывае на некалькі функцый, захоўвайце выразную спасылку на ўзгодненую версію замест капіравання розных версій у кожны раздзел. Перад змяненнем праверце, якія наступныя спецыфікацыі і пункты праверкі ад яе залежаць.

Раздзяляйце ўзгадненне, рэалізацыю і праверку

«Узгоднена» азначае, што змест прыняты ў межах запланаванага абсягу. Гэта не азначае, што функцыя рэалізавана. «Рэалізавана» не пацвярджае, што ўзгодненыя крытэрыі прыёмкі выкананы або функцыя выпушчана. Захоўвайце гэтыя адрозненні відавочнымі, нават калі выкарыстоўваеце просты спіс статусаў.

Праверце звычайны сцэнарый, пустыя або адсутныя ўваходныя даныя, дазволы і, дзе дарэчы, збоі знешніх сістэм. Вызначце, якія доказы захоўваць, хто іх правярае і хто можа закрыць нявырашанае пытанне.

Зафіксуйце змяненне і яго ўплыў, перш чым лічыць яго ўзгодненым

Новы запыт застаецца прапановай, пакуль адказныя асобы не дамовяцца, як з ім працаваць. Запішыце прычыну змены, закранутыя ID і ўплыў на працу, тэрміны, спецыфікацыі і праверку. Таксама ўлічыце, ці датычыцца змена запісаў або карыстальнікаў, якія ўжо выкарыстоўваюць функцыю.

Пасля прыняцця рашэння абнавіце бягучую спецыфікацыю і паведаміце зацікаўленым людзям. Захоўвайце папярэднюю ўзгодненую версію або нататку пра змены, калі трэба растлумачыць, што змянілася. Не мяркуйце, што інструмент аўтаматычна запісвае кожнае зацвярджэнне і кожную праўку.

Выберыце месца, дзе зможаце падтрымліваць актуальныя даныя

Для невялікага спіса можа быць дастаткова агульнага дакумента або электроннай табліцы. Калі абмеркаванне, рэалізацыя і праверка размеркаваны паміж некалькімі інструментамі, выберыце асноўную крыніцу і дадайце ў ёй спасылкі на звязаныя матэрыялы. Важна, каб кожны мог вызначыць актуальны ўзгоднены змест.

Выкарыстоўвайце AI для чарнавіка, а потым пацвердзіце рашэнні

ШІ можа дапамагчы скласці спіс магчымых патрабаванняў, упарадкаваць чарнавік і прапанаваць пытанні, якіх не хапае. Аддзяляйце ў запыце пацверджаныя факты ад дапушчэнняў і прасіце пакідаць нявызначаныя значэнні ў выглядзе пытанняў. Праверце вынік разам з людзьмі, якія ведаюць, як гэта плануецца выкарыстоўваць.

У ReqSpec AI можна іерархічна арганізоўваць патрабаванні і спецыфікацыі, а таксама выкарыстоўваць ШІ для дапамогі ў іх стварэнні, рэдагаванні і праверцы. Задайце канкрэтнае пытанне, напрыклад: «Якія ўмовы для пустых вынікаў яшчэ не вызначаны?» Разглядайце любы адказ як прапанову, якую трэба праверыць паводле зарэгістраванага зместу, а не як пацвярджэнне зацвярджэння ці паўнаты.

Пачніце з адной функцыі і адной праверкі

Выберыце адну функцыю, пералічыце патрэбныя вынікі, прысвойце пунктам ID і дадайце крытэрыі прыёмкі ды адкрытыя пытанні. Адзін раз абмяркуйце ўсё з адпаведным чалавекам, а затым зафіксуйце рашэнні і таго, хто адказвае за наступны крок. Невялікі набор, які падтрымліваецца ў актуальным стане, больш карысны за вялікі дакумент, які ніхто не абнаўляе.

Дадатковая літаратура

NASA: Як напісаць добрае патрабаванне

NASA: Кіраванне патрабаваннямі

Упарадкуйце патрабаванні і спецыфікацыі з ReqSpec AI

ReqSpec AI прапануе просты спосаб арганізаваць патрабаванні і спецыфікацыі на тэлефоне і ў інтэрнэце. Азнаёмцеся з магчымасцямі на старонцы праграмы.