Suunnitteludokumentin FTR-kokouksen pöytäkirja 29.11.2002


Ohjelmistotuotantoprojektiryhmä 11. Converge
Syksy 2002

Aika:   Perjantai 29.11.2002, klo 8.15
Paikka: TKTL C455
Läsnä:  Anssi Johansson
        Mikko Hiipakka          projektipäällikkö, sihteeri
        Joni Karppinen
        Olli Pettay
        Timo Ranta-ojala
        Tea Silander
        Markus Ekholm           ryhmän ohjaaja, puheenjohtaja
Poissa: Mikko Mäkelä            asiakas

1. Kokouksen avaus

   Puheenjohtaja avasi kokouksen klo 8.20.

2. Yleistä

   Pidetyssä FTR-kokouksessa tarkastettiin suunnitteludokumentin 
   versio 0.1.4. 25.11.2002 pidetyssä kokouksessa päätettiin, että
   jokainen ryhmän jäsen lukee dokumentin läpi ja keskittyy niihin
   osiin, joita ei ole itse kirjoittanut. Muuten mitään tiettyjä 
   vastuualueita ei jaettu.


3. Kommentteja 

   Yleistä korjattavaa:
      - Kirjoitusvirheet
      - Korostettiin, että luokkien kuvaukset on oltava luokan roolia
        järjestelmässä kuvaavia.
      - Metodien selityksissä on tärkeää kirjata tarkasti jokaisen 
        parametrin rooli luokan toiminnan kannalta.
      - Jos ei ole selvää mistä pakkauksesta jokin luokka otetaan 
        käyttöön liitetään luokkanimen eteen koko pakkausnimi
      - Dokumentin sisältö yhdenmukaistetaan jokaisen moduulin osalta
            * Lisätään alkuun maininta, että aliluokkakuvauksissa 
              listataan vain uudet ja yläluokan korvatut metodit sekä 
              niiden kuvaukset.
            * Lisätään alkuun maininta, että jos ei toisin ole määritelty
              ovat kaikki määritykset näkyvyydeltään public, jonka maininta
              poistetaan kaikista metodi, kenttä ja luokka kuvauksista.
            * kynnysarvo, ei raja-arvo

   1.1 Dokumentin tarkoitus
       - "syntyvästä järjestelmästä .." korvataan "syntyvästä järjestelmän 
          prototyypistä"
  
   1.2 Määritelmät, termit ja lyhenteet
       - Kaikkien listattujen lyhenteiden selitykset vaativat tarkentamista
         kattavammiksi kuvauksiksi.
   1.3 Dokumentin rakenne
       - Kirjataan lukujen kuvaukset läpi koko dokumentin

   2.1 Viestin lähetys
       - Kappaleen esimerkkiä voisi muuttaa kuvaamaan jotain dokumentin 
         muissa osissa käytettyä protokollaa.

   3. Tietosuunnitelma
       - Lisätään kuvaus logi-tiedostostoista ja niiden sijoittelusta 
         järjestelmän käyttämiin tiedostonhallintaresursseihin
   
   4. Arkkitehtuuri
       - Tiedonhakumoduulin ja Ytimen kuvauskappaleiden paikkoja vaihdetaan,
         sekä sisällöllinen muutos Tiedonhakumoduulikappaleen viimmeiseen 
         virkkeeseen.

   5. Järjestelmän ydin
   5.1 Luokat
       - Luokkakaaviota muutetaan siten, että rajapinta-luokkien kuvauksessa
         käytetty kuvio eroaa luokkien kuvauksessa käytettävästä kuviosta.
       - AttributeInterface siirtyy ContextModelAttributeInterfacen ja 
         MessageAttributeInterface yläluokaksi.
  
   5.1.2 ContextModelHandler
       - "suoritetaan kaikillle viestin vastaanottajaan liitetyille..." virke 
         vaatii sisällöllistä tarkistamista

   5.1.4 DroolsHandler
       - Luokannimi on harhaanjohtava vaihdetaan RuleHandleriksi. 
       - provessMessage-metodin kuvaus vaatii tarkentamista ActionEventin-osalta

   5.1.10 ViewMonitor
       - Metodit, joissa on MessageID-parametri vaativat muutoksen, jossa 
         lisätään User olio lisäparametriksi

   5.1.11 ViewEvent
       - SET_MESSAGE- ja SET_MESSAGE_ID-kenttien nimet vaativat muutoksen, 
         koska ovat harhaanjohtavia

   5.1.13 DataBaseProvider
       - query( String ) - vaatii kuvauksen palautus arvo NodeSet:istä

   5.1.24 ScheduleManager
       - addRule-metodi vaatii tarkentamista
  
   5.1.27 Log
       - output-metodi vaatii tarkentamista name-parametrin osalta
   
   5.2.1 ActionInterface
       - setValue-metodin values-parametrin kuvaus vaatiin selventämistä 
         vaikutuksista ja roolista luokan toimintaan
   5.3.1 UserPropertyInterface 
       - boolean compare
       - oletus laskusääntö vertailun suorituksessa poistetaan
       - setValue( Object ) ja kuvaus tarkennus

   5.3.3 MessageAttributeInterface 
       - compare-metodin oletus laskusääntö vertailun suorituksessa poistetaan

   6 Tiedonhakumoduuli
       - Käytettävä JavaMail vaatii kuvauksen 

   6.1 Luokat
       - AttributeInterface siirtyy ContextModelAttributeInterfacen ja 
         MessageAttributeInterface yläluokaksi.
       - Luokkakaavio meni muutenkin attribuuttien osalta uusiksi (lisää 
         luokkia), vaatii muutoksia attribuuttiluokkien määrittelyihin

   6.1.2 IMAP
       - getNewData-metodi vaatii User-tyyppisen parametrin

   6.1.12 AttachmentAttributes  
       - määrittely "implements XMLContent"

   7. Asiakasmoduuli
       - Lisätään luokkakaavio

   7.1 ClientManager
       - Vaatii luokka- ja metodikuvauksien tarkentamista

   7.2 ClientHandler
       - Vaatiin luokkakuvauksen tarkentamista
       - Lisätään metodimäärittelyt ja niiden kuvaukset

   8.1.1 WebClientHandler
       - "generoiville webcore-luokille joitakin palveluita..." vaatii 
       							tarkentamista
       - "(ja sitä kautta ytimelle) jonkinlaisen..." vaatii tarkentamista
       - Metodimäärittely vaativat kuvakset 
 
   8.1.2 HTML-ää tuottavat webcore-luokat
       - Luokat vaativat kuvakset, määritykset ja metodikuvaukset

   A.1 ContextModelValueAttribute
       - compare-metodi kuvausksessa "(Integer)" maininta pois


4. Kokouksen päätöksiä

   Dokumentti päätettiin hyväksyä muutoksin, ja korjauten teko vastuu 
   jaettiin kappaleen kirjoittajan mukaan.
   Korjausten tekemiselle annettiin aikaa torstai 5.12.2002 asti

5. Kokouksen päättäminen

   Puheenjohtaja päätti kokouksen 10.20