Harjoitustyön loppupalautus
⚠️ Loppupalautuksen deadline on sunnuntai 22.12. klo 23:59. Älä palauta myöhässä, deadline on ehdoton! Jos sinulla on joku erittäin hyvä syy palautuksen myöhästymiseen, ota yhteyttä viimeistään tiistaina niin voit saada lisäaikaa.
Loppupalautuksen oletetaan sisältävän toimivan ohjelman, testien ja konfiguraatioiden lisäksi myös dokumentaation, eli:
- Käyttöohjeen
- Vaatimusmäärittelyn
- Arkkitehtuurikuvauksen
- Testausdokumentin
Päivitä viikolla 2 tehty alustava vaatimusmäärittely vastaamaan ohjelman lopullisen version toiminnallisuutta.
Päivitä myös viimeistään tässä vaiheessa Labtooliin projektisi nimi vastaamaan projektin aihetta.
Lue huolellisesti arvosteluperusteista mitä loppupalautuksen oletetaan sisältävän dokumentaation ja ohjelmiston osalta!
Dokumentteihin kannattaa ottaa mallia referenssisovelluksen dokumenteista.
Selvitys kielimallien käytöstä ja palaute
Käy lopuksi vastaamassa kyselyyn ChatGPT:n ja muiden kielimalleihin perustuvien välineiden käytöstä ja antamassa kurssipalautetta. Molemmat näistä ovat yhden pisteen arvoisia ja voivat siten hyvinkin vaikuttaa arvosanaasi. (Kielimallikysely katsotaan oikeastaan osaksi harjoitustyön dokumentaatiota.) Kielimallikyselyn löydät Moodlesta ja kurssipalautelomakkeen Norpasta. Kopioi kurssipalautelomakkeessa näkyvä koodi, jotta voit hakea palautepisteen Moodlen puolella.
Arviointi
Lopulliset pisteet näet tammikuussa Moodlessa.
Harjoitustyön toimivuus
HUOM: Saadaksesi harjoitustyöstä viikkokohtaiset pisteet, sovelluksen tulee toimia laitoksen tietokoneella ja ohjaajien pitää pystyä se niiltä aukaisemaan! Voit testata tätä millä tahansa Cubbli-tietokoneella, kuten fuksiläppärillä, tai laitoksen tietokoneluokkien tietokoneilla. Testaus onnistuu myös virtuaalityöasemassa joko selaimen tai VMWare Horizon -asiakasohjelman avulla.
Virtuaalityöasemassa oman sovelluksen testaaminen onnistuu selaimen avulla seuraavasti:
- Kirjaudu virtuaalityöasemaan ja valitse Cubbli Linux
- Käynnistä terminaali ja tarkista käytössäoleva Python-versio komennolla
python3 --version
. Jos versio on alle 3.8, päivitä versio tämän ohjeen avulla - Varmista, että Poetry on asennettu suorittamalla komento
poetry --version
. Jos asennus puuttuu, seuraa näitä Linux-asennuksen ohjeita - Kloonaa repositoriosi haluamaasi hakemistoon
git clone
-komennolla - Siirry repositoriosi hakemistoon ja asenna riippuvuudet komennolla
poetry install
. Huomaa, että komento tulee suorittaa hakemistossa, jossa pyproject.toml-tiedosto sijaitsee
Mikäli yhteys virtuaalityöasemaan pätkii, kannattaa kokeilla toista selainta. Käyttäjät ovat raportoineet ainakin Google Chromen toimivan varsin hyvin. Myös VMWare Horizon Clientin asentaminen saattaa auttaa.
HUOM: Jos suoritat SQLite-tietokantaa käyttävää sovellusta virtuaalityöasemassa, saatat törmätä virheeseen database is locked
. Ongelma ratkeaa luultavasti tämän ohjeen avulla.
Älä plagioi tai riko tekijänoikeuksia
Plagiointi
Kurssilla seurataan Helsingin yliopiston opintokäytäntöjä. Plagiarismi ja opintovilppi, eli esimerkiksi netissä olevien tai kaverilta saatujen vastausten kopiointi ja niiden palauttaminen omana työnä on kiellettyä. Todettu opintovilppi johtaa kurssisuorituksen hylkäämiseen ja toistuva opintovilppi voi johtaa opinto-oikeuden määräaikaiseen menettämiseen.
Mitä plagiointi tarkoittaa harjoitustyön yhteydessä? Koodin suora kopioiminen on kiellettyä poikkeuksena muutaman rivin mittaiset algoritmit ja ChatGPT:n tai vastaavien välineiden generoima koodi (ks. alla). Myös koodin rakenteen suora kopioiminen esim. siten että muuttujien ja funktioiden nimet muutetaan lasketaan plagioinniksi. Toisaalta esim. verkosta löytyneitä kuvia saa käyttää, jos tähän on oikeus (ks. kohta tekijänoikeudet), mutta näin tehtävessä tulee työn dokumentaatioon tehdä “lähdeviite”, eli mainita mistä lainaus on tehty.
Samat plagiaattisäännöt koskevat työn dokumentaatiota ja erityisen kiellettyä on copy pasteta referenssisovelluksen dokumentaatiota.
ChatGPT ja vastaavat
Myös ChatGPT:n ja vastaavien tekoälyyn perustuvien välineiden (kuten esim. Microsoft Copilotin, Google Geminin, CurreChatin tai GitHub Copilotin) generoiman koodin tai tekstin esittäminen itse kirjoitetuksi on plagiointia. Generoidun koodin käyttö on kurssilla sallittua, mutta “ympäröi” aina tällainen koodi kommenteilla # generoitu koodi alkaa ja # generoitu koodi päättyy. Tee näin myös silloin, jos olet tehnyt generoituun koodiin vain vähäisiä muutoksia (vaihtanut muuttujien ja funktioiden nimiä tms.). Toisaalta, jos tämä ei käyttötavasta johtuen tunnu mielekkäältä, voit vaihtoehtoisesti liittää dokumentaatioon kuvauksen siitä, että millä tavoin ja missä laajuudessa olet tekoälypohjaisia välineitä harjoitustyösi missäkin osassa käyttänyt.
Muistathan, että ChatGPT:n ja vastaavien välineiden käyttö yksikkötestien koodin generointiin on kurssilla kiellettyä (muuten saa kyllä käyttää testailtaessakin).
Tekijänoikeudet
Kunnioita muutenkin tekijänoikeuksia ja muita immateriaalioikeuksia. Muista, että et saa käyttää mitä tahansa verkosta löytynyttä omassa työssäsi. Tämä koskee monenlaista materiaalia ohjelmakoodista kuviin ja teksteihin. Tarkista siis aina, että onko käyttö sallittua sen lisenssin mukaan, jolla materiaali mahdollisesti on jaettu. Muista, että harjoitustyöt ovat lähtökohtaisesti julkisia GitHubissa. On omalla vastuullasi, ettet riko tekijänoikeuksia.