Polku 07Oppitunti 3 / 8

Tarkasta Discovery yhtenä dokumenttikokonaisuutena

Jäljitä vaatimus specificationista arkkitehtuuriin, datavirtoihin ja turvallisuusdokumentteihin. Käsittele muutokset ennen vanhentuneisiin oletuksiin perustuvaa suunnittelua.

Käytännön työ12 minTarkistettu

Julkaisija Näin kirjoitamme

Mitä opit

  • Selitä dokumenttijärjestyksen ja julkaisutilan merkitys.
  • Tunnista specification-muutoksen vaikutus riippuviin dokumentteihin.
  • Erota generoitu, julkaistu, tarkastettu ja vanhentunut sisältö.

Seuraa yhtä vaatimusta kokonaisuuden läpi

Jatketaan kuvitteellista työvälineiden pyyntöpalvelua. Ensimmäinen specification sallii pyyntöjen syötön managereille. Tiimi lisää työntekijöiden itsepalvelun.

Muutos koskee muutakin kuin näkymää. Työntekijät tarvitsevat identiteetin ja pääsyn omiin pyyntöihinsä. Managerin näkyvyys tarvitsee rajauksen. Datavirran ja turvallisuusarvion pitää kattaa molemmat roolit.

Määritä ja tarkasta tarkoitus Discoveryn Context-, Conversation- ja Documents-vaiheissa. Import-tuotteessa repoanalyysi korvaa keskustelun. Katso erillinen import-työnkulku.

Tunne pakolliset dokumentit

Pakollisia dokumentteja on kahdeksan specification mukaan lukien:

DokumenttiEsimerkin tarkastuskysymys
SpecificationKuka saa pyytää välineitä ja mihin tarkoitukseen?
User flowsMiten työntekijä lähettää pyynnön ja seuraa sitä?
ArchitectureMissä käyttöoikeuspäätös valvotaan?
Technology decisionsKäytetäänkö hyväksyttyjä identiteetti- ja datapalveluja?
Data flowMitkä komponentit vastaanottavat työntekijä- ja pyyntötiedot?
DPIAVastaako tietosuoja-arvio todellista käsittelyä?
Threat modelVoiko työntekijä lukea toisen pyynnön?
Risk registerKuka omistaa avoimen riskin ja sen käsittelyn?

Generointi seuraa riippuvuuksia ja julkaisujärjestystä. Tarkasta aikainen dokumentti ennen sen oletusten hyväksymistä seuraaviin. Generoitu DPIA on arviointiaineistoa. Sen olemassaolo ei yksin osoita lainmukaisuutta.

Look & Feel ja Service Blueprint ovat valinnaisia. Käytä niitä, kun renderöity käyttöliittymäsuunta tai palvelukuvaus auttaa arviointia.

Erota julkaisu tarkastuksesta

Specification alkaa draftina. Seuraava generointi käyttää julkaistua versiota. Muokkaus luo uuden draftin, jonka muutokset tulevat käyttöön uuden version julkaisulla.

Muilla dokumenteilla on julkaisu- ja tarkastustiedot. Generate remaining voi generoida puuttuvan kokonaisuuden järjestyksessä. Jokainen tulos tarvitsee tarkastuksen. Generoinnin valmistuminen ei ole ihmisen päätös oletusten oikeellisuudesta.

Tarkasta esimerkin käyttöoikeussääntö kaikista siihen liittyvistä dokumenteista. Oikea specification ja vanhentunut datavirta eivät muodosta yhtenäistä suunnitelmaa.

Käsittele muutokset tietoisesti

Specificationin uusi julkaisu voi merkitä riippuvat dokumentit Outdated-tilaan. Taiga ei kirjoita niitä huomaamatta uudelleen. Myös muun lähdedokumentin muutos voi vaikuttaa ketjun myöhempiin osiin.

Generoi tarvittavat dokumentit uudelleen Discoveryn ollessa avoinna. Generate remaining käsittelee myös vanhentuneet dokumentit. Tarkasta uudet tulokset ja etenkin useaan dokumenttiin vaikuttavat oletukset.

Finish Discovery tulee saataville, kun kaikki kahdeksan pakollista dokumenttia on julkaistu. Outdated ei estä viimeistelyä. Varmista yhtenäisyys itse: painike ei todista kaikkien tarkastusten valmistumista.

Viimeistely lukitsee kokonaisuuden ja avaa seuraavan työnkulun. Avaa Discovery uudelleen dokumentista, kun lukittua kokonaisuutta pitää muuttaa.

Anna suunnittelulle yhtenäinen tarkoitus

Kirjaa ennen suunnittelua nykyiset roolit, hyväksytyt rajat ja avoimet päätökset. Tarkista, että initiative-ehdotusten lähteet kuvaavat samaa tuotetta.

Hyödyllinen tarkastustulos on täsmällinen: ”Työntekijöiden itsepalvelu näkyy user flow -kuvauksissa, authorizationissa, datavirrassa ja uhkien käsittelyssä.” Jatka initiativeihin.

Sovella käytäntöön

Kuvitteellinen pyyntöpalvelu laajenee manager-käytöstä työntekijöiden itsepalveluun. Tunnista vaikutukset user flow -kuvauksiin, arkkitehtuuriin, datavirtaan, DPIA:han, threat modeliin ja risk registeriin. Mitä tarkastat tai generoit uudelleen ennen Discoveryn viimeistelyä?

Lataa työpohja (Markdown)

Testaa, mitä opit

Julkaiset uuden specification-version riippuvien dokumenttien generoinnin jälkeen. Miten toimit?

Lähteet ja lisälukeminen