software requirements and design (srd) · figure 2-1: srd contents 2.1 hensikten med dokumentet et...
TRANSCRIPT
![Page 1: Software Requirements and Design (SRD) · Figure 2-1: SRD Contents 2.1 Hensikten med dokumentet Et løpende dokument som brukes til å gi en oversikt over hva som skal lages (Requirements)/utvikles](https://reader034.vdocuments.us/reader034/viewer/2022050611/5fb2bf81501de7175e4c1a0d/html5/thumbnails/1.jpg)
1
SoftwareRequirementsandDesign(SRD)Vimåhaenstandardtittelside(Side1)påalledokumenter.Itilleggtiltittel,kanvihamedfirmanavn,logo,m.m.Innholdsfortegnelsebørogsåværemedpåside2.
1 GenereltomdokumenterNedenforservitypiskedokumenterietsoftware-utviklingsprosjekt(Figure1-1).
Figure1-1:TypiskSoftwaredokumentasjon
Alledissedokumenteneskalvilageutoverifaget.
1.1 OneDriveDetkanværelurtåbrukef.eks.MicrosoftOneDrivefordelingogsamhandlingifmutarbeidelseavdokumentene.DaharmanmulighetenforatflerepersonersamtidigkanendrepåsammedokumentpåhversinPC.OneDriveerogsåinnebygdiWindows10,sådetkrevesikkenoeekstraforåtadetibruk.Mankanlagreopptil5Gbmeddatagratis,somjoburdeværenokivårttilfelle.ForbestutbytteerdetviktigatallebrukerWord2016,evt.WordOnline.
1.2 DokumentkategorierDokumenterkandelesinniulikekategorier(Figure1-2).
![Page 2: Software Requirements and Design (SRD) · Figure 2-1: SRD Contents 2.1 Hensikten med dokumentet Et løpende dokument som brukes til å gi en oversikt over hva som skal lages (Requirements)/utvikles](https://reader034.vdocuments.us/reader034/viewer/2022050611/5fb2bf81501de7175e4c1a0d/html5/thumbnails/2.jpg)
2
Figure1-2:Dokumentkategorier
Figure1-3viserforskjellenmellomettradisjoneltskoleprosjektogetvirkeligsoftware-prosjekt.
Figure1-3:Skoleprosjektvs.virkeligprosjekt
Dvs.viskalikkelageetdokumentiformavenrapportidettefaget(somjoervanliginoenprosjektfagiskolesammenheng),menetsettmeddokumentersomtilsammenvilinngåsomendelavtotalleveransen.Detteforågjøredetmestmuligvirkelighetsnærtiforholdtilhvordanetvirkeligsoftware-prosjektblirdokumentert.Deteringenfasitmtputarbeidelseavdokumentasjon,determangevarianteruteåår.Deterendelgrunnleggendetingsomgårigjenialleformerfordokumenter.Altdereharlærtomrapportskrivingtidligeregjelderogsåher!–Denenesteforskjellenathererdetfleredokumenteristedenforenrapport.Produktwebsidenblirpåenmåteselverapporten,mensSDP,SRD,STP,osv.blirpåenmåtevedlegg.Dvs.grunnleggende“rapporttekniske”tingsomTabellogfigurnummerering,m.m.måselvfølgeligværemed!
![Page 3: Software Requirements and Design (SRD) · Figure 2-1: SRD Contents 2.1 Hensikten med dokumentet Et løpende dokument som brukes til å gi en oversikt over hva som skal lages (Requirements)/utvikles](https://reader034.vdocuments.us/reader034/viewer/2022050611/5fb2bf81501de7175e4c1a0d/html5/thumbnails/3.jpg)
3
Typiskstruktur:Forside/Tittelside,innholdsfortegnelse,Innledning,enellerflerekapitlermedinnhold,+evtvedlegg.Brukenummereringiforbindelsemedkapitlerogunderkapitlerervanlig.Sidenummereringmåselvfølgeligværemed.Brukesamme“WordTemplate”påalledokumentene!–dvsbruksammefonter,fargebruk,m.m.ideulikedokumentene.Brukavreferanserderdeterbrukkilder,ressurserfraandre.
2 HvaerSRD?SRD–SoftwareRequirementsandDesignRequirements(WHAT):
• WHATthesystemshoulddo• DescribeswhatthesystemshoulddowithWordsandFigures,etc.• SRS–SoftwareRequirementsSpecificationDocument
SoftwareDesign(HOW):
• HOWitshoulddoit• Examples:GUIDesign,UML,ERdiagram,CAD,etc.• SDD–SoftwareDesignDocument
Note!Manydon'tseparateSRSandSDDdocuments,butincludeeverythinginaRequirements&DesignDocument(SRD).Inpractice,requirementsanddesignareinseparable.SRS–SoftwareRequirementsSpecificationsSDD–SoftwareDesignDocumentSRD–SoftwareRequirementsandDesignFigure2-1visertypiskinnholdietSRDdocument.
![Page 4: Software Requirements and Design (SRD) · Figure 2-1: SRD Contents 2.1 Hensikten med dokumentet Et løpende dokument som brukes til å gi en oversikt over hva som skal lages (Requirements)/utvikles](https://reader034.vdocuments.us/reader034/viewer/2022050611/5fb2bf81501de7175e4c1a0d/html5/thumbnails/4.jpg)
4
Figure2-1:SRDContents
2.1 HensiktenmeddokumentetEtløpendedokumentsombrukestilågienoversiktoverhvasomskallages(Requirements)/utviklesoghvordandetskallages/utvikles(Design).Dokumentetbrukessomen"kontrakt"mellomutviklingsfirmaogkunde,samtbrukeskontinuerligavutviklere(nårdeskallage/utvikleløsningen),testere(nårdeskaltesteløsningen)ogkunde(sikeatløsningenblirslikdeønsker)underveis.Myeavinnholdetlagesioppstartenavprosjektet(elleriforkantavprosjektet),meninnholdetmåoppdatereskontinuerlignårendringeroppstår,særligmedmedsmidigutviklingvildetteværetilfellet.
3 Eksempler3.1 EksempelATypiskinnholdiSRSdokumentet:Følgendetemaerbørværemed[1]:
• SystemOverview(briefdescriptionofwhatthesoftwaresystemwilldo)• TechnicalRequirements(Functionalrequirement,Non-functionalrequirements,
User-interfacespecification,Usertaskflow,Input/outputandotherdataspecifications,Interfacespecificationstoothersystems)
![Page 5: Software Requirements and Design (SRD) · Figure 2-1: SRD Contents 2.1 Hensikten med dokumentet Et løpende dokument som brukes til å gi en oversikt over hva som skal lages (Requirements)/utvikles](https://reader034.vdocuments.us/reader034/viewer/2022050611/5fb2bf81501de7175e4c1a0d/html5/thumbnails/5.jpg)
5
• AcceptanceCriteria/InteractionScenarios• Validation/Verification• RequirementsConsiderations(Assumptionmadeaboutthesoftware,Endusers,
Existingsystems,Environment,Limitations)• OtherInformation...
Merdetaljeromdissepunkteneduiboka-AppendixB.DennebokaertilgjengeligfraSafariBooksOnline.
3.2 EksempelBTypiskinnholdiSRSdokumentet:Følgendetemaerbørværemed[2]:
Figure3-1:SRSeksempel
Merk!DeretrengernødvendigvisikkefølgealternativAellerBslavisk,derekangjerneblande,tilføyeellerutelatetingsomikkeerrelevantforderesprosjekt.Deterviktigatmanharmedsoftware-arkitekturogoversiktoversoftwareplattformer,m.m.Dvs.skalsystemetsomutvikleskunvirkeforWindows?EllerskaldetvirkepåenMacogså.Hvilkenettlesereskalvistøtte?Godeskisser(Systemoversikt)iforbindelsemeddettemedulikdetaljeringsgradforulikelesereerrelevant.
3.3 EksempelCSoftwareRequirementsandDesign(SRD)document:
![Page 6: Software Requirements and Design (SRD) · Figure 2-1: SRD Contents 2.1 Hensikten med dokumentet Et løpende dokument som brukes til å gi en oversikt over hva som skal lages (Requirements)/utvikles](https://reader034.vdocuments.us/reader034/viewer/2022050611/5fb2bf81501de7175e4c1a0d/html5/thumbnails/6.jpg)
6
• SystemOverview– Introduction,Descriptionofthesystem,ProblemDescription,Sketchesofthe
system• TechnicalRequirements
– Functionalrequirement,Non-functionalrequirements,User-interfacespecification,Usertaskflow,Input/outputandotherdataspecifications,Interfacespecificationstoothersystems
• Architecture– Thetechnicalarchitectureofthesystem,systemsketches,etc.
• Database– Databasemodellinganddetaileddescriptions
• UML– UseCaseDiagrams,SequenceDiagrams,ClassDiagrams
etc.SRDisamixoftheSRSandSDDdocuments.Manydon'tseparateSRSandSDDdocuments,butincludeeverythinginaRequirements&DesignDocument(SRDdocument).Inpractice,requirementsanddesignareinseparable.
4 Referanser[1]F.Tsui,O.Karam,andB.Bernal,EssentialsofSoftwareEngineering,3ed.:Jones&
BarlettLearning,2014.[2]I.Sommerville,SoftwareEngineering,10ed.:Pearson,2015.[3]E.J.BraudeandM.E.Bernstein,SoftwareEngineering:ModernApproaches,2ed.:
Wiley,2011.