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ä:
Ilmari Repo avasi kokouksen kello 12:15.
Ilmari Repo valittiin puheenjohtajaksi ja Ari Roponen sihteeriksi.
Puheenjohtaja ehdotti esityslistaan muutosta, jonka mukaan kohdan 4 jälkeen käsiteltäisiin projektin tilaa.
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.
Anssi Pannula esitteli projektin nykytilaa.
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.
Anssi Pannula esitteli vaatimusmäärittelyä videotykin avulla. Sitä käytiin läpi sivu kerrallaan, ja siihen esitettiin muutos- ja korjausehdotuksia.
Johdannosta keskusteltiin. Tilaajan edustajat ja ohjaajat antoivat korjausehdotuksia ja täsmensivät epäselviä kohtia.
Sanastosta keskusteltiin ja sinne ehdotettiin uusiksi termeiksi materiaalipankki, ryhmä ja roolit.
Jukka-Pekka Santanen totesi, että luvusta puuttuvat taustat. Hän ehdotti johdantokappaleen kirjoittamista yleisemmäksi.
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.
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ä.
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.
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.
Prosessimalliksi ehdotettiin inkrementaalista mallia. Perusteluna käytettiin sitä, että vaatimusten voivat muuttua ajan kuluessa. Myös välitulosten esittely on mahdollista.
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.
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.
Todettiin, että Plone-perehdytys kannattaisi pitää mahdollisimman pian. Keskustelun jälkeen todettiin, että kaikille sopi aika tiistaiksi 13.2 kello 9:00 - 11:00.
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.
Puheenjohtaja päätti kokouksen kello 14:15.