Kakapo-projektin 2. palaveri Kakapo-projektin 2. palaveri Aika: maanantai 12.2.2007. klo. 12:15 - 14:15 Paikka: Sovellusprojektien kokoustila AgC223.1 Laatineet 14.2.2007 klo 9:55 Ari & Tero Roponen Läsnä: * Antti Auer, kohdat 1 - 7, 12:15 - 13:55 * Vesa Lappalainen, kohdan 9 aikana, 14:05 - 14:10 * Anssi Pannula * Ilmari Repo, puheenjohtaja * Ari Roponen, sihteeri * Tero Roponen * Jussi Talaskivi * Jukka-Pekka Santanen * Panu Suominen 1. Kokouksen avaus Ilmari Repo avasi kokouksen kello 12:15. 2. Sihteerin ja puheenjohtajan valinta Ilmari Repo valittiin puheenjohtajaksi ja Ari Roponen sihteeriksi. 3. Esityslistan hyväksyminen Puheenjohtaja ehdotti esityslistaan muutosta, jonka mukaan kohdan 4 jälkeen käsiteltäisiin projektin tilaa. Päätökset * Esityslista hyväksyttiin muutoksen jälkeen. 4. Edellisen palaverin pöytäkirjan hyväksyminen Anssi Pannula esitti videotykin avulla 1. palaverin pöytäkirjan. Todettiin, että nyt riittää vain tehtyjen päätösten läpikäynti. Jussi Talaskivi halusi päätöksen moduulien kommentoinnista, sillä sellainen oli jo tehty docstringien osalta. Puheenjohtaja ehdotti asiaa käsiteltäväksi kohdassa 11. Ehdotus hyväksyttiin. Jussi Talaskivi mainitsi myös Plone-perehdytyksen tärkeydestä. Anssi Pannula huomautti asiasta päätettävän myöhemmässä kohdassa. Päätökset * Pöytäkirja hyväksyttiin. 5. Projektin tila Anssi Pannula esitteli projektin nykytilaa. * Projektihuoneen tietokoneisiin ei oltu vielä asennettu Plonea, ja Eclipsekin pitää asentaa itse. * Track-tunnuksia oli haettu, mutta niitä ei oltu vielä saatu. * Yksi tietokone oli mennyt rikki ja viety huoltoon, mutta atk-tuki ei ollut ilmoittanut tästä sähköpostilistalle. * Vaatimusmäärittelystä on tehty alustava versio. * Projektisuunnitelma on hieman kesken. Sitä esitellään seuraavassa palaverissa. * Jukka-Pekka Santanen on perustanut kakapo- ja kakapo_opetus-sähköpostilistat. * Plone-perehdytys oli siirtynyt. 6. Käytettävän lisenssin valinta Keskusteltiin Kokapo-projektin sopimuksen pohjalta tehdystä sopimusmallista. Panu Suominen huomautti, että siinä kielletään yliopistolta oikeuksia, joita GPL muille sallii. Tero Roponen muistutti, että yliopistolle pätevät sopimuksessa mainittujen erillisten ehtojen lisäksi myös GPL-oikeudet. Jukka-Pekka Santanen ehdotti sopimuksen selventämistä ja kysyi, sopiiko GPL tilaajille. Antti Auer ehdotti, että sopimukseen tehdään selvennyksiä, mutta sitä ei tarvitse esitellä uudelleen. Päätökset * Sopimusta selvennetään, mutta sitä ei tarvitse esitellä uudelleen. 7. Vaatimusmäärittelyn esittely ja siitä keskustelu Anssi Pannula esitteli vaatimusmäärittelyä videotykin avulla. Sitä käytiin läpi sivu kerrallaan, ja siihen esitettiin muutos- ja korjausehdotuksia. 7.1 Johdanto Johdannosta keskusteltiin. Tilaajan edustajat ja ohjaajat antoivat korjausehdotuksia ja täsmensivät epäselviä kohtia. 7.2 Termit Sanastosta keskusteltiin ja sinne ehdotettiin uusiksi termeiksi materiaalipankki, ryhmä ja roolit. 7.3 Taustat ja tavoitteet Jukka-Pekka Santanen totesi, että luvusta puuttuvat taustat. Hän ehdotti johdantokappaleen kirjoittamista yleisemmäksi. 7.4 Toiminnalliset vaatimukset Keskusteltiin toiminnallisista vaatimuksista ja siitä, miten eri tiedot saadaan. Selvisi, että projektissa ei tarvitse huolehtia autentikoinnista ja autorisoinnista. Jussi Talaskivi selosti Plonen oikeuksista ja rooleista. Hän mainitsi, että Kakapo-projekti tekee sovelluksen, joka yhdistää roolit ja oikeudet. Todettiin, että vaadittu ydintoiminnallisuus ei ole kovin laaja, joten projektin aikana ehditään toteuttaa myös muita ominaisuuksia. Keskusteltiin materiaalin jakamisesta. Mainittiin tekijänoikeudet ja materiaalin tallentamiseen liittyvät kysymykset. Todettiin, että liitetiedostojen tallennuksen toteuttaminen on hankalaa, eikä sen prioriteetti ole kovin korkea. Todettiin, että ensin pitää päästä alkuun, ennenkuin voidaan suunnitella pidemmälle. Todettiin, että vaatimusmäärittelyn kappaleet 4.1 ja 4.2 pitää kuvata tarkemmin. 7.5 Tekniset vaatimukset Todettiin, että vain käytettävä Plone-versio ja 32-bittinen Linux-ympäristö ovat teknisiä vaatimuksia. Muille vaatimuksille on etsittävä toinen esityspaikka. Todettiin, että docstring-kommentit kirjoitetaan englanniksi, kuten myös kommit-viestit. Tiketit ja wiki-materiaali tehdään suomeksi. Panu Suominen muistutti, että kannattaa kommitoida vain kokonaisuuksia. Jussi Talaskivi täsmensi, että kommit-viesteissä kuvataan aikomus, eikä niitä tiedostoja, joita muutettiin. Todettiin, ettei yksikkötestausta vaadita, mutta jonkinlaista testausta kannattaa kuitenkin tehdä. 7.6 Rajoitteet Todettiin, että projektin aikana pyritään välttämään valmiiden järjestelmien muokkausta. Erityisesti Plonesta ja Korpista yritetään käyttää vain olemassaolevia toimintoja. 7.7 Kaaviot Todettiin, että jotkin kuvat olivat osin virheellisiä. Panu Suominen piirsi seuraavanlaisen kuvan: +-------------------------------------------+ +--------+ XML-RPC | +--------+ +--------------+ | | Korppi |-----------+->| tilan | 1, 2 ja 3 | työtila | | +--------+ 1) | | luonti |------------->| +----------+ | | | +--------+ | | näkymä- | | | | | | koostaja | | | | | | 3) | | | | | +----------+ | | | Plone +--------------+ | | ^ 2) | | | | | käyttäjä | +-------------------------------------------+ 1) Korppi antaa käskyn luoda työtila. Tarvittavat tiedot tulevat XML-RPC-kutsun kautta. 2) Normaalitapauksessa Plone tarkistaa käyttäjän oikeudet, joten työtilaan päästessä oikeudet ovat jo kunnossa. 3) Jos Plone ei voi tarkistaa oikeuksia, eli niitä ei ole voitu esittää Plonen ymmärtämässä muodossa, oikeuksien tarkistus jää näkymäkoostajan tehtäväksi. Panu Suominen totesi, että projektin aikana ei synny yhtä sovellusta, vaan ainakin kaksi komponenttia. Jukka-Pekka Santanen ehdotti aineiston siirtoa vaatimusmäärittelystä projektisuunnitelmaan. Panu Suominen totesi, että iteratiivisessa prosessissa vaatimusmäärittelyn teko on hankalaa. Päätökset * Vaatimusmäärittely voidaan tehdä minimoidusti, mutta kaikki termit on määriteltävä selkeästi. 8. Prosessimallin valinta Prosessimalliksi ehdotettiin inkrementaalista mallia. Perusteluna käytettiin sitä, että vaatimusten voivat muuttua ajan kuluessa. Myös välitulosten esittely on mahdollista. Päätökset * Käytetään inkrementaalista prosessimallia. 9. Dokumentteja koskevat käytännöt 9.1 Nimeämiskäytännöt Puheenjohtaja antoi ehdotuksen tiedostojen nimeämiskäytännöstä. Todettiin, ettei nimeämiskäytäntö ulotu wikiin. Jukka-Pekka Santanen muistutti, että dokumentit kannattaa tallentaa alkuperäisessä muodossa. Seurasi keskustelua dokumenttien versionumeroinnista. Päädyttiin käyttämään muotoa 0.01, 0.02, 1.00, joista versio 1.00 on ensimmäinen hyväksytty versio. Lopuksi muistutettiin, että käytettävä hakemistorakenne kannattaa suunnitella heti sellaiseksi, että se on helppo tallentaa CD:lle. Päätökset * Käytetään esitettyä nimeämiskäytäntöä siten, että versiota 1.00 edeltävät versiot numeroidaan: 0.01, 0.02, .. 9.2 Tikettien käyttö Keskusteltiin tikettien käytöstä vaatimusmäärittelyssä. Jussi Talaskivi totesi, että Tracin kannalta on parasta, että jokaiseen tikettiin liittyy jokin lähdekoodi. Jukka-Pekka Santanen tiedusteli, voiko tiketin jakaa osiin. Jussi Talaskivi vastasi kieltävästi, lisäten, että silloin on luotava uudet tiketit ja siirrettävä sisältö käsin. Puheenjohtaja muistutti, että tiketit ja wikiin laitettavat tekstit on sovittu kirjoitettavan suomeksi. Jussi Talaskivi puolestaan muistutti, että koodi ja kommit-viestit kirjoitetaan vastaavasti englanniksi. 10. Plone-perehdytyksen ajankohdan valinta Todettiin, että Plone-perehdytys kannattaisi pitää mahdollisimman pian. Keskustelun jälkeen todettiin, että kaikille sopi aika tiistaiksi 13.2 kello 9:00 - 11:00. Päätökset: * Jussi Talaskivi pitää Plone-perehdytyksen tiistaina 13.2.2007 kello 9:00 - 11:00 sovellusprojektien kokoustilassa. 11. Muut esille tulleet asiat Vesa Lappalainen kävi paikalla kysymässä palaverin ajankohdasta. Hän ei osallistunut minkään kohdan käsittelyyn. Puheenjohtaja kysyi moduulien kommentointitavoista. Jukka-Pekka vastasi, että projektiryhmä määrittelee alkukommentit, eikä muutoshistoriaa tarvitse laittaa tiedoston alkuun. Jukka-Pekka Santanen kertoi, että Leena Hiltunen oli pyytänyt päästä projektin sähköpostilistalle. Päätökset: * Moduulit kommentoidaan projektiryhmän määrittelemällä tavalla. * Jukka-Pekka Santanen lisää Leena Hiltusen kakapo-sähköpostilistalle. 12. Sovitaan seuraavan palaverin aika ja paikka Päätökset: * Seuraava palaveri pidetään maanantaina 19.2.2007 klo 12:00 sovellusprojektien kokoustilassa AgC223.1 13. Sovitaan seuraavista tehtävistä Seuraavista tehtävistä päätettiin: * Projektipäällikkö jatkaa projektisuunnitelman tekoa. * Projektipäällikkö varaa tilan ja laitteet tiistain 13.2.2007 Plone-perehdytykseen. * Projektipäällikkö kyselee Trac-tunnusten tilannetta. * Projektipäällikkö kysyy rikkoutuneesta tietokoneesta ylläpidolta. * Projektiryhmä asentaa tietokoneisiin Eclipsen ja tarvittavat laajennukset. * Projektiryhmä korjaa vaatimusmäärittelyn korjausehdotusten perusteella. * Jussi Talaskivi pitää projektiryhmälle Plone-perehdytyksen sovellusprojektien kokoustilassa tiistaina 13.2.2007 kello 9:00 - 11:00. * Jukka-Pekka Santanen lisää Leena Hiltusen kakapo-sähköpostilistalle. 14. Kokouksen päättäminen Puheenjohtaja päätti kokouksen kello 14:15.