# kyselma
	Kyselmä - kysele, vastaile ja tutki tuloksia

TO GET IT RUNNING:

Install postgresql for local user & get it running (as in course material)
- $ wget https://github.com/hy-tsoha/local-pg/raw/master/pg-install.sh
- $ bash pg-install.sh
- $ postrgres &

Clone the source
- $ git clone https://github.com/triionhe/kyselma.git
- $ cd kyselma

Get database ready
- $ psql < SCHEMA.sql (BE CAREFUL! This drops some tables.)
	
Either use (1) poetry or (2) venv to handle dependencies and run the app

(1) Install poetry if nessesary. (refer your distro)
- $ pip install --user poetry
- $ pipx install poetry

(1) Install dependencies
- $ export PYTHON_KEYRING_BACKEND=keyring.backends.fail.Keyring (Just in case..)
- $ poetry install --no-root

(1) Start the app in poetry virtual environment
- $ poetry run flask run

(2) Activate venv environment
- $ python3 -m venv venv
- $ source venv/bin/activate

(2) Install dependencies with pip
- $ pip install -r ./requirements.txt

(2) Start the app
- $ flask run

Surf to the webpage and start two sessions for better testing
- $ firefox http://localhost:5000/ http://127.0.0.1:5000/

There is ready made kyselmä named 'kysdemo' for testing.





DONE:
- Tietoturvaseikat: CSRF suojaus
- Eniten ja vähiten yhdenmukaiset vastaajat
- Parempi ulkoasu
- Vastauksen ja luomisen aloittamisen yksinkertaistaminen
- Vastausten anto
- Vastausten tarkistelu
- Kyselyn luomisen näyttö
- Kyselyn lukitseminen vastattavaksi
- Kysymyksen näyttö
- Ulkoasu
- Voi lisätä kyselyn
- Kysymyksen mukana lisätään vastaus
- Kysymyksen lisäys
- Vastaustaulu
- Kysymystaulu
- Kyselytaulu
- Tietokantayhteys
- Nimierkkitaulu
- Nimimerkin käyttöönotto ja tarkistus
- Virheviestien kuljetus
- Nettisivurunko

TODO:
- Moderointi
...

Tarkoitus on luoda sivu jossa voi luoda kysymyksiä ja kyselyitä, joita
täytetään anonyymillä nimimerkillä.

Käyttäjä luo ensin kyselyn ja antaa omat vastauksensa.

Käyttäjän luonti:
- Tässä ohjelmassa ei ole käyttäjiä vaan ainoastaan nimimerkkejä
- Nimimerkki on sessiokohtainen ja enempi vähempi pysyvä

Kyselyn luonti:
- Käyttäjä kirjoittaa kysymyksen
- Käyttäjä valistee kysymykseen sopivat vastinparit
- Käyttäjä vastaa itse kysymykseensä
- Em 3 kohtaa toistetaan, kunnes käyttäjä valitsee valmis
- Tämän jälkeen käyttäjä1 siirretään tarkastelutilaan

Vastausvaihtoehdot on muunnettavissa luvuiksi, joita voi vertailla.

Esimerkkivastinpareja:
- kyllä vs ei
- samaa mieltä vs eri mieltä
- vaihtoehto1 vs vaihtoehto2

Kyselytila:
- Käyttäjä 2 saa käyttäjän 1 esittämät kysymykset vastattavakseen
- Vastattuaan kysymyksiin käyttäjä 2 siirretään tarkastelu tilaan

Tarkastelutila:
- Tilassa näkyy kutsulinkki ja koodi, jolla käyttäjä voi kutsua toisen
- Tilassa voi valita monta eri moodia:
	1. Eniten omia vastauksia mukaileva käyttäjä
	2. Vähiten omia vastauksia mukaileva käyttäjä
	3. Etsi käyttäjä vertailtavaksi
- Kaikissa moodeissa vertaillaan vastauksia/keskiarvoa omiin
- Jokainen moodi näyttää myös yhtenäisyysprosentin

Yhtenäisyysprosentti:
- Tismalleen samat vastaukset antaa 100%
- Tismalleen eri ääripäiden vastaukset antaa 0%
- Jos vastausten välinen etäisyys koko skaalalla on 10% niin se antaa 90%
- Eli siis 1-abs(vast_a-vast_b)/(max-min)
- Kyselyn yhtenäisyysprosentti on keskiarvo kaikkien kysymysten prosenteista


Moderointitila:
- poista kysely kutsukoodilla
- esti kysely hakusanalla positettavasksi


Kysymykset, kyselyt, vastaukset tallennetaan asianmukaisiin tauluihin.


Ominaisuuksia joiden tekemistä voi harkita:
- Jokaisella kyselyllä on elinikä jonka jälkeen ne siivotaan.
- Kysymyksiin voi liittää kuvia

Ikonit (CC) pixellove:
https://www.svgrepo.com/collection/pixellove-bordered-vectors/