Timezones and localization

.gitignore

@@ -8,3 +8,4 @@ celerybeat-*
 env.sh
 .cache
 .idea/
+docker-compose.yml

README.md

@@ -6,10 +6,26 @@ Helios is an end-to-end verifiable voting system.
 
 ## Info
 
-větve v gitu:
+Větve v gitu:
 
 - `original` je kopie https://github.com/benadida/helios-server
 - `master` je z `original` odvozená Pirátská verze nasazená v produkci
 - `test` je testovací verze odvozená z `master` nasazená pro testování
 
 Obvykle děláme změny v `test` a když je to ok, releasujeme do `master`.
+
+### Jak na upgrade?
+
+1. aktualizuj větev `original`
+2. udělej rebase větve `master` z větve `original`
+3. udělej novou větev `test` odvozenou z `master`
+
+## Čas
+
+S šasy se v kódu pracuje velmi primitivně. Všechny časy jsou naivně a musí být UTC.
+Což komplikuje všechno. Ale podařilo se to rozumně pořešit na vstupu a výstupu.
+
+V kódu je to ohnuté takto:
+
+* Vizuálně času v templatech prohnán přes filtr `|timezone:"Europe/Prague"`.
+* Ve form field `SplitDateTimeField` očekáváme Europe/Prague a převádíme na UTC.

helios/fields.py

 import datetime
+import pytz
 
 from django.forms import fields
+from django.utils.timezone import make_aware, make_naive
 
 from .widgets import SplitSelectDateTimeWidget
 
@@ -25,6 +27,8 @@ class SplitDateTimeField(fields.MultiValueField):
         if data_list:
             if not (data_list[0] and data_list[1]):
                 return None
-            return datetime.datetime.combine(*data_list)
+            value = datetime.datetime.combine(*data_list)
+            # do formuláře zadáváme Europe/Prague, ale do DB se ukládá naivní UTC
+            return make_naive(make_aware(value, pytz.timezone("Europe/Prague")), pytz.UTC)
         return None
 

helios/forms.py

@@ -21,10 +21,8 @@ class ElectionForm(forms.Form):
   randomize_answer_order = forms.BooleanField(required=False, initial=False, help_text=u'zvolte, pokud chcete, aby se každému voliči zobrazovaly odpovědi na otázky v náhodně zvoleném pořadí', label=u"Odpovědi v náhodném pořadí")
   private_p = forms.BooleanField(required=False, initial=False, label=u"Soukromé?", help_text=u'Soukromé hlasování je viditelné jen pro registrované voliče.')
   help_email = forms.CharField(required=False, initial="", label=u"E-mail pro nápovědu", help_text=u'e-mailová adresa, na kterou se budou voliči obracet s žádostmi o pomoc.')
-  voting_starts_at = SplitDateTimeField(help_text = u'datum a čas zahájení hlasování; v UTC, takže oproti časovému pásmu ČR je menší o 1 hodinu v zimním, resp. o 2 hodiny v letním čase',
-                                   widget=SplitSelectDateTimeWidget, required=False, label=u"Hlasování začíná v")
-  voting_ends_at = SplitDateTimeField(help_text = u'datum a čas ukončení hlasování; v UTC, takže oproti časovému pásmu ČR je menší o 1 v zimním, resp. o 2 hodiny v letním čase',
-                                   widget=SplitSelectDateTimeWidget, required=False, label=u"Hlasování končí v")
+  voting_starts_at = SplitDateTimeField(help_text = u'datum a čas zahájení hlasování v lokálním čase!', widget=SplitSelectDateTimeWidget, required=False, label=u"Hlasování začíná v")
+  voting_ends_at = SplitDateTimeField(help_text = u'datum a čas ukončení hlasování v lokálním čase!', widget=SplitSelectDateTimeWidget, required=False, label=u"Hlasování končí v")
 
   if settings.ALLOW_ELECTION_INFO_URL:
     election_info_url = forms.CharField(required=False, initial="", label=u"URL pro stažení informací o hlasování", help_text=u"URL dokumentu ve formátu PDF, obsahujícího doplňkové informace k hlasování, např. životopisy a profily kandidátů")
@@ -32,7 +30,7 @@ class ElectionForm(forms.Form):
   pass
 
 class ElectionTimeExtensionForm(forms.Form):
-  voting_extended_until = SplitDateTimeField(help_text = u'datum a čas prodlouženého ukončení hlasování; v UTC',
+  voting_extended_until = SplitDateTimeField(help_text = u'datum a čas prodlouženého ukončení hlasování; v lokálním čase!',
                                    widget=SplitSelectDateTimeWidget, required=False, label=u"Hlasování prodlouženo do")
 
 class EmailVotersForm(forms.Form):

helios/templates/election_not_started.html

 {% extends TEMPLATE_BASE %}
+{% load tz %}
 
 {% block content %}
 
@@ -9,8 +10,8 @@
   </p>
 
   <p>
-      {% if election.voting_start_at %}začátek hlasování: {{election.voting_start_at}}<br />{% endif %}
-      {% if election.voting_end_at %}konec hlasování: {{election.voting_end_at}}<br />{% endif %}
+      {% if election.voting_start_at %}začátek hlasování: {{election.voting_start_at|timezone:"Europe/Prague"}}<br />{% endif %}
+      {% if election.voting_end_at %}konec hlasování: {{election.voting_end_at|timezone:"Europe/Prague"}}<br />{% endif %}
   </p>
 
   <p>

helios/templates/election_tallied.html

 {% extends TEMPLATE_BASE %}
+{% load tz %}
 
 {% block content %}
 
@@ -9,8 +10,8 @@
   </p>
 
   <p>
-      {% if election.voting_start_at %}začátek hlasování: {{election.voting_start_at}}<br />{% endif %}
-      {% if election.voting_end_at %}konec hlasování: {{election.voting_end_at}}<br />{% endif %}
+      {% if election.voting_start_at %}začátek hlasování: {{election.voting_start_at|timezone:"Europe/Prague"}}<br />{% endif %}
+      {% if election.voting_end_at %}konec hlasování: {{election.voting_end_at|timezone:"Europe/Prague"}}<br />{% endif %}
   </p>
 
   <p>

helios/templates/election_view.html

 {% extends TEMPLATE_BASE %}
+{% load tz %}
 {% block title %}{{election.name}}{% endblock %}
 {% block content %}
 <div style="float: left; margin-right: 50px;">
@@ -48,8 +49,8 @@ toto {{election.election_type}} <u>není</u> zobrazeno na titulní stránce.
 
 <p>
 {% if election.help_email and admin_p%}Email pro nápovědu: {{election.help_email}}<br />{% endif %}
-{% if election.voting_start_at %}Hlasování začíná: {{election.voting_start_at}}<br />{% endif %}
-{% if election.voting_end_at %}Hlasování končí: {{election.voting_end_at}}<br />{% endif %}
+{% if election.voting_start_at %}Hlasování začíná: {{election.voting_start_at|timezone:"Europe/Prague"}}<br />{% endif %}
+{% if election.voting_end_at %}Hlasování končí: {{election.voting_end_at|timezone:"Europe/Prague"}}<br />{% endif %}
 </p>
 
 {% if election.election_info_url %}
@@ -97,7 +98,7 @@ toto {{election.election_type}} <u>není</u> zobrazeno na titulní stránce.
 <br />
 {% if election.voting_starts_at %}
 jakmile to učiníte, hlasování bude připraveno k odevzdávání hlasovacích lístků a bude automaticky zahájeno<br />
-v {{election.voting_starts_at}}, podle vašeho nastavení.
+v {{election.voting_starts_at|timezone:"Europe/Prague"}}, podle vašeho nastavení.
 {% else %}
 jakmile to učiníte, hlasování bude ihned zahájeno.
 {% endif %}
@@ -185,12 +186,12 @@ Poté uvidíte výsledek pouze vy jakožto zakladatel hlasování.
 <br />
 <br />
 {% if election.voting_extended_until %}
-Toto {{election.election_type}} mělo původně skončit v {{election.voting_ends_at}} (UTC),<br />
-ale bylo prodlouženo do {{ election.voting_extended_until }} (UTC).
+Toto {{election.election_type}} mělo původně skončit v {{election.voting_ends_at|timezone:"Europe/Prague"}},<br />
+ale bylo prodlouženo do {{ election.voting_extended_until|timezone:"Europe/Prague" }}.
 {% else %}
 {% if election.voting_ends_at %}
 <br />
-Toto {{election.election_type}} bude uzavřeno v {{election.voting_ends_at}} (UTC).
+Toto {{election.election_type}} bude uzavřeno v {{election.voting_ends_at|timezone:"Europe/Prague"}}.
 {% else %}
 Toto {{election.election_type}} bude uzavřeno podle rozhodnutí jeho zakladatele.
 {% endif %}

helios/templates/email/vote_body.txt

+{% load tz %}
 Vážený {{voter.name}},
 
 {{custom_message|safe}}
 
 URL Hlasování: {{election_vote_url}}
 Otisk Hlasováné: {{voter.election.hash}}
-{% if election.voting_start_at %}Hlasování začíná {{election.voting_start_at}}
-{% endif %}{% if election.voting_end_at %}Hlasování končí {{election.voting_end_at}}
+{% if election.voting_start_at %}Hlasování začíná {{election.voting_start_at|timezone:"Europe/Prague"}}
+{% endif %}{% if election.voting_end_at %}Hlasování končí {{election.voting_end_at|timezone:"Europe/Prague"}}
 {% endif %}
 
 {% ifequal voter.voter_type "password" %}

settings.py

@@ -54,11 +54,11 @@ if get_from_env('DATABASE_URL', None):
 # although not all choices may be available on all operating systems.
 # If running in a Windows environment this must be set to the same as your
 # system time zone.
-TIME_ZONE = 'America/Los_Angeles'
+TIME_ZONE = 'UTC'
 
 # Language code for this installation. All choices can be found here:
 # http://www.i18nguy.com/unicode/language-identifiers.html
-LANGUAGE_CODE = 'en-us'
+LANGUAGE_CODE = 'cs-cz'
 
 SITE_ID = 1
 
@@ -66,6 +66,8 @@ SITE_ID = 1
 # to load the internationalization machinery.
 USE_I18N = True
 
+USE_L10N = True
+
 # Absolute path to the directory that holds media.
 # Example: "/home/media/media.lawrence.com/"
 MEDIA_ROOT = ''