Määrittelydokumentti Olutkortisto Juuso Hyvönen juuso.hyvonen@cs.helsinki.fi Ohjaaja Pekka Mikkola HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos Ohjelmoinnin harjoitustyö, 12.9.2010
1 1 Ohjelman tarkoitus ja yleiskuvaus Olutharrastajat pitävät usein kirjaa maistamistaan oluista. He kirjoittavat lyhyitä sanallisia arvioita ja ottavat talteen oluesta kaikenlaisia oleellisia tietoja kuten alkoholiprosentin ja katkerot sekä tietysti panimon nimen. Vanhoja arvioita on mukava lukea ja niille on myös mukava kirjoitella uudempia arvioita verrokiksi. Olutkortisto on komentoriviohjelma, joka mahdollistaa tälläisen olutkortiston ylläpidon mukavasti komentoriviltä. Ohjelmassa on yksi käyttäjä, joka voi Lisätä uuden oluen Oluesta tallennetaan ainakin seuraavat tiedot: nimi, panimo, tyyli, alkoholiprosentti, arvosana välillä 0-50. Vapaaehtoisia tietoja ovat: sanallinen arvio oluesta, kantavierre, katkerot, väri, Poistaa oluen Selata oluita Hakea oluita tunnistenumeoron sekä panimon- tai oluen nimen perusteella Tarkastella oluen tietoja Lisätä olueen uuden sanallisen arvion Ohjelma tallentaa kortiston automaattisesti tekstitiedostoksi ohjelmaa suljettaessa sekä lataa tiedoston automaattisesti käynnistyksen yhteydessä. 2 Rajoitukset Käyttäjä voi tallentaa saman oluen vain kertaalleen. Oluen korttiin ei voi lisätä kuvaa. Yksittäisen sanallisen arvion suurin sallittu pituus on 500 merkkiä. 3 Käsiteltävän datan kuvaus Ohjelma tallentaa kortiston tekstitiedostoon ja lataa kortiston samasta tiedostosta. Kortti sisältää seuraavat kentät: Oluen nimi, panimon nimi, tyyli, alkoholiprosentti, numeerinen arvosana, kantavierre, katkerot, väri, sanallinen arvio. 4 Tiedonkulun kuvaus Olutkortisto lataa vanhan kortiston ohjelman käynnistyessä. Ohjelma tulostaa ruudulle listan mahdollisista toiminnoista. Käyttäjä syöttää näppäimistöllä haluamansa valinnan, jonka jälkeen ohjelma piirtää uuden listan komennoista ja mahdollisesti muuta tietoa kuten käyttäjän kannalta olennaisimman eli oluen tiedot. Käyttäjää syöttää taas valitsemansa komennon tai tarvittaessa antaa kysytylle kentälle arvon. Tehdyt muutokset tallentuvat tiedostoon ohjelmasta poistumisen yhteydessä.
2 5 Toimintojen kuvaus Oluen lisäys Käyttäjä lisää uuden oluen ja syöttää tälle tarpeelliset tiedot. Oluen poisto Käyttäjä poistaa oluen kortistosta. Oluen haku Käyttäjä hakee olutta tunnistenumeron tai panimon- tai oluen nimen perusteella. Oluen tarkastelu Käyttäjä tarkastelee lisäämänsä oluen korttia. Uuden sanallisen arvion lisäys Käyttäjä lisää korttiin uuden sanallisen arvion. 6 Käyttäytymisen kuvaus Ohjelma lataa kortiston käynnistyessään ja tallentaa muutokset automaattisesti ohjelman sulkeutuessa. Käynnistymisen jälkeen ohjelma tulostaa käyttäjälle komentolistan sekä perustietoja kortistosta kuten oluiden määrän ja viimeksi lisätyn oluen. Kaikki seuraavaksi esitetyt käyttötapaukset olettavat käyttäjän olevan ohjelman päävalikossa. Uusi olut lisätään kortistoon painamalla näppämistöstä merkkiä L(isää) ja tämän jälkeen Enternäppäintä. Ohjelma kysyy käyttäjältä järjestyksessä kortin kunkin kentän. Käyttäjä syöttää kysytyn tiedon ja painaa Enter-näppäintä. Vapaaehtoiset kentät voi ohittaa jättämällä kentän tyhjäksi ja painamalla Enter-näppäintä. Oluen lisäys luo oluelle automaattisesti tunnistenumeron, joka on kokonaisluku alkaen numerosta yksi ja aina yhtä suurempi kuin edellisen oluen tunniste. Oluelle tallennetaan automaattisesti myös lisäyspäivämäärä sekä sanallisen arvion päivämäärä. Olueen lisätään uusi sanallinen arvio navigoimalla oluen korttiin ja painamalla L(isää arvio) sekä Enter-näppäintä. Tämän jälkeen käyttäjä syöttää arvion ja painaa Enter-näppäintä. Ohjelma palaa takaisin oluen korttiin ja näyttää nyt kaksi arviota allekkain sekä arvioiden päivämäärät. Olut poistetaan navigoimalla oluen korttiin ja kirjoittamalla käsky poista ja painamalla tämän jälkeen Enter-näppäintä. Kortti tuhotaan ja ohjelma palaa päävalikkoon. Oluita selataan painamalla näppäintä S(elaa) ja Enter-näppäintä. Ohjelma tulostaa listan oluista lisäysjärjestyksessä vanhimmasta uusimpaan. Oluen korttia voidaan tarkastella syöttämällä oluen nimen yhteydessä esiintyvä tunnistenumero ja painamalla Enter-näppäintä. Oluita haetaan painamalla H(ae) ja tämän jälkeen Enter-näppäintä. Tämän jälkeen ohjelma kysyy hakuperustetta, joka on joko O(luen nimi) tai P(animon nimo). Valinta kuitataan Enternäppäimellä. Seuraavaksi käyttäjä syöttää hakusanan ja painaa Enter-näppäintä. Ohjelma tulostaa
löytyneet oluet ja näiden tunnistenumerot. Käyttäjä voi valita oluen kirjoittamalla tunnistenumeron ja painamalla Enter-näppäintä tai poistua päävalikkoon painamalla P(oistu) ja Enter-näppäintä. Päävalikon käyttöliittymäkaavio Oluita yhteensä 34 kappaletta. Uusin olut Anchor Liberty Ale (34) L)isää S)elaa H)ae 3 Selailun käyttöliittymäkaavio Anna oluen tunnistenumero tarkastellaksesi olutta. Sinebrychoff Porter (1). #tässä kohtaa oikeassa ohjelmassa. #lisää oluita. Plevna Petolintu (30) Avery The Kaiser Imperial Oktoberfest (31) Boon Faro (32) Nøgne Ø India Pale Ale (33) Anchor Liberty Ale (34) Olutkortin käyttöliittymäkaavio Plevna Smörre IPA Pisteet: 45 Alkoholi: 5,9% Tyyli: India Pale Ale Katkerot: 60 EBU Kantavierre: 14,0% Väri:? EBC Arviot: 12.9.2010 Läpikuultavan tumman ruskea väri. Pieni pitsinen vaahto. Tuoksu herkullisen leipäinen ja hedelmäinen. Maku on hedelmäinen ja hieman havumetsää. Ripaus greippiä ja sopivan kirpeä katkeruus. Suutuntuma keskitäyteläinen. Oikein mukava ruis-ipa tämä.
31.1.2010 Väri läpikuultavan tumman ruskea. Vaahto tiivistä ja pitsiäkin jää. Miedohkossa tuoksussa humala selkeästi esillä. Maku on hieman havuinen ja selkeän greippin kuoren katkeroinen. Maussa tuntuu myös hieman maltaista pyöreyttä päättyen kuitenkin täysin kuivaan loppuun. Suutuntuma on keveähkö ja raikas. 4 L)isää arvio