TUGAS TEKNIK DOKUMENTASI DOKUMENTASI MAKALAH MATERI MATERI
Disusun Oleh : Arief Rakhmad Wicaksono Wicaksono MI-2B 13311400!
MANAJEMEN INFORMATIKA TEKNOLOGI INFORMASI POLITEKNIK NEGERI MALANG 2015
DAFTAR ISI
DAFTAR ISI..............................................................................................2 BAB 1 KEBUTUHAN DOKUMENTASI................................................................3 1.1
Dokumen!"# P$o%ek ...........................................................................3
1.2 1.2
L!n&k L!n&k!' !'(L (L!n !n&k &k!' !' Pen) Pen)ok okum umen en! !"# "#!n !n P$o% P$o%ek ek ...............................................4
1.2.1
Pen)e*#n#"#!n..............................................................................4
1.2.2
Pe$en+!n!!n...............................................................................5
1.2.,
O$&!n#"!"#.................................................................................6
1.2.-
Pen&!!"!n...............................................................................7
1.2.5
Pen%e/e"!#!n...............................................................................8
1.2.
Le!)#n&....................................................................................8
BAB II DOKUMENTASI PERANANGAN SISTEM..............................................10 2.1
Tuu!n.........................................................................................10
2.2
Pen)!'u/u!n..................................................................................10
2., 2.,
.............................. .............................10 .............10 Ak# Ak#*# *#! !"" Pe$ Pe$en en+! +!n! n!!n !n Pen& Pen&em em3! 3!n& n&!n !n So* So*! !$e $e..............
2.2.-
Doku Dokume men n!" !"## %!n& %!n& 3#!" 3#!"! ! )#&u )#&un! n!k! k!n n.........................................................11
2.-.1
P$oe+ P/!n..............................................................................11
2.-.2
S4e"#*#k!"# De"!#n.......................................................................13
BAB III MODEL DOKUMENTASI PERANANGAN SISTEM...................................15 ,.1
Tuu!n.........................................................................................15
,.2
................................ ............................... ..................15 ...15 ono' )okumen!"# 4e$!n+!n&!n "#"em................
,.,.1
Ke3uu'!n 4e 4en&&un!...................................................................15
,.,.2
S4e"#*#k!"#................................................................................16
,.,.,
De"!#n....................................................................................18
,.,. ,.,.-
................................... ............................19 .............19 Im4/ Im4/em emen en! !"# "# )!n )!n 4em 4em#/ #/#' #'!n !n ekn ekno/ o/o& o&##....................
,.,.5
Pen&u#!n................................................................................19
BAB I KEBUTUHAN DOKUMENTASI 1.1 Dokumen!"# P$o%ek Dokumen"asi se#uah $ro%ek adalah sua"u dokumen"asi %an& #erisi ke#u"uhan user %an& akan diim$lemen"asikan dalam #en"uk s$esifikasi dan ins"ruksi' (eun"un&an dari mem#ua" dokumen"asi $ro%ek adalah se#a&ai #eriku" : -
Men&e"ahui dam$ak "eknolo&i dan #isnis Men&hi"un& es"imasi #ia%a sesun&&uhn%a Menen"ukan "in&ka" usaha Menca$ai sua"u $en%elesaian %an& $alin& efek"if #ia%an%a' Memilih $eran&ka" #an"u dan "eknik "er#aik
(uali"as $roses #iasan%a meli#a"kan elemen #eriku" ini : Meo)o/o&# )ua"u cara* me"oda* un"uk menca$ai "u+uan' )ua"u me"odolo& #erlaku
secara umum* den&an $erencanaan "in&ka" "in&&i* dan di&unakan se#a&ai landasan se"ia$ $ro%ek' Dokumen!"# : Dokumen khusus* %an& $ada a,al $ro%ek akan meneran&kan secara &aris #esar %an& akan dilen&ka$i $ada se"ia$ $ro%ek %an& dilaksanakan' S!n)!$) anduan %an& disusun dan di&unakan $ada sua"u ins"i"usi un"uk
-
men%elesaikan sua"u $eker+aan' .on"oh s"andard ini adalah : (ese$aka"an $enamaan un"uk #er#a&ai macam kode* o (ese$aka"an la%ar /I* o kese$aka"an da"a modellin&' o )"andard ini $en"in& karena meru$akan landasan: se#a&ai keran&ka ker+a* o )arana komunikasi' o u&a un"uk men&on"rol kuali"as ser"a men+a&a kon"inui"as $en&em#an&an' o
1.2 L!n&k!'(L!n&k!' Pen)okumen!"#!n P$o%ek 1.2.1
Pen)e*#n#"#!n
Den&an mendefinisikan $ro%ek den&an "e"a$* dihara$kan $ro%ek da$a" mulai dan diakhiri den&an #ia%a %an& $alin& efek"if' ermasuk men+a,a# : ,ho* ,ha"* ,hen* ,here* ,h% and ho, dari $elaksanaan $ro%ek "erse#u"' eran&ka" #an"u un"uk melaksanakan "u&as ini dise#u" den&an )"a"emen" of "he Works )OW' )OW adalah kese$aka"an an"ar clien" dan de5elo$er' Dokumen ini di"ulis #erdasarkan $ers$ek"if #isnis dan "eknis %an& #erisi "o$ik-"o$ik #eriku" ini : en&an"ar misal informasi la"ar #elakan& u+uan dan o#%ek"if misal cos"* +ad,al* dan kuali"as )co$e misal* a$likasi 6M7 a"au 8RM7 Assumsi misal kemam$uan $enan&anan $enin&ka"an "raffic +arin&an ser )um#er da%a misal s$esialis +arin&an* $ro&rammer Milestone un"uk $en+ad,alan misal ,ak"u akhir "es"in& em#ia%aan #ia%a lan&sun& dan o5erhead Amandemen" definisi ulan& dari $en%erahan $eker+aan anda "an&an mana+emen senior dan komuni"as $en&&una
)OW mem#erikan keun"un&an ke"ika di&unakan un"uk memulai sua"u $ro%ek' 9ai"u :
Men+elaskan 3#!%! dan !)!/ +u&a asumsi u"ama "en"an& $ro%ek Men+elaskan 4e$!n!n )!n !n&&un& !!3 ' Men&ukuhkan )e*#n#"# '!/ %!n& !k!n )#+!4!# 4$o%ek In"rane" "erse#u"' Men)o$on& )#"e/e"!#k!nn%! 4$o%ek e$"e3u * karena adan%a kese$aka"an "er"ulis dalam dokumen "erse#u" "anda "an&an'
1.2.2
Pe$en+!n!!n SO6 men+a#arkan #ia%a secara kasar* 4en!)!/!n7 ku!/#!"7 dan "um3e$)!%!
m!nu"#! $ada sua"u $ro%ek' erencanaan se#a&ai lan&kah #eriku"n%a meli$u"i "aha$an
%an& da$a" dilaksanakan secara #eruru"an a"au$un $aralel' lan&kah "erse#u" adalah:
Men%usun Work Breakdo,n )"ruc"ure WB) Daf"ar $eker+aan %an& harus diselesaikan o Dasar es"imasi* alokasi sum#er da%a* men%usun +ad,al* dan men&hi"un& #ia%a o Mem$er"im#an&kan secara serius se#elum mem#an&un sua"u $ro%ek' o
Men&es"imasi ,ak"u $elaksanaan $ro%ek o Mo" o4#m#"#+ : Wak"u ideal un"uk men%elesaikan $eker+aan* diasumsikan o
se&ala sesua"un%a #er+alan lancar* dan sem$urna' Mo" /#ke/% Wak"u %an& di#u"uhkan $ada kondisi ke#an%akan* "i$ikal dan
o
normal' Mo" 4e""#m#"#+ Wak"u %an& di#u"uhkan ke"ika keadaan $alin& suli" "er+adi'
Men&alokasikan sum#er da%a en&im#an&an ,ak"u se"ia$ $eker+aan* ke"ersediaan* dan kemam$uan sum#er da%a' 6arus di"en"ukan le5el load dari sum#er da%a* a&ar "ak ada $ersonal %an& #eker+a "erlalu #era"* dan ada %an& "erlalu rin&an'
Men&hi"un& $em#ia%aan A$akah #ia%a %an& akan dikeluarkan sesuai den&an )OW; ika sesuai* maka $eker+aan $erencanaan selesai* #ila "idak harus dilakukan re5isi' Bila meman& suli" harus dilakukan ne&osiasi den&an $ihak $em#eri ker+a' (e"ika melakukan $erhi"un&an #ia%a $erlu di$er"im#an&kan #e#era$a #ia%a "ersem#un%i*
misal "rainin&* dokumen"asi' Men%usun +ad,al ker+a Di#a&i men+adi 2*%ai"u : o B!$ '!$7 %an& han%a meneran&kan sho, "ime dari se"ia$ $eker+aan dan "an$a o
ke"erkai"an an"ar $eker+aan' Deskri$si ini $alin& #aik di&unakan $ada $resen"asi Neo$k D#!&$!m7 %an& menen+ukkan ke"erkai"an an"ar "u&as dan men&iden"ifikasi saa" kri"is $ada +ad,al' )ua"u ne",ork dia&ram* meru$akan cara "er#aik un"uk merencanakan secara de"ail* dan men&iku"i $erkem#an&an $ro%ek' Dia&ram ini akan men&hu#un&kan $eker+aan "erkai"* dan ,ak"u mulai dan #erakhirn%a dari $eker+aan "erse#u"' Men&iden"ifikasi ke"erkai"an $eker+aan $ada $ro%ek In"rane" adalah san&a" $en"in& se#a# kom$onen-kom$onen "erse#u" salin& "erkai" a&ar da$a" #eker+a sesuai den&an fun&sin%a'
en&elolaan resiko Mana+er $ro%ek da$a" menen"ukan "in&ka" ke$en"in&an se"ia$ "u&as' Mana+er $ro%ek da$a" #erkonsen"rasi $ada ,ak"u dan sum#er da%a $ada elemen %an& "erkri"is dari $en+ad,alan'
1.2.,
O$&!n#"!"# Adalah $roses $en%usunan sua"u infras"ruk"ur %an& akan memaksimalkan efisiensi dan
efek"ifi"as ke"ika melaksanakan $ro%ek' 9an& harus di$er"im#an&kan adalah : S$uku$ e!m
Di"en"ukan den&an men+elaskan o o o
en+elasan $eranan an&&un& +a,a# 6u#un&an $ela$oran )OW se#aikn%a men%ediakan dasar un"uk men+elaskan ke-3 hal dia"as' Informasi
ini mem#an"u un"uk me$ersia$kan s"ruk"ur "eam* se$er"i un"uk men&hasilkan : Dia&ram or&anisasi Ma"riks "an&&un& +a,a# o Dokumen!"# o Dokumen!"# adalah $en"in& sekali* se#a# user memiliki $eranan $en"in& dalam o
o
o o
mem#ua" dan mera,a" kandun&an ,e# si"e' D#!&$!m !$"#eku$7 $eran&ka" #an"u ma$$in&* dan manual on line meru$akan $eran&ka" #an"u dokumen"asi "eknis' Dokumen!"# 3#"n#" se$er"i la$oran s"a"us* dan +ad,al +u&a $en"in&' Dokumen"asi #aik "eknis mau$un #isnis* harus disim$an dalam $ er$us"akaan %an& da$a" diakses un"uk referensi menda"an&'
Pe$emu!n erdiri dari 3 +enis : 7 dilakukan secara re&ular un"uk men&um$ulkan informasi o Status review meeting
o
o
men&enai kondisi dari $eker+aan indi5idu' Checkpoint review meeting 7 dilakukan un"uk menca$ai miles"one #esar* se$er"i mense"u$ ser5er' Staff meeting 7 dilakukan un"uk #er"ukar informasi dan #er"ukar $en&alaman #a&i seluruh $ihak %an& "erli#a"
1.2.-
Pen&!!"!n roses ini men+amin #ah,a $ro%ek In"rane" efek"if $em#ia%aan%a* dan sesuai den&an %an& direncanakan' roses ini "erdiri dari :
•
S!u" o//e+#on Men&um$ulkan da"a "en"an& $en%elesaian sua"u $eker+aan*
(emudian mem#ua" $enilaian men&enai $erkem#an&an %an& dilakukan'
o
S#"# Tekn#" : enilaian kuali"as $eker+aan %an& dilakukan'
o
S#"# 3#"n#" : ada "in&ka"an mana $eker+aan i"u dilakukan #erdasarkan ,aku "er"en"u'
'!n&e on$o/ eker+aan men&e5aluasi $elaksanaan "eknis dan +ad,al'
o
A$akah se#enarn%a $eru#ahan %an& "er+adi misal arsi"ek"ur +arin&an'
o
A$a dam$akn%a #a&i finansial* +ad,al* dan kuali"as sis"em'
o
Ba&aimana $enan&anan $eru#ahan "erse#u"'
o
Bilamana $eru#ahan "erse#u" akan men%e#a#kan sua"u efek'
o$$e+#8e A+#on : Melakukan re5isi $endeka"an un"uk $enca$aian "u+uan $ro%ek sesuai
den&an )OW dan $erencanaan' Berkai"an sekali den&an lan&kah s"a"us collec"ion and assesmen"* se#a# lan&kah %an& di#u"uhkan misal $erencanaan ulan&* #er&an"un& a$akah correc"i5e ac"ion ini $erlu dilakukan secara #esar a"au cuku$ sediki" sa+a'
1.2.5
Pen%e/e"!#!n en&um$ulan dan analisis da"a Men&iden"ifikasi den&an #aik Berdasarkan seluruh da"a dalam $ro%ek Menurunn%a $roduk"ifi"as' Berdasarkan da"a %an& dikoleksi men&enai un+uk ker+a $ro%ek melalui kum$ulan hasil
s"a"is"ik* ,a,ancara* dan re5ie, se"elah im$lemen"asi' - endensi a$akah %an& "er+adi di an"ara $ersonal %an& "erli#a" $ada $en&em#an&an
$ro%ek $ada saa" mendeka"i akhir $ro%ek' - Bila sua"u $ro%ek akan selesai #iasan%a an&&o"a "eam men+adi menurun $roduk"ifi"asn%a'
1.2.6 Le!)#n&
aha$an ini $en"in& sekali han%a akan "er+adi #ila ke lima $roses se#elumn%a dilakukan
den&an #ernar' ada "aha$an ini di#u"uhkan $em#en"ukan sua"u lin&kun&an ker+a %an& mendoron&
$ihak %an& "erli#a"* sehin&&a da$a" "erca$ain%a "u+uan' n"uk menca$ai hal "erse#u"* mana+er $ro%ek haruslah : Mem#ua" 5isi %an& +elas #a&i $ro%ek o Berkomunikasi den&an efek"if o Men+a&a mo"i5asi %an& "in&&i o Men+a&a fokus dari 5isi o Men%ediakan lin&kun&an %an& mendukun& o Mendoron& $en%usunan "eam' o )ua"u $ro%ek akan da$a" dilakukan den&an #aik #ila "elah dilakukan $roses en&ineerin& %an& #aik' Ini #erlaku #aik un"uk $en&em#an&an $ro&ram den&an $roduk +adi* a"au den&an kon"rak"or a"au +u&a den&an "eam sendiri' 7e#ih #aik men&ha#iskan ,ak"u le#ih lama un"uk melakukan disain dan $ena"aan a,al %an& #aik* dari$ada "er#uru-#uru melakukan im$lemen"asi'
BAB II DOKUMENTASI PERANANGAN SISTEM 2.1
2.2
Tuu!n
Men&e"ahui #a&aimana mendokumen"asikan $erancan&an sis"em
Men&e"ahui ak"i5i"as $em#ua"an dokumen"asi $erancan&an sis"em
Men&e"ahui macam-macam dokumen"asi $erancan&an sis"em
Pen)!'u/u!n
n"uk $ro%ek sof",are %an& #esar* #iasan%a dokumen"asi dilaksanakan se#elum $roses $en&em#an&an dimulai' ro$osal un"uk men&em#an&kan sis"em da$a" di#ua" se#a&ai res$on "erhada$ $ermin"aan un"uk "ender oleh klien eks"ernal a"au un"uk meres$on dokumen s"ra"e&i #isnis lainn%a'
2.,
Ak#*#!" Pe$en+!n!!n Pen&em3!n&!n So*!$e
Memilih sua"u model un"uk $roses $en&em#an&an
Men&on"rak dan men%usun "im $em#ua" sof",are
Mem#eli a"au men%e,a $eran&ka" keras
Memilih $roduk #er$o"ensi #erdasarkan $en&alaman keor&anisasian* sum#er da%a* dan "u+uan'
Men&e5aluasi informasi $asar men&enai 5ia#li"as $roduk
Men&es"imasi #ia%a* +ad,al* "ersiko dan har&a dari $roduk
Memilih #en"uk la$oran dan cara $en&ukuran $erkem#an&an $ro%ek
Memilih no"asi un"uk s$esifikasi dan $erancan&an
Memilih #ahasa $emro&raman
2.-
Mele"akkan s"andar un"uk dokumen"asi* codin&* 5erifikasi dan $en&u+ian
Memilih mekanisme $en&a"uran konfi&urasi
Men%ia$kan #ahan dan $ersonil un"uk ins"alasi
Dokumen!"# %!n& 3#!"! )#&un!k!n 2.-.1 •
P$oe+ P/!n
en&an"ar Deskri$si $ermasalahan o o
Deskri$si lin&kun&an masalah
ro$osal o
=un&si %an& di#erikan $ada solusi %an& dia+ukan
o
)"ra"e&i umum un"uk men&em#an&kan solusi
(e"er#a"asan sis"em o
riori"as kus"omer
o
rofil $en&&una
o
sia $en&hara$an dari $roduk
o
ra-s%ara" keandalan relia#ili"as
o
ra-s%ara" kiner+a
o
7in&kun&an $eran&ka" keras dan an"ar muka %an& "elah ada
>s"imasi o
ad,al
o
)"af dan or&anisasi
o
Bud&e"
o
Analisis resiko
2.-.2 •
•
•
•
rosedur o
Model $roses
o
Me"odolo&i dan no"asi
o
)"andardisasi dan +aminan kuali"as
o
Accoun"a#ili"% moni"orin&
o
(endali $roduk
o
Da"a $en&u+ian dan sum#er da"a
o
(ri"eria akse$"ansi dan me"oda $em#a%aran
Refferensi o
Dokumen"asi %an& di&unakan dalam $en&em#an&an
o
(amus is"ilah
o
(on"rak %an& diusulkan +ika ada S4e"#*#k!"# De"!#n
)ua"u dokumen s$esifikasi desain "erdiri dari : endahuluan /aris #esar $ermasalahan o 7in&kun&an a$likasi dan karak"eris"ik $en&&una o ?o"asi %an& di&unakan dalam desain o u+uan $ro%ek o )$esifikasi desain =un&si $eran&ka" lunak o eknik %an& di&unakan un"uk men%elesaikan masalah ini "eru"ama ke"ika o desainer "idak memiliki $en&e"ahuan khusus (iner+a %an& harus dica$ai o Desain arsi"ek"ur o )$esifikasi real "ime o )$esifikasi in"erakasi manusia dan mesin %an& di&unakan' Ba"asan o Modifikasi dan $era,a"an %an& di$rediksi o Modul hirarki dan dia&ram in"erface o )$esifikasi de"ail se"ia$ modul Deskri$si modul dan s$esifikasi in"erface o
o o o o o
•
Deskri$si $roses Definisi s"ruk"ur da"a ra-s%ara" inisialisasi )$esifikasi $enan&anan ekse$si Al"erna"if desain* un"uk "ia$ desain %an& di"olak diser"akan ke"eran&an alasan
$enolakan ser"a kondisi %an& men%e#a#kan desain %an& "er$ilih' Refferensi Referensi o Dokumen"asi %an& di&unakan un"uk men&em#an&kan desain' o Daf"ar "erminolo&i o
BAB III MODEL DOKUMENTASI PERANANGAN SISTEM ,.1
Tuu!n
Men&e"ahui con"oh model dokumen"asi $erancan&an sis"em
Men&e"ahui "aha$an $em#ua"an dokumen"asi $erancan&an sis"em
,.2.1
Ke3uu'!n 4en&&un! De*#n#"# ke3uu'!n 4en&&un! Mendefinisikan ke#u"uhan dan hal-hal %an& #erkai"an den&an ke#u"uhan sis"em
secara men%eluruh' =ak"an%a* dokumen ini harus dise"u+ui oleh $em#eri ker+a dan $elaksana ker+a' Ba&ian %an& di#ahas dalam dokumen ini adalah : Purposeful requirement . Men+elaskan men&a$a ke#u"uhan i"u $erlu di$enuhi Functional requirement. A$akah fun&si se#enarn%a %an& di#u"uhkan oleh user dari sis"em ini' Nonfunctional requirement. (e#u"uhan sis"em %an& "idak #erkai"an den&an fun&sin%a %an& meli#a"kan
se$er"i* #isa dimodifikasi* "es"in&* dan $or"a#ili"as User Profile. Meneran&kan "en"an& $en&&una dari sis"em ini* "eru"ama %an& #erkai"an
den&an "in&ka" $en&enalan "erhada$ "eknolo&i %an& akan di"era$kan' An!/#"#" ke3uu'!n Requirement Prioritisation. Men+a#arkan ke#u"uhan mana %an& "er$en"in& dari ke#u"uhan-ke#u"uhan %an& "im#ul un"uk sis"em %an& akan di#ua" "erse#u"' Constraint and Risk nal!sis. Memahami halan&an dan resiko %an& ada un"uk men&im$lemen"asikan model dan men&a$likasikan sis"em ini' "rade#off anal!sis. Men&e"ahui hal-hal %an& salin& #er"en"an&an dalam $erancan&an* $en&im$lemen"asian ser"a $en&a$likasian dari solusi' Mo)e/ ke3uu'!n Ba&ian ini men%usun model ke#u"uhan "erse#u" men+adi sua"u #en"uk model ke#u"uhan'
Disusun a"as : Hierarchical (functional) model dari $riori"as* risk functional , non-functional requirement dan )ua"u $ro"o"%$e %an& in"erac"i5e' Functional model Exploratory prototype Requirement trace The conceptual model ,.2.2
S4e"#*#k!"#
S4e"#*#k!"# "#k/u" o4e$!"# "#"em7 Dalam #a&ian ini di+elaskan siklus $en&&unaan
sis"em ini' u+uan un"uk menda$a"kan s$esifikasi "eknis "eru"ama akan #er&una $ada #a&ian im$lemen"asi' )is"em fault tolerant 24 +am akan #er#eda den&an sis"em %an& #ero$erasi 1 +am sehari' Be&i"u +u&a siklus ker+a sis"em* a"au lan&kah ker+a sa"u demi sa"u dis$esifikasikan' S4e"#*#k!"# *un&"#on!/7 $ssential Capa%ilities
Di+a#arkan fun&si u"ama dari sis"em' Ini meru$akan fun&si minimal %an& harus di$enuhi oleh sis"em %an& di#ua"' dditional Capa%ilites
Dideskri$sikan fun&si "am#ahan %an& "im#ul karena di$enuhi dan di&unakan sis"em ini' Future Capa%ilities
Men+elaskan fun&si $ada masa da"an& dari sis"em ini' en+elasan ini era" kai"ann%a den&an marketing strategy, technological dan ales' Kom4onen "#"em
oft!are ,
hard!are,
"ser * dan
Or&anisasi $enun+an&'
S4e"#*#k!"# k#ne$!.
Men+elaskan $erformansi < un+uk ker+a %an& in&in dica$ai ser"a kemun&kinan ke"er#a"asan di dalam $en&&unaan sis"em' )e"ia$ ke#u"uhan diusahakan dis$esifikasikan den&an +elas* "ermasuk karak"eris"ik elek"ris dan fisis' Characteristics and Constraints
Meru$akan karak"eris"ik "ia$ kom$onen $endukun& sis"em* "ermasuk karak"eris"ik fisis* elek"ris* mau$un karak"eris"ik $eran&ka" lunak misal@ user friendl% dan in"erak"if' u&a di+a#arkan ke"er#a"asan di dalam $en&&unaan sis"em
Ph!sical characteristics
Meru$akan $en+elasan #en"uk luar dari sis"em secara keseluruhan* misal@ ukuran #era" dan lain-lain'
$nvironmental characteristics
7in&kun&an "em$a" ker+a dari sis"em ini
&uman Factors
en&aruh manusia di dalam o$erasi sis"em* #aik se#a&ai $enen"u o$erasi* misal dalam decision making system a"au super#ised control system'
u&a $en&aruh manusia dalam menim#ulkan ke"idak-akura"an a"au kesalahan sis"em'
,.2.,
De"!#n D#!&$!m 3/ok
Men&&am#ar #lok dia&ram sis"em secara keseluruhan dan in"erface an"ara kedua #a&ian "erse#u"' Blok dia&ram "erdiri dari 2 #a&ian* %ai"u dunia di luar sis"em dan di dalam sis"em' Flow of Control
Meneran&kan kondisi-kondisi %an& mun&kin dari sis"em ser"a "ransisi dari sa"u kondisi ke kondisi lainn%a'
Representation of 'ata Flow
Men&&am#arkan aliran da"a ser"a "ransformasi %an& dialami da"a "erse#u" dalam sis"em
'ecomposition into Functions
Mem#a&i-#a&i fun&si secara keseluruhan men+adi su# sis"em den&an su# fun&sin%a' Da$a" di&unakan ree Dia&ram'
Relationship among Function
Di+elaskan hu#un&an an"ar su# sis"em den&an kai"ann%a "erhada$ su#fun&sin%a'
Module Spesification
Men&&am#arkan s$esifikasi dari modul sis"em' Dalam memilih dia&ram un"uk mendesain sis"em $erlu di$erha"ikan #e#era$a $oin :
)ua"u ala" #an"u un"uk #erfikir secara +elas
Mudah dimen&er"i
)e#a&ai ala" #an"u un"uk komunikasi den&an end -user
,.2.
Im4/emen!"# )!n 4em#/#'!n ekno/o&#
Men+elaskan me"ode dan $erala"an %an& di&unakan un"uk men&im$lemen"asikan solusi %an& "elah dia+ukan dalam #a&ian desain'
Men+elaskan alasan $emilihan "eknolo&i %an& di&unakan'
)e#elum dilakukan $emilihan "eknolo&i a"au le5el ala" %an& di&unakan maka harus dilakukan es"imasi "erhada$ #e#era$a hal :
,.2.5
>s"imasi ,ak"u un"uk men&em#an&kan sis"em
>s"imasi $an+an&n%a $ro&ram
>s"imasi ke#u"uhan memori
>s"imasi kece$a"an eksekusi
u&a harus di$er"im#an&kan $em#a&ian an"ara sof",are dan hard,are Pen&u#!n
Ba&ian ini menun+ukkan ker+a dari sis"em #aik un"uk masukan %an& #ersifa" normal* a"au$un un"uk masukan %an& di luar am#an& normal'
)e"ia$ $en&u+ian dilakukan dokumen"asi se#a&ai #uk"i o"en"ik kemam$uan sis"em'
ada dasarn%a* dilakukan "es"in& #eriku" ini :
Recover! testing
n"uk men&e"ahui kemam$uan sis"em* un"uk men&em#alikan ke kondisi normal se"elah sua"u masukan a"au kondisi di luar dari %an& dis$esifikasikan'
Stress testing
n"uk men&e"ahui kemam$uan sis"em dalam menan&ani #e#an ker+a %an& #era"* san&a" #aik un"uk men&e"ahui kemam$uan maksimal dari sis"em'
Securit! testing
n"uk men&e"ahui +enis-+enis a$likasi %an& #erkai"an den&an keamanan sis"em* #aik dari $en&&una %an& melakukan kesalahan secara sen&a+a a"au$un "idak sen&a+a'
Dalam melakukan u+i co#a da$a" di&unakan #e#era$a me"odolo&i* dian"aran%a:
"se-$ase
%hite &ox
&lack &ox
'oop testing
ada dasarn%a sua"u "es"in& akan melakukan :
8erifikasi : Men+amin #ah,a sis"em #enar-#enar #eker+a sesuai fun&sin%a'
8alidasi : Men+amin #ah,a sis"em #enar-#enar memenuhi kein&inan $emakai'
BAB I9 DOKUMENTASI
BAB 9 KUALITAS DOKUMEN
)"ruk"ur Dokumen
)"andar Dokumen
roses
roduk
er"ukaran
/a%a enulisan
Dokumen"asi Online
BAB VI & VII Document 1 :.1 Ke/!" Dokumen!"#
'1'1 Dokumen"asi roses Dokumen-dokumen ini merekam $roses $em#an&unan dan $emeliharaan' Rencana* +ad,al* dokumen kuali"as $roses dan s"andar or&anisasi dan $ro%ek %an& $roses dokumen"asi' Dokumen"asi $roses di#a&i ke dalam #e#era$a ka"e&ori: 1' Rencana* $erkiraan dan +ad,al' Ini adalah dokumen %an& dihasilkan oleh mana+er %an& di&unakan un"uk mem$rediksi dan men&on"rol $roses sof",are' 2' 7a$oran* Ini adalah dokumen %an& mela$orkan #a&aimana sum#er da%a di&unakan selama $roses $em#an&unan' 3' )"andar* Ini adalah dokumen %an& mene"a$kan #a&aimana $roses %an& harus dilaksanakan' Ini da$a" dikem#an&kan dari s"andar or&anisasi* nasional a"au in"ernasional 4' (er"as ker+a' Ini serin& dokumen komunikasi "eknis u"ama dalam $ro%ek' Mereka menca"a" ide dan $emikiran dari $ara insin%ur %an& #eker+a $ada $ro%ek* adalah 5ersi in"erim dokumen"asi $roduk* men+elaskan s"ra"e&i $elaksanaan dan men&a"ur masalah-masalah %an& "elah diiden"ifikasi' Mereka serin&* secara im$lisi"* merekam alasan un"uk ke$u"usan desain' ' Memo dan $esan sura" elek"ronik' Ini menca"a" rincian komunikasi sehari-hari an"ara mana+er dan insin%ur $en&em#an&an '1'2 Dokumen"asi roduk Dokumen"asi ini men+elaskan $roduk %an& sedan& ma+u' Dokumen"asi sis"em men&&am#arkan $roduk dari sudu" $andan& $ara insin%ur men&em#an&kan dan mem$er"ahankan sis"em dokumen"asi $en&&una men%ediakan $roduk deskri$si %an& #erorien"asi $ada $en&&una sis"em' Dokumentasi Pengguna 1. Akhir-pengguna menggunakan perangkat lunak untuk membantu dengan beberapa tugas. Hal ini dapat menerbangkan pesawat terbang, mengelola kebijakan asuransi, menulis buku, dll Mereka ingin tahu bagaimana perangkat lunak dapat membantu mereka. Mereka tidak tertarik pada komputer atau administrasi rincian.
2. istem administrator bertanggung jawab untuk mengelola perangkat lunak !ang digunakan oleh pengguna akhir. "ni mungkin melibatkan bertindak sebagai operator jika sistem adalah sistem main#rame besar, sebagai manajer jaringan sistem melibatkan jaringan workstation atau sebagai guru teknis !ang perbaikan masalah-pengguna akhir perangkat lunak dan !ang bekerja, dan ketika antara pengguna dan pemasok perangkat lunak.
Diferent types o user !ocument"tion
:.2 Fun&"# De"k$#4"# Deskripsi #ungsional dari sistem menguraikan pers!aratan sistem dan secara ringkas menjelaskan la!anan !ang disediakan. Dokumen ini harus memberikan gambaran tentang sistem. Pengguna harus dapat membaca dokumen ini dengan panduan pengantar dan memutuskan apakah sistem ini apa !ang mereka butuhkan :., S#"em In"!/!"# Dokumen sistem instalasi ditujukan untuk administrator sistem. "ni harus memberikan rincian tentang bagaimana untuk menginstal sistem di lingkungan tertentu. "ni harus berisi deskripsi dari $le !ang membentuk sistem dan kon$gurasi hardware minimal !ang diperlukan.
7.4 #istem $eerensi %e#erensi sistem manual harus menjelaskan #asilitas sistem dan penggunaann!a, harus memberikan da#tar lengkap pesan kesalahan dan harus menjelaskan bagaimana memulihkan dari kesalahan terdeteksi.
7.5 %"n!u"n #istem A!ministr"tion
Panduan ebuah sistem administrator !ang lebih umum harus disediakan untuk beberapa jenis sistem seperti komando dan kontrol sistem. "ni harus menggambarkan pesan !ang dihasilkan ketika sistem berinteraksi dengan sistem lain dan bagaimana bereaksi terhadap pesan-pesan ini. &ika perangkat keras sistem !ang terlibat, mungkin juga menjelaskan tugas operator dalam menjaga hardware !ang. ebagai contoh, mungkin menjelaskan bagaimana untuk membersihkan kesalahan dalam sistem konsol, bagaimana menghubungkan peripheral baru, dll
BAB I; Ku!/#!" Dokumen <.1 Pe)om!n S$uku$ Dokumen
1' )emua dokumen harus memiliki halaman co5er %an& men&iden"ifikasikan $ro%ek* nama dan +enis dokumen* $en&aran&* "an&&al $em#ua"an dokumen* informasi $en+aminan kuali"as* $erun"ukan dokumen dan "in&ka" kerahasiaan dokumen' 2' Dokumen %an& le#ih dari #e#era$a halaman* harus di#a&i men+adi #a#-#a# dan su# #a#' Memiliki daf"ar isi* men&&unakan $enomoran #a# dan su# #a# %an& konsis"en' )e"ia$ #a# memiliki $enomoran halaman "er$isah* sehin&&a memudahkan a$a#ila ada $eru#ahan di salah sa"u #a# sa+a* "idak $erlu melakukan $eru#ahan nomor halaman di keseluruhan dokumen' 3' A$a#ila dokumen memiliki #an%ak $en+elasan de"il* informasi referensi harus di#eri inde' 4' A$a#ila dokumen di$erun"ukkan $em#aca %an& memun&kinkan $en&e"ahuann%a #er#eda* &lossar% $erlu di"am#ahkan un"uk men+elaskan is"ilah-is"ilah "eknis dan akronim %an& di&unakan di dokumen <.2 S!n)!$ Dokumen 1' )"andar dokumen meru$akan dasar un"uk melakukan $en+aminan kuali"as sua"u dokumen' 2' Dokumen %an& di#ua" #erdasarkan s"andar %an& #enar akan memiliki "am$ilan* s"ruk"ur dan kuali"as %an& konsis"en' )"andar" dokumen"asi %an& di &unakan $ada $roses dokumen"asi :
)"andar $roses Mendefinisikan $roses %an& harus diiku"i un"uk men&hasilkan dokumen %an& #erkuali"as "in&&i' )"andar $roduk )"andar %an& men&a"ur dokumen i"u sendiri')"andar $er"ukaran < interchange standards' )"andar $er"ukaran men+a&a a&ar se"ia$ dokumen da$a" kom$a"i#el'
<., S!n)!$ P$o"e" 1' )"andar $roses men&a"ur $endeka"an < me"ode %an& harus dilakukan dalam mem#ua" sua"u dokumen' 2' Menen"ukan sof",are < "ools %& di&unakan menulis dokumen dan $rosedur $en+aminan kuali"as %an& da$a" dilakukan un"uk men&ukur kuali"as dokumen %an& dihasilkan' 3' )"andar $en+aminan kuali"as dokumen harus fleksi#el dan mencaku$ semua "i$e dokumen' 4' Dalam #e#era$a kasus meman& "idak $erlu di"era$kan s"andar $en+aminan kuali"as dokumen* se$er"i $ada dokumen lem#ar ker+a a"au memo' <.- S!n)!$ P$o)uk )"andar roduk #erlaku un"uk semua dokumen %an& di$roduksi oleh $en&em#an& sof",are' Be#era$a s"andar %an& seharusn%a di$erha"ikan : 1' )"andar Iden"ifikasi Dokumen 2' )"andar s"ruk"ur dokumen 3' )"andar $resen"asi Dokumen 4' )"andar u$da"e Dokumen <.5 G!%! P!n)u!n Penu/#"!n 1' en&&unaan kalima" ak"if 2' en&&unaan "a"a #ahasa dan e+aan %an& "e$a" 3' (uran&i kalima"-kalima" %an& $an+an& 4' (uran&i $ara&raf %an& $an+an& ' idak #er"ele-"ele ' /unakan dan definisikan is"ilah secara "e$a" ' lan&i $en+elasan un"uk hal %an& rumi" den&an #ahasan %an& #er#eda !' /unakan +udul #a# dan su# #a# C' Men&&unakan #ulle"s
