WIP: Reforma importů

Ze systému importů rostl pěkný bastl: spousta věcí byla implementovaná velmi podobně na více místech a bylo pracné přidávat nové typy importů. Také původní předpoklad, že budeme umět jen jeden formát souboru, se ukázal být příliš naivním.

Pokusil jsem se importy zobecnit, značně to prokouklo. Teď existuje jedna jediná implementace UI k importům, jedna společná dokumentace pro všechny druhy importů a jeden generátor šablon. Formát souboru se vybírá explicitně.

Postupně doplním další drobnosti jako ignorování prázdných řádků.

mo/web/templates/doc_import.html

 {% extends "base.html" %}
 {% block body %}
-<h2>Import účastníků</h2>
+<h2>Rozhraní pro import</h2>
+
+<p>Potřebujete-li do OSMO vložit větší množství dat, můžete si na svém počítači
+připravit tabulku a tu pak do OSMO importovat.
 
-<p>Připravte soubor ve formátu CSV (comma-separated values) v kódování znaků UTF-8.
-Na každém řádku je jeden účastník, sloupce jsou oddělené čárkami. Pokud
-potřebujete v nějakém sloupci použít čárku, uzavřete hodnotu sloupce do
-uvozovek (obyčejných, ne českých). Běžné tabulkové kalkulátory (třeba Excel
-nebo LibreOffice Calc) umí v tomto formátu ukládat.
+<p>Tabulky jsou textové soubory ve formátu CSV (comma-separated values).
+Každý řádek odpovídá jednomu záznamu (třeba účastníkovi), sloupce jsou oddělené
+čárkami. Pokud potřebujete v nějakém sloupci použít čárku, uzavřete hodnotu sloupce do
+uvozovek (obyčejných, ne českých).
+
+<p>Běžné tabulkové kalkulátory (třeba Excel nebo LibreOffice Calc) umí v CSV ukládat.
+Každý z nich ale má svou vlastní variantu formátu (třeba se středníky místo čárek).
+Proto si můžete při importu variantu vybrat.
 
 <p>První řádek tabulky obsahuje názvy sloupců. Ty najdete v šabloně, kterou si
-můžete stáhnout ze stránky importu. Názvy neměňte.
+můžete stáhnout ze stránky importu. Názvy neměňte. Na pořadí sloupců nezáleží;
+když přidáte vlastní sloupce s novými názvy, budou se ignorovat.
+
+<h2>Import účastníků</h2>
 
 <p>Definovány jsou tyto sloupce (tučné jsou povinné):
 
@@ -32,4 +41,30 @@ můžete stáhnout ze stránky importu. Názvy neměňte.
 rozporu mezi importovanými údaji a již známými import selže a je nutné provést
 editaci ručně.
 
+<h2>Import dozoru</h2>
+
+<p>Definovány jsou tyto sloupce (tučné jsou povinné):
+
+<table class=data>
+	<tr><th>Název<th>Obsah
+	<tr><td><b>email</b><td>E-mailová adresa
+	<tr><td><b>krestni</b><td>Křestní jméno
+	<tr><td><b>prijmeni</b><td>Příjmení
+	<tr><td><b>kod_mista</b><td>Kód soutěžního místa (viz katalog škol na tomto webu)
+</table>
+
+<h2>Import opravovatelů</h2>
+
+<p>Definovány jsou tyto sloupce (tučné jsou povinné):
+
+<table class=data>
+	<tr><th>Název<th>Obsah
+	<tr><td><b>email</b><td>E-mailová adresa
+	<tr><td><b>krestni</b><td>Křestní jméno
+	<tr><td><b>prijmeni</b><td>Příjmení
+	<tr><td>kod_oblasti<td>Pokud neimportujete do konkrétní soutěže, ale do celého kola,
+		můžete uvést kód oblasti, ve které opravovatel pracuje.
+		V opačném případě bude mít práva ke všem oblastem.
+</table>
+
 {% endblock %}