Erthyglau / Gofynion a manylebau

Gofynion a manylebau: sut i drefnu penderfyniadau a newidiadau

Mae'n haws trafod ceisiadau pan fyddwch yn cofnodi beth sydd ei angen, pam mae'n bwysig a sut y byddwch yn gwirio'r canlyniad. Mae rheoli gofynion a manylebau'n cadw'r penderfyniadau hynny'n ddefnyddiol wrth i'r gwaith fynd rhagddo.

Beth ydych chi'n ei reoli ar wahân i'r ddogfen?

Dim ond un ffordd o gofnodi penderfyniad yw dogfen. Mae angen i chi hefyd wybod pa eitemau y cytunwyd arnynt, pa rai sy'n dal yn gynigion, pwy fydd yn ateb cwestiynau, a beth sy'n newid pan gaiff eitem ei diwygio. Mae hyn yn helpu i osgoi gweithio ar sail dehongliadau gwahanol o'r un cais.

Gall yr un dull helpu gyda datblygu apiau, offer mewnol, amodau cynnyrch a rheolau gweithredu. Dechreuwch gydag un nodwedd neu lif gwaith yn hytrach na cheisio dogfennu popeth ar unwaith.

Cysylltwch y nod, y gofyniad, y fanyleb a'r meini prawf derbyn

Mae timau'n defnyddio'r termau hyn mewn ffyrdd gwahanol. Yn yr enghraifft hon, mae gofyniad yn disgrifio canlyniad neu gyfyngiad sydd ei angen, mae manyleb yn cofnodi'r ymddygiad y cytunwyd arno, ac mae meini prawf derbyn yn egluro sut i'w wirio. Cytunwch ar yr ystyron hyn gyda'r bobl sy'n gweithio gyda'i gilydd.

Nod: lleihau trawsgrifio â llaw

Mae'r broses adrodd fisol ar hyn o bryd yn cynnwys copïo cofnodion â llaw. Diben allforio yw gwneud y gwaith hwnnw'n haws.

Gofyniad: allforio'r cofnodion sydd eu hangen ar gyfer yr adroddiad

Mae angen i aelod o staff allforio cofnodion ar gyfer mis penodol, o fewn cwmpas y data y mae ganddo ganiatâd i'w cyrchu.

Manyleb: diffiniwch y ffeil a'i hymddygiad

Cytunwch ar y colofnau, eu trefn, amgodio testun, fformat dyddiad, ymddygiad pan nad oes canlyniadau, a gwallau. Dewisiadau ar gyfer yr enghraifft hon yw'r rhain, nid gosodiadau diofyn cyffredinol.

Meini prawf derbyn: gwnewch y canlyniad yn wiriadwy

Paratowch gofnodion â dyddiadau a chaniatadau hysbys, allforiwch nhw a chymharwch yr allbwn â'r canlyniad y cytunwyd arno.

O nod i feini prawf derbyn Agor ReqSpec AI

Ysgrifennwch un syniad gwiriadwy fesul eitem

Mae ymadrodd fel “Gwneud allforio'n gyfleus” yn gadael dewisiadau pwysig heb eu penderfynu. Gwahanwch ddewis cyfnod, dewis meysydd allbwn, ymdrin â dim canlyniadau cyfatebol a gwirio mynediad pan ellir newid neu wirio'r eitemau hynny'n annibynnol.

Defnyddiwch amodau penodol yn hytrach na geiriau fel “cyflym” neu “hawdd”. Os yw targed amser ymateb yn bwysig, cofnodwch y llwyth gwaith, yr amgylchedd a'r dull mesur yn ogystal â'r rhif. Nodwch yn glir fod gwerthoedd sydd heb eu penderfynu yn dal heb eu penderfynu.

Cyn: “Caniatáu allforio CSV.”

Ar ôl: “Allforiwch y mis a ddewiswyd gan ddefnyddio'r colofnau a'r drefn ddidoli y cytunwyd arnynt. Diffiniwch ganlyniadau gwag a gwiriadau mynediad mewn eitemau ar wahân.”

Mae'r geiriad diwygiedig yn nodi'r dewisiadau y mae angen cytuno arnynt ac yn gwneud dyrannu ac adolygu'r gwaith yn haws. Mae angen diffiniadau penodol o feysydd o hyd cyn gweithredu.

Set fach o feysydd i ddechrau gyda nhw

ID, teitl a disgrifiad

Rhowch ID sefydlog i bob eitem, megis REQ-001. Nodwch y pwnc, yr amod a'r canlyniad disgwyliedig. Mae ID sefydlog yn helpu pobl i gyfeirio at yr eitem ar ôl i'r teitl newid.

Rheswm a ffynhonnell

Cofnodwch y broblem y mae'r eitem yn mynd i'r afael â hi a'i tharddiad, megis sgwrs, cais neu ddogfen ategol.

Blaenoriaeth a chwmpas

Gwahaniaethwch rhwng yr hyn sydd ei angen ar gyfer y fersiwn hon a'r hyn a all aros. Eglurwch y rheswm dros y flaenoriaeth; peidiwch â rhoi'r flaenoriaeth uchaf i bob eitem.

Perchennog a statws penderfyniad

Cofnodwch pwy fydd yn egluro'r eitem ac a yw'n ddrafft, dan adolygiad neu wedi'i chytuno. Gall perchennog y gweithredu a'r cymeradwywr fod yn bobl wahanol.

Meini prawf derbyn a gwybodaeth gysylltiedig

Cysylltwch yr eitem â'r manylebau, y dyluniadau, y tasgau a'r cofnodion dilysu perthnasol. Cadwch y cysylltiadau hynny'n gyfredol pan fydd y gofyniad yn newid.

Enghraifft: tri gofyniad ar gyfer allforio CSV misol

Mae'r canlynol yn enghraifft eglurhaol. Dylid cytuno ar enwau meysydd ac ymddygiad ar gyfer y cynnyrch rydych yn ei adeiladu; nid yw'r enghraifft yn fanyleb gyflawn ar gyfer pob nodwedd allforio.

REQ-001: cofnodion ar gyfer y mis a ddewiswyd

Enghraifft o fanyleb: defnyddiwch y mis a ddewiswyd yn y gylchfa amser fusnes y cytunwyd arni ac allforiwch ID, dyddiad y cofnod a theitl yn UTF-8, wedi’u didoli yn ôl dyddiad ac yna ID. Enghraifft derbyn: mae tri chofnod sy’n cyfateb yn cynhyrchu un rhes bennawd a’r tair rhes ddata hynny’n union, heb gofnodion o fisoedd eraill.

REQ-002: dim cofnodion sy'n cyfateb

Enghraifft o fanyleb: allforiwch y rhes bennawd y cytunwyd arni hyd yn oed pan nad oes unrhyw gofnodion cyfatebol. Enghraifft derbyn: mae'r set ddata brawf wag yn creu ffeil gyda'r pennawd hwnnw a dim rhesi data. Os yw'n well gennych neges yn hytrach na ffeil, cytunwch ar yr ymddygiad gwahanol hwnnw a'i ddogfennu.

REQ-003: caiff mynediad ei wirio cyn allforio

Enghraifft o fanyleb: ni all defnyddwyr heb ganiatâd allforio gynhyrchu'r ffeil, ac ni chynhwysir cofnodion y tu allan i'r cwmpas a ganiateir. Dylai enghreifftiau derbyn gynnwys defnyddiwr heb ganiatâd allforio a defnyddiwr sydd â mynediad cyfyngedig at gofnodion.

Defnyddiwch hierarchaeth heb golli penderfyniadau unigol

Grwpiwch eitemau yn ôl diben neu nodwedd, yna rhowch yr amodau manwl o dan y grŵp perthnasol. Er enghraifft: Adrodd → Allforio CSV misol → Cofnodion targed / Fformat ffeil / Canlyniadau gwag / Mynediad. Rhowch gefndir a chwestiynau agored mewn nodiadau yn hytrach na’u cymysgu mewn un gofyniad hir.

Os yw un amod yn effeithio ar sawl nodwedd, cadwch gyfeiriad clir at y fersiwn y cytunwyd arni yn hytrach na chopïo fersiynau gwahanol i bob adran. Gwiriwch pa fanylebau dilynol ac eitemau gwirio sy'n dibynnu arno cyn ei newid.

Cadwch gytundeb, gweithredu a gwirio ar wahân

Mae “Cytunwyd” yn golygu bod y cynnwys wedi’i dderbyn ar gyfer y cwmpas bwriadedig. Nid yw’n golygu bod y nodwedd wedi’i gweithredu. Nid yw “Gweithredwyd” yn cadarnhau bod y meini prawf derbyn y cytunwyd arnynt wedi’u bodloni, na bod y nodwedd wedi’i rhyddhau. Cadwch y gwahaniaethau hyn yn glir hyd yn oed os ydych yn defnyddio rhestr statws syml.

Adolygwch yr achos arferol, mewnbwn gwag neu goll, caniatadau a methiannau allanol lle bo'n berthnasol. Penderfynwch pa dystiolaeth i'w chadw, pwy sy'n ei gwirio a phwy all gau cwestiwn sydd heb ei ddatrys.

Cofnodwch newid a'i effaith cyn ei drin fel newid y cytunwyd arno

Mae cais newydd yn gynnig nes bod y bobl sy'n gyfrifol yn cytuno ar sut i'w drin. Cofnodwch y rheswm dros y newid, yr IDau yr effeithir arnynt, a'r effaith ar waith, dyddiadau, manylebau a gwirio. Ystyriwch hefyd a yw'r newid yn berthnasol i gofnodion neu ddefnyddwyr sydd eisoes yn defnyddio'r nodwedd.

Ar ôl y penderfyniad, diweddarwch y fanyleb gyfredol a rhowch wybod i'r bobl yr effeithir arnynt. Cadwch y fersiwn y cytunwyd arni o'r blaen neu nodyn newid pan fydd angen esbonio beth sydd wedi newid. Peidiwch â chymryd yn ganiataol fod offeryn yn cofnodi pob cymeradwyaeth ac adolygiad yn awtomatig.

Dewiswch le y gallwch ei gadw'n gyfredol

Ar gyfer rhestr fach, gall dogfen neu daenlen a rennir fod yn ddigon. Pan fo trafodaeth, gweithredu a gwirio wedi’u gwasgaru ar draws sawl offeryn, dewiswch brif gyfeirnod a chysylltwch y deunydd perthnasol ohono. Y peth pwysig yw bod pawb yn gallu adnabod y cynnwys cyfredol y cytunwyd arno.

Defnyddiwch AI ar gyfer drafft ac yna cadarnhewch y penderfyniadau

Gall AI helpu i restru gofynion posibl, trefnu drafft ac awgrymu cwestiynau sydd ar goll. Gwahanwch ffeithiau sydd wedi'u cadarnhau oddi wrth ragdybiaethau yn yr anogwr a gofynnwch iddo adael gwerthoedd sydd heb eu penderfynu fel cwestiynau. Adolygwch y canlyniad gyda'r bobl sy'n deall y defnydd bwriadedig.

Yn ReqSpec AI, gallwch drefnu gofynion a manylebau yn hierarchaidd a defnyddio AI i gynorthwyo gyda’u creu, eu golygu a’u gwirio. Gofynnwch gwestiwn penodol fel “Pa amodau ar gyfer canlyniadau gwag sydd heb eu diffinio o hyd?” Triniwch unrhyw ateb fel awgrym i’w wirio yn erbyn y cynnwys cofrestredig, nid fel prawf o gymeradwyaeth na chyflawnrwydd.

Dechreuwch gydag un nodwedd ac un adolygiad

Dewiswch un nodwedd, rhestrwch y canlyniadau sydd eu hangen, rhowch IDau i'r eitemau ac ychwanegwch feini prawf derbyn a chwestiynau heb eu hateb. Adolygwch y cyfan unwaith gyda pherson perthnasol, yna cofnodwch y penderfyniadau a'r person nesaf sy'n gyfrifol. Mae set fach sy'n cael ei chynnal yn fwy defnyddiol na dogfen fawr nad oes neb yn ei diweddaru.

Darllen pellach

NASA: Sut i ysgrifennu gofyniad da

NASA: Rheoli gofynion

Trefnwch ofynion a manylebau gyda ReqSpec AI

Mae ReqSpec AI yn cynnig ffordd syml o drefnu gofynion a manylebau ar ffôn symudol ac ar y we. Archwiliwch ei nodweddion ar dudalen yr ap.