Templed cofnod penderfyniad gan Jeff Tyree ac Art Akerman

Dyma'r templed disgrifio penderfyniadau saernïaeth a gyhoeddwyd yn "Architecture Decisions: Demystifying Architecture" gan Jeff Tyree ac Art Akerman, Capital One Financial.

• Mater (Issue): Disgrifiwch y mater dylunio saernïaeth rydych yn mynd i'r afael ag ef, gan beidio â gadael unrhyw gwestiynau ynghylch pam rydych yn mynd i'r afael â'r mater hwn nawr. Gan ddilyn dull minimalaidd, rhowch sylw i'r materion sydd angen sylw yn unig, a dogfennwch nhw, ar wahanol bwyntiau yn y cylch oes.

• Penderfyniad (Decision): Datganwch yn glir gyfeiriad y saernïaeth—hynny yw, y safbwynt rydych wedi'i ddewis.

• Statws (Status): Statws y penderfyniad, fel yn aros, wedi'i benderfynu, neu wedi'i gymeradwyo.

• Grŵp (Group): Gallwch ddefnyddio grwpio syml—fel integreiddio, cyflwyno, data, ac ati—i helpu i drefnu'r set o benderfyniadau. Gallech hefyd ddefnyddio ontoleg saernïaeth fwy soffistigedig, fel un John Kyaruzi a Jan van Katwijk, sy'n cynnwys categorïau mwy haniaethol fel digwyddiad, calendr a lleoliad. Er enghraifft, gan ddefnyddio'r ontoleg hon, byddech yn grwpio penderfyniadau sy'n ymdrin â digwyddiadau lle mae'r system angen gwybodaeth o dan ddigwyddiad.

• Rhagdybiaethau (Assumptions): Disgrifiwch yn glir y rhagdybiaethau sylfaenol yn yr amgylchedd lle rydych yn gwneud y penderfyniad—cost, amserlen, technoleg, ac ati. Sylwer y gall cyfyngiadau amgylcheddol (fel safonau technoleg a dderbynnir, saernïaeth menter, patrymau a ddefnyddir yn gyffredin, ac ati) gyfyngu ar y dewisiadau amgen rydych yn eu hystyried.

• Cyfyngiadau (Constraints): Cofnodwch unrhyw gyfyngiadau ychwanegol ar yr amgylchedd y gallai'r dewis amgen a ddewiswyd (y penderfyniad) eu hachosi.

• Safbwyntiau (Positions): Rhestrwch y safbwyntiau (dewisiadau dichonadwy neu ddewisiadau amgen) a ystyriwyd gennych. Mae'r rhain yn aml yn galw am esboniadau hir, ac weithiau hyd yn oed fodelau a diagramau. Nid yw hon yn rhestr gyflawn. Fodd bynnag, nid ydych am glywed y cwestiwn "Ydych chi wedi meddwl am...?" yn ystod adolygiad terfynol; mae hyn yn arwain at golli hygrededd ac at gwestiynu penderfyniadau eraill ynghylch saernïaeth. Mae'r adran hon hefyd yn helpu i sicrhau eich bod wedi gwrando ar farn eraill; mae datgan barn eraill yn glir yn helpu i ennyn cefnogaeth eu heiriolwyr i'ch penderfyniad.

• Dadl (Argument): Amlinellwch pam y dewisoch safbwynt, gan gynnwys eitemau fel cost gweithredu, cyfanswm cost perchnogaeth, amser i'r farchnad, ac argaeledd yr adnoddau datblygu angenrheidiol. Mae hyn yn debygol o fod mor bwysig â'r penderfyniad ei hun.

• Goblygiadau (Implications): Daw llawer o oblygiadau gyda phenderfyniad, fel y mae metamodel REMAP yn ei ddynodi. Er enghraifft, gallai penderfyniad greu angen i wneud penderfyniadau eraill, creu gofynion newydd, neu addasu gofynion presennol; gosod cyfyngiadau ychwanegol ar yr amgylchedd; galw am ailnegodi'r cwmpas neu'r amserlen gyda chwsmeriaid; neu alw am hyfforddiant ychwanegol i staff. Gall deall a datgan goblygiadau eich penderfyniad yn glir fod yn effeithiol iawn wrth ennill cefnogaeth a chreu map trywydd ar gyfer gweithredu'r saernïaeth.

• Penderfyniadau cysylltiedig (Related decisions): Mae'n amlwg bod llawer o benderfyniadau'n gysylltiedig; gallwch eu rhestru yma. Fodd bynnag, rydym wedi canfod bod matrics olrhain, coed penderfyniadau neu fetamodelau yn fwy defnyddiol yn ymarferol. Mae metamodelau'n ddefnyddiol i ddangos perthnasoedd cymhleth ar ffurf diagram (fel modelau Rose).

• Gofynion cysylltiedig (Related requirements): Dylai penderfyniadau gael eu gyrru gan y busnes. I ddangos atebolrwydd, mapiwch eich penderfyniadau yn glir i'r amcanion neu'r gofynion. Gallwch restru'r gofynion cysylltiedig hyn yma, ond rydym wedi canfod ei bod yn fwy cyfleus cyfeirio at fatrics olrhain. Gallwch asesu cyfraniad pob penderfyniad ynghylch saernïaeth at fodloni pob gofyniad, ac yna asesu pa mor dda y mae'r gofyniad yn cael ei fodloni ar draws yr holl benderfyniadau. Os nad yw penderfyniad yn cyfrannu at fodloni gofyniad, peidiwch â gwneud y penderfyniad hwnnw.

• Arteffactau cysylltiedig (Related artifacts): Rhestrwch y dogfennau saernïaeth, dylunio neu gwmpas cysylltiedig y mae'r penderfyniad hwn yn effeithio arnynt.

• Egwyddorion cysylltiedig (Related principles): Os oes gan y fenter set o egwyddorion y cytunwyd arnynt, sicrhewch fod y penderfyniad yn gyson ag un neu fwy ohonynt. Mae hyn yn helpu i sicrhau aliniad ar draws parthau neu systemau.

• Nodiadau (Notes): Gan y gall y broses o wneud penderfyniadau gymryd wythnosau, rydym wedi canfod ei bod yn ddefnyddiol cofnodi nodiadau a materion y mae'r tîm yn eu trafod yn ystod y broses gymdeithasoli.