Tämä sivu kuvaa kurssin arvosteluperusteet, jotka kurssin ohjaja käy läpi työsi arvostelussa. Kurssin arvosana määräytyy seuraavasti:
- Saat kurssista arvosanan 3, jos perusvaatimukset täyttyvät.
- Saat kurssista arvosanan 4, jos arvosanojen 3–4 vaatimukset täyttyvät.
- Saat kurssista arvosanan 5, jos arvosanojen 3–5 vaatimukset täyttyvät.
Voit käyttää myös teknistä tarkastuslistaa apuna sovelluksen viimeistelyssä.
Perusvaatimukset (arvosana 3)
Sovelluksen perusvaatimukset
| Käyttäjä pystyy luomaan tunnuksen ja kirjautumaan sisään sovellukseen |
| Käyttäjä pystyy lisäämään, muokkaamaan ja poistamaan tietokohteita |
| Käyttäjä näkee sovellukseen lisätyt tietokohteet |
| Käyttäjä pystyy etsimään tietokohteita hakusanalla tai muulla perusteella |
| Käyttäjäsivu näyttää tilastoja ja käyttäjän lisäämät tietokohteet |
| Käyttäjä pystyy valitsemaan tietokohteelle yhden tai useamman luokittelun |
| Käyttäjä pystyy lisäämään tietokohteeseen toissijaisia tietokohteita |
Sovelluksen perusvaatimukset on kuvattu tarkemmin aloitussivulla.
Tekniset perusvaatimukset
| Sovellus toteutettu kurssimateriaalin mukaisesti |
| Sovellus toteutettu Pythonilla käyttäen Flask-kirjastoa |
| Sovellus käyttää SQLite-tietokantaa |
| Kehitystyössä käytetty Gitiä ja GitHubia |
| Sovelluksen käyttöliittymä muodostuu HTML-sivuista |
| Sovelluksessa ei ole käytetty JavaScript-koodia |
| Tietokantaa käytetään suoraan SQL-komennoilla (ei ORMia) |
| Flaskin lisäksi käytössä ei muita erikseen asennettavia Python-kirjastoja |
| Sovelluksen ulkoasu (HTML/CSS) on toteutettu itse ilman kirjastoja |
| Sovelluksen koodi on kirjoitettu englanniksi |
| Tietokannan taulut ja sarakkeet on nimetty englanniksi |
Versionhallinta
Tiedosto README.md kertoo, millainen sovellus on ja miten sitä voi testata |
| Kehitystyön aikana on tehty commiteja säännöllisesti |
| Commit-viestit on kirjoitettu englanniksi |
Sovelluksen turvallisuus
| Salasanat tallennetaan tietokantaan asianmukaisesti |
| Käyttäjän oikeus nähdä sivun sisältö tarkastetaan |
| Käyttäjän oikeus lähettää lomake tarkastetaan |
| Käyttäjän syötteet tarkastetaan ennen tietokantaan lisäämistä |
| SQL-komennoissa käytetty parametreja |
Sivut muodostetaan sivupohjien kautta (render_template) |
| Lomakkeissa on estetty CSRF-aukko |
Vertaisarviointi ja palaute
| Ensimmäinen vertaisarviointi annettu |
| Toinen vertaisarviointi annettu |
Lisävaatimukset (arvosana 4)
Toimivuus ja käytettävyys
| Sovellusta on helppoa ja loogista käyttää |
| CSS:n avulla toteutettu ulkoasu (itse tehty, ei CSS-kirjastoa) |
Versionhallinta
| Versionhallinnassa ei ole sinne kuulumattomia tiedostoja |
| Commitit ovat hyviä kokonaisuuksia ja niissä on hyvät viestit |
Ohjelmointityyli
| Muuttujat ja funktiot nimetty kuvaavasti |
| Sisennyksen leveys on neljä välilyöntiä |
| Koodissa ei ole liian pitkiä rivejä |
Muuttujien ja funktioiden nimet muotoa total_count (ei totalCount) |
Välit oikein =- ja ,-merkkien ympärillä |
Ei ylimääräisiä sulkeita if- ja while-rakenteissa |
Tietokanta-asiat
| Taulut ja sarakkeet on nimetty kuvaavasti |
Käytetty REFERENCES-määrettä, kun viittaus toiseen tauluun |
Ei kyselyjä muotoa SELECT * (haettavat sarakkeet listattu aina) |
| Käytetty SQL:n ominaisuuksia järkevällä tavalla |
Vertaisarviointi ja palaute
| Ensimmäinen vertaisarviointi tehty kattavasti |
| Toinen vertaisarviointi tehty kattavasti |
| Kurssipalaute annettu |
Kurssin vastuuhenkilö saa palautejärjestelmästä listan opiskelijoista, jotka ovat antaneet palautteen. Järjestelmästä ei näe, kuka on antanut tietyn palautteen.
Lisävaatimukset (arvosana 5)
Ohjelmointityyli
| Käytetty Pylint-työkalua ja raportoitu tulokset |
Raportissa tulee näkyä Pylintin antama palaute sekä jokaisesta Pylintin ilmoitustyypistä selostus, miksi kyseistä asiaa ei ole korjattu koodissa.
Toimivuus ja käytettävyys
| Käyttäjän lähettämässä tekstissä rivinvaihdot näkyvät selaimessa |
Kuvissa käytetty alt-attribuuttia (jos sovelluksessa kuvia) |
Lomakkeissa käytetty label-elementtiä |
Suuren tietomäärän käsittely
| Sovellusta testattu suurella tietomäärällä ja raportoitu tulokset |
| Sovelluksessa käytössä tietokohteiden sivutus |
| Tietokantaan lisätty indeksi, joka nopeuttaa suuren tietomäärän käsittelyä |
Sopiva tapa raportoida tulokset on lisätä tiedosto seed.py repositorioon ja kirjoittaa tiedostoon README.md selostus sovelluksen toiminnasta suurella tietomäärällä.