Päivitetty Python 2.7 ja Dajango 1.11 sekä piiripisteet

README.md

@@ -1,15 +1,74 @@
 Kipa
 ====
 
-Kipa- / Tupa2-ohjelmisto, jota käytetään partiotaitokilpailujen tuloslaskentaan. 
+Kipa- / Tupa2-ohjelmisto, jota käytetään partiotaitokilpailujen tuloslaskentaan. https://www.facebook.com/Kisapalvelu/
 
-Asennusohjeet: https://sites.google.com/site/kisapalvelukipa/kaeytae-ja-asenna
+Asennusohjeet, Linux: docs/kipa asennusmuistio ubuntu 2017.txt
+Windows: https://sites.google.com/site/kisapalvelukipa/kaeytae-ja-asenna
 
 Vanhat sivustot:
 
 * https://sites.google.com/site/kisapalvelukipa/
 * http://sourceforge.net/projects/tupa2/
 
+**Ohjelmaa kokeiltu:**
+
+* Django v.1.11
+* Python v.2.7
+* Chrome / Firefox
+
+**Tilanne: toimivat**
+
+* Kipa -sivusto
+* Admin -sivusto
+* static files
+* migrate
+* käyttäjäautentikointi (serverilaajuinen)
+* piirienväliset pisteet
+* dia2django
+* production serveri (nginx ja uwsgi)
+
+**Ei toimi tai ei testattu:**
+
+* testit (käyttäjähallinta ei mukana ja parametrit ei välity)
+* HTTPS tarvii sertifikaatit web-serverille
+* i18n
+* muut turhat härpäkkeet, joita en osaa käyttää
+
+**Tunnetut, ei toivotut ominaisuudet (known bugs):**
+
+* Jossain harvoissa tilanteissa, samassa sarjassa olevat samannimiset vartiot saavat samat tulokset, riippumatta syötteistä.
+* Samassa sarjassa olevat samannimiset tehtävät saavat toisetensa tulokset tulosten laskennassa.
+* Jos interpoloinnissa on vain yksi vartio ja nollasuorituksen kaavana max*muk, niin ainut vartio saa 0 pistettä.
+* Yhteen tehtävään voi syöttää vain yksi käyttäjä kerrallaan, joko varsinaisia tai tarkistussyötteitä.
+* Negatiivinen aikaväli antaa tulokseski nollan.
+* Aika -syötekentässä, E- tai H- syöte rikkoo ajan muotoilun, mutta korjaantuu tallentamalla 0 (tai joku) aika.
+* Tehtävän kaavassa desimaalipilkku kaataa laskennan (kaavan tarkastus ei aukoton).
+
+**Toivotut ominaisuudet:**
+
+* Python 3 ja Django 2 -tuki
+* Docker container
+* Manuaalin päivittäminen
+* Vartioiden import taulukosta / Kuksasta (tai muusta ilmoittautumisjärjestelmästä)
+* Tuloslaskennan huomiot, tuomarineuvoston kirjaukset, kilpailijoiden tarkastuspyynnöt tehtävien / syötteiden yhteyteen
+* Tietojen tallennus taustalla
+* Tietojen varmuuskopiointi ja palautus, eli Undo / muutosten logaus
+* Kisan tilanneseuranta
+* Piirit ja lippukunnat valita listasta, ei kirjoittamalla -> lyhenteet
+* Tulosten massavienti tikulle, eli yhdestä napista kaikki formaatit ja sarjat
+* Tulosten näyttämiseen tykillä valinta, mitkä sarjat + piirien tilanne ja onko useampi sarja samalla sivulla
+* Mahdollisuus liittää kuvia (videota?) tulosten tarkastuksen yhteyteen / kommentteihin
+* Tulosseuranta / tilanneseuranta netin yli kotiväelle
+
+**Muita ohjeita:**
+* Tietokantatiedostojen (.dia) katselemiseen ja muokkaamiseen voit käyttää ilmaista 'Dia Diagram Editor' -ohjelmaa. https://sourceforge.net/projects/dia-installer/ (asennus debian/ubuntu ympäristössä: sudo apt-get install dia )
+
+* Dia2django -skriptin käyttö:
+  * Mene omaan kipa kansioon ...kipa/web/tupa/
+  * Aja komento: python dia2django.py tietokanta.dia models.py
+  * Skripti päivittää ohjelman models.py tiedoston tietokantakentät annetun .dia tiedoston mukaiseksi.
+
 Lisenssi
 ========
 

docs/kipa asennusmuistio ubuntu 2017.txt

@@ -0,0 +1,117 @@
+######################
+# Kipa kisapalveluohjelmiston asentaminen ubuntun kaltaisiin järjestelmiin.
+# 
+# Kaikki risuaita-alkuiset rivit ovat kommentteja ja niitä ei tarvitse kirjoittaa komentoriville
+# 
+# Asennusta kokeiltu:
+# Ubuntu 17.10, Linux mint 18.3 ja Ubuntu Gnome 16.04 käyttöjärjestelmillä
+# Muiden pakettien versiot:
+# python 2.7
+# django 1.11
+# uwsgi 2.0
+# nginx 1.10
+# 
+# Alla on ohjeet Kipan asetamiseksi sekä yhdelle koneelle django testipalvelinta käyttäen, että lähiverkkopalvelimena toimivalle koneelle nginx -nettipalvelinohjelmistoa käyttäen.
+# Kaikkia laitteita, ohjelmien asennusta ja toimintaa kannattaa kokeilla jo ennen kisapaikalle siirtymistä, kiireisten ongelmatapausten välttämiseksi
+# 
+# Huomautus: Minä en ole tietoturva-alan ammattilainen ja en vastaa sinun tiedostoistasi tai koneistasi näitä tai muita ohjeita noudattaessasi. Joitain ohjeita Django projektin tietoturvaan liittyen löydät esimerkiksi: https://developer.mozilla.org/en-US/docs/Learn/Server-side/Django/web_application_security
+# 
+# Asennettuasi kipa -ohjelman, voit luoda järjestelmän pääkäyttäjän komennolla: python manage.py createsuperuser
+# pääkäyttäjän tunnuksilla voit kirjautua admin -sivulle http://127.0.0.1:8000/admin/ (jos käytät palvelinta verkossa muuta ip osoite) josta voit luoda muita käyttäjiä.
+# 
+######################
+# Yhden tietokoneen asennus ilman verkkokäyttöä:
+
+# järjestelmän päivittäminen
+sudo apt-get update
+sudo apt-get upgrade
+
+# Käynnistä järjestelmä uudelleen
+
+# tarvittavien pakettien asentaminen / päivittäminen
+sudo apt-get install git python2.7-dev python-pip
+sudo -H python -m pip install --upgrade pip
+sudo -H pip install setuptools 
+sudo -H pip install django==1.11
+
+# Käynnistä järjestelmä uudelleen
+
+# kipa -ohjelman haku github -sivulta (aja tämä komento siinä kansiossa johon haluat tiedostot ladattavan ja sinulla on oikeudet käyttää)
+git clone https://github.com/Pena86/kipa.git
+
+# siirrytään ohjelmakansioon ja käynnistetään testipalvelin
+cd kipa/web/
+python manage.py runserver
+
+
+#Luo itsellesi palvelimen pääkäyttäjätili komennolla: (sähköpostiosoitteen ei tarvi olla toimiva, mutta pitää olla oikeaa muotoa) Luomallasi tunnuksella voit kirjautua Kipa -järjestelmään, tuoda tai luoda kisan ja luoda muita käyttäjiä.
+python manage.py createsuperuser
+
+
+# mene selaimella osoitteeseen http://127.0.0.1:8000/ ja kipa-ohjelman pitäisi olla käytössä
+# ohjelman voi sulkea komentorivillä painamalla CONTROL-C
+# 
+######################
+# Kipan asentaminen palvelinkoneelle usean koneen verkkokäyttöä varten
+# 
+
+# järjestelmän päivittäminen
+sudo apt-get update
+sudo apt-get upgrade
+
+# Käynnistä järjestelmä uudelleen
+
+# tarvittavien pakettien asentaminen / päivittäminen
+sudo apt-get install git python2.7-dev python-pip nginx
+sudo -H python -m pip install --upgrade pip
+sudo -H pip install setuptools 
+sudo -H pip install uwsgi django==1.11
+
+# lisätään käyttäjä www-data ryhmään dialout
+sudo adduser www-data dialout
+
+# Käynnistä järjestelmä uudelleen
+
+# siirrytään hakemistoon (jos aiot ajaa kipa-ohjelmaa muusta hakemistosta, sinun pitää muokata uusi hakemistopolku ainakin kipa_nginx.conf -tiedostoon)
+cd /var/www/
+# ladataan kipa -ohjelmisto githubista
+sudo git clone https://github.com/Pena86/kipa.git
+# muutetaan kansion kipa ja sen alikansioiden ja tiedostojen omistajaksi ja ryhmäksi www-data
+sudo chown -R www-data:www-data kipa/
+
+# linkitetään kipa_nginx.conf -tiedosto nginx -ohjelman käytettäväksi
+sudo ln -s /var/www/kipa/web/kipa_nginx.conf /etc/nginx/sites-enabled/kipa_nginx.conf
+# käynnistetään nginx -ohjelma uudestaan
+sudo /etc/init.d/nginx restart
+
+# siirrytään kansioon ja ajetaan uwsgi -ohjelma (käyttäjänä www-data), joka suorittaa django -projektin tiedostoja nettipalvelinohjelmiston niitä pyytäessä
+cd /var/www/kipa/web/
+sudo -H -u www-data uwsgi --ini kipa_uwsgi.ini
+
+# mene selaimella osoitteeseen http://127.0.0.1/ ja kipa-ohjelman pitäisi olla käytössä (jos muutat asetustiedostoihin palvelinkoneen ip-osoitten, käytä sitä myös paikallisella koneella)
+# ohjelman voi sulkea komentorivillä painamalla CONTROL-C
+
+# Että voisit käyttää kipa -ohjelmaa muilla lähiverkon koneilla, tulee sinun vielä tehdä pari asiaa:
+# - Selvitä palvelinkoneen ip -osoite esim. koneen tai lähiverkkoreitittimesi asetuksista
+# - Muuta palvelinkoneen ip -osoite /var/www/kipa/web/kipa_nginx.conf -tiedoston server_name -kohtaan ja käynnistämään nginx -palvelinohjelman uudestaan komennolla sudo /etc/init.d/nginx restart
+# - Lisää palvelinkoneen ip -osoite /var/www/kipa/web/settings.py -tiedoston ALLOWED_HOSTS -kohtaan ja käynnistä uwsgi -komento (yltä) uudestaan
+# - Saatat tarvita asettaa lähiverkkoreitittimeesi portin- tai ip -osoitteen reitityksen palvelinkoneen osoitteeseen
+# nyt myös lähiverkon koneilta pitäisi päästä kipa -ohjelmaan kirjoittamalla selainohjelman osoiteriville palvelinkoneen ip-osoite.
+
+
+#Luo itsellesi palvelimen pääkäyttäjätili komennolla: (sähköpostiosoitteen ei tarvi olla toimiva, mutta pitää olla oikeaa muotoa) Luomallasi tunnuksella voit kirjautua Kipa -järjestelmään, tuoda tai luoda kisan ja luoda muita käyttäjiä.
+python manage.py createsuperuser
+
+
+# seuraavilla komennoilla saat lisää tietoa ja voit hallita nginx -ohjelman toimintaa
+sudo /etc/init.d/nginx status
+sudo /etc/init.d/nginx stop
+sudo /etc/init.d/nginx start
+nano /var/log/nginx/error.log (painamalla CONTROL-X suljet editorin)
+nano /var/log/nginx/access.log (painamalla CONTROL-X suljet editorin)
+
+# Django testipalvelimen käynnistäminen 
+cd /var/www/kipa/web/
+sudo -H -u www-data python manage.py runserver
+# mene selaimella osoitteeseen http://127.0.0.1:8000/ ja kipa-ohjelman pitäisi olla käytössä
+# ohjelman voi sulkea komentorivillä painamalla CONTROL-C

docs/views_templates.txt

@@ -0,0 +1,113 @@
+Mitä templateja kukin näkymä käyttää:
+
+Umpihanki » Etusivu
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/kisa.html -->
+
+
+#### Suoritusten syöttö ####
+
+Umpihanki » Syötä tuloksia (sekä) Syötä tuloksia - tarkistussyötteet
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/valitse.html -->
+<!-- #### templates/tupa/valitse_linkki.html --> jokaiselle sarjalle
+
+Umpihanki » Syötä tuloksia » (tehtävä)
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/syota_tehtava.html -->
+<!-- #### templates/tupa/tallenna.html -->
+
+Umpihanki » Tuomarineuvoston antamien tulosten määritys
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/valitse.html -->
+<!-- #### templates/tupa/tuomarineuvos.html --> jokaiselle sarjalle
+<!-- #### templates/tupa/tallenna.html -->
+
+
+#### Tulokset ####
+
+Umpihanki » Tulokset sarjoittain (sarjan tulokset) (sekä) (tulosta tuloksia) (sekä) (tulokset CVS-tiedostoon)
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/tulosta.html -->
+
+Umpihanki » Tulokset sarjoittain » (sarja)
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/tulokset.html -->
+
+(tulosta tuloksia)
+<!-- #### templates/tupa/tuloksetHTML.html -->
+
+(heijasta tuloksia)
+<!-- #### templates/tupa/heijasta.html -->
+
+Umpihanki » Laskennan tilanne
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/laskennan_tilanne.html -->
+
+
+#### Kisan määritykset ###
+
+Umpihanki » Määritä kisa
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/maarita.html -->
+<!-- #### templates/tupa/tallenna.html -->
+
+Umpihanki » Määritä vartiot
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/valitse.html -->
+<!-- #### templates/tupa/valitse_formset.html -->
+<!-- #### templates/tupa/tallenna.html -->
+
+Umpihanki » Muokkaa tehtävää
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/valitse.html -->
+<!-- #### templates/tupa/maaritaValitseTestava.html --> (jokaiselle sarjalle)
+<!-- #### templates/tupa/poista.html -->
+
+Umpihanki » Muokkaa tehtävää » (tehtävä)
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/maarita.html -->
+<!-- #### templates/tupa/tallenna.html -->
+	+ templates/tupa/forms/...
+
+Umpihanki » Testituloksien määritys
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/valitse.html -->
+<!-- #### templates/tupa/valitse.html -->
+<!-- #### templates/tupa/testitulos.html --> (jokaiselle sarjalle)
+
+
+#### Ylläpito ####
+
+(listaa kaikki kisat)
+<!-- #### templates/tupa/index.html -->
+<!-- #### templates/tupa/login.html -->
+
+(tallenna kisa)
+
+Umpihanki » Korvaa kisa tiedostosta
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/upload.html -->
+<!-- #### templates/tupa/tallenna.html -->
+
+Umpihanki » Poista kisa
+<!-- #### templates/tupa/base.html -->
+<!-- #### templates/tupa/login.html -->
+<!-- #### templates/tupa/poista_kisa.html -->
+
+
+#### Apua ####
+(ohje)