Projektisuunnitelma. CoSCA-simulaattorin jatkokehitysprojekti. TeamDC

Transkriptio

1 Projektisuunnitelma CoSCA-simulaattorin jatkokehitysprojekti TeamDC

2 Muutoshistoria Versio Pvm Tekijä Kuvaus Elina Kontro Ensimmäinen mallipohjaan täytetty versio, englanninkielinen Elina Kontro Laura Lehtola Dokumentointi kielen vaihto, rakenteen muuttamista, sisältöä budjetti, termejä Asiakkaan tavoitteet, riskienhallintasuunnitelma ja riskiloki. Kirjoitusvirheiden korjausta Kari Ylihärsilä Ohjelmointikäytännöt ja työkalut, ideoiden lisäystä Elina Kontro Templaten vaihto, sisällön päivitystä, PP-iteraatio suunnitelman tietojen siirtäminen tähän dokumenttiin ja päivittäminen Laura Lehtola Terminologiaa, vaatimustenhallinta, alustava budjetti, katselmointikäytännöt Elina Kontro Kari Ylihärsilä Elina Kontro Aikatauluja, termejä, korjauksia Tarkka kuvaus työkaluista, versionumerot ja linkit työkaluihin. Yleisiä parannuksia. Merkitsin avoimia kohtia TODO merkinnöillä. Työmääräarvioita, palaverikäytäntöjen & budjetin päivitys, kehittäjä -> suunnittelija Kari Ylihärsilä Parannuksia, lisätty rakennekaavio, tekstin selvennystä Elina Kontro Elina Kontro SEPA päivitystä Elina Kontro Laura Lehtola Santeri Saarinen QA-osuuden aloitus lukuun Oppimistavoitteita, SEPA aiheet, kokouskäytäntöjen päivitys, virheiden korjausta SEPA päivitystä, oppimistavoitteiden päivitystä, työmääräarvio PP iteraatioon päivitetty, johdanto, tuntiraportointia tarkennettu, pienryhmät lisätty, korjauksia Käyttäjä- ja asiakasnäkökulman varmistaminen, vaatimusten hallinnan uusi versio, kirjoitusvirheiden korjausta ja muotoilua Elina Kontro QA-kohdan hieromista Elina kontro Henkilöstö kohtaan työmäärä korjaus, SEPA aiheen korjaus Elina Kontro QA-asiat siirretty omaan tiedostoon Elina Kontro Suunnitelman päivitystä (I1 iteraatio suunnitelma), vastuumuutokset Elina Kontro Riski-login tarkastusta, lähdeluettelo, I1 päivitystä Elina Kontro Elina Kontro Projektisuunnitelman päivitys välietappikatselmuksen jälkeen: käytäntöjä päivitetty, katselmointipäivämäärät ja ryhmät I1 Työmääräarviotaulukko päivitetty, riskilogi siirretty liitteeksi. Muita korjauksia Elina Kontro Riskilokin päivitys, korjauksia Elina Kontro Katselmoinnin perusteella tehtyjä korjauksia 1

3 Elina Kontro Koodikatselmointien ja katselmointikäytännön siirto laatusuunnitelmaan Elina Kontro Dokumenttikatselmointi päivämäärät ja henkilöt Elina Kontro I2- työmääriä korjattu, riskiloki päivitetty Elina Kontro Pieniä korjauksia ja päivityksiä I2-kohtaan Laura Lehtola Lisäyksiä, poistoja ja tarkennuksia Elina Kontro Pieniä korjauksia ja tarkennuksia Elina Kontro Päivitetty I2 teotuneet työtunnit 2

4 Sisällysluettelo 1 Johdanto Projektin tarkoitus ja laajuus Terminologia ja määritykset Järjestelmä ja ympäristö 3 2 Osapuolet ja henkilöstö Projektiryhmä Muut osapuolet 5 3 Tavoitteet ja lopetuskriteerit Asiakkaan tavoitteet Projektiryhmän tavoitteet Henkilökohtaiset oppimistavoitteet Projektin keskeytyskriteerit Projektin lopetuskriteerit 9 4 Resurssit ja budjetti Henkilöt Materiaalihankinnat Budjetti 11 5 Työkäytännöt ja työkalut Käytännöt Iteratiivinen kehitys Iteraation suunnittelu Dokumentointi Riskienhallinta Tuntiraportointi Ohjelmakoodin koon raportointi Kommunikointi ja palaverikäytännöt Pienryhmät Katselmointikäytäntö Iteraatiodemot Vikojen seuranta Versionhallinta Koodauskäytäntö Vertaistestaus Vaatimusten määrittely ja hallinta Asiakas- ja käyttäjänäkökulman varmistaminen projektin aikana Välietappikatselmukset Laadunvarmistussuunnitelma Työkalut Kehityslaitteisto Ohjelmistot Kehitystyökalut 22 1

5 5.4 Standardit SEPA -työt Coding Camp Käytettävyyden arviointi Staattiset menetelmät 24 6 Vaiheistus Projektin suunnittelu (PP) Toteutusiteraatio 1 (I1) I1 iteraation tavoitteet I1 iteraation tuotokset I1-iteraation tehtävät I1 iteraation vaiheistus ja aikataulutus I1-iteraatiossa toteutuneet tunnit Toteutusiteraatio 2 (I2) Tavoitteet: Tuotokset I2-iteraation tehtävät I2 iteraation vaiheistus ja aikataulutus 40 7 Riskiloki 44 8 Lähdeluettelo 45 2

6 1 Johdanto Tämä dokumentti on TeamDC -projektiryhmän projektisuunnitelma Teknillisen Korkeakoulun kurssilla T Ohjelmistoprojekti I. Dokumenttia päivitetään koko projektin ajan. 1.1 Projektin tarkoitus ja laajuus Tehdastuotannon päivittäisenä haasteena on tehdä nopeasti päätöksiä tilausten aikataulutuksesta. Tällaisia päätöksiä ovat esimerkiksi koska toimitetaan, kenelle ja milloin tuotantoresurssit ovat käytettävissä. Päätösprosessi on yritykselle tärkeä, kuitenkin vain harvat yritykset käyttävät hyväkseen oman toimitusketjun hallitaan alan tutkijoiden kehittämiä satoja eri sääntöjä, jotka auttavat parempaan tilausten hallitsemiseen ja aikataulutukseen. Helsingin Kauppakorkeakoulussa (HKKK) kehitetyn CoSCA (Coordination of Supply Chain Activities) simulaattorin avulla on ollut tarkoitus mallintaa tilaus-toimitusketjun päätöksiä ja hajautettua tuotannonohjausta. Tällä hetkellä simulaattorilla on ollut yksi käyttäjä eikä siihen näin ollen ole kehitetty graafista käyttöliittymää. Asiakkaan keskeisenä tavoitteena on päästä hyödyntämään simulaattoria tuotannon suunnittelun ja ohjauksen sekä toimitusketjun hallinnan opetuksessa. Lisäksi asiakas haluaisi tarjota yritysmaailmassa työskenteleville käytännönihmisille mahdollisuuden ymmärtää kokeilun kautta, miten erilaisten päätössääntöjen käyttäminen vaikuttaa tilaus-toimitusprosessin ennustettavuuteen ja tehokkuuteen. Tässä ohjelmistokehitysprojektissa on tarkoitus toteuttaa olemassa olevaan CoSCA -simulaattoriin helposti opittava ja miellyttävä käyttöliittymä, jonka avulla oppijat pystyvät kokeilemaan, miten erityyppisten päätössääntöjen käyttäminen erilaisissa tilanteissa vaikuttaa töiden läpimenoon liittyviin tunnuslukuihin. Projektin alussa tullaan kartoittamaan myös muiden lisätoiminnallisuuksien tarvetta ja toteutusmahdollisuuksia tässä projektissa. Tämän ohjelmistokehitysprojektin toteuttaa TeamDC- projektiryhmä T Ohjelmistoprojekti I-kurssin harjoitustyönä. Projektiryhmässä on 7 henkilöä, joista kaikilla on kiinteä 150 tunnin työmäärä käytettävissä projektiin. Osa ryhmän jäsenistä suorittaa projektin ohessa parityönä työmäärältään 20h/henkilö olevan T Ohjelmistotuotannon erikoiskurssin projektia tukevasta aiheesta ja panostavat projektiin 20h/henkilö lisää. Projektin aikataulu on kiinteä alkaen ja loppuen , sisältäen joululoman

7 1.2 Terminologia ja määritykset Seuraavassa taulukossa 1 on kuvattu tässä dokumentissa ja projektissa käytettäviä termejä ja lyhenteitä. Taulukko 1. Projektissa käytettäviä lyhenteitä ja terminologiaa Termi tai lyhyenne Kuvaus CoSCA Coordination of Supply Chain Activities CoSCA järjestelmä Tässä projektissa kehitettävä järjestelmä, joka käsittää sekä jo kehitetyn simulaattorin, että siihen kehitettävän käyttöliittymän. CosCA simulaattori HKKK:ssa kehitetty CoSCA simulaattori, jossa ei toistaiseksi ole varsinaista käyttöliittymää. HKKK Helsingin Kauppakorkeakoulu I1 1. Toteutusiteraatio (Implementation 1) I2 2. Toteutusiteraatio (Implementation 2) LOC Lines of Code Koodirivien määrä Management ryhmä Projektin johtoryhmä, johon kuuluvat projektipäällikkö (Elina), vaatimusmäärittelijä (Laura) sekä pääsuunnittelija(kari). NCLOC Lines of code without comments and blank lines Koodirivien määrä, poislukien kommenttirivit ja tyhjät rivit PP Projektisuunnittelu iteraatio Projektiryhmä Projektin toteuttava ryhmä (management ryhmä + suunnittelijat), jossa on seitsemän jäsentä. SEPA Software Engineering Practice Assignment, erillinen projektin ohessa pääasiassa parityönä toteutettava työ Suunnittelijat Projektin 4 jäsentä (Santeri, Samuel, Aleksi ja Vesa), joiden päävastuulla on järjestelmän tekninen suunnittelu, ohjelmointi ja testaus. TKK Teknillinen korkeakoulu XML Extensible Markup Language, tiedosto formaatti 2

8 1.3 Järjestelmä ja ympäristö Tämän projektin keskeisin tavoite on toteuttaa olemassa olevaan CoSCA-simulaattoriin graafinen käyttöliittymä. Olemassa oleva CoSCA -simulaattori on toteutettu Javalla, käyttäen open source työkaluja. Järjestelmää kehitetään ja testataan Windows-ympäristössä. Järjestelmän simulaatioajo kestää tyypillisesti (opetuskäytössä) muutaman sekunnin, haastavassa tapauksessa (tutkimuskäytössä) noin tunnin. Simulaattoria varten ei tarvita erillistä erikoisalustaa. Aiemmin kehitetty simulaattori lukee asetuksensa XML-tiedostosta ja raportoi tuloksensa tekstimuodossa tiedostoon, jota voidaan jatkokäsitellä esim. Excelillä. Laajennusprojektin tuotoksen on tarkoitus mahdollistaa asetusten syöttäminen, simulaation ajon hallinta ja tulosten raportointi käyttöliittymästä. Tarkempaa tietoa uuden järjestelmän toteutuksesta löytyy CoSCA GUI Technical Specification dokumentista. Järjestelmä toimii seuraavanlaisessa esimerkkikokoonpanossa: Pentium 4 (2,6 Ghz), 512Mb muistia, Windows 2000/XP, Java

9 2 Osapuolet ja henkilöstö Kuvassa 2 on esitetty projektin osapuolet. Asiakas Katariina Kemppainen Tekninen ohjaaja Lauri Svan Käyttäjät Projektiryhmä TeamDC Projektipäällikkö Elina Kontro Vaatimustenhallinta Pääsuunnittelija Laura Lehtola Vesa Haukkavaara Suunnittelijat Aleksi Airola Kari Ylihärsilä Samuel Korpi Santeri Saarinen Mentor Kari Suhonen Kuva 2. Projektin osapuolet 2.1 Projektiryhmä Projektiryhmän vastuulla on selvittää asiakkaan vaatimukset ja toteuttaa niiden mukainen käyttöliittymä ja toiminnallisuus CoSCA-simulaattoriin. Taulukossa 2 on esitetty projektiryhmän jäsenten roolit yleisellä tasolla sekä heidän yhteystietonsa. Vesa Haukkavaara on toiminut projektin pääarkkitehtina I1 iteraation alkupuolelta lähtien. Tätä ennen pääarkkitehdin tehtävistä vastasi Kari Ylihärsilä. Taulukko 2. TeamDC-projektiryhmä ja yhteystiedot Rooli Nimi Puhelinnumero Sähköpostiosoite Projektipäällikkö Elina Kontro elina.kontro(at)pp.inet.fi Mentoryhteyshenkilö Vaatimustenhallinta, Laura Lehtola laura.lehtola(at)hut.fi Asiakasyhteyshenkilö Pääsuunnittelija Vesa Haukkavaara vthaukka(at)cc.hut.fi Tekninen yhteyshenkilö Suunnittelija Kari Ylihärsilä kylihars(at)cc.hut.fi Suunnittelija Aleksi Airola aleksi.airola(at)tkk.fi Suunnittelija Samuel Korpi sjkorpi(at)cc.hut.fi Suunnittelija Santeri Saarinen santeri.saarinen(at)hut.fi 4

10 2.2 Muut osapuolet Projektin muut osapuolet ovat asiakas ja T Ohjelmistoprojekti 1 -kurssin henkilökunta. Asiakas-osapuoli voidaan jaotella itse asiakkaaseen, tekniseen ohjaajaan sekä ohjelmiston tuleviin käyttäjiin. Projektin asiakas ja yhteyshenkilö on Katariina Kemppainen Helsingin Kauppakorkeakoulusta. Asiakkaan vastuulla on esittää tavoitteet ja vaatimukset projektille prioriteettijärjestyksessä sekä hyväksyä toteutettu järjestelmä. Tekninen ohjaaja Lauri Svan on toteuttanut CoSCA simulaatorin nykyisen version ja hän on käytettävissä olemassa olevan toteutuksen teknisten ratkaisujen opastamisessa, sekä tulevan toiminnallisuuden suunnittelussa tekniseltä kannalta. Ohjelmiston käyttäjää projektissa edustaa joukko Helsingin Kauppakorkeakoulun opiskelijoita. Asiakaan vastuulla on auttaa etsimään vähintään kolme opiskelijaa, jotka tulevat olemaan käytettävissä projektin aikana (max. 5h/hlö). Käyttäjiltä pyritään kartoittamaan simulaattorin käyttöön liittyviä tarpeita ja lisäksi käyttäjät osallistuvat projektin puitteissa järjestettäviin käytettävyystesteihin. Mentor Kari Suhonen edustaa kurssin henkilökuntaan, auttaa projektiryhmää projektissa erityisesti kurssin suorittamiseen liittyvissä kysymyksissä sekä arvostelee palautukset. Taulukko 3. Muiden osapuolien yhteystietoja Rooli Nimi Puhelinnumero Sähköpostiosoite Asiakas Katariina Kemppainen katariina.kemppainen(at)hkkk.fi Tekninen ohjaaja Lauri Svan lauri.svan(at)hut.fi Mentor Kari Suhonen kari.suhonen(at)hut.fi 5

11 3 Tavoitteet ja lopetuskriteerit Seuraavissa kappaleissa kuvataan projektiryhmän ja asiakkaan asettamia tavoitteita projektille sekä projektin keskeytys ja lopetuskriteerit 3.1 Asiakkaan tavoitteet Taulukko 3 listaa asiakkaan tärkeimmät tavoitteet ja niiden hyväksyntäkriteerit prioriteettijärjestyksessä. Taulukko 4: Asiakkaan tärkeimmät tavoitteet Tavoite 1. Kyetä käyttämään järjestelmää opetuksen apuvälineenä HKKK:n tilaus-toimitus kurssilla sekä yritysyhteistyössä 1.1 Havainnollistaa tilaus-toimitus -aihealueen pääkäsitteitä ja niiden välisiä suhteita 1.2 Havainnollistaa graafisesti päätössääntöjen ominaisuuksia ja kyvykkyyttä erilaisissa tilanteissa 1.3 Tarjota opiskelijoille mahdollisuus pelata toisiaan vastaan tilaus-toimitus päätösvalintojen tekemisessä 1.4 Tarjota opiskelijoille mahdollisuus itse kokeilla käytettyjen päätössääntöjen vaikutusta läpimenoaikoihin erilaisilla koeasetelmilla 1.5 Tarjota opiskelijalle mahdollisuus tarkastella simulaatioajon vaiheita graafisesti 2. Käyttää olemassa olevan CoSCA simulaattorin tärkeimpiä toiminnallisuuksia graafisen käyttöliittymän avulla 3. Järjestelmän jatkokehitettävyys 4. Erilaiset käyttäjäryhmät kykenevät helposti saamaan ja asentamaan ohjelman itselleen 5. Lisätä asiakkaan omaa ymmärrystä siitä, miten tilaus-toimitus -aihealueen asioita pitäisi opettaa Hyväksyntäkriteeri Kohtien toteutuminen Järjestelmällä kykenee luomaan erilaisia testitilanteita (= systeemeitä) Käyttöliittymän avulla kykenee ajamaan läpi erilaisia testitilanteita, joiden tulokset järjestelmä esittää sekä numeerisessa että graafisessa muodossa. Käyttäjä voi nähdä käyttöliittymän avulla, miten hänen tekemänsä päätökset vaikuttavat tärkeimpiin tunnuslukuihin eri ajanhetkillä Järjestelmä on niin helppokäyttöinen ja intuitiivinen, että käyttäjän ei tarvitse olla aihealueen asiantuntija. Käyttöliittymässä on mahdollisuus tarkastella graafisesti käyttäjän käyttämien päätössääntöjen menestymistä ajan funktiona. Tutkija voi itse käyttää itselleen tärkeimmiksi nimeämiään simulaattorin ominaisuuksia nykyistä toimintatapaa helpommin. Koodi on modulaarista ja kommentoitu projektissa päätetyn käytännön mukaisesti. Järjestelmä on paketoitu ja siinä on käyttö- ja asennusohjeet. Järjestelmän voi kätevästi asentaa Windows XP käyttöjärjestelmään. Asiakas pystyy nimeämään vähintään kaksi oivallustaan siitä, miten aihealueen vaikeimmat asiat selitetään aihealuetta tuntemattomille yliopistoopiskelijoille. 6

12 3.2 Projektiryhmän tavoitteet Projektiryhmän tavoitteet ja kriteerit, joilla nämä tavoitteet todetaan saavutetuiksi on listattuna taulukossa 5. Taulukko 5: Projektiryhmän yhteiset tavoitteet Tavoite Hyväksyntäkriteeri 1. Kurssin läpäiseminen Ryhmä saa kurssista hyväksytyn arvosanan 2. Saada aikaan asiakkaan tarpeita vastaava tuote 3. Saada käytännön kokemusta ohjelmistotuotteen toteuttamisesta iteratiivisesti ja inkrementaalisesti 4. Henkilökohtaiset oppimistavoitteet saavutetaan Asiakas on tyytyväinen toteutettuun ja toimitettuun ohjelmistoon, ja kokee sen täyttävän sille asetetut vaatimukset. Projektin jälkeen jokainen ryhmän jäsen kokee tietävänsä enemmän ko. ohjelmistokehitysmenetelmästä kuin ennen projektin alkua ja pystyy mainitsemaan jonkin menetelmästä käytännön kautta oppimansa asian. Jokainen ryhmän jäsen kokee saavuttaneensa itselleen asettamansa oppimistavoitteet (luku 3.3) 5. Kurssista saadaan arvosana 5 Ryhmän lopullinen arvosana kurssista on 5 6. Saada onnistuneesta projektista maininta ansioluetteloihin 7. Oppia uusia ohjelmistotuotannon tekniikoita 8. Sujuva kommunikaatio asiakkaan kanssa 9. Projektiryhmän toimiva kommunikointi ja ryhmätyöskentely Projektiryhmä saa työstään positiivisen arvion sekä asiakkaalta että järjestävältä kurssilta ja voi tätä tunnustusta hyödyntää tulevissa työnhakutilanteissaan. Kukin projektiryhmän jäsen pystyy listaamaan 3 ohjelmistotuotannon tekniikkaa tai työkalua, joista kokee tietävänsä enemmän kuin ennen projektin alkua. Asiakas kokee saaneensa riittävästi tietoa projektin etenemisestä koko projektin ajan ja voineensa vaikuttaa siihen, mitä ominaisuuksia järjestelmään toteutetaan. Sovitut tehtävät hoidetaan sovittuihin päivämääriin mennessä ja työmäärä jakaantuu tasaisesti ryhmän kesken. Ryhmänjäsenet kokevat pysyvänsä riittävällä tarkkuudella ajan tasalla muiden ryhmäläisten tekemisistä. 10. Tavoitteet on asetettu oikein suhteessa käytettäviin resursseihin Projektin tavoitteet saavutetaan ylittämättä kurssin asettamaa työpanosta (150 h tai 190h/ henkilö). 7

13 3.3 Henkilökohtaiset oppimistavoitteet Taulukossa 6 on lueteltu jokaisen ryhmän jäsenen henkilökohtaiset oppimistavoitteet. Taulukko 6: Henkilökohtaiset oppimistavoitteet Ryhmän jäsen Rooli Henkilökohtainen oppimistavoite Santeri Saarinen Samuel Korpi Kari Ylihärsilä Aleksi Airola Vesa Haukkavaara Laura Lehtola Elina Kontro Suunnittelija Suunnittelija Suunnittelija Suunnittelija Pääsuunnittelija Vaatimusmäärittelijä Projektipäällikkö Saada käytännön kokemusta tämän suuruusluokan (7 henkeä, 6kk) ohjelmistoprojektista. Projektissa haluaisin erityisesti saada kokemusta projektin laadunhallinnasta, dokumentoinnista, sekä projektin etenemisen seuraamisesta sille asetettujen vaatimusten näkökulmasta. Oppia paremmin hyödyntämään tarjolla olevia ohjelmistokehitystyökaluja (erityisesti Eclipse) erilaisissa ohjelmistokehitysprojekteissa. Kehittää olemassa olevia ryhmätyöskentelytaitojaan. Opettelen, miten 7-henkisen projektiryhmän toimintaa pyöritetään niin, että projekti kantaa hedelmää. Opin tuntemaan ohjelmistoprojekteja niin, että voisin muun koulutuksen avulla madollisesti konsultoida alalla. Opin ihmisten johtamisesta ja ohjelmistoarkkitehtuurin suunnittelusta niin, että selvästi koen olevani valmis näihin myös työtehtävissä. Odotan pääseväni soveltamaan opittuja asioita siinä laajuudessa, että se valmistaa työelämää varten. Olen perehtynyt jonkin verran käytettävyyteen ja on aika päästä kokeilemaan omia siipiään. Konkreettisina oppimistavoitteina on tutustuminen tarkemmin vaatimustenmäärittelyyn ja - hallintaan sekä Eclipse kehitysympäristön ja sen plug-inien kokonaisvaltaisempi hallitseminen. Tärkein tavoitteeni on oppia käyttöliittymä- ja käytettävyyssuunnittelun perusteet sekä käytettävyystestauksen asioita. Toinen tavoitteeni on syventää osaamistani oliopohjaisen järjestelmän suunnittelutavoissa. Lisäksi toivon projektin suorittamisen välillisesti tukevan tuotantotalouden opintojani. Saada käytännön kokemusta käyttäjälähtöisestä vaatimusmäärittelytyöstä tiiviissä yhteistyössä asiakkaan kanssa, sekä oppia lisää asiakkaan odotuksien hallitsemisesta ja asettamisesta oikealle tasolle. Oppia lisää menestyksellisestä toimimisesta asiaorientoituneen asiakkaan ja teknisesti orientoituneiden kehittäjien välillä. Saada kokemusta ohjelmistokehitysprojektin vetämisestä Käytettävyys-näkökulman soveltaminen käytännön projektissa 8

14 3.4 Projektin keskeytyskriteerit Projekti keskeytetään projektiryhmän, asiakkan ja mentorin yhteisellä päätöksellä, mikäli kaksi tai useampi projektiryhmän jäsen jättää projektin kesken tai mikäli asiakas lopettaa yhteistyön projektiryhmän kanssa. 3.5 Projektin lopetuskriteerit Projekti loppuu, kun jokin seuraavista kriteereistä täyttyy: Kurssi päättyy aikataulunsa mukaisesti Asetettuja tavoitteita vastaava tuote on toimitettu asiakkaalle, ja asiakas on sen hyväksynyt Asiakas hyväksyy projektin päättyneeksi muista syistä 9

15 4 Resurssit ja budjetti Seuraavassa kuvataan projektin suunnitellut resurssit ja budjetti. 4.1 Henkilöt Projektin työmääräarviot vaiheittain kullekin henkilölle on esitetty taulukossa 7. Työmääräarvioita päivitetään, kun todelliset työmäärät selviävät ja myöhempien vaiheiden suunnittelu tarkentuu. Koko projektissa yksittäisen henkilö työmäärä kokonaisuudessaan on joko 150h tai 190h. Laajempi työmäärä pitää sisällään SEPA-työn. Taulukko 7: Projektin työmääräarviot PP iteraatiossa Elina Laura Kari Aleksi Vesa Samuel Santeri Yhteensä PP I I Yhteensä Taulukko 8: Projektin työmääräarviot I1 iteraatiossa henkilöittäin (* PP kohdassa toteutuneet) Elina Laura Kari Aleksi Vesa Samuel Santeri Yhteensä PP * 82, ,5 13, ,5 I1 86,5 54, , ,5 I , ,5 60,5 91, Yhteensä Taulukko 9. Projektin työmääräarvoit I2 iteraatioon (* PP ja I1 toteutuneet työmäärät), I2 toteuma päivitetty Elina Laura Kari Aleksi Vesa Samuel Santeri Yhteensä PP * 82, ,5 13, ,5 I1 * ,5 73, ,5 79,5 526 I2 EE 38 25,5 48, , ,5 I2 toteuma ,5 79, Yhteensä 196, ,5 177, ,5 192,5 1301,5 10

16 4.2 Materiaalihankinnat Työn tekeminen ei edellytä erityisiä ohjelmisto- tai laitteistohankintoja. Projektissa tullaan käyttämään omia sekä SoberIT -laboratorion laitteistoja, sekä ohjelmistoja jotka ovat joko open source tuotteita tai käytettävissä SoberIT -laboratorion tai TKK:n ATK-keskuksen puolesta. 4.3 Budjetti Taulukossa 8 on esitetty projektin teoreettinen budjetti, jonka tarkoituksena on havainnollistaa mitä tämän kokoinen projektin todellisuudessa voisi maksaa. Projektiryhmän työstä ei todellisuudessa laskuteta esitetyn laskelman mukaisesti. Asiakkaan projektiin liittyvät kustannukset ovat SoberIT:lle maksettu maksu. Taulukko 8: Projektin arvioitu budjetti Kustannuserä Työmääräarvio Palkkio/h Kustannukset Asiakkaan SoberIT:lle maksama summa Asiakkaan projektiin käyttämä aika 100 h Projektiryhmän työ budjetoitu h Kustannukset yhteensä

17 5 Työkäytännöt ja työkalut Tässä kappaleessa kuvataan projektissa käytettävät työkäytännöt sekä työkalut. Osa käytännöistä on pakollisia kurssin puolesta ja osa on erikseen valittu helpottamaan projektin kulkua. 5.1 Käytännöt Seuraavissa kappaleissa on kuvattu projektissa noudatettavat käytännöt. Lisäksi luvussa 5.2 on listattu SEPA - käytännöt, joita projektissa käytetään Iteratiivinen kehitys Projektissa tuotettava ohjelmisto toteutetaan käyttäen iteratiivista ja inkrementaalista kehitysmallia. Projekti koostuu kolmesta iteraatiosta, joita ovat projektin suunnittelu (PP), toteutusiteraatio 1 (I1) sekä toteutusiteraatio 2 (I2). Vaiheiden tavoitteet, tehtävät ja aikataulut on kuvattu tarkemmin kappaleessa 6 Vaiheistus. I1-iteraatiossa pyritään toteuttamaan asiakkaan vaatimusten mukaiset keskeisimmät ominaisuudet siten, että iteraation lopussa pidettävässä iteraatiodemossa esitetään testattu ja toimiva sovellus. I2-iteraatiossa sovellukseen lisätään toiminnallisuutta iteraation alussa tehtävän suunnitelman mukaisesti. Toteutusiteraatiot voidaan vielä sisäisesti jakaa seuraaviin päävaiheisiin: suunnittelu, toteutus, testaus ja iteraatio demo. Toteutusiteraatiot toteutetaan käytänössä vähintään kahdessa kehityssyklissä, jolloin totetustehtävien osalta tavoitteet asetetaan erikseen näille kehityssykleille ja syklien välissä pidetään ns. välietappikatselmus (kts Välietappikatselmus). Tarkemmin iteraatioiden sisäinen vaiheistus aikatauluineen on kuvattu kappaleissa 6.2 Toteutusiteraatio 1 ja 6.3 Toteutusiteraatio Iteraation suunnittelu Iteraation tarkempi suunnittelu tehdään ko. iteraation alussa. I1 ja I2 iteraatioiden suunnittelu aloitetaan yhdessä asiakkaan kanssa edellisen vaiheen iteraatiodemon jälkeen. Iteraation suunnittelupalaverissa projektiryhmä esittää alustavan ehdotuksen tulevalle iteraatiolla työmääräarvioineen. Asiakas voi esittää muutoksia ja asiakas on vastuussa iteraatioon valittujen vaatimusten asettamisesta toteutusjärjestykseen. Asiakaspalaverin jälkeen, iteraation ensimmäisen viikon aikana suunnitelmaa ja työmääräarvioita tarkennetaan. Suunnittelijat osallistuvat suunnitelman tekemiseen ja työmäärien arviointiin I1 ja I2-iteraatioiden osalta. Iteraation suunnitelmat päivitetään tämän dokumentin lukuun 6. Vaiheistus. Ennen virallista aikataulun mukaista palautusta lähetetään suunnitelma asiakkaalle katselmoitavaksi. 12

18 5.1.3 Dokumentointi Projektissa tuotettava dokumentaatio palautetaan viimeistään sille määriteltynä palautuspäivänä sekä asiakkaalle että mentorille. Dokumentit lähetetään asianosaisille sähköpostitse PDF-formaatissa. Lisäksi dokumentit julkaistaan projektiryhmän kotisivulla. Projektissa käytettävä dokumentointikieli on suomi, paitsi teknisen spesifikaation, käyttöohjeen sekä koodin kommentoinnin osalta, jotka tulee tehdä englannin kielellä. Projektissa tuotettava dokumentaatio, vastuuhenkilöt ja dokumenttien palautuspäivämäärät on koostettu taulukkoon 10. Mikäli dokumentti katselmoidaan, on katselmoinnit myös merkitty. Taulukkoa päivitetään projektin edetessä kunkin vaiheen osalta. Vastuuhenkilöt huolehtivat siitä, että päivitetyt dokumentin päivitetään myös ryhmän kotisivulle. Taulukko 10. Dokumentit ja niiden vastuuhenkilöt PP Päävastuu Katselmointi pvm Katselmointi ryhmä Palautus pvm Projektisuunnitteluvaiheen Elina Kontro suunnitelma Projektisuunnitelma Elina Kontro Asiakas, Projektiryhmä Vaatimusmäärittely Laura Lehtola Asiakas, Projektiryhmä Tilannekatsausraportti Elina Kontro Managementtiimi Kehitystyöohjeistus Kari Ylihärsilä SEPA: Käyttäjätestit Elina Kontro SEPA: Coding Camp Kari Ylihärsilä I1 I1-iteraation suunnitelma Elina Kontro Managementtiimi Projektisuunnitelma Elina Kontro Managementtiimi Laadunvarmistussuunnitelma Santeri Saarinen Vesa, Samuel sisältää Testaussuunnitelman I1 Tekninen määrittely Vesa Haukkavaara Kari, Santeri, Samuel Vaatimusmäärittely Laura Lehtola Elina, Vesa, Santeri Tilannekatsausraportti Elina Kontro Managementtiimi SEPA : Coding Camp Kari Ylihärsilä Samuel Korpi SEPA : Saattiset Menetelmät Santeri Saarinen SEPA: Käytettävyydenarvointi Aleksi Airola Vesa Haukkavaara Elina Kontro Käyttöliittymän paperiproto Aleksi Airola

19 Päävastuu Katselmointi pvm Katselmointi ryhmä I I2 iteraatiosuunnitelma Elina Kontro Managementtiimi 18.1 Projektisuunnitelma Elina Kontro 13.2 Managementtiimi Laatusuunnitelma (sis. I2- Santeri Saarinen Aleksi tesrausuunnitelman) Tekninen määrittely Vesa Haukkavaara Lauri, Kari Vaatimusmäärittely Laura Lehtola Santeri, Elina Testitapaukset Testauslogi Santeri Saarinen 10.2 Aleksi I2 Testausraportti Santeri Saarinen Laura, Elina Vertaisryhmän testiraportti Samuel Korpi Santeri Aleksi Airola Vertaisryhmän testauksen Santeri Saarinen Aleksi 17.2 suunnittelu ja ohjeistus Käyttöohje Laura Lehtola Vesa, Elina 27.2 Aleksi Airola Loppuraportti Elina Kontro 24.2 Vesa, Laura 27.2 Tilannekatsausraportti Elina Kontro 1.2 Vesa, Laura 3.2 SEPA : Coding Camp Kari Ylihärsilä Samuel Korpi SEPA : Saattiset Menetelmät Santeri Saarinen Palautus pvm SEPA: Käytettävyydenarvointi Aleksi Airola Vesa Haukkavaara Elina Kontro Riskienhallinta Projektin riskienhallintaan käytetään kevennettyä ja modifioitua versiota Jyrki Kontion kehittämästä Riskit menetelmästä. Projektiin liittyvät keskeisimmät riskit pyritään tunnistamaan heti projektin alussa ja lisäksi yksittäisiin iteraatioihin liittyvät riskit tunnistetaan jokaisen iteraation aloituspalaverissa. Yleisimpien riskien osalta niiden tilaa monitoroidaan kerran kunkin iteraation aikana sen puolivälissä olevassa viikkopalaverissa. Mikäli jonkin riskin realisoitumisesta havaitaan merkkejä, analysoidaan sitä tarkemmin ja se otetaan erityistarkkailun alle. Riskilokia päivitetään kunkin seurantapalaverin yhteydessä. Projektin riskienhallintakäytäntö koostuu seuraavista askeleista: Uhkien tunnistaminen Uhkien syiden tunnistaminen 14

20 Uhkien todennäköisyyden arviointi Uhkien vaikutusten arviointi Riskejä vähentävien toimien käyttäminen Riskitilanteen seuranta Tunnistetut uhat kootaan riskilokiin (Luku 7). Lokiin merkitään erikseen myös se, mikäli riski liittyy johonkin tiettyyn projektin vaiheeseen Tuntiraportointi Työtuntien raportointiin käytetään Excelillä tehtyä taulukkoa. Kullakin ryhmän jäsennellä on oma Excel - tiedosto, johon tunnit raportoidaan ja johon jokainen huolehtii omien tuntiensa raportoinnista. Tiedostossa on oma sivunsa jokaiselle iteraatiolle. Tiedostoja säilytetään ryhmän TikiWiki sivuilla. Tunnit tulee raportoida päivittäin, mieluiten heti suoritetun tehtävän jälkeen. Jokaisen viikon maanantaina klo 12:00 tulee edellisen viikon tuntien olla ajan tasalla. Tämän jälkeen projektipäällikkö koostaa yhteenvedon raportoiduista tunneista ja kooste julkaistaan tiistaina projektiryhmän www-sivuilla. Tuntiraportointikoosteen perusteella tarkistetaan, onko tarvetta tehdä muutoksia esim. iteraation työmääräarvoihin, työtehtävien jakamiseen tai suunniteltuun toteutustoiminnallisuuteen Ohjelmakoodin koon raportointi Ohjelmakoodin koosta pidetään kirjaa koodirivien määrän perusteella (LOC ja NCLOC). Koodirivien määrä on helposti mitattavissa oleva, muihin projekteihin suhteuttamiskelpoinen elementti. Arkkitehtuurikaavio auttaa ymmärtämään ohjelman kompleksisuutta koodirivien määrää paremmin, ja antaa kokonaiskuvan ohjelman rakenteesta, mutta ei suoranaisesti auta ohjelmakoodin koon raportointia Kommunikointi ja palaverikäytännöt Kaikkiin ennalta sovittuihin palavereihin, jotka eivät ole säännöölisiä viikko tai tilanne katsauspalavereita tulee olla agenda, joka toimitetaan osallistujille etukäteen. Palaverin alussa agenda käydään läpi ja tehdään tarvittaessa muutoksia. Viikkopalavereiden yhteydessä erillistä agendaa ei tarvitse lähettää, sillä palaverin agenda sovitaan aina edellisessä palaverissa tai se on vakio muotoinen. Kaikista palavereista tehdään pöytäkirjat, joihin kirjataan tärkeimmät huomiot ja päätökset. Pöytäkirjat tallennetaan TikiWikiin ryhmän kotisivuilla niille varattuun paikaan. I2-iteraatiossa viikkopalaverit ovat olleet lyhyitä tilannekatsauksia, joista erillisä pöytäkirjoja ei ole kirjoitettu. Päätökset tai sovitut muutokset on suoraan päivitetty ko. dokumentteihin. 15

21 Projektiryhmän sisäinen kommunikointi Projektinsuunnitteluiteraation aikana management -ryhmä kokoontuu viikkopalavereihin, jossa käydään läpi suunnittelua, tarkistetaan kunkin tehtävien eteneminen ja sovitaan seuraavat toimenpiteet. Tämän vaiheen aikana suunnittelijat pidetään ajan tasalla tärkeimmistä päätöksistä ja tapahtumista lähettämällä vähintään kerran viikossa tiedotuksia sähköpostitse. Suunnittelijoille järjestetään myös projektin käynnistyspalaveri PPiteraation aikana. I1 -iteraatioissa alussa noudatettiin myös viikkopalaverikäytäntöä, tästä käytännöstä luovuttiin heti, kun se töiden etenemisen kannalta oli mahdollista. Viikkopalaverin tilalla pidetään tiistaisin 9-12 yhden SEPA aiheen mukainen Coding Camp (kts. Luku 5.5.1). Tarvittaessa Coding Campin alussa pidetään lyhyt palaveriosuus esim. informoidaan projektiin liittyvistä yleisistä asioista. I2 iteraatiossa noudatetaan myös Coding Camp käytäntöä. Tälle varattu aika on keskiviikkoisin klo Manager-ryhmän palaverit pidetään keskiviikkoisin 12:30 13:00. Palaverin tarkoituksena on projektitöiden etenemisen seuranta. Tarpeen mukaan järjestetään myös muita palavereita (kts. Esim. luku Pienryhmät). Palaverien lisäksi ryhmän sisäiseen kommunikointiin käytetään sähköpostia ja kiireellisiä asioita sovitaan myös puhelimitse. Dokumentaation tallentamiseen ja jakamiseen ryhmän sisällä käytetään TikiWikiä. Toteutustyötä tukemaan on avattu ryhmälle oma IRC-kanava. Kommunikointi projektiryhmän ulkopuolelle Asiakkaan, teknisen ohjaajan ja mentorin kanssa kommunikoidaan sähköpostitse sekä tarvittaessa järjestetään yhteisiä palavereita. Mentorin kanssa palavereita järjestetään vähintään yksi jokaisessa iteraatiossa. Asiakkaalle, tekniselle ohjaalle ja mentorille tarjotaan pääsy projektissa tuotettavaan materiaalin, kuten esim. vaatimusmäärittely, projektisuunnitelma ja yhteisten palaverien pöytäkirjat. Ko. dokumentit jaetaan joko TikiWikin tai erillisten www-sivujen kautta. Projektin vastuuhenkilö asiakkaan suuntaan on Laura Lehtola. Hänen tehtävänsä on sopia asiakkaan kanssa tarvittavista tapaamisista ja toimista, sekä monitoroida asiakkaan tyytyväisyyttä ja pitää huolta siitä, että projekti on asiakkaan näkökulmasta menossa oikeaan suuntaan. Projektin vastuuhenkilö mentorin suuntaan on Elina Kontro. Kommunikaatiosta teknisen ohjaajan kanssa vastaa Vesa Haukkavaara Pienryhmät PP-iteraation loppupuolella projektiryhmä jaetaan kolmeen ns. pienryhmään. Pienryhmätoiminnan tarkoituksena ottaa suunnittelijat mukaan suunnittelutehtäviin PP-iteraation aikana ja tämän avulla myös tehostetaan I1- iteraation käynnistymistä. Nyt sovitut pienryhmät ovat toiminnassa vähintään I1-iteraation alussa, mutta tarvittaessa vastuualueestaan riippuen myös I2-iteraation aikana. Ryhmät raportoivat edistymisestään 16

22 viikkopalavereissa. Taulukkossa 10 on lueteltu sovitut pienryhmät ja niiden kokoonpanot. Ryhmien tuotosten aikataulut noudattavat projektin aikatauluja. Taulukko 10. Pienryhmät Pienryhmän vastuualue Tuotos Vaiheet Ryhmän jäsenet Arkkitehtuurin suunnittelu Käyttöliittymäsuunnittelu Laadunvarmistussuunnittelu Arkkitehtuurisuunnitelma Ns. Paperiprototyyppi järjestelmän käyttöliittymästä Käyttöliittymäsuunnittelua Laatusuunnitelma (Testaussuunnitelma) I1 I1 I1,I2 Vesa Haukkavaara Kari Ylihärsilä Samuel Korpi Laura Lehtola Aleksi Airola Elina Kontro Santeri Saarinen Elina Kontro Varsinaisesti pienryhmät olivat toiminnassa vain I1-iteraation alussa, jotta työt saatiin edellä esitettyjen asioiden osalta käyntiin, mutta laaturyhmä ja käyttöliittymäryhmä toimivat epävirallisesti koko projektin ajan Katselmointikäytäntö Projektissa noudatettavaa katselmointikäytäntöä kuvataan Laadunvarmistussuunnitelmassa Iteraatiodemot Iteraatiodemo toteutetaan kurssin ohjeistuksen mukaisesti. Projektipäällikkö valmistelee kalvoesitysmuotoon tilannekatsausraportin ennen iteraatiodemoa niin, että se voidaan katselmoida demoa edeltävässä viikkopalaverissa. Ohjelmiston toiminnallisuuden demonstroinnista I1 ja I2 iteraatiodemoissa vastaa pääsuunnittelija. Iteraatio demossa esitettävän sovelluksen version tulee olla, esitysmateriaalin tavoin, läpikäytävissä demoa edeltävässä viikkopalaverissa. Iteraatiodemon päivämäärät on asetettu kurssin puolesta ja iteraatiodemot pidetään Innopoli2:ssa SoberITtiloissa. Tarkemmat kellonajat ehdotetaan myös kurssin puolesta ja ovat nähtävissä kurssin kotisivuilla. Asiakasyhteyshenkilö varmistaa ajan sopimisen asiakkaalle ja tekniselle ohjaajalle. PP iteraation demo pidetään klo 13, I1-iteraation demo pidetään klo 13 ja I2-iteraatio demo 1.3. klo 14:30. Iteraatio demojen paikkana on Innopoli 2. Projektipäällikön vastuulla on, että katselmointitilaisuudessa pysytään aikataulussa ja kaikki olennaiset asiat saadaan esitettyä. 17

23 Vikojen seuranta Vikojen seurantaan käytetään julkisesti saatavilla olevaa Bugzilla-työkalua ( Yksityiskohtainen ohje Bugzillan käytöstä on tehty I1 iteraation alussa tehtävään erilliseen työkaluohje-dokumenttiin Versionhallinta Projektin versionhallintatyökaluna käytetään CVS-versionhallintajärjestelmää. Repositorio sijaitsee ryhmän yhteisen työhakemiston alle ATK-keskuksella ja järjestelmään kytkeydytään suoraan Eclipsen kautta. Versionhallinnan käyttämisestä on tarkempi ohje TikiWikissä olevassa työkaluohjeessa Koodauskäytäntö Projektissa noudatettavaa koodauskäytöntöä kuvataan Laadunvarmistussuunnitelmassa Vertaistestaus Vertaistestaus tehdään kurssin ohjeiden mukaisesti I2 iteraatiossa. Vertaistestaukseen liittyvät toimenpiteet kuvataan projektin Laadunvarmistussuunnitelmassa Vaatimusten määrittely ja hallinta Vaatimusmäärittely on silta asiakkaan ja projektiryhmän välissä. Siksi vaatimusten määrittelyyn ja hallintaan kiinnitetään erityistä huomiota projektin aikana ja sitä pyritetään tekemään mahdollisimman paljon yhteistyössä asiakkaan kanssa Hankinta Projektin asiakas- ja käyttäjätarpeet hankitaan iteratiivisesti. Tarpeiden kartoitus aloitetaan asiakkaan korkeantason tavoitteiden ja projektin tärkeimpien käyttäjäryhmien selvittämisestä ja priorisoinnista. Näiden perusteella tehdään käyttäjätutkimus simulaattorin toistaiseksi ainoalla käyttäjällä, joka on myös tämän projektin asiakas. Käyttäjätutkimuksessa seurataan simulaattorin käyttöä sen todellisessa käyttöympäristössä, sekä pyydetään käyttäjää mm. kuvailemaan tekemiään toimia ja toiminnan vaiheita sanallisesti käyttäjän termistön selvittämiseksi. Edellisten aktiviteettien tulosten pohjalta tehdään vaatimusmäärittelyn ensimmäinen versio sekä käyttöliittymäprototyyppi, josta haetaan palautetta asiakkaalta ja jota testataan tärkeimmällä käyttäjäryhmällä, opiskelijakäyttäjillä Analysointi ja priorisointi Hankittuja vaatimuksia analysoidaan kolmesta näkökulmasta, joiden perusteella niille annetaan toteutusprioriteetti (= vaihe). Näkökulmia ovat: tärkeys asiakkaalle, 18

24 kiireys arkkitehtuurin kannalta ja toteutuskustannukset Tärkeyttä asiakkaalle arvioidaan neliportaisella asteikolla (1-4), joista kaikista ylimpään luokkaan asiakas saa asettaa korkeintaan 20% vaatimuksista. Kiireyttä arkkitehtuurin kannalta ja toteutuskustannuksia arvioidaan kolmiportaisella asteikolla. Nämä arviot tekee projektiryhmä. Toteutuskustannusten arvioinnissa otetaan huomioon kaikki vaatimuksen eteen tehtävä työn määrittelystä testaukseen ja käyttöohjeiden kirjoittamiseen. Jokaisen iteraation alussa valitaan arvioitujen näkökulmien perusteella yhdessä asiakkaan kanssa vaatimukset, jotka iteraation aikana tullaan toteuttamaan Toteutusiteraatioiden aikainen vaatimustenhallinta Iteraation alussa toteutettaviksi valittuja käyttötapauksia tarkennetaan yksityiskohtaisiksi käyttötapauksiksi. Kaikentyyppisten vaatimusten tilaa monitoroidaan koko projektin ajan. Mahdolliset tilat vaatimukselle on esitetty taulukossa 11. Taulukko 11: Vaatimusten tilat ja niiden kuvaus Tila Kuvaus Ehdotettu Vaatimus on esitetty ja jossakin määrin analysoitu ohjelmiston kannalta olennaiseksi, mutta ei vielä hyväksytty mihinkään toteutusiteraatioon. Hyväksytty ieraatioon X Vaatimus on sovittu toteutettavaksi iteraatiossa x. Toteutettu Vaatimus on toteutettu, mutta sitä ei vielä ole testattu. Testattu Vaatimus on testattu ja projektiryhmän näkökulmasta valmis. Toimitettu Vaatimus on toteutettu asiakkaalle, joka sen on hyväksynyt. Hylätty Vaatimus on hylätty. 19

25 Asiakas- ja käyttäjänäkökulman varmistaminen projektin aikana Asiakkaan ja käyttäjän äänen kuulumiseksi ja säilymiseksi koko projektin ajan kiinnitetään erityistä huomiota. Keskeistä tämän asian varmistamiseen on tiivis yhteistyö asiakkaan kanssa koko projektin kanssa. Lisäksi tämä varmistetaan iteraatiokohtaisilla toimenpiteillä, joista keskeisimmät on lyhyesti lueteltu seuraavassa. Projektisuunnittelu iteraatio Kevyt käyttäjätutkimus, jossa selvitettiin simulaattorin toistaiseksi ainoan käyttäjän kanssa aidossa käyttötilanteessa, mitkä ovat käytön perussekvenssit ja kuinka paljon erilaisia toimintoja käytetään Tiivis yhteistyö asiakkaan kanssa tärkeimpien käyttäjäryhmien ja heidän keskeisten tarpeidensa selvittämiseksi Asiakkaan osallistuminen vaatimusmäärittelyyn iteratiivisesti (raakaversioiden komentointi + puhelinkeskustelut) Toteutusiteraatio 1 Käyttöliittymäprototyypin kehittäminen palautteen saamiseksi. Prototyyppi tehdään quick and dirty tyylisesti Eclipsen käyttöliittymätyökalulla siten, että se ei ole kiinni nykyisen simulaattorin koodissa. Käyttöliittymäprototyypin testaus. Testihenkilöinä 2 opiskelijakäyttäjää. Iteraation lopussa käyttäjätestit simulaattorin senhetkisellä versiolla (2 opiskelija käyttäjää). Toteutusiteraatio 2 Käyttöohjeen kirjoittaminen Käyttöohjeen integrointi sovellukseen Asiakkaan hyväksyntätestaus HKKK:n opiskelijoiden itsenäisesti suorittamat käytettävyystestit Välietappikatselmukset Toteutusiteraation on jaettu kahteen totetussykliin ja näiden syklien välissä pidetään management-tiimin palaveri ns. välietappikatselmus. Katselmus on palaveri, jossa tarkemmin käydään läpi projektin sen hetkistä tilannetta; sovittujen vaatimusten toteutustilanne, toteutuneet työmäärät suhteessa arvoituihin, tarkistetaan riskitilanne ja päätetään tarvittavista korjaustoimenpiteistä. 20

26 5.2 Laadunvarmistussuunnitelma Projektin laadunvarmistussuunnitelma kuvataan erillisessä Laadunvarmistussuunnitelma-dokumentissa (viite). 5.3 Työkalut Projektissa käytetään seuraavia työkaluja Kehityslaitteisto Projektissa tuotettavan ohjelmiston kehittämiseen ei tarvita mitään erikoislaitteistoa. Tavallinen kotitietokone (teholuokkaa P4 2,6 Ghz, 512Mb muistia) riittää hyvin. Ohjelman kehitys tapahtuu sekä ryhmän jäsenten omilla tietokoneilla, että SoberIT:n tietokoneilla. Kaikki käytettävät työkalut ovat joko open source -tuotteita tai ne on saatavilla TKK ATK-keskuksen tai SoberITlaboratorin puolelta. Borlandin Together Architectia, tarjotaan käyttöön projektin ajaksi kurssin puolesta Ohjelmistot Eclipse 3.1 Kehitysympäristö: Tulee Together Architectin mukana. Lisätietoa: Borland Together Architect: Ladataan kurssin kotisivuilta Työkalut -osiosta. Sun Java Java 2 Platform Standard Edition 5.0 Development Kit (JDK) (JDK 5.0 Update 5 Paketti) CVS Versionhallintatyökalu: Sisältyy Eclipseen Asennuspakettityökalu: NSIS (Nullsoft Scriptable Install System) Apukirjastot: Nämä tulevat ohjelmakoodin mukana. o o o o o Groovy-skriptauskieli: Groovy 1.0 JSR-03 tai uudempi (esim. groovy-1.0-jsr-03.zip osoitteesta COLT-matematiikkakirjasto: Colt (esim. colt zip osoitteesta Commons Beanutils-apukirjasto: Beanutils (esim. commons-beanutils zip osoitteesta Commons Logging-apukirjasto: Logging (esim. commons-logging zip osoitteesta Commons Digester-apukirjasto: Digester (esim. commons-digester-1.7.zip osoitteesta 21

27 Bugzilla 2.20: Ohjelmaprojektin toteuttamiseen käytetään Javaa, kehitysympäristönä Eclipse 3.1. Borlandin Together Architectia käytetään ohjelmistoarkkitehtuurin suunnittelussa. Graafisista käyttöliittymäeditoreista käyttöliittymän toteuttamisessa käytetään Eclipsen lisäpalikkana: Jigloo SWT/Swing GUI Builder for Eclipse and WebSphere JSci graafin piirto paketti Kehitystyökalut Versionhallinta Versionhallintaan ja ohjelmakoodin säilyttämiseen käytämme CVS-versionhallintajärjestelmää. Repositorio asennetaan TKK:lle ryhmän yhteiseen kansioon. Tähän kansioon on kaikilla ryhmäläisillä luku-, suoritus- ja kirjoitusoikeudet. Tiedostot haetaan ja tallennetaan Eclipsen kautta repositorioon. Uusia tiedostoja luotaessa ryhmäläisten on muistettava erikseen jakaa oikeudet koko ryhmälle näihin tiedostoihin. Vain toimivaa ohjelmakoodia saa laittaa repositorioon. CVS:stä ja sen käytöstä tehdään yksityiskohtainen ohjeet I1-iteraation alussa kirjoitettavassa erillisessä työkaluohjeessa. Projektiryhmää varten on luotu ATK-keskuksen UNIX-järjestelmään a-teamdc niminen ryhmä, johon kuuluvat kaikki projektiryhmän jäsenet. Ohjelmointi Java-kehitysympäristönä käytetään Eclipse 3.1:htä, Javasta versiota 5.0. Lisäksi käytetään jotakin yllämainituista Eclipsen lisäpalikoista käyttöliittymän toteuttamisessa. Luokkakaaviot Borlandin Together Architect-työkalua käytetään luokkakaavioiden piirtämisessä ja ohjelmistoarkkitehtuurin suunnittelussa. Käännös Ohjelma käännetän suoraan Eclipsestä. Jos myöhemmin on tarkoituksenmukaista, otetaan myös ant - käännöstyökaluksi monimutkaisempiin asioita, kuten ohjelman paketointia varten. Vikaraportointi Vikaraportointiin käytetään Bugzilla-työkalua. Kommunikointi 22

28 Ryhmän sisäiseen kommunikointiin käytetään Wiki-ympäristöä. Wikiin laitetaan asioita kuten dokumenttien uusia versioita muutoslogeineen. Nopeaan yleiseen asioista tiedottamiseen käytetään sähköpostia. Asiakkaalla on käytettävissä ryhmän kotisivu ja mentorille on pääsy ryhmän Twiki sivuilla. Sähköpostin otsikoissa käytetään [TeamDC] tagia tunnistamaan projektin sisäiset viestit. Projektiryhmällä on yhteistä palaveriaikaa tiistaisin klo I1-Iteraartion alussa tämä jakautuu ensin tunnin manageripalaveriin, sitten kaikkien yhteiseen osioon ja lopuksi kehittäjien omaan osioon. Nyt palaveri aika käytetään Coding Camp tarkoitukseen ja varsinainen lyhyt palaveri osuus pidetään vain tarvittaessa. Tuntiseuranta Tuntiseurantaan käytetään Excelillä tehtyä taulukkoa. Tarkemmat ohjeet tuntiseurannasta on kuvattu kohdassa tuntiraportointi. 5.4 Standardit Projektissa käytetään Sunin Java-ohjelmointikonventioita, joka on lyhyesti määritelty ryhmän työkalu-ohjeessa. Linkki koko dokumenttiin löytyy täältä: Käyttöliittymäsuunnittelussa pyritään noudattamaan Nielsenin (5) kymmentä käytettävyysheuristiikkaa, jotka ovat: Yksinkertainen ja luonnollinen kieli, Puhu käyttäjän kieltä, Minimoi käyttäjän muistikuorma, Yhdenmukaisuus, Palaute, Selvästi merkityt poistumistiet, Oikopolut, Hyvät virheilmoitukset, Virheiden estäminen ja Opastus ja ohjeistus. 5.5 SEPA -työt Osa projektiryhmän jäsenistä suorittaa projektin ohessa T Ohjelmistotuotannin erikoiskurssia, jossa perehdytään johonkin ohjelmistonkehityskäytäntöön ja sovelletaan sitä tähän ohjelmistoprojektiin. Aiheen voi valita joko kurssin ehdottamista vaihtoehdoista tai omasta aiheesta, joka on kuitenkin hyväksytettävä mentorilla. Työ toteutetaan tekemällä ns. SEPA päiväkirja, jonka työmäärä on noin 20h/henkilö sekä tekemällä 20h/henkilö lisätyötä ohjelmistokehitysprojektiin. Projektiryhmän SEPA-työt tehdään työpareina ja oheisessa taulukossa 12 on listattu ryhmän SEPA aiheet. Aiheista ensimmäinen on ns. oma aihe, muut kaksi kurssin puolesta ehdotettuja aiheita. Aiheet on valittu niin, että niiden on katsottu olevan hyödyllisiä projektin kannalta. Seuraavissa luvuissa on lyhyt kuvaus valituista aiheista. Tarkemmat kuvaukset ja valintaperusteet kuvataan kunkin aiheen erillisessä dokumentissa, SEPA päiväkirjassa. Taulukko 12: TeamDC SEPAt 23

29 Käytäntö Vastuuhenkilö Vaiheet Coding Camp Käyttettävyyden arvointi Kari Ylihärsilä Samuel Korpi Aleksi Airola Vesa Haukkavaara Elina Kontro I1 ja I2 I1 ja I2 Staatiset menetemät Santeri Saarinen I1 ja I Coding Camp Kyseessä on käytäntö, jossa vähintään kerran kussakin iteraatiossa järjestetään kokonainen etukäteen suunniteltu työpäivä, jolloin kaikki ryhmämme jäsenet tekevät töitä projektin eteen yhdessä, samassa paikassa ja samaan aikaan. Tutkimme eri näkökulmista keskitetyn työskentelytavan tuottavuutta verrattuna hajautettuun työhön, jossa useimmat ryhmän jäsenet tekevät asioita eri paikoissa eri aikaan. Hajautetun työn etuja ovat keskittyminen tehtävään sekä ajan tehokas käyttäminen siltä osin, kun tekijälle on oma tehtävä täysin selvä. Keskitetyn työn etuja taas ovat tehokas tiedon siirtyminen kokemusten kautta sekä parempi ongelmanratkaisu, kun kaikkien taitoja saadaan hyödynnettyä samaan aikaan. Tutkimme "Coding Camp" käytännön tuottavuutta ainakin seuraavista näkökulmista: Ryhmän tuottavuus työtunteihin nähden, tuotetun koodin / tuotosten laatu (virheettömyys), tiedon siirtyminen ryhmän sisällä sekä työskentelytapojen nautittavuus Käytettävyyden arviointi Käytettävyyden arvoinnin avoitteena on testata ja parantaa kehitteillä olevan tuotteen käytettävyyttä. Tuotetta kehitettäesssä pyritään kiinnittämään erityistä huomiota tuotteen tulevien käyttäjien näkökulmaan. Käytettävyyden arvointia tulaa tekemään sekä käytettäsyystesteillä että heuristisella arviolla. Koska tässä ohjelmistokehitysprojektissa tavoitteena on toteutetaan olemassa olevaan CoSCA-simulaattoriin helppokäyttöinen ja opittava käyttöliittymä, joka mahdollistaa simulaattorin hyödyntämisen mm. HKKK:ssa opetuksen apuvälineenä, on luontevaa ottaa käytettävyyden arvointi yhdeksi projektissa käytettäväksi menetelmäksi, jolla pyritään varmistamaan tämän tavoitteen saavuttaminen. Käyttäjäryhmä, johon testauksessa keskitytään ovat HKKK:n opiskeljat, joita käytettävyystestauksen osallistuu vähintään kolme henkilöä Staattiset menetelmät Staattisella analysoinnilla tarkoitetaan sellaista esim. lähdekoodin analysointia, jossa koodia ei ajeta. Koodikatselmointi on yksi staattinen ohjelmistonanalysointi menetelmä. Menetelmän avulla voidaan mitata, analysoida ja parantaa ohjelmiston suunnittelua sekä löytää virheitä. 24

30 Työssä tullaan käyttämään jotakin staattista analysointimenetelmää mittaamaan ja parantamaan ohjelmiston laatua sekä vähentämään ohjelmistossa olevien virheiden määrää. 25

31 6 Vaiheistus Projekti on jaettu kolmeen iteraatioon. Seuraavissa kappaleissa kuvataan iteraatioiden päätavoitteet, tuotokset, tehtävät ja työmääräarviot. Lisäksi esitettään aikataulut ja tärkeimmät päivämäärät. Iteraatiot ja niiden aloitussekä lopetuspäivämäärät on asetettu kurssin puolesta. Kuvassa x. On kuvattu projektin vaiheet ja aikataulu ylätasolla. Tähdellä merkityt kuvastavat keskeisimpiä niistä tapahtumista, joissa asiakkaan osallistuminen on välttämätöntä. Kunkin vaiheen tarkempi aikataulutus kerrotaan ko. vaiheen kohdalla PP I Joululoma I Iteraatio demo Välidemo Kuva 3. Projektin vaiheet ja aikataulutus 26