riinaalisah / kirjahylly

Tietokantasovelluksen harjoitustyö, Kirjahylly

Kirjahylly

Kirjahyllysovellus on oma kirjahylly netissä! Sovelluksen avulla lukemisesta enemmän tai vähemmän innostuneet pystyvät seuraamaan omaa kirjatilannettaan; mitä kirjoja on jo lukenut, mitä kirjoja on vielä luettavana, mitä kirjoja muut lukevat ja niin edelleen.

Kuka tahansa pääsee selailemaan tietokantaan lisättyjä kirjoja ja kirjailijoita ilman rekisteröitymistä, mutta rekisteröityneille käyttäjille löytyy monia muitakin toimintoja:

• kirjojen ja kirjailijoiden lisääminen tietokantaan
• kirjojen ja kirjailijoiden tietojen päivittäminen
• tietokantaan lisättyjen kirjojen lisääminen omaan hyllyyn ja sieltä poistaminen
• kirjojen merkitseminen luetuiksi tai lukemattomiksi
• omien käyttäjätietojen päivittäminen

Nämä toiminnot ovat kaikille tavallisille käyttäjille. Admin-käyttäjillä on lisäksi mahdollisuus poistaa käyttäjiä, kirjoja ja kirjailijoita tietokannasta.

Linkkejä

Sovellus Herokussa: http://tsoha-kirjahylly.herokuapp.com/

• Testausta varten löytyy kaksi tunnusta:
  • tavallinen käyttäjä (käyttäjänimi 'testi', salasana 'testi')
  • admin-käyttäjä (käyttäjänimi 'testiadmin', salasana 'testiadmin')

User storyt

Tietokannan kuvaus

Asennusohje

Käyttöohje

Kehitysideoita

kirjahylly's Issues

Koodikatselmointi

Koodikatselmonti (ladattu ma 25.2. klo 17.30)

Käyttötapaukset ovat selkeät ja helposti toteutettavissa sovelluksessa. Kaikki listatut toiminnot, joita testasin ovat kunnossa. Sovellukseen pystyy rekisteröitymään, kirjautumaan, lisäämään kirjailijoita ja kirjoja sekä muokkaamaan omaa kirjahyllyä. En testannut salasanan vaihtamista tilanteessa, jossa alkuperäinen salasana on unohtunut.

Sovelluksen ulkoasu on selkeä, helposti navigoitavissa ja tyyliltään miellyttävä ja yhtenäinen. Kaikki toiminnot löytyvät helposti. Erityisen kivoina pidin ”ilmoitusikkunoita”, jota ilmestyivät aina ruudun alareunaan muutoksia tehdessä.

Validoinnit näyttivät toimivan pääsääntöisesti ihan ok (sovellus ilmoittaa nätisti, jos jokin pakollinen kenttä on jäänyt täyttämättä, samaa tunnusta ja sähköpostiosoitetta ei voi olla kahdella henkilöllä jne.) Joitain kehittämiskohtia onnistuin kuitenkin löytämään. Kirjan tai kirjailijan nimi ei saa olla tyhjä, mutta antamalla nimeksi pelkän tyhjän välilyönnin voi ikään kuin jättää nimen antamatta. Uutta käyttäjätunnusta rekisteröitäessä huomasin, että sovellus vie rumalle virhesivulle, jos käyttäjänimeksi yrittää valita liian pitkää sanaa. Myöskään salasanan valinnan kohdalla ei ole validointia? Onnistuin antamaan salasanaksi yhden merkin pituisen salasanan. Huomasin myös, että oman käyttäjätunnuksen tai sähköpostiosoitteen vaihtaminen ei onnistu (salasanan vaihto onnistuu). Sovellus vie taas rumalle virheilmoitussivulla.

Ohjelmakoodin tiedostorakenne on selkeä. Kansiot ja tiedostot on nimetty selkeästi, johdonmukaisesti ja kuvaavasti. Ohjelmakoodia oli erittäin helppo selailla läpi. Sama selkeys, johdonmukaisuus ja kuvaavuus koskee myös itse ohjelmakoodia. Luokat, metodit ja muuttujat on nimetty kuvaavasti. Tosi helppo seurata! Koodia on jonkin verran, joten tykkäsin, että se oli jaettuna sopivan pieniin erillisiin tiedostoihin.
Tosi hyvältä näyttää!

Koodikatselmointi

Projekti ladattu 12.2. klo 13:09

Ensimmäinen huomio sovelluksesta oli, että ”lisää uusi käyttäjä” -linkki on vähän hämmentävästi kirjahyllyn toiminnallisuuksiin liittyvien linkkien seassa. Voisi olla selkeämpää, jos se olisi samassa paikassa kuin ”kirjaudu sisään” -linkki. Uuden käyttäjän luominen ja sisäänkirjautuminen kuitenkin onnistuu.

Testailin kirjahyllyn toiminnallisuuksia ja huomasin seuraavaa:

• Uuden kirjailijan lisääminen onnistuu, mutta tälle kirjailijalle ei voi lisätä uusia kirjoja (sain lisättyä kirjailijoihin Tolkienin, mutta en Tolkienille kirjoja). Sovelluksessa valmiina olleille kirjailijoille pystyi kuitenkin lisäämään uusia kirjoja (kokeilin Murakamilla).
• Kirjan lisääminen kirjojen listasta omaan hyllyyn onnistuu, mutta jostain syystä ensimmäistä omassa hyllyssä olevaa kirjaa ei voi merkata luetuksi – nappi ei tee mitään. Muut listauksen kirjat sen sijaan voi merkata luetuksi tai uudelleen lukemattomaksi. Tämän testailun yhteydessä tuli mieleen, että voisi olla käyttäjän kannalta parempi, jos omassa hyllyssä ”Luettu”-sarakkeessa näkyisi true/false -jaottelun sijaan vaikka ”kyllä/ei” -jaottelu.
• Yhteenvetokyselyt, jotka näyttävät, montako kirjaa omassa hyllyssä on ja moniko niistä on luettu, ovat tosi jees ja tuntuvat toimivan.
• Lomakkeiden validoinnit tuntuivat ihan päteviltä, liian lyhyt salasana ainakaan ei mennyt läpi.
• Sivun ylälaitaan ilmestyvät ilmoitusviestit on toteutettu kivalla tavalla!

Koodin rakenne vaikuttaa selkeältä, kaikki luokat on eritelty omiksi kokonaisuuksikseen, nimetty loogisesti jne. En ainakaan huomannut mitään epäjohdonmukaisuuksia. Hyvältä näyttää! : )