harjoitustyo_viikko4.md

Harjoitustyö, viikko 4

Palautuksen deadline ti 24.11. klo 23:59

Muista pushata harjoitustyöhön liittyvät asiat GitHubiin ennen viikkodeadlinea.

• Klo 00 jälkeen tulevia repositorion päivityksiä ei huomioida pisteytyksessä, eli ne tuovat 0 pistettä.

HUOM! Saadaksesi harjoitustyöstä viikkokohtaiset pisteet, sovelluksen tulee toimia laitoksen koneella ja ohjaajien pitää pystyä se niiltä aukaisemaan!! Esim. Virtuaalisessatyöasemassa voit testata tätä.

Palautuksesta on tarjolla 3 kurssipistettä.

Arvostelussa kiinnitetään huomiota seuraaviin seikkoihin

• Ohjelma on kasvanut edellisestä viikosta (0.75p)
  • Projektin koodin pystyy suorittamaan NetBeansin vihreällä napilla tai/ja komennolla mvn compile exec:java -Dexec.mainClass=pakkaus.Paaohjelma
  • Suoritettava oleva versio on kasvanut edellisestä viikosta ja toteuttaa edellisen viikon versiota suuremman osan määrittelydokumentin toiminnallisuuksista eli ohjelmaan on lisätty jotain käyttäjälle näkyvää hyödyllistä toiminnallisuutta. Merkitse lisäksi tarkastusta varten määrittelydokumenttiin valmiit toiminnallisuudet "tehty" merkinnällä.
• Testaus on edennyt (0.5p)
  • Sovellukselle tulee pystyä generoimaan testikattavuusraportti komennolla mvn test jacoco:report
  • Käyttöliittymän rakentava koodi jätetään pois testikattavuusraportista
  • Sovelluksen testien rivikattavuuden tulee olla vähintään 20%
  • Testien tulee olla mielekkäitä, eli niiden on testattava jotain ohjelman kannalta merkityksellistä asiaa
• Koodin laatu (1p)
  • Sovelluslogiikka on riittävissä määrin eriytetty käyttöliittymästä
    • Vihjeitä täällä ja referenssisovelluksessa
  • Ohjelman pakkausrakenne heijastaa ohjelman loogista rakennetta ja on nimennältään järkevä
  • Checkstyle on otettu käyttöön
    • Ohje Checkstylen käyttöönottoon täällä
    • Täydet pisteet Checkstylestä ainoastaan jos ohjelmassa on alle 10 Checkstyle-virhettä
    • Käyttöliittymän rakentavan koodin ei tarvitse olla Checkstyle-tarkastelun alla
• Ohjelman alustava rakenne luokka/pakkauskaaviona (0.75p) vastaavalla mekanismilla
  • Kaavion ei tarvitse merkitä kuin sovelluslogiikan kannalta oleelliset luokat
  • Voit tarvittaessa tehdä kaavion, josta ilmenee myös sovelluksen pakkausrakenne
  • Mallia voi ottaa referenssisovelluksesta
  • Tee repositorioosi hakemisto dokumentaatio ja sen sisälle tiedosto arkkitehtuuri.md ja upota kuva tiedostoon, tiedoston sisältö voi olla muilta osin tyhjä
  • Tiedostoon arkkitehtuuri.md tulee olla linkki repositorion README:stä referenssisovelluksen tavoin

Seuraavien kohtien puutteet vähentävät pisteitä

• Tuntikirjanpito on ajantasalla
  • Tuntien summan tulee olla merkittynä
  • Tuntikirjanpitoon ei merkitä laskareihin käytettyä aikaa
• Repositorion README.md kunnossa
  • tiedosto on kurssin tämän vaiheen osalta relevantin sisällön suhteen samankaltainen kuin referenssisovelluksen README.md
  • kaikki ylimääräinen, mm. linkit laskareihin on poistettu
• Repositorio siisti
  • ei ylimääräistä tavaraa (mm. hakemistoa target/ tai tietokantatiedoistoja)
  • laskarit jätetään hakemiston laskarit alle
  • järkevä .gitignore-tiedosto olemassa

Harjoitustyön toimivuus

• Koneiden konfiguraatioissa on eroja, ja tällä kurssilla ei riitä että hajoitustyössä tekemäsi sovellus toimii vain omalla koneellasi

• Harjoitustyösi pitää pystyä joka viikko suorittamaan, kääntämään ja testaamaan komentoriviltä käsin laitoksen Linux-koneilla (tai uusimmat päivitykset sisältävällä cubbli-linuxilla), muussa tapauksessa työtä ei tarkasteta ja menetät viikonpalautuksen pisteet.

• Pääset testaamaan ohjelmaasi laitoksen koneella myös kotoa käsin käyttämällä etätyöpöytää https://helpdesk.it.helsinki.fi/ohjeet/tietokone-ja-tulostaminen/tyoasemapalvelu/etakaytettavat-tyopoydat-vdi-ja-vmware tai kirjautumalla ssh:lla palvelimelle melkki.cs.helsinki.fi