Sessiot, autentikointi ja tietokannat - Viikkotehtävä 3

• Taso 1
• Taso 3
• Taso 5

Tällä viikolla harjoitellaan Flaskin sessioita ja autentikointia sekä relaatiotietokantojen käsittelyä.

Kaikille tasoille yhteiset vaatimukset:

• Käytetään Python-kieltä. Ohjelmakoodi on kommentoitava.
• Sivut on toteutettava Flask-sovelluksena, joka toimii eu.pythonanywhere.com-palvelimella. Muille palvelimille sijoitetut sovellukset eivät kelpaa.
• Kaikkien sivujen on oltava validia HTML5:sta
• Javascriptiä ei saa käyttää
• Sovellus ei saa kaatua
• Tietojen tallentamiseen on käytettävä MySQL-tietokantaa.
• Sivujen tulee pysyä valideina, vaikka käyttäjä syöttäisi HTML-koodia joihinkin syötekenttiin. Sivuston sisältämä HTML on tuotettava Jinja-templatejen avulla. Python-koodin seassa ei saa esiintyä HTML-koodia. Jinja-koodi on pidettävä mahdollisimman yksinkertaisena.
• Kommentoikaa koodin oleellisimpia osia!
• Käytetään valmista tietokantaa, jonka luontilauseet löytyvät mysql.sql-tiedostosta (vrt. sqlite3-versioon). Tietokanta on samantyyppinen kuin viikkotehtävässä 1, mutta rakenne on muutettu relaatiotietokantaan sopivaksi.

  Tietokannan rakennetta ei saa muuttaa.

  

  Joukkueen jäsenlistaus on tallennettu JSON-muodossa joukkueet-tauluun

• HTML-lomakkeessa, jolla aiheutetaan muutoksia (lisäys, muutos, poisto) tietokantaan, ei saa käyttää GET-metodia
• SQL-lauseiden muodostaminen merkkijono-operaatioilla on ehdottomasti kiellettyä ja pudottaa vastauksen pisteet nollaan
• Sivustolla on käytettävä UTF-8-merkistöä kaikkialla.
• Salasanoja ei saa tallentaa selkokielisinä vaan on käytettävä SHA-512-algoritmia.
• Tietokannan taulujen ID-kenttien sisältöä ei pidä näyttää käyttäjälle eikä kysyä käyttäjältä. Tietokannassa on käytetty SERIAL/AUTOINCREMENT-tyyppistä kenttää, jolloin tietokanta keksii ID-kenttien arvot tarvittaessa itse.
• SQL-kyselyissä ei saa käyttää DISTINCT-ominaisuutta. Kyselysi on kirjoitettu väärin, jos luulet DISTINCT-ominaisuudella korjaavasi tilanteen.
• Sovellus on toteutettava käyttäen mysql.connector-kirjastoa. SQLAlchemyn käyttäminen ei ole sallittua.
• Sovelluksen on toimittava riippumatta tietokannan sisällöstä. Et voi hardkoodata mitään tietokannan sisältöön liittyvää. Älä kuvittele, että koko tietokanta mahtuu kerralla esim. sessioon.
• Sovelluksen on toimittava usealla eri käyttäjällä samaan aikaan.
• Tietokantayhteyden avaamiseen liittyvät tiedot (tietokannan nimi, käyttäjätunnus, salasana ja tietokantapalvelimen osoite) eivät saa esiintyä lähdekoodissa. Sijoita ne erilliseen tiedostoon, josta ne luetaan tarvittaessa. Esim. dbconfig.json
• Tietokantayhteys täytyy sulkea kaikissa tilanteissa

  try:
     db = pool.get_connection()
  except: #tämä osa ei ole pakollinen
     ...
     ....
  finally: #tämä suoritetaan aina lopuksi
     db.close()

Taso 1

Toteuta tulospalvelusivusto, jolla on seuraavat ominaisuudet:

• Käytä valmista tietokannan määrittelyä ja sisältöä. Luo vastaava MySQL-tietokanta, jota käytät sovelluksessasi. Tallenna kaikki muutokset samaan tietokantaan. Huom! Tietokannan sisältö ei ole aivan sama kuin aiemmissa tehtävissä. Tässä versiossa on useita samannimisiä joukkueita.
• Sovellukseen pitää kirjautua valitsemalla lomakkeelta jokin tietokannassa olevista kilpailuista ja syöttämällä lomakkeelle joukkueen nimi ja salasana. Salasana on kaikilla sama eli ties4080. Salasana ei saa esiintyä selkokielisenä ohjelmakoodissa eikä tiedostoissa! Joukkueen nimessä ei huomioida isoja ja pieniä kirjaimia eikä mahdollisiä välilyöntejä nimen alussa ja lopussa. Ts. " Kukka kaali " on sama asia kuin "kukka kaali".
• Toteuta sivuston autentikointi siten, että käytät tietokannasta löytyviä salasanoja. Jokaisella joukkueella on sama salasana (ties4080), jota vastaavaa tarkiste löytyy tietokannan joukkueet-taulusta, ja on luotu käyttäen tietokantaan tallennettua joukkueen id-kenttää seuraavalla tavalla:

  import hashlib
  m = hashlib.sha512()
  m.update( str(joukkueen_id).encode("UTF-8") )
  m.update( 'ties4080'.encode("UTF-8") )
  salasana = m.hexdigest()

  Salasana on generoitu hexdigest()-funktiolla

• Jos nimi tai salasana oli väärä tai joukkuetta ei löydy valitusta kilpailusta, tulostetaan virheilmoitus: "Kirjautuminen epäonnistui" ja palautetaan käyttäjä takaisin kirjautumissivulle.
• Jos yrittää tulla jollekin sovelluksen sivulle kirjautumatta, edelleenohjataan automaattisesti kirjautumissivulle.
• Oikeiden kirjautumistietojen syöttämisen jälkeen pääsee automaattisesti (edelleenohjaus, redirect) joukkuelistaussivulle
• Sovelluksen jokaisella alasivulla on sivun ylälaidassa navigointipalkki jossa on seuraavanlaiset tiedot:
  • Kilpailun nimi
  • Kirjautuneen joukkueen nimi, josta on linkki sivulle, jossa joukkue voi muokata tietojaan
  • Linkki joukkuelistaussivulle

  Kirjautumissivulla ei ole navigointilinkkejä.

• Toteuta joukkuelistaussivu jossa on listaus kaikista valitun kilpailun joukkueista. Listauksessa näkyvät myös sarjan nimi sekä joukkueiden jäsenet. Joukkuelistaus on ensisijaisesti aakkosjärjestyksessa sarjan nimen mukaan ja toissijaisesti joukkueen nimen mukaan. Joukkueen jäsenten nimet listataan myös aakkosjärjestyksessä. Järjestäminen on case-insensitive eli ei välitä onko käytetty isoja tai pieniä kirjaimia. Joukkueiden järjestäminen on tehtävä SQL-kyselyssä. Listauksen on oltava seuraavan mallin mukainen:
  • Sarjan nimi
    • Rennot 2
      • Heikki Häkkinen
      • Pia Virtanen
      • Sari Maaninka
    • Retkellä v 13
      • Henna Venäläinen
      • Katja Vitikka
    • ...

  <ul>
      <li>Sarjan nimi
          <ul>
              <li>Rennot 2
                  <ul>
                  <li>Heikki Häkkinen</li>
                  <li>Pia Virtanen</li>
                  <li>Sari Maaninka</li>
                  </ul>
              </li>
              <li>Retkellä v 13
                  <ul>
                  <li>Henna Venäläinen</li>
                  <li>Katja Vitikka</li>
                  </ul>
              </li>
              <li>...</li>
          </ul>
      </li>
  </ul>
  

  Listauksessa tarvittavat tiedot on haettava tietokannasta yhdellä sql-kyselyllä. Jos yrität hakea erikseen jokaisen joukkueen jäsenen tietoja, pieleen menee.

• Luo sivu, jossa järjestelmään kirjautunut joukkue voi muuttaa oman joukkueensa tietoja. Lomakkeella on oltava valmiina joukkueen aiemmat tiedot. Sivulla on lomake, joka sisältää seuraavat asiat:
  • Sarja, joka on valittava tietokannassa tarjolla olevista sarjoista. Sarjan valinta on toteutettava select-elementin (alasvetovalikon) avulla.
  • Joukkueen nimi, jota ei saa jättää tyhjäksi
  • Samassa kilpailussa ei saa olla kahta samannimistä joukkuetta
  • Joukkueen jäsenet, joita voi olla 2-5 kappaletta. Lomakkeella on valmiina viisi kenttää joihin voi syöttää jäsenten nimiä. Jäsenen nimi ei saa olla tyhjä eli tyhjiä kenttiä ei huomioida.
  Lomakkeella on osattava järkevästi käyttää HTML5-lomake-elementtejä kuten label. Pelkästään lomake-elementtien rajoitteisiin ei voi luottaa vaan kaikki tarkistukset on tehtävä ja virheilmoitukset tuotettava myös Flask-ohjelmassa. Javascriptiä ei saa käyttää.

  Lomake on toteutettava Flask-WTF- ja WTForms-kirjastojen avulla.

• Jos lomakkeen tiedoissa on puutteita, niin virheistä pitää ilmoittaa kyseisen kentän vieressä esitettävällä virheilmoituksella. Esim. joukkueen nimeä ei ole annettu tai jäseniä on syötetty vähemmän kuin kaksi kappaletta. Jos tiedoissa on virheitä tai puutteita, muutoksia ei tallenneta.
• Aiemmin tietokannassa olleiden arvojen täytyy olla lomakkeella valmiina odottamassa muutoksia. Jos syötetyissä tiedoissa on virheitä, lomake muistaa myös virheelliset syötteet.

Taso 3

Toteuta taso 1 -mukainen sovellus seuraavilla muutoksilla ja lisäyksillä:

• Tee sovellukseen sivu (logout), jolla voi kirjautua ulos sovelluksesta painikkeella. Uloskirjautumisen jälkeen siirrytään takaisin kirjautumissivulle eikä muille sivuille enää pääse. Lisää navigointipalkkiin linkki uloskirjautumissivulle.
• Lisää sovellukseen uusi sivu (admin), jolla pyydetään kirjautumaan sisään ylläpitäjänä. Sivulla on yksi salasanakenttä. Salasanana toimii admin. Salasana ei saa esiintyä koodissa eikä tiedostoissa selkokielisenä. Sivulla voi olla myös tunnuskenttä, mutta se on tarpeeton, koska oletetaan, että kirjautujan tunnus on aina admin.
• Kirjauduttaessa sovellukseen admin-sivulta muuttuu sovelluksen ulkoasu. Huom. tee aivan uudet sivut ylläpitäjän käyttöön. Älä yritä muokata edellisellä tasolla olevia sivuja. admin-sivulta kirjauduttaessa ei saa päästä edellistasolla toteutetuille sivuille
• Navigointipalkissa lukee joukkueen nimen sijaan sana admin, josta on linkki sovelluksen etusivulle.

  Sovelluksen etusivulla on linkkilistaus tietokannasta löytyvistä kilpailuista. Sovelluksen on toimittava vaikka kilpailujen nimet olisivat mitä tahansa.

  • Jäärogaining
  • Fillarirogaining
  • Kintturogaining
• Kilpailun nimeä klikattaessa päästään sivulle, jossa listataan kilpailun sarjat keston mukaan järjestettyinä. Sovellus muistaa valitun kilpailun. Sovelluksen on toimittava kaikilla mahdollisilla sarjanimillä. Et voi hardkoodata sarjojen nimiä vaan ne on aina haettava tietokannasta. Listaus on oltava seuraavan mallin mukainen:
  • 2 h
  • 4 h
  • 8 h

  <ul>
  <li><a href="...">4 h</a></li>
  <li><a href="...">2 h</a></li>
  <li><a href="...">8 h</a></li>
  </ul>

• Valittaessa sarjalistaussivulta sarja päästään sivulle, jossa listataan kaikki kyseisen sarjan joukkueet. Sovellus muistaa valitun sarjan.
  • Samalla sivulla on lomake, jolla voidaan lisätä uusia joukkueita valittuna olevaan sarjaan. Joukkueelta kysytään samat tiedot, kuin joukkueen tietojen muutoslomakkeella (kts. taso 1). Sarjaa ei tarvitse kysyä, koska se on jo valittu. Myös samat tarkistukset ovat voimassa. Lisäksi lomakkeella voi antaa joukkueelle halutun salasanan. Lomake on toteutettava WTFormsin avulla.
  • Onnistuneen joukkueen lisäämisen jälkeen saadaan listaus sarjan joukkueista. Myös juuri lisätty joukkue täytyy näkyä listauksessa. Sovellus muistaa lisätyn joukkueen.
• Tee joukkuelistauksessa olevista joukkueiden nimistä linkkejä. Linkki vie joukkueen omalle sivulle, joka on samanlainen kuin tasolla 1, mutta ei sama sivu, eli pääsee muokkaamaan joukkueen tietoja. Myös salasanan voi vaihtaa.. Sovellus muistaa valitun joukkueen.
• Lisää joukkueen muokkauslomakkeeseen myös checkbox, jonka valitsemalla kyseinen joukkue poistetaan tietorakenteesta. Joukkuetta ei kuitenkaan saa poistaa, jos joukkueella on jo rastileimauksia. Anna selkeä virheilmoitus, jos joukkueen poistaminen ei onnistu.
• Kirjauduttaessa järjestelmään joukkueena voi joukkue vaihtaa omalla sivullaan tietojensa lisäksi myös salasanansa.
• Kirjautumissivun on näytettävä seuraavanlaiselta (värit ja layout). Samaa väritystä saa käyttää muuallakin sivustolla.
  
• Sivun navigointipalkin on näytettävä seuraavanlaiselta:
  
• Joukkueen tietojen muokkaussivulla olevan lomakkeen on näytettävä seuraavanlaiselta:
  

  Navigointi toimii seuraavalla tavalla:

  • Kilpailut vie sivulle, jossa listataan kaikki kilpailut. Valittaessa tällä sivulla jokin kilpailu unohdetaan aiemmin valitut sarjat ja joukkueet, jos valittu kilpailu on eri kuin aiemmin valittuna ollut.
  • Sarjat vie sivulle, jossa listataan viimeksi valitun kilpailun sarjat. Jos kilpailua ei ole vielä valittu, ohjaudutaan Kilpailut-sivulle
  • Joukkueet vie sivulle, jossa listataan viimeksi valitun sarjan joukkueet. Jos sarjaa ei ole vielä valittu, ohjaudutaan Sarjat-sivulle
  • Joukkue vie sivulle, jossa muokataan viimeksi valitun tai lisätyn joukkueen tietoja. Jos joukkuetta ei ole vielä kertaakaan valittu tai lisätty, ohjaudutaan Joukkueet-sivulle
  • Logout kirjaa ulos järjestelmästä. Uloskirjautumisen jälkeen ei enää päästä muille kuin sisäänkirjautumissivulle.

Taso 5

Toteuta taso 3 -mukainen sovellus seuraavilla muutoksilla ja lisäyksillä:

• Lisää sovelluksen admin-osioon uusi sivu, jossa listataan kilpailun kaikki rastit kaikkine tietoineen taulukkomuodossa. Kunkin rastin yhteydessä kerrotaan myös lukumäärä tämän rastin leimauskerroista. Huomioi myös rastit joita ei ole leimattu kertaakaan! Lisää rastisivulle vievä linkki navigointipalkkiin sekä sarjalistaussivulle.
• Kaikkien rastien listaus on tehtävä SQL-kyselyllä, jossa käytetään sopivaa ulkoliitosta (LEFT OUTER, RIGHT OUTER tai FULL OUTER)
• Lisää joukkuekohtaiselle sivulle taulukkomuotoinen listaus kyseisen joukkueen rastileimauksista aikajärjestyksessä:

  Aika	Rasti
  2017-03-18 10:30:30	34
  2017-03-18 10:47:50	5C
  ...	...

• Admin-tilassa jokaisen rastileimauksen kellonajasta on linkki sivulle, jossa pääsee muokkaamaan kyseisen rastileimauksen tietoja.
  • Sivulla on oltava lomake, jossa voi muokata leimausaikaa ja valita leimatun rastin alasvetovalikosta.
  • Lomakkeella on myös "poista leimaus"-kohta, jonka voi ruksata, jos haluaa poistaa kyseisen leimauksen.
  • Leimaukseen liittyvää joukkuetta ei voi vaihtaa.