summaryrefslogtreecommitdiff
path: root/CONFIG
blob: c1e6e3292d92d29cf436fbe1fb96d0c36e81627e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
JFR Teamy - play-off - plik konfiguracyjny
==========================================

Przykładowy plik konfiguracyjny, który służył do wygenerowania [przykładów](https://emkael.info/brydz/playoff/), umieszczono w całości u dołu tego pliku.

Ogólny format
-------------

Plik konfiguracyjny jest formatu JSON - a to oznacza na przykład, że trzeba pilnować backslashów wewnątrz łańcuchów znaków.
Na przykład - backslashe w konfiguracji logo nagłówka są podwojone. Szczególnie należy na to uważać przy podawaniu ścieżek do pliku wyjściowego.

Opcje ogólne
------------

Konfiguracja składa się, po kolei, z:
 - pola `"output"`: ścieżki do pliku, do którego będzie generowana drabinka.
   Polecam ścieżkę bezwzględną do katalogu WWW turnieju.
   W ścieżce musi znajdować katalog `sklady/`, do którego kopiowany jest JavaScript `playoff.js`
 - sekcji `"page"`: ustawień strony
   + `"title"` - tytuł (`<title>` HTMLa)
   + `"logoh"` - nagłówek, jak w tabeli admin bazy turnieju
   + `"refresh"` - parametr odświeżania strony drabinki: `0` = wyłączone, liczba naturalna = interwał odświeżania, w sekundach
   + `"width"` i `"height"` - wymiary (w pikselach) miejsca rezerwowanego dla każdego meczu w widoku drabinki (`"width"` bezpośrednio wpływa na rozmieszczanie kolumn, wewnątrz każdej z kolumn mecze rozmieszczane są równomiernie, w zależnie od ich liczby)
   + `"margin"` - odstęp między w/w miejscem (minimalny - jak widać, w przypadku mniejszej liczby meczów w fazie, odstępy się dopasują)
 - sekcji `"database"`, zawierającej ustawienia połączenia bazy danych
 - sekcji `"goniec"`, zawierającej ustawienia Gońca (`"enabled"` przyjmuje wartości `0`/`1`)

Ustawienia teamów
-----------------

Dalej mamy sekcję `"teams"`, która jest pierwsza do przebudowy (albo do odstrzału, w ogóle), więc zbytnio nie przyzwyczajałbym się do jej struktury.

W niej definiujemy teamy w kolejności, wg której mają być rozdzielane miejsca (w sytuacjach "przegrani zajmują miejsca...").

Każdy team to tablica, kolejno: pełnej nazwy (tej, która MUSI się zgadzać z nazwami we wszystkich turniejach), skróconej nazwy, pliku flagi (opcjonalnie).

Jako czwarty element każdej tablicy można wpisać liczbę naturalną, która oznacza pozycję, jaką team ma zająć w końcowej klasyfikacji (tj. wpisanie tam liczby oznacza, że team od samego początku umieszczany jest na tej pozycji w klasyfikacji końcowej - np. jeśli nie uczestniczy w ogóle w play-off).

Co zrobić, gdy jest taki team, a turniej nie ma ustawionych obrazków z flagami - nie wiem, będę się martwił kiedy indziej.

Ustawienia drabinki
-------------------

Sekcja `"phases"` definiuje już samą drabinkę.

Jest to tablica obiektów - każdy obiekt to kolejna faza (kolumna) drabinki.

Faza ma następujące pola:
 - `"title"` - etykieta fazy, wyświetlana u góry jako link do wyników szczegółowych danej fazy
 - `"link"` - w/w link (ale linki do poszczególnych meczów generują się na podstawie informacji pobranych z bazy, dopóki wszystkie turnieje, których mecze wchodzą w skład danej fazy, są wysyłane do jednej ścieżki)
 - tablicę `"matches"`, definiującej mecze w fazie

Ustawienia kozy (co meczy)
--------------------------

Mecz ma następujące pola:
 - `"id"` - identyfikator meczu (liczbowy, musi być unikatowy)
 - `"database"`, `"round"` i `"table"` - określają, skąd brać dane meczu
 - `"teams"` określa, co ma się wyświetlić w przypadku, gdy z powyższego
zestawu pól nie da się pobrać informacji o meczu
  Jest to tablica dwóch elementów, które mogą być:
   + łańcuchem tekstowym - wówczas musi to być pełna nazwa teamu
   + obiektem, z możliwymi polami tablicowymi `"winner"` lub `"loser"` - oznacza to, że dane miejsce drabinki jest przeznaczone dla zwycięzców/przegranych w meczach o ID podanych w polu
 - opcjonalne, pola `"winner"` i `"loser"` - które z kolei w tym kontekście oznaczają, miejsca, które zajmują zwycięzcy/przegrani danego meczu w końcowej klasyfikacji

Na przykładach, pierwszy i ostatni mecz z poniższego pliku:

```
{
  "id": 1,
  "database": "iiild_po_1",
  "round": 1,
  "table": 1,
  "teams": [
    "CKM Łódź",
    "MKS Bzura I Ozorków"
  ],
  "loser": [7, 8]
}
```

Mecz nr 1, pobierany z turnieju `iiild_po_1`, ze stołu nr 1 w pierwszej rundzie.

Gdyby turniej nie był gotowy i rozstawiony, i tak wiadomo, że w meczu gra CKM z Bzurą.

W końcu, przegrany tego meczu zajmie jedno z miejsc 7-8.
Tu uwaga: jeśli okaże się, że żaden inny mecz nie ma dokładnie tego samego warunku - miejsc 7-8 - klasyfikacja prawdopodobnie nie wypełni się, tj. nie można określić, że przegrany jednego meczu zajmie miejsca 7-8, drugiego 8-9, a trzeciego 9-10 i liczyć, że program sam rozwiąże zagadkę.

```
{
  "id": 14,
  "database": "iiild_po_4",
  "round": 1,
  "table": 2,
  "teams": [
    { "loser": [11, 12] },
    { "loser": [11, 12] }
  ],
  "winner": [15],
  "loser": [16]
}
```

Mecz nr 14 to mecz z drugiego stołu pierwszej rundy turnieju `iiild_po_4`.

Miejsca w tym meczu zajmują przegrani meczów o ID 11 i 12 (przy czym gospodarze/goście są nieznani dopóki turniej nie zostanie rozstawiony w bazie).

Zwycięzca zajmie 15. miejsce w lidze, a przegrany - 16.

Pełen plik konfiguracyjny
-------------------------

```
{
    "output": "D:/Brydz/Teamy/www/liga_playoff_12.html",
    "page": {
        "title": "III liga 2016/17, WZBS Łódź, play-off",
        "logoh": "<span id=\"logo\"></span><script type=\"text/javascript\">loadIt('liga_logo.html','logo');</script>",
        "refresh": 0,
        "width": 200,
        "height": 80,
        "margin": 70
    },
    "database": {
        "host": "localhost",
        "port": 3306,
        "user": "UŻYTKOWNIK BAZY",
        "pass": "HASŁO BAZY"
    },
    "goniec": {
        "enabled": 1,
        "host": "localhost",
        "port": 8090
    },
    "teams": [
        ["Mazowia Płock", "Mazowia", "herby/wp.png"],
        ["Jagielloński Ośrodek Kultury Łódź", "JOK", "herby/el.png"],
        ["KDK II Kutno", "KDK II", "herby/eku.png"],
        ["BINŻ Bełchatów", "BINŻ", "herby/ebe.png"],
        ["CKM Łódź", "CKM", "herby/el.png"],
        ["PTC - PAFANA I Pabianice", "PTC", "herby/epa.png"],
        ["Intra Łódź", "Intra", "herby/el.png"],
        ["BOK Rondo Łódź", "Rondo", "herby/el.png"],
        ["MKS Bzura I Ozorków", "Bzura", "herby/ezgozo.png"],
        ["Zdrowie Piast Sieradz", "Piast", "herby/esi.png"],
        ["Olimpia Chąśno", "Olimpia", "herby/elc.png"],
        ["Brydż Quartet Lechia Tomaszów Mazowiecki", "Lechia", "herby/etm.png"],
        ["Veolia Energia Łódź", "Veolia", "herby/el.png"],
        ["Ekolog Łódź", "Ekolog", "herby/el.png"],
        ["KDK III Kutno", "KDK III", "herby/eku.png"],
        ["Pomiar - Ceemka Opoczno", "Ceemka", "herby/eop.png"]
    ],
    "phases": [
        {
            "title": "25.02.2017",
            "link": "http://arturwasiak.republika.pl/brydz/sedzia/3liga_2016_17/faza_3/liga_runda1.html",
            "matches": [
                {
                    "id": 1,
                    "database": "iiild_po_1",
                    "round": 1,
                    "table": 1,
                    "teams": [
                        "CKM Łódź",
                        "MKS Bzura I Ozorków"
                    ],
                    "loser": [7, 8]
                },
                {
                    "id": 2,
                    "database": "iiild_po_1",
                    "round": 1,
                    "table": 2,
                    "teams": [
                        "PTC - PAFANA I Pabianice",
                        "Intra Łódź"
                    ],
                    "loser": [7, 8]
                },
                {
                    "id": 3,
                    "database": "iiild_po_1",
                    "round": 1,
                    "table": 3,
                    "teams": [
                        "BOK Rondo Łódź",
                        "KDK III Kutno"
                    ],
                    "winner": [9, 10]
                },
                {
                    "id": 4,
                    "database": "iiild_po_1",
                    "round": 1,
                    "table": 4,
                    "teams": [
                        "Zdrowie Piast Sieradz",
                        "Ekolog Łódź"
                    ],
                    "winner": [9, 10]
                }
            ]
        },
        {
            "title": "26.02.2017",
            "link": "http://arturwasiak.republika.pl/brydz/sedzia/3liga_2016_17/faza_4/liga_runda1.html",
            "matches": [
                {
                    "id": 5,
                    "database": "iiild_po_2",
                    "round": 1,
                    "table": 1,
                    "teams": [
                        "BINŻ Bełchatów",
                        { "winner": [1, 2] }
                    ],
                    "loser": [5, 6]
                },
                {
                    "id": 6,
                    "database": "iiild_po_2",
                    "round": 1,
                    "table": 2,
                    "teams": [
                        "KDK II Kutno",
                        { "winner": [1, 2] }
                    ],
                    "loser": [5, 6]
                },
                {
                    "id": 7,
                    "database": "iiild_po_2",
                    "round": 1,
                    "table": 3,
                    "teams": [
                        "Pomiar - Ceemka Opoczno",
                        { "loser": [3, 4] }
                    ],
                    "winner": [11, 12]
                },
                {
                    "id": 8,
                    "database": "iiild_po_2",
                    "round": 1,
                    "table": 4,
                    "teams": [
                        "Olimpia Chąśno",
                        { "loser": [3, 4] }
                    ],
                    "winner": [11, 12]
                }
            ]
        },
        {
            "title": "08.04.2017",
            "link": "http://arturwasiak.republika.pl/brydz/sedzia/3liga_2016_17/faza_5/liga_runda1.html",
            "matches": [
                {
                    "id": 9,
                    "database": "iiild_po_3",
                    "round": 1,
                    "table": 1,
                    "teams": [
                        "Mazowia Płock",
                        { "winner": [5, 6] }
                    ],
                    "loser": [3, 4]
                },
                {
                    "id": 10,
                    "database": "iiild_po_3",
                    "round": 1,
                    "table": 2,
                    "teams": [
                        "Jagielloński Ośrodek Kultury Łódź",
                        { "winner": [5, 6] }
                    ],
                    "loser": [3, 4]
                },
                {
                    "id": 11,
                    "database": "iiild_po_3",
                    "round": 1,
                    "table": 3,
                    "teams": [
                        "Veolia Energia Łódź",
                        { "loser": [7, 8] }
                    ],
                    "winner": [13, 14]
                },
                {
                    "id": 12,
                    "database": "iiild_po_3",
                    "round": 1,
                    "table": 4,
                    "teams": [
                        "Brydż Quartet Lechia Tomaszów Mazowiecki",
                        { "loser": [7, 8] }
                    ],
                    "winner": [13, 14]
                }
            ]
        },
        {
            "title": "09.04.2017",
            "link": "http://arturwasiak.republika.pl/brydz/sedzia/3liga_2016_17/faza_6/liga_runda1.html",
            "matches": [
                {
                    "id": 13,
                    "database": "iiild_po_4",
                    "round": 1,
                    "table": 1,
                    "teams": [
                        { "winner": [9, 10] },
                        { "winner": [9, 10] }

                    ],
                    "winner": [1],
                    "loser": [2]
                },
                {
                    "id": 14,
                    "database": "iiild_po_4",
                    "round": 1,
                    "table": 2,
                    "teams": [
                        { "loser": [11, 12] },
                        { "loser": [11, 12] }
                    ],
                    "winner": [15],
                    "loser": [16]
                }
            ]
        }
    ]
}
```