summaryrefslogtreecommitdiff
path: root/README.md
blob: a7e4f531c8f92a2e8cbe4001864e959a71bc6781 (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
# teamy-diff-deals

Program umożliwia wyświetlenie w protokole JFR Teamy na stronie wielu rozkładów rozdań, tj. innego rozkładu dla każdego stołu (lub tylko dla wybranych stołów).

Program wyświetla rozkład rozdania przy danym stole, jeśli oba zapisy z tego meczu widnieją już w protokole. 
Może to być zachowanie niewystarczające, gdy rozkład jest przeznaczony nie tylko dla tego jednego meczu, ale również dla kolejnych, widniejących niżej w protokole.

## Instalacja

W katalogu z plikami html na serwerze należy umieścić .htaccess oraz pliki PHP, a także w odpowiednich katalogach dodatkowe pliki CSS/JS.
Reguła w .htaccess zapewnia, że zapytania do plików HTML z protokołami są przekierowywane do tdd-protocol.php, który podejmuje niezbędne działania.

## Dodanie rozkładów

W Adminie nie podpina się do turnieju żadnych rozkładów.

Pliki PBN z rozkładami należy wrzucić na serwerze pod ściśle określonymi nazwami. 
Dostęp do plików PBN przez HTTP jest zablokowany dyrektywą w .htaccess, ale należy to przetestować w przypadku korzystania z serwera z niestandardową konfiguracją.

Nazwy plików na FTP muszą być następującej postaci:
```
{PREFIKS}-r{RUNDA}-t{STÓŁ}-b{OD_ROZDANIA}.pbn
```

gdzie:

* {PREFIKS} - prefiks plików turnieju generowanych przez Admina,
* {RUNDA} - numer rundy w Adminie, w play-offach to zawsze będzie 1,
* {STÓŁ} - numer stołu, dla którego przeznaczone są rozkłady,
* {OD_ROZDANIA} - wskazanie rozdania w meczu, dla którego przeznaczone jest pierwsze rozdanie z tego pliku pbn.

Na przykład turniej o prefiksie "nepo1" z 5 różnymi zestawami rozdań dla kolejnych stołów wymaga dodania następujących plików z rozkładami:

```
nepo1-r1-t1-b1.pbn
nepo1-r1-t2-b1.pbn
nepo1-r1-t3-b1.pbn
nepo1-r1-t4-b1.pbn
nepo1-r1-t5-b1.pbn
```

W przypadku, gdy w meczu 48-rozdaniowym numeracja rozdań to 1-24 i 1-24, to plik PBN z tymi ostatnimi 24 rozdaniami nazywa się "nepo1-r1-t1-b25.pbn" (pierwsze rozdanie z tego pliku stanowi 25. z kolei rozdanie meczu).

## Znane problemy

* brak obsługi dwucyfrowych numerów rund - [#1](https://github.com/michzimny/teamy-diff-deals/issues/1)