Skip to content

Latest commit

 

History

History
79 lines (61 loc) · 6.15 KB

harjoitustyo_viikko5.md

File metadata and controls

79 lines (61 loc) · 6.15 KB
Raw

Harjoitustyö, viikko 5

Palautuksen deadline tiistai 01.12. klo 23:59

HUOM jotta voisit osallistua viikolla 6 pidettävään koodikatselmointiin (josta tarjolla 2 kurssipistettä)

  • viikon 5 deadlinen jälkeen tulee palautusrepositoriosta löytyä osan määrittelydokumentin käyttäjälle näkyvää toiminnallisuutta toteuttava toimiva versio harjoitustyöstä
  • viikon 5 palautuksesta tulee saada enemmän kuin 0 pistettä
  • palautusrepositorioistasi on GitHub-issuet sallittuna, ks. ohje

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

  • Ohjelmasta pystyy tekemään suorituskelpoisen jar-tiedoston komennolla mvn package (0.5p)
  • Projektista on tehty github release (0.25p)
    • Release sisältää ohjelman uusimman version suorituskelpoisen jar-tiedoston
    • Ohje releasen tekemiseen
    • Releaseen on linkki projektin README:stä
  • Ohjelma on kasvanut edellisestä viikosta (0.75p)
    • Ohjelman suoritettavissa oleva versio on kasvanut edellisestä viikosta ja toteuttaa edellisen viikon versiota suuremman osan määrittelydokumentin toiminnallisuudesta eli jotain käyttäjälle näkyvää hyödyllistä toiminnallisuutta. Merkitse lisäksi tarkastusta varten määrittelydokumenttiin tällä viikolla tekemäsi 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 40%
    • Testien tulee olla mielekkäitä, eli niiden on testattava jotain ohjelman kannalta merkityksellistä asiaa
  • Koodin laatu (0.5p)
    • Sovelluslogiikka on eriytetty käyttöliittymästä
    • Ohjelman pakkausrakenne heijastaa ohjelman loogista rakennetta ja on nimennältään järkevä
    • Checkstyle on käytössä
      • Täydet pisteet Checkstylestä ainoastaan jos ohjelmassa on alle 5 Checkstyle-virhettä
      • Käyttöliittymän rakentavan koodin ei tarvitse olla Checkstyle-tarkastelun alla
    • Ohjelma ei sisällä suurta määrää toisteista koodia
  • Ohjelman dokumentaatiossa on ainakin yksi sen jotain oleellista toiminnallisuutta kuvaava sekvenssikaavio (0.5p)

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

  • Koodin laatu
    • Pakkausrakenne ei ole järkevä (esim. kaikki koodi oletuspakkauksessa)
    • Sovelluslogiikkaa ei ole eriytetty riittävästi käyttöliittymästä
  • Tuntikirjanpito on ajantasalla
    • Tuntien summan tulee olla merkittynä
    • Tuntikirjanpitoon ei merkitä laskareihin käytettyä aikaa
  • Palautusrepositorioosi voi tehdä GitHub-issuieta, ks ohje
  • Repositorion README.md kunnossa
    • tiedosto on kurssin tämän vaiheen osalta relevantin sisällön suhteen samankaltainen kuin referenssisovelluksen README.md, eli siellä on ainakin seuraavat
      • harjoitustyön aiheen lyhyt kuvas
      • linkit vaatimusmäärittelyyn, arkkitehtuuridokumenttiin ja tuntikirjanpitoon
      • linkki releaseen
      • ohjeet komentoriviltä suoritettaviin toimenpiteisiin (testaus, testiraportin suoritus, suoritettavan jarin generointi, checkstyletarkastuksen suorittaminen)
  • Repositorio siisti
    • ei ylimääräistä tavaraa (mm. hakemistoa target)
    • laskarit jätetään hakemiston laskarit alle
    • järkevä .gitignore-tiedosto olemassa

Issueiden salliminen

Varmista, että palautusrepositorioosi on mahdollista tehdä issueita, eli repositorion Settings näyttää seuraavalta

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