Hirviö Vaatimusmäärittely Jani Heikkinen Anssi Kalliolahti Jukka Larja Kim Nylund Liia Sarjakoski Samuli Sorvakko Timo Toivanen 2. marraskuuta 2004 Tiivistelmä Tässä dokumentissa kuvataan Tietoliikenneohjelmistojen ja multimedian laboratoriolle kehitettävän järjestelmän kaikki vaatimukset yleisellä tasolla sekä kerrotaan järjestelmästä ja sen ympäristöstä yleensä. Vaatimusten dokumentointiin on käytetty vaatimusluetteloita sekä käyttäjätapauksia. 1
Sisältö 1 Dokumentin tarkoitus 3 1.1 Levitys........................................ 3 2 Termit ja määritelmät 3 2.1 Käsitteet...................................... 3 2.2 Lyhenteet...................................... 3 2.3 Tunnisteet...................................... 4 2.4 Statukset...................................... 4 2.5 Prioriteetit..................................... 4 3 Järjestelmän tavoitteet 5 4 Asiakkaan toimialakuvaus 5 5 Järjestelmän kuvaus 5 5.1 Työryhmät ja oikeustasot............................. 6 6 Käyttäjät 6 7 Toiminnalliset vaatimukset 6 8 Ei-toiminnalliset vaatimukset 9 9 Käyttäjätapaukset 10 9.1 Opiskelijan tietojen hakeminen.......................... 10 9.2 Opiskelijan tietojen näytäminen.......................... 11 9.3 Uuden opiskelijan syöttäminen.......................... 12 9.4 Opiskelijakohtaisen muistiinpanon tekeminen.................. 13 9.5 Perusopintojen statuksen päivittäminen..................... 13 9.6 Jatko-opintojen statuksen päivittäminen..................... 14 9.7 Työryhmän vaihtaminen.............................. 14 9.8 Työryhmänäkymän vaihtaminen......................... 15 10 Rajoitukset 15 11 Viitteet 16 A Käyttöliittymän HTML-prototyyppi 17 2
Versio Päivämäärä Tekijä Versio 1.00 1.11.2004 Sarjakoski Asiakkaalle ja kurssille PP-vaiheen lopussa luovutettava dokumentti 1 Dokumentin tarkoitus Dokumentti kuvaa järjestelmän vaatimukset. Dokumenttia päivitetään jatkuvasti projektin edistyessä asiakkaan palautteen pohjalta. 1.1 Levitys Lukijaryhmä Asiakas Asiakasvastaava Ohjelmoijat Testaajat Muu projektiryhmä Tehtävä Asiakas varmistaa, että dokumenttiin on merkitty kaikki oleelliset vaatimukset. Projektin päättyessä asiakas varmistaa, että toteutus täyttää dokumentissa esitetyt vaatimukset. Asiakasvastaava hallitsee vaatimuksia dokumentin avulla. Asiakasvastaava pitää dokumentin ajantasalla. Ohjelmoijat lukevat dokumentin ymmärtääkseen asiakkaan tarpeet. Testaajat varmistavat, että toteutus vastaa dokumentin vaatimuksia. Tiedoksi 2 Termit ja määritelmät Tässä luvussa on esitelty järjestelmään liittyvät käsitteet, lyhenteet, eri vaatimusluokat, vaatimusten tunnisteet, statukset sekä prioriteetit. 2.1 Käsitteet Muistiinpano Muistiinpano on yhteen opiskelijaan ja yhteen työryhmään liitetty määrämuotoinen tietoalkio, jonka tärkein osa on vapaamuotoinen teksti. Muistiinpanoja voi olla vapaavalintainen määrä kutakin opiskelija ja kutakin työryhmää kohti. Professoreihin ja muuhun opetushenkilökuntaan viitataan yleisellä termillä opet- Opettaja taja. Työryhmä Työryhmät ovat järjestelmän sisäinen tapa määritellä oikeuksia. Työryhmän jäsenet näkevät kaikki työryhmäänsä liitetyt muistiinpanot. Opettajat voivat kuulua useampaan työryhmään. 2.2 Lyhenteet TKK TML Teknillinen korkeakoulu Tietoliikenneohjelmistojen ja multimedian laboratorio 3
2.3 Tunnisteet Jokainen vaatimus, käyttäjätapaus, rajoitus ja ratkaisuidea saa yksilöllisen tunnisteen. Tunnisteiden avulla vaatimusten täyttymistä seurataan projektin myöhemmissä vaiheissa. Tunnisteet on jaettu alempana listattuihin luokkiin, joista kukin saa oman etuliitteensä. Tunnisteet jaetaan kronologisessa järjestyksessä. Jos jokin vaatimus, käyttäjätapaus, rajoitus tai ratkaisuidea muuttuu, sen tunnisteen perään liitetään versiotunniste, esimerkiksi seuraavasti: F1b tai E2a. Tunnisteet ovat: C Rajoitus F Toiminnallinen vaatimus N Ei-toiminnallinen vaatimus S Ratkaisuidea U Käyttäjätapaus 2.4 Statukset Jokaisella vaatimuksella on status, joka kertoo, missä vaiheessa sen toteutus on. Ehdotettu Asiakas tai projektiryhmä on ehdottanut vaatimusta lisättäväksi. Kummatkin osapuolet ovat hyväksyneet vaatimuksen. Toteutettu Vaatimus on toteutettu ja testattu. Verifioitu On varmistuttu siitä, että toteutus täyttää vaatimuksen. Poistettu Vaatimus on poistettu. 2.5 Prioriteetit Jokaisella vaatimuksella on prioriteetti. luokat on lueteltu seuraavana: Prioriteetiltaan kriittiset vaatimukset ovat välttämättömiä järjestelmän toiminnan ja käytettävyyden kannalta. Jos projekti täyttää kaikki kriittiset vaatimukset, sitä voidaan pitää onnistuneena. Korkea Prioriteetiltaan korkeat vaatimukset olisi hyvä muttei täysin välttämätöntä toteuttaa. Jos projekti täyttää kaikki korkean tason vaatimukset, sitä voidaan pitää erittäin onnistuneena. Matala Prioriteetiltaan matalat vaatimukset toteutetaan, jos muilta muiden vaatimuksien toteuttamisesta jää. Ne ovat vaatimuksia, joiden toteuttaminen tuottaa käyttäjille lisäarvoa, mutta eivät kuitenkaan kuulu ydintoimintoihin. 4
3 Järjestelmän tavoitteet Järjestelmän on tarkoitus helpottaa TML:n opetushenkilökunnan keskistä viestintää tarjoamalla työkalu opiskelijakohtaisten muistiinpanojen tekemiseen, seuraamiseen ja hallintaan. Erityisesti järjestelmästä on tarkoitus olla hyötyä tietoliikenneohjelmistojen pääaineen professoreille, joiden nykyisistä opiskelijatiedon hallinnan ongelmista ajatus järjestelmän kehittämisestä sai alkunsa. Tietoliikenneohjelmistojen pääainetta hoitaa tällä hetkellä kaksi professoria. Professorit haluavat järjestelmältä pääosin kahta asiaa: mahdollisuutta koordinoida kunkin opiskelijan kanssa sovittavia asioita siten, että saman opiskelijan kohdalla ei sovita asioista ristiriitaisesti, sekä mahdollisuutta seurata diplomitöiden edistymistä. Opiskelijoiden kanssa sovitaan tyypillisimmin erilaisista suorituksien erityisjärjestelyistä. Järjestelmän toissijainen tavoite on helpottaa viestintää opintojaksojen järjestäjien kesken. Laboratorion opintojaksoja on usein järjestämässä useampi henkilö. Myös opintojaksoilla opiskelijat tarvitsevat usein suoritusten erityisjärjestelyjä, joista täytyy viestiä opetushenkilökunnan kesken. Sekä professorien tekemät että opintojaksoilla sovittavat asiat ovat hyvin samankaltaisia, joten niitä on mahdollista tallentaa samaan järjestelmään. Professorit tulevat käyttämään järjestelmää pääosin opinnoissaan pääaineeseen saakka edenneiden opiskelijoiden sekä mahdolliseseti myös jatko-opiskelijoiden ohjaukseen. Opintojaksojen osalta järjestelmää taas tullaan käyttämään tutkinnon alkupään suurilla opintojaksoilla. 4 Asiakkaan toimialakuvaus Tietoliikenneohjelmistojen ja multimedian laboratorio (TML) on Teknillisen korkeakoulun (TKK) Tietotekniikan osaston laboratorio. Laboratorio vastaa alansa tutkimuksesta sekä perus- ja jatko-opetuksesta TKK:ssa. Suurin osa laboratorion opetuksesta on suunnattu tietotekniikan koulutusohjelman perusopiskelijoille sekä jatko-opiskelijoille. Jonkin verran opetusta järjestetään myös muille TKK:n opiskelijoille. TKK:ssa voi suorittaa diplomi-insinöörin, tekniikan lisensiaatin tai tekniikan tohtorin tutkinnon. Diplomi-insinöörin tutkinto koostuu tutkinnon ensimmäisestä osasta, opintosuunnasta, pääaineesta, sivuaineesta sekä diplomityöstä. Diplomityö tehdään tyypillisesti pääaineeseen, mutta pääaineen professorin suostumuksella sen voi tehdä myös sivuaineeseen. TML järjestää tutkinnon ensimmäiseen osaan ja opintosuuntaan kuuluvia opintojaksoja sekä tarjoaa neljä pääainetta ja viisi sivuainetta. Laboratorio vastaa myös omiin pää- tai sivuaineisiin tehtyjen diplomitöiden valvomisesta sekä joskus myös ohjauksesta. TML järjestää opetusta myös jatko-opiskelijoille. Opintojaksojen järjestämisestä TML:ssa vastaavat useimmiten professorit, opettavat tutkijat, tutkijat, tuntiopettajat sekä kurssi- ja tuntiassistentit. Diplomitöiden valvomisen hoitavat professorit. 5 Järjestelmän kuvaus Järjestelmää käyttäen opettajat voivat tehdä yksinkertaisia muistiinpanoja. Muistiinpanot liitetään järjestelmässä oleviin opiskelijoihin. Vanhoja muistiinpanoja voi hakea, ja niiden pohjalta voi tehdä raportteja. Järjestelmä ei sisällä kaikkia opiskelijoita, vaan opettaja lisää opiskelijan järjestelmään asioinnin yhteydessä. Opiskelijan yhteyteen voidaan liittää myös muuta tietoa. 5
5.1 Työryhmät ja oikeustasot Järjestelmässä jokainen muistiinpano liittyy yhteen opiskelijaan sekä yhteen työryhmään. Työryhmät ovat järjestelmän sisäinen tapa määritellä oikeuksia. Työryhmän jäsenet näkevät kaikki työryhmäänsä liitetyt muistiinpanot. Yksi työryhmä voi esimerkiksi sisältää kaikki yhtä kurssia koskevat tiedot. Tärkein työryhmä on niin kutsuttu proffatyöryhmä, johon kuuluuvat diplomityötä koskevat tiedot sekä mm. muistiinpanot luvatuista kurssikorvaavuuksista. Järjestelmässä on viisi käyttöoikeusryhmää: Professorikäyttäjällä on pääsy kaikkien työryhmien ja opiskelijoiden tietoihin. On mahdollista, että muillekin kuin professoreille myönnetään professorikäyttäjän oikeudet. on pääsy kaikkiin hänen kurssinsa työryhmään kuu- Kurssihenkilökunnan edustajalla luviin tietoihin. Opiskelija näkee kaikki itseään koskevat yleiset tiedot mutta voi muuttaa niitä vain rajoitetusti. Muistiinpanoja opiskelija ei näe. Ylläpitäjä pääsee käsiksi kaiken normaalin tiedon lisäksi muutoslokiin, pystyy muuttamaan käyttöoikeuksia ja työryhmiä sekä lisäämään tai poistamaan käyttäjiä. DI-työn ohjaaja Opiskelijalle voidaan määrittää diplomityön ohjaaja, jolla on pääsy kaikkiin kyseistä opiskelijaa koskeviin tietoihin. Yhdelle käyttäjälle pystytään määrittelemään useampia käyttöikeuksia, jolloin hän voi esimerkiksi opettaa useammalla kurssilla ja samalla ohjata yhtä tai useampaa diplomityötä. 6 Käyttäjät Ryhmä Kuvaus Lukumäärä Professorit Järjestelmää käyttävät professorikunnan edustajat 2 Opettajat Opettavat tutkijat ja tuntiopettajat sekä assistentit 10-15 Assistentit Kurssi- ja tuntiassistentit 15-20 Opiskelijat Opiskelijat jotka suorittavat opintoja TML:llä 500-1000 Ylläpitäjät Järjestelmän ylläpitäjät 1-3 Professoreihin, opettajiin ja assistentteihin viitataan tässä dokumentissa kuitenkin yleisellä termillä opettaja. 7 Toiminnalliset vaatimukset Tässä luvussa esitellään järjestelmän toiminnalliset vaatimukset. Vaatimuksia tullaan päivittämään projektin edetessä. Toiminnallisiin vaatimuksiin liittyvien tunnisteiden, statusten ja prioriteettien selitykset löytyvät luvusta 2. 6
Vaatimus Lähde Kuvaus Selitys Liittyy UC:n F1 Opiskelijakohtaisten Kokous Järjestelmään voi Muistiinpanojen tallen- U4 1.10.2004 tallettaa opiskelitaminen on eräs jär- muistiinpanojen jakohtaisia muisjestelmän ydintoimintaminen tallettiinpanoja. Nämä noista. Muistiinpanot muistiinpanot ovat koskevat yleensä erilaisia asianmukaisten käyttäjien selailtavissa. suoritusten erityisjärjestelyitä tai diplomitöitä. F2 Hakujen tekeminen Kokous Järjestelmästä voi Haut ovat nopea tapa ja U1 1.10.2004 tehdä hakuja opiske- joustava tapa saada tietyn lijan opiskelijanumeron opiskelijan tiedot näkyviin. tai nimen perusteella F3 Opiskelijan Kokous Järjestelmä sisältää Pakollisina tiedoina opiskelijasta U2, U3, tietojen tallettaminen 1.10.2004 perustietoja kustakin on järjestelmään U5, U6 opiskelijasta tallennettu nimi, opiske- lijanumero sekä sähköpostiosoite. Edellisten yleistietojen lisäksi järjestelmään tallennetaan tieto perusopintojen, diplomityön ja jatkoopintojen tilasta. F4 Tiedostojen Kokous Järjestelmään voi Tyypillisesti tallennettavia - tallennus 1.10.2004 tallettaa opiskelijaan tiedostoja ovat diplomityön liittyviä tiedostoja. sisällysluettelo, luon- Myös tiedostot kuuluvat nos ja opintosuunnitelmat. aina johonkin työryhmään. F5 F6 Diplomitöiden seuraaminen Järjestelmällä voidaan seurata opiskelijan diplomityön edistymistä. Kaikki diplomityöt käyvät läpi tiettyjä tiloja Järjestelmään kuuluu opiskelijakäyttöliittymä, jonka kautta opiskelija voi tal- Opiskelijakäyttöliittymä Kokous 7.10.2004 Kokous 1.10.2004 lentaa järjestelmään tiedostoja. Opiskelija voi myös rajoitetusti muuttaa omia tietojaan, sähköpostiosoitettaan. esimerkiksi Professorit päivittävät opiskelijan diplomityön tilaa tarvittaessa. Opiskelijäkäyttöliittymä helpottaa opettajien työtä, sillä sen kautta opiskelijat itse voivat hoitaa tiedostojen tallentamisen, mikä pienentää opettajien työmäärää. U2 - Korkea 7
(Jatkoa edelliseltä sivulta) Vaatimus Lähde Kuvaus Selitys Liittyy UC:n F7 Ylläpitotyökalryhmä Projekti- Ylläpitotyökalulla Järjestelmän ylläpito on - hallitaan tunnuksia, eriytetty järjestelmän hyö- (erityisesti opettajien dyntämisestä kokonaan ja tunnuksia) siihen tarvitaan erillinen niiden oikeustasoja ja tunnus. työryhmiä. F8 Raportit Kokous Järjestelmästä saa Erityisesti raportteja pitää - Korkea 1.10.2004 haettua raportteja. saada kunakin vuonna valmistuneiden tai valmistuvien diplomitöiden määrästä. Myös keskeneräisistä diplomitöistä voidaan pyytää raportti. F9 Käyttöliittymä Kokous Järjestelmässä on www-pohjainen järjestelmä - 1.10.2004 www-pohjainen on asiakkaan käyttöliittymä, joka vaatimusten mukaisesti toimii HTML- varsin alustariippumaton standardeja noudattavilla ja joustava. selaimilla. F10 Tietojen Projektiryhmä Sekä tietokannassa Tiedot ovat tärkeät - Ehdotus varmuuskopiointi olevat tiedot että henkilökunnalle eikä niitä ulkoiset tiedot pitää välttämättä ole muissa pystyä varmistamaan. rekistereissä. Tietojen varmistaminen on tärkeää huomioida jo suunnitteluvaiheessa. F11 Järjestelmäloki Projektiryhmä Järjestelmän tärkeät Lokitiedot auttavat selvit- - tapahtumat kuten tämään esimerkiksi tieto- sisään- ja uloskirjautumiset murtoa. ja tietojen muuttamiset pitää kirjata lokitiedostoon. F12 Todennusmenetelmäryhmä Projekti- Järjestelmässä täytyy Sisäisen todennus- - olla sisäinen todenmenetelmän täytyy ol- nusmenetelmä käyttäjien la olemassa, sillä muita tunnistamiseen ei välttämättä toteuteta. ja todentamiseen. Kaikilla käyttäjillä ei myöskään välttämättä ole mahdollisuutta käyttää F13 F13 Järjestelmä täytyy toteuttaa siten, että myös muita todennusmenetelmiä voidaan lisätä. Järjestelmä käyttää sisäisen todennusmenetelmän lisäksi muita jo olemassa olevia ulkoisia mentelmiä, kuten esimerkiksi mahdollisia TML:n tai ATK-keskuksen todennuspalveluita. Todennusmenetelmät Projektiryhmä Todennusmenetelmät Projektiryhmä ulkoisia menetelmiä. Jo olemassa olevien menetelmien käyttö pienentää käyttäjien salasanataakkaa. Jo olemassa olevien menetelmien käyttö pienentää käyttäjien salasanataakkaa. - Korkea Ehdotus - Matala Ehdotus 8
8 Ei-toiminnalliset vaatimukset Tässä luvussa esitellään järjestemän ei-toiminnalliset vaatimukset. Ei-toiminnallisiin vaatimuksiin liittyvien tunnisteiden, statusten ja prioriteettien selitykset löytyvät luvusta 2. Vaatimus Lähde Selitys N1 Järjestelmää voitava Kokous Opiskelijat käyttävät käyttää sekä TML:n 1.10.2004 järjestelmää liki poikkeuksetta verkosta että muualta TML:n ulkopuolelta. Internetistä Opettajat tarvitsevat mahdollisuuden järjestelmän käyttöön myös esimerkiksi etätöitä tehdessään. N2 Työryhmät U7 Järjestelmässä on työryhmiä, joihin kuuluu käyttäjiä. Kukin muistiinpano kuuluu yhteen työryhmään. Työryhmän jäsenet näkevät työryhmään tehdyt muistiinpanot. Työryhmät määrittävät mitä tietoja käyttäjä pääsee näkemään. Käyttäjä voi kuulua useampaan työryhmään. N3 Tunnistus ja valtuutus Tietoturvavastaava N4 Järjestelmän on oltava niin nopea ja helppokäyttöinen, että sitä voi käyttää myös opiskelijan kanssa käytävän keskustelun lomassa. N5 Järjestelmästä pitää kirjoittaa rekisteriseloste. N8 Käyttöliittymä toteutetaan suomeksi Kokous 7.10.2004 N6 Järjestelmä pitää suunnitella niin, että kieliä voidaan lisätä jälkeenpäin N7 Käyttöliittymä toteutetaan englanniksi Projektiryhmä Kokous 7.10.2004 Projektiryhmä Käyttäjät pääsevät käsiksi vain niihin tietoihin, joihin heille on annettu lupa Järjestelmän tiedot ovat tarkoitettu vain henkilökunnan käyttöön. Henkilötietolaki vaatii että henkilötiedot käsitellään luottamuksellisesti. Opettajat saattavat haluta nähdä vanhoja opiskelijaan liittyviä muistiinpanoja keskustellessaan hänen kanssaan. Samoin useat tallennettavat muistiinpanot tulevat esiin opiskelijan kanssa keskustellessa. Jotta muistiinpanosta tulisi tarkka, sen tallentaminen pitäisi olla mahdollista tehdä keskutelun lomassa. Projektiryhmä Järjestelmä sisältää henkilötietoja henkilötietolain (523/1999) tarkoittamassa muodossa. Henkilötietolaki (523/1999, 10 ) velvoittaa laatimaan rekisteriselosteen. Saattaa tulla tilanteita, joissa järjestelmää täytyy tai olisi hyvä voida käyttää useammalla kielellä. Englanti on ainoa kieli, jota kaikki järjestelmän käyttäjät ymmärtävät. Suomenkielisten käyttäjien saattaa olla miellyttävämpää käyttää järjestelmää äidinkielellään. Matala 9
9 Käyttäjätapaukset Tässä luvussa kuvataa järjestelmän vaatimuksia käyttäjätapausten avulla. Käyttäjätapauksia laatiessa käytettiin apuna HTML-prototyyppiä järjestelmän käyttöliittymästä. Prototyypistä on ruudunkaappauksia liitteessä A. 9.1 Opiskelijan tietojen hakeminen Nimi Esiehdot Basic sequence U1 Opiskelijan tietojen hakeminen Opettaja A on kirjautunut järjestelmään. 1. Opettaja A valitsee työkaluvalikosta toiminnon Hae opiskelija. 2. Opettaja A syöttää opiskelijan opiskelijanumeron sekä vapaaehtoisen tarkistuskirjaimen hakutoimintoon. 3. Järjestelmä näyttää opiskelijan tiedot (Usecase U2 ). Poikkeukset 2a. Opettaja A syöttää opiskelijan nimen tai nimen osan hakutoimintoon Jälkiehdot - Liittyy vaatimukseen F2 Liittyy testiin - 1. Järjestelmä näyttää opiskelijan tiedot (Usecase U2 ). 1a. Järjestelmä näyttää listan hakua vastaavista opiskelijoista. 1. Opettaja A valitsee listasta haluamansa opiskelijan. 2. Järjestelmä näyttää opiskelijan tiedot (Usecase U2 ). 2b. Opettaja A käyttää edistynyt haku -toimintoa. 1. Järjestelmä näyttää hakua vastaavan opiskelijan yleiset sekä työryhmän T syöttämät tiedot. 1a. Järjestelmä näyttää listan hakua vastaavista opiskelijoista. 1. Opettaja A valitsee listasta haluamansa opiskelijan. 2. Järjestelmä näyttää opiskelijan tiedot (Usecase U2 ). 3a. Järjestelmästä ei löydy haulla mitään. 1. Järjestelmä näyttää virheilmoituksen. 2. Järjestelmä tarjoaa Lisää uusi opiskelija -toimintoa (Usecase U3 ). 10
9.2 Opiskelijan tietojen näytäminen Nimi Esiehdot Basic sequence U2 Opiskelijan tietojen näyttäminen Opettaja A on kirjautunut järjestelmään. Opettajan A aktiivinen työryhmä on T. (Usecase U1 ) 1. Järjestelmä näyttää opiskelijan yleiset tiedot. 2. Järjestelmä näyttää opiskelijan perusopintojen (perus- / pääaine- / sivuaine- / masters-opiskelija), diplomityön ja jatko-opintojen (ei vielä kiinnostunut jatko-opinnoista / kiinnostunut jatko-opinnoista / opiskelee / valmistunut) statuksen. 3. Järjestelmä näyttää kaikki työryhmän T opiskelijasta syöttämät tiedot. Poikkeukset 2a. Opettajalla A on oikeus päivittää opiskelijoiden perusopintojen statusta. 1. Järjestelmä näyttää opiskelijan perusopintojen statuksen. 2. Järjestelmä näyttää listan mahdollisista tiloista perusopinnoille. 2b. Opettajalla A on oikeus päivittää opiskelijoiden diplomitöiden statusta. 1. Järjestelmä näyttää opiskelijan diplomityön statuksen. 2. Järjestelmä näyttää listan mahdollisista tiloista diplomityölle. 2c. Opettajalla A on oikeus päivittää opiskelijoiden jatkoopintojen statusta. 1. Järjestelmä näyttää opiskelijan jatko-opintojen statuksen. 2. Järjestelmä näyttää listan mahdollisista tiloista jatkoopinnoille. 3a. Opettajalla A on työryhmänäkymänä näytä kaikki omien työryhmien merkinnät. 1. Järjestelmä näyttää kaikkien opettajan A työryhmien opiskelijasta syöttämät tiedot. 3b. Opettaja A on professorikäyttäjä (jolloin hänellä on oikeus nähdä kaikki opiskelijaan liittyvät merkinnät) ja hänellä on työryhmänäkymänä näytä opiskelijan kaikki tiedot. 3c. Opettajalla A on valittuna piilota vanhentuneet merkinnät. 1. Järjestelmä näyttää kaikki sellaiset työryhmän T opiskelijasta syöttämät tiedot, jotka eivät ole vielä vanhentuneet. Jälkiehdot - Liittyy vaatimukseen F3, F5 Liittyy testiin - 11
9.3 Uuden opiskelijan syöttäminen Nimi Esiehdot Basic sequence U3 Uuden opiskelijan syöttäminen Opettaja A on kirjautunut järjestelmään. 1. Opettaja A valitsee työkaluvalikosta toiminnon Lisää uusi opiskelija. 2. Järjestelmä tarjoaa lomakkeen, jolla siihen voi syöttää opiskelijan tiedot. 3. Opettaja A täyttää lomakkeen ja tallentaa sen järjestelmään. Poikkeukset 3a. Opiskelijatiedot ovat jo järjestelmässä. 1. Järjestelmä näyttää virheilmoituksen. 2. Järjestelmä ehdottaa mahdolliseksi toiminnoksi järjestelmässä jo olevan opiskelijan tietojen näyttämistä. 3b. Kaikkia tarvittavia tietoja ei syötetty. 1. Järjestelmä näyttää puutteet selittävän virheilmoituksen ja palauttaa opettajan lomakenäkymään. Jälkiehdot Järjestelmään tallennetaan uusi opiskelija Liittyy vaatimukseen F3 Liittyy testiin - 12
9.4 Opiskelijakohtaisen muistiinpanon tekeminen U4 Nimi Opiskelijakohtaisen muistiinpanon tekeminen Esiehdot (Usecase U1 ) Basic sequence 1. Järjestelmä näyttää opiskelijanäkymässä lomakkeen, jolla voi syöttää määrämuotoisen muistiinpanon. Muoto sisältää myös kohdan vapaamuotoiselle tekstille. 2. Opettaja A täyttää lomakkeen tarpeellisilta osin ja tallentaa sen järjestelmään. Poikkeukset 2a. Muistiinpanolle halutaan antaa eräpäivä. 1. Opettaja A käyttää helppokäyttöistä päivämääränsyöttötyökalua ja valitsee haluamansa päivän. 2b. Muistiinpanolle halutaan jokin muu kuin sillä hetkellä aktiivinen työryhmä. Jälkiehdot Uusi muistiinpano tallennetaan Liittyy vaatimukseen F1 Liittyy testiin - 1. Opettaja A valitsee työryhmän, johon muistiinpano kuuluu. 9.5 Perusopintojen statuksen päivittäminen Nimi Esiehdot Basic sequence U5 Perusopintojen statuksen päivittäminen Opettajalla A on oikeus päivittää perusopintojen statuksia sekä Usecase U1. 1. Järjestelmä näyttää opiskelijanäkymässä mahdolliset tilat perusopinnoille [Kommentti-otsake]. 2. Opettaja A valitsee haluamansa vaihtoehdon. 3. Järjestelmä tallentaa opiskelijan perusopinnoille uuden statuksen. Poikkeukset - Jälkiehdot Opiskelijan perusopintostatus vaihtuu Liittyy vaatimukseen F3 Liittyy testiin - 13
9.6 Jatko-opintojen statuksen päivittäminen Nimi Esiehdot Basic sequence U6 Jatko-opintojen statuksen päivittäminen Opettajalla A on oikeus päivittää jatko-opintojen statuksia sekä Usecase U2. 1. Järjestelmä näyttää opiskelijanäkymässä mahdolliset tilat jatko-opinnoille. 2. Opettaja A valitsee haluamansa vaihtoehdon. 3. Järjestelmä tallentaa opiskelijan jatko-opinnoille uuden statuksen. Poikkeukset - Jälkiehdot Opiskelijan jatko-opintostatus muuttuu Liittyy vaatimukseen F3 Liittyy testiin - 9.7 Työryhmän vaihtaminen Nimi Esiehdot Basic sequence U7 Työryhmän vaihtaminen Opettaja A on kirjautunut järjestelmään 1. Järjestelmä näyttää työkaluvalikossa työryhmävaihtoehtoina opettajan A kaikki työryhmät. 2. Opettaja A valitsee haluamansa vaihtoehdon. Poikkeukset - Jälkiehdot Aktiivinen työryhmä muuttuu Liittyy vaatimukseen - Liittyy testiin - 3. Järjestelmä vaihtaa opettajan A aktiiviseksi työryhmäksi valitun vaihtoehdon. 14
9.8 Työryhmänäkymän vaihtaminen Nimi Esiehdot Basic sequence U8 Työryhmänäkymän vaihtaminen Opettaja A on kirjautunut järjestelmään 1. Järjestelmä näyttää työkaluvalikossa vaihtoehdot näytä kaikki omien työryhmien merkinnät ja näytä vain aktiivisen työryhmän merkinnät. Poikkeukset - Jälkiehdot Työryhmänäkymä vaihtuu Liittyy vaatimukseen - Liittyy testiin - 10 Rajoitukset 2. Opettaja A valitsee haluamansa vaihtoehdon. 3. Järjestelmä vaihtaa opettajan A työryhmänäkymäksi valitun vaihtoehdon. C1 Aihe HTML-kielen versio Kuvaus Järjestelmän tuottamat www-sivut noudattavat XHTML 1.1- suositusta Perustelu Asiakkaalla on monta eri selainta ja alustaa käytössä. Vain noudattamalla virallisia suosituksia tarkasti voidaan taata, että järjestelmä toimii kaikissa ympäristöissä. Lähde Koko ryhmä Käyttötapaukset Kaikki C2 Aihe PHP-kielen versio Kuvaus Järjestelmä toteutetaan PHP:n versiolla 5. Perustelu PHP 5 tukee olio-ohjelmointia, jota projektiryhmä haluaa käyttää järjestelmän toteutuksessa. Lähde Projektiryhmä Ehdotus Käyttötapaukset Kaikki C3 Aihe Tietokantaohjelmisto Kuvaus Järjestelmä käyttää PostgreSQL-tietokantaa datan tallentamiseen. Perustelu PostgreSQL tukee transaktioita. Lähde Asiakas ja projektiryhmä Ehdotus Käyttötapaukset Kaikki 15
11 Viitteet Projektisuunnitelma Kuvaa projektiryhmää ja projektin taustat. 16
A Käyttöliittymän HTML-prototyyppi Vaatimusten keräämisessä käytettiin apuna nopeasti rakennettua HTML-prototyyppiä käyttöliittymästä. Kuvassa 1 on esitelty perusnäkymää ja kuvassa 2 syöttönäkymää. Prototyyppi ei ole täydellinen eikä sitä ole päivitetty täysin vastaamaan tässä dokumentissa esitettyjä vaatimuksia. Kuva 1: Perusnäkymä 17
Kuva 2: Syöttönäkymä 18