Parsi-projektin 11. palaveri

Aika: keskiviikkona 18.5. klo 10:18 - 12.13.
Paikka: sovellusprojektien kokoushuone Ag C226.2, Jyväskylän yliopisto

Pöytäkirja laadittu: 18.5.2011
Pöytäkirjaa muokattu: 23.5.2011

Paikalla
  Projektiryhmä
    Vili Auvinen, puheenjohtaja
    Juho Tammela
    Olli Kauppinen, sihteeri

  Tilaajat
    Antti Ekonoja
    Tommi Lahtonen

  Ohjaajat
    Jukka-Pekka Santanen
    Mikko Tyrväinen


1. Palaverin avaus

Auvinen avasi palaverin. Auvinen valittiin puheenjohtajaksi ja Kauppinen sihteeriksi.


2. Laillisuus ja päätösvaltaisuus

Todettiin palaveri lailliseksi ja päätösvaltaiseksi.


3. Esityslistan hyväksyminen

Esityslistaan ehdotettiin muutettavaksi kohta 7 muotoon "Tulosten katselmointi" ja kohta 8 muotoon "Keskustelua dokumenteista".

PÄÄTÖS:
  - Hyväksyttiin esityslista edellä mainituin muutoksin.


4. Edellisen pöytäkirjan hyväksyminen

Auvinen kävi läpi edellisen palaverin pöytäkirjaan tulleet muutokset, päätökset ja tehtävät.

Tarkasteltiin, mitkä tehtävät on jo toteutettu sekä mitkä keskeneräisistä tehtävistä tehdään vielä projektin aikana ja mitkä toteutetaan jatkokehitysvaiheessa. Käytiin tarkemmin läpi kohta 7 seuraavan vaiheen tehtävät:
   - Käyttöliittymän palautesivun HTML:ssä sisäkkäinen lista on
     muodostettu väärin. Toteutettu.
   - Käyttöliittymän lomakkeen pitäisi käyttää mieluummin GET- kuin
     POST-menetelmää. Toteutetaan jatkokehitysvaiheessa.
   - Käyttöliittymän palautesivulla voisi esittää tarkastuksen
     päivämäärän ja ajan sekä tiedoston viime muokkauksen ajankohdan.
     Tarkastuksen päivämäärä toteutettu. Tarkastettavan dokumentin 
     viime muokkauksen ajankohdan lisääminen toteutetaan 
     jatkokehitysvaiheessa.
   - Palautesivulla voi jättää näyttämättä kokonaisuudet, jotka ovat
     tehty oikein. Toteutettu.
   - Kurssin nimi tulee lisätä lomake- ja palautesivulle. Kesken.
   - Lomakesivu voisi virhetilanteessa muistaa, kumpi radiopainike oli
     valittu. Toteutetaan jatkokehitysvaiheessa.
   - Vaatimustiedoston parsiminen tulee toteuttaa niin, ettei sovellus
     kaadu, jos tiedostoon esimerkiksi unohtaa kirjoittaa 
     default-virheilmoituksen. Testattava ja dokumentoitava, varsinainen
     toteutus jatkokehitykseen.
   - Vaatimustiedoston hakeminen sähköpostiosoitteen perusteella tulee
     toteuttaa. Toteutettu.

Muita esille nousseita huomioita olivat seuraavat:
   - "Tietokone ja tietoverkot työvälineenä - Harkkapoliisi"
     lisätään sovelluksen käyttöliittymään.
   - Sitoumusluonnokseen pitää liittää lisenssit. Creative Commons
     Attribution 1.0 Finland -lisenssin osalta liitettävä laajempi
     kuvaus lisenssistä.
   - Sovellusraporttiin pitää laatia ohjeet uusien ominaisuuksien
     lisäämiseen, kuten tarkastimien ja tarkastettavien vaatimusten
     lisääminen.
   - Asennusohjeisiin tulee kirjata mitä tiedostoja sovelluksen asennus vaatii,
     muut tarvittavat sovellukset sekä mitä muutoksia koodiin pitää
     tehdä.

Pöytäkirjaan sovittiin muutos:
   - Kohdan 12 päätöksen testaussuunnitelma ei tule pelkästään ryhmän
     käyttöön.

PÄÄTÖKSET:
  - Sovelluksen nimi päätetään jatkokehityksessä. 
  - Sovelluksen työnimeksi sovittiin Harkkapoliisi.
  - Hyväksyttiin sitoumusluonnos.
  - Hyväksyttiin edellisen palaverin pöytäkirja edellä mainitulla 
    muutoksella.
  - Sovellukseen toteutetaan eo. kohtien suorittamattomista 
    toimenpiteistä ne, joita ei sovittu projektin jälkeiseen 
    jatkokehitykseen.


5. Edellisessä palaverissa sovitut tehtävät

Ryhmä:
    - Tiedottaa, kun sovelluksesta tulee uusi versio. Toteutettu.
    - Tekstinkäsittelyn tarkastaminen loppuun. Toteutettu.
    - Taulukkolaskennan ja esitysgrafiikan tarkastamisen 
      aloittaminen. Ei toteuteta.
    - Toimittaa sovellusraportin ensimmäisen version. Toteutettu.
    - Toimittaa projektiraportin ensimmäisen version. Toteutettu.
    - Allekirjoittaa sitoumuksen ja toimittaa sen Lahtoselle. 
      Toteutettu.
    - Suorittaa sovellukselle järjestelmätestauksen. Kesken.
    - Auvinen toimittaa Lahtoselle ongelmallisen dokumentin. 
      Toteutettu.
    - Toimittaa katselmoitavan lähdekoodin organisaatiolle
      tiistaina 10.5. Toteutettu.
    - Laatii testaussuunnitelman. Kesken.
    - Tarkastaa työmikrot tärkeän materiaalin osalta projektin 
      päättyessä. Kesken.

Lahtonen:
    - Tutustuu OpenOffice.orgin tyylipohjiin (style templates). Ei 
      toteuteta.
    - Käy keskustelemassa laitosjohdon kanssa mahdollisuudesta
      jatkokehittää sovellusta kesätöinä. Toteutettu.
    - Laatii lausunnon projektista projektin päättyessä. Kesken.

Santanen:
    - Laatii projektitodistukset ryhmän jäsenille projektin
      päätyttyä. Kesken.


6. Projektin tilakatsaus

Auvinen esitteli projektin tilakatsausta videoprojektorilla.

Ryhmä on viimeistellyt lähdekoodeja ja dokumentteja. Sovellusraportin ja projektiraportin laatiminen sekä projektikansion kokoaminen on aloitettu.

Seuraavaksi on tarkoitus hyväksyttää lähdekoodi ja aloittaa projektikansion kokoaminen.

Ongelmia ryhmällä on ollut merkistöjen kanssa. Sovellus toimii tällä hetkellä, joten merkistöongelmien korjaus sovittiin siirrettäväksi projektin jälkeiseen jatkokehitykseen. Ongelma voi johtua Windows- ja Linux-koneissa olevasta merkistöerosta.

Projektin ajankäyttö näyttää toteutuvan suunnitellun mukaisesti. Loppuesittely kuuluu kirjata projektin työtunteihin.

PÄÄTÖS:
   - Merkistöongelmien korjaus siirretään projektin jälkeiseen
     jatkokehitykseen.

7. Tulosten katselmointi

Tulosten katselmoinnissa tarkasteltiin ensin ePydocilla toteutettuja luokkadokumentteja. Esille nousi seuraavia huomioita:
    - Ryhmän pitää toimittaa Lahtosen ircin kautta lähettämä palaute
      projektin postilistalle.
    - Koodit ja etenkin parametrit on kommentoitava, jos tuntuu, että
      koodiin tutustuja voi tulkita koodia väärin.
    - word_processing-moduulin inspect-metodin zipFile-parametri
      muutettava kuvaavampaan documentFile-muotoon.
    - Paketin nimi ja hakemistorakenne on korjattava.
    
Seuraavaksi tarkasteltiin sovelluksen käyttöliittymää. Esille nousi seuraavia huomioita:
    - Lataamista osoittava animaatio ei toimi Opera-selaimessa.
    - Pitkillä dokumenteilla tarkastaminen kestää kauan. 
      Jatkokehityksessä tutkittava mahdollisuuksia optimointiin.
    - Itse dokumentin tekstistä tarkastettavien vaatimusten lisääminen
      kerralla tarkastettavaan listaan, voi nopeuttaa tarkastusta.
    - Muokkauspäivämäärä ja tarkastettavan dokumentin otsikko lisätään
      jatkokehityksessä.
    - Plussa-kuvakkeen voisi siirtää virheiden määrän kohdalle ja 
      piilottaa, jos virheitä ei löytynyt.
    - Odf-formaattiin saattaa Arial-fonttia käytettäessä tulla fontin
      nimeksi Arial1 tai Arial2 XML-tiedostoon. Ongelma on
      kirjattava sovellusraporttiin.
      
PÄÄTÖKSET:
   - zipFile-parametri muutettava documentFile-muotoon.
   - Paketin nimi ja hakemistorakenne on korjattava.
   - Lataamista osoittava animaatio korjattava toimivaksi.
   - Muut eo. huomiot ja korjaukset toteutetaan jatkokehityksessä.


8. Keskustelua dokumenteista

Ensimmäisenä keskusteltiin järjestelmätestaussuunnitelmasta. Santanen oli käynyt sen läpi ennen palaveria ja toi esille siitä seuraavat huomiot:
    - Dokumentin alusta puuttuu sovelluksen ja sen version tiedot.
    - Testauksessa käytetty selain ja sen versio on syytä kirjata ylös.
    - Testauksessa käytetty käyttäjänimi ja sähköpostiosoite on
      mainittava, jotta tiedetään mitä vaatimustiedostoa on käytetty.
    - Virheellisen tai huomautuksen sisältävän testauksen osalta on 
      kirjoitettava parin virkkeen kuvaus. Virheen osalta sovittava
      tilaajan kanssa myös, korjataanko se projektin puitteissa vai 
      jatkokehityksessä.
    - Virheiden ja huomioiden kokonaismäärä dokumentin alkuun, jolloin
      sen lukija saa yleiskäsityksen testauksesta.
    - Käyttöliittymän vaatimukset on testattava eri selaimilla. 
      Tilaajien pyynnöstä on testattava ainakin Internet Explorer,
      Opera, Safari, Mozilla ja Chrome selaimilla.
    - Käyttöliittymän lähdekoodi on validoitava.
    - Huomioille tulee varata oma taulukko.
    - Dokumentissa on käytetty termiä vaatimus kahdessa eri 
      merkityksessä.

Ei käyty muita dokumentteja läpi palaverissa.


9. Jatkokehitystehtävät

Vili Auvisen kesätöiden jatkokehitystehtäviksi sovittiin seuraavassa järjestyksessä seuraavat tehtävät:
    1. Puutteellisten ja viallisten osien korjaus.
    2. Esitygrafiikkatarkastimen toteuttaminen.
    3. Taulukkolaskentatarkastimen toteuttaminen.
    4. Harjoitustyö vaatimusten luonti työkalun toteuttaminen.
    5. WWW-sivuntarkastimen toteuttaminen.

Puutteelliset ja vialliset toteutusratkaisut kirjataan sovellusraporttiin.

10. META

Käytiin läpi tulevia tehtäviä ja projektin päättämistä. Auvinen, Lahtonen ja Tammela siirtyvät lomalle 20. toukokuuta. Lahtonen tulee lomalta takaisin 3. kesäkuuta ja Auvinen 5. kesäkuuta. Tulokset hyväksytetään tilaajalla, kun Lahtonen saapuu lomalta takaisin. 

Lähdekoodien hyväksyntään riittää Tyrväisen hyväksyntä. Lähdekoodit pyritään toimittamaan Tyrväiselle tarkastettavaksi 19. toukokuuta. Tyrväinen ja Santanen tarkastavat luokkadokumentit. 

Asennusohje ja käyttöliittymän korjaukset pyritään toimittamaan 19. toukokuuta tilaajille. Sovellus pyritään saamaan hyväksytyksi 20. toukokuuta. Auvinen tarkastaa lomansa jälkeen sovittujen tehtävien tilanteet.

Käytiin läpi projektin aikana tulleita tuntemuksia ja oppeja. Auvinen kertoi oppineensa projektityöskentelystä ja arkkitehtuurin merkityksestä. Tammela kertoi oppineensa projektityöskentelystä ja saaneensa kuvan, millaista oikeasti työskentely on. Tammelan mielestä projektin aihe oli mielenkiintoinen, mutta toisaalta se oli välillä raskas ja turhauttava. Myös teknistä ja dokumentointikokemusta kertyi projektista. Kauppinen kertoi oppineensa projektityöskentelyä sekä erilaisten työkalujen ja ohjelmointikielten käyttöä. Viestinnän merkitys projektityöskentelyssä oli myös keskeinen opetus. Kaikki olivat tyytyväisiä projektikurssiin.

Tilaajien mielestä kehitettävää oli viestinnässä. Tilannekatsauksia ei tullut riittävän usein, ja sovelluksen uusista versioista ei tiedotettu tarpeeksi hyvin. Tilaajilla oli välillä epäselvyyttä, mitä palaverien välissä tapahtui ja mikä versio sovelluksesta oli verkossa. Sovelluksessa olisi pitänyt olla versionumero tai päivämäärä näkyvillä. Myös erilliset projektiryhmän ja projektiorganisaation testiversiot verkossa olisi selkeyttänyt testausta.

Päätös:
    - Projektin tulokset hyväksytään sähköpostitse.

10. Osallistujien seuraavat tehtävät   

Ryhmä: 
    - Auvinen tarkastaa lomalta tultuaan, että pöytäkirjaan kirjatut
      tehtävät on suoritettu.
    - Suorittaa sovellukselle järjestelmätestauksen.
    - Laatii testausraportin.
    - Liittää lisenssit sitoumusluonnoksiin.
    - Testaa käyttöliittymän vaatimukset eri selaimilla.
    - Validoi käyttöliittymän lähdekoodin.
    - Toimittaa lähdekoodit Tyrväiselle tarkastettavaksi.
    - Toimittaa asennusohjeen ja käyttöliittymän korjaukset tilaajille.
    - Tarkastaa työmikrot tärkeän materiaalin osalta projektin
      päättyessä.
    - Toimittaa irc-login koko projektiorganisaation saataville.

Lahtonen:
    - Laatii lausunnon projektista projektin päättyessä.

Santanen:
    - Laatii projektitodistukset ryhmän jäsenille projektin 
      päätyttyä.
      
Tyrväinen:
    - Tarkistaa lähdekoodin ja luokkadokumentit.


11. Palaverin päättäminen

Auvinen päätti palaverin.


Jaetut ja käsitellyt materiaalit:
  - Projektin tilakatsaus käytiin läpi videoprojektorilla.
  - Sitoumusluonnos.


___________________________                  ________________________
Vili Auvinen, puheenjohtaja                  Olli Kauppinen, sihteeri