Řešení pro podporu vytváření soupisek družstev pro šachové soutěže Ceského šachového svazu

Cílem je udržet přehled o soupiskách a hráčích. Tedy abychom na nikoho nezapomněli a současně nebyl žádný hráč na více soupiskách, než je povoleno.

Současně vypočítá písmenka v soupisce včetně V - volných hráčů z Z - základ Obsahuje i kontrolu na hostování - zda jsou podané všechny žádosti a zda jsou vyřízené.

Admin může provádět všechny úpravy. Kapitáni družstva můžou provádět jen přesuny na soupisce družstva. Členové můžou jen prohlížet soupisky a podávat žádosti k změne.

Testovací instalace

Testovací instalace je v http://sachy-druzstva.borec.cz/

Instalace

1) vyžaduje web server s instalovanou JOOMLA (https://www.joomla.org/) 2) Nahrat balíček (soubor com_druzstva.zip) do System - Extension

Historické instalační balíčky

package.ps1 před sestavením uchová dosavadní com_druzstva.zip a po sestavení archivuje i nový balíček.

• Základní název: com_druzstva-1.2.0.zip.
• Další odlišná sestavení stejné verze: název doplněný časem a částí SHA-256.
• Identický soubor se znovu neukládá. Existující archivy se nikdy nepřepisují.
• Vedle každého ZIP je kontrolní součet .sha256.

Archivuje se skutečný instalační ZIP, nikoli pouze zdrojový kód. Archivace nezaručuje, že každé sestavení bylo nasazeno na live; některá jsou lokální testovací sestavení. Starší verze, jejichž ZIP už není k dispozici, se zpětně nevytvářejí. Instalace staršího balíčku není automatickým vrácením databáze.

Ověřená nasazení

• 2026-11-01: 1.3.3 Tlačítko pro smazání všech dat, domovské družstvo jde nastavit na stránce Kluby
• 2026-10-24: 1.3.1 nasazena na live z archivu com_druzstva-1.3.1.zip (SHA-256 4b137c8ece7bd1dac68f5a14eae7075374ed34cf260eb3fbdc9d45614b0881ff). Joomla hlásila úspěšnou instalaci a „Uložená data zůstala zachována“. Po instalaci Info uvádí 1.3.1; editace zůstala OFF, domovský oddíl 11011. Podmenu Hostování nemá žádné akční položky, Kontrola hostování zůstala a její stránka vrací HTTP 200; položky A zůstaly stejné jako před instalací. Žádná aktualizace hráčů, import ani kontrola hostování nebyly spuštěny.
• 2026-10-24: připraven 1.3.1. Při aktualizaci instalátor odstraní všechny přímé položky podmenu soupisky Hostování (včetně případných vnořených položek), a už je znovu nevytváří. Samostatná sesterská položka Kontrola hostování zůstává; běžná podmenu ostatních soupisek se nemění. Migrace je opakovatelná. Prošlo lint 78 PHP, všech 49 PHP + 2 JS testů; nový test pokrývá odstranění akcí, zachování cizí soupisky/Kontroly hostování a idempotenci. Balíček com_druzstva-1.3.1.zip; lokální instalace ani live nasazení zatím neproběhly.
• 2026-10-24: připraven balíček 1.3.0 (lokální zdroj a instalační ZIP; instalaci ani live nasazení tato GO nepožadovala). Při vypnuté editaci skrývá na stránce soupisky submenu všechny volby s mode kromě copy; nadřazené odkazy soupisek a Kopírovat zůstávají, Joomla menu záznamy se nemažou a při ON se nabídka obnoví. Oprávnění serverových úloh zůstávají beze změny. Lint 78 PHP souborů a všech 48 PHP + 2 JS testů prošly. Archiv se sestavil do oddělené cesty, protože pracovní com_druzstva.zip je OneDrive zámkem chráněn; balíček releases/com_druzstva-1.3.0.zip, SHA-256 2c85b1631f7064dce40859bb54f229f5650f0823068b22e01021ac7e3970e383.
• 2026-10-24: následná stylová revize PHP 1.3.0: v Soupiska/HtmlView.php a šabloně soupiska/default.php doplněn strict typing tam, kde je kompatibilní, typované vlastnosti/closures a čitelnější PER formátování. Frameworkový override display ponechává parametr bez typu kvůli rodičovské signatuře; návrat je mixed kvůli zachování kompatibility testovacího/view API. Prošlo všech 48 PHP + 2 JS testů a lint 78 PHP souborů. Aktualizovaný archiv: com_druzstva-1.3.0-20261024-212458-a2ebe40b73f4.zip, SHA-256 a2ebe40b73f4c4ffdf5df0e1b5b2a677db8c6f23a267a97074ed1958b327c240. Znovu se neinstaloval.
• 2026-10-24: 1.2.38 nainstalována a ověřena lokálně, archiv com_druzstva-1.2.38.zip, SHA-256 a6ea2e41ea0fb444c20fd6e5d1d63bc2eb05409e056766e1f963d98bfc6a00d2. Komponenta i balíček hlásí 1.2.38, Intro plugin 1.1.1. Nastavení dle GO: přepínač nahoře, editační workflow v požadovaném pořadí, při OFF jen načtení kalendáře, oddělovač a nástroje soupisek/exportů. Zachován ODS (po upřesnění uživatele, nikoli ODT) a PDF jako dosavadní přehled hráčů. Aktualizační podmenu Kluby/Hraci SSCR odstraněna (lokální ID 111/112); seznamové stránky i přímé obsluhy zachovány. Stránky projektu jsou na Intro pod verzí bez přepsání článku; Zdroj dat oddílu odstraněn z Nastavení. Prošlo 48 PHP + 2 JS testů a lint 78 PHP souborů. Browser ověřil ON/OFF, 9 popisů pod verzí, ODS download 200 (65 807 B) a PDF přehled 200. Snapshot settings-138-before-20261024-v2.json potvrzuje zachování původních komponentových tabulek, členství/skupin, článků (kromě automatického modified času), 1002 kalendářních zápasů a zbývajících frontendových menu. Joomla regenerovala ID backendové položky komponenty, její ostatní metadata se shodují. Lokální editace po testu vrácena na původní ON. Žádné aktualizace zdrojů, importy, změny hráčů ani kontroly nebyly na skutečných datech spuštěny. Na live se nesahalo.
• 2026-10-23: 1.2.37 nasazena na live, SHA-256 02cc4b2dccd21a09f7976d0089da84d583b1d71946f74ef597182e71b71bbdf6. Instalátor uspěl; komponenta i balíček ověřeny na 1.2.37. Před/po snímky všech osmi soupisek, Oprav, nastavení, seznamu hráčů a reportu jsou identické. Bezpečný GET task=hraci.update bez POST tokenu zastaven na guardu: HTTP 403, vlastní obrazovka „Aktualizace hráčů není povolena.“ a tlačítko Zpět, bez „Stránka nenalezena“. Aktualizace/import nebyly spuštěny; starším Opravám se LOK doplní až při příští řádně spuštěné aktualizaci.
• 2026-10-23: připravena 1.2.37, SHA-256 02cc4b2dccd21a09f7976d0089da84d583b1d71946f74ef597182e71b71bbdf6. Read-only kontrola live nalezla starší Opravu Czop/1988 bez LOK/FIDE. Oprava 1.2.35 řešila jen nově přidané záznamy; 1.2.36 zachytávala jen display, nikoliv hraci.update. Nově společný Site Dispatcher zachytává i výjimky akcí, odstraní částečný výstup a vykreslí escapovanou chybu se Zpět, bez změny JSON. Před aktualizací doplní starším Opravám volné LOK od 999900 v transakci; čísla zůstanou stabilní i při následném neúspěšném importu. Přidání i úprava Opravy bez LOK používají stejný generátor. Testy helperu (kolize/rollback/opakování), dispatcheru a skutečné lokální Joomla (chybná akce + hraci.update bez tokenu, bez importu), regresní testy a lint prošly. Balíček není nainstalován lokálně ani na live; live data nebyla měněna a aktualizace nebyla spuštěna.
• 2026-10-23: 1.2.36 nasazena na live, com_druzstva-1.2.36.zip SHA-256 15adf308788ab2a5dab7075f850f63e944691615fa749c70b2be3ec5a716f953. Instalátor uspěl; komponenta i balíček ověřeny na 1.2.36. Frontendové snímky před/po jsou identické: A–HOST 20/20/20/18/17/20/20/7 hráčů, Opravy 19, nastavení editace ON a oddíl 11011, včetně hodnot buněk a polí. Kalendář zůstává kvůli zapnuté editaci HTTP 403; přepínač nebyl změněn. Bez importů či editace dat.
• 2026-10-23: 1.2.36 nainstalována lokálně, com_druzstva-1.2.36.zip SHA-256 15adf308788ab2a5dab7075f850f63e944691615fa749c70b2be3ec5a716f953. Instalátor uspěl; komponenta i balíček ověřeny na 1.2.36. Před/po DB kontrola potvrdila beze změny opravy (5), SSČR hráče (26 267), seznam (55), soupisky (8/44), kalendář (2 importy/1002 zápasů), kluby, nastavení a reporty. Automaticky se změnil pouze modified čas Intro článku.
• 2026-10-23: 1.2.35 nainstalována lokálně, com_druzstva-1.2.35.zip SHA-256 a8f0f612eec6eedcd401a7faa148a3a984d3936ae3bb67f8816e9b64a9868cfe. Instalátor potvrdil úspěch; komponenta i balíček hlásí 1.2.35. Před/po databázová kontrola: opravy (5), hráči SSČR (26 267), seznam (55), soupisky (8/44), kalendářní importy/zápasy (2/1002), kluby, nastavení a reporty beze změny. Joomla automaticky aktualizovala pouze modified čas Intro článku.
• 2026-10-21: 1.2.34 nasazena na live, archiv com_druzstva-1.2.34.zip (SHA-256 f4d37d8102f95beaeb1b2b25123ab24ed91d2dc8d52c9ee2bae52996d86dcdc5). Instalátor úspěšný, komponenta i balíček 1.2.34 ověřeny. Fresh pre/post frontendové snímky shodné ve všech datech: A–HOST 20/20/20/19/17/20/19/7, 68 hráčů seznamu, 18 oprav, reporty 22+7, nastavení editace ON/oddíl 11011 a všechny buňky/poznámky/checkboxy. Kalendář zůstal nedostupný HTTP403 kvůli ponechané editaci ON; přepínač nebyl změněn, takže nový sloupec se na live projeví po uzamčení a při zápasech kalendáře. Žádné importy, úpravy, přesuny ani kontroly nebyly spuštěny. Live nyní1.2.34.
• 2026-10-21: 1.2.34 nainstalována lokálně, archiv com_druzstva-1.2.34.zip. Lokální editace zůstala OFF/oddíl 11011; A zobrazuje 11 zápasů a Další soupisky (např. Svatoš Jan B-9, Sandvik Thomas B-2), bez Změna/Hotovo. Před/po DB: 8 soupisek, 44 hráčů, 55 seznamu, 26 267 SSČR hráčů, 496 klubů, 5 oprav, reporty/nastavení/členství a 2 importy/1002 zápasů beze změny; jen automatický Intro modified timestamp.
• 2026-10-21: zdroj/balíček 1.2.34 (SHA-256 f4d37d8102f95beaeb1b2b25123ab24ed91d2dc8d52c9ee2bae52996d86dcdc5). Při editaci ON zůstávají Změna/Hotovo; při OFF jsou skryté a pouze při zápasech zobrazeného kalendáře se ukáže Další soupisky (E-3, G-5). Párování LOK, poté FIDE ID; bez odhadu podle jména. Aktuální soupisku a HOST vynechá. Bez změny DB; testy membership, permissions/UI, kalendář, limity, lint prošly.
• 2026-10-21: 1.2.33 nainstalována lokálně, archiv com_druzstva-1.2.33.zip (SHA-256 90f3eba861a28086c4810447e4481792ddd707712aeba92f97815dbb61a1283c). Opraven přetékající formulář Uprav: tlačítko rozbalí samostatný editační řádek přes celou šířku tabulky, Smaž zůstává viditelné v akční buňce. PHP/UI/CRUD/regresní testy prošly. Prohlížeč ověřil rozbalení skutečného zápasu, čitelná pole ve třech řádcích bez překryvů; data se při kontrole neuložila. Instalátor úspěšný, komponenta/balíček 1.2.33 ověřeny. Před/po snímek potvrdil nezměněná původní data včetně 2 importů/1002 zápasů a nastavení; pouze Intro modified čas aktualizoval instalátor. Live zůstává 1.2.30.
• 2026-10-21: 1.2.32 nainstalována lokálně, archiv com_druzstva-1.2.32.zip (SHA-256 fc5397c822f5ce9d245dc5272a004bc8c6aa471adb5773ba6211ad76d10468fa). Navazuje na kalendářní CRUD 1.2.31 a upravuje workflow dle uživatele: administrátor nahrává i ručně mění kalendář až po uzamčení soupisek; zámek se ověřuje v transakci. Ostatní role zůstávají read-only. Testy importu při ON/OFF, rolí/UI, validace a kalendáře i PHP lint prošly. Instalátor úspěšný, Správce rozšíření potvrzuje komponentu i balíček 1.2.32. Před/po DB snímek potvrdil nezměněných 8 soupisek, 44 hráčů soupisek, 55 řádků seznamu, 26 267 SSČR hráčů, 496 klubů, 5 oprav, reporty, nastavení/členství i 2 importy/1002 zápasů kalendáře; změnil se pouze automatický čas modified Intro článku. Žádný přepínač, kalendářní import, úprava ani smazání nebyly provedeny. Live zůstává 1.2.30; 1.2.32 tam není nasazena.
• 2026-10-21: připraven lokální zdroj a instalační balíček 1.2.31, finální archiv com_druzstva-1.2.31-20261021-091209-86f17ebaf7f9.zip (SHA-256 86f17ebaf7f9ad739454a266bf9a5c9e97bc7f4cf335d9aa5368db855134403a). Kalendářní CRUD pouze pro administrátora při editaci OFF, přes POST+CSRF a transakční ověření zámku; lze ručně založit i první kalendář bez předchozího XLS. Nový/upravený/smazaný zápas se týká posledního importu; následující import přepíše zobrazený rozpis, starší snapshoty zůstávají. Nastavení nabízí potvrzované smazání všech zápasů i historie, nikoli soupisek. Kalendářní validační, role/UI, import, ICS a roster testy i PHP lint prošly. Na localhost ani live zatím neinstalováno.
• 2026-10-20: 1.2.30 nasazena na live na výslovné potvrzení uživatele, archiv com_druzstva-1.2.30.zip, SHA-256 a1d3ac2c3abd059101862583f6cb0d14bcfeb341e91dd4e4529e6b04c35e7b59. Řeší potvrzenou chybu CREATE TEMPORARY TABLES: instalátor založí persistentní staging, import používá pouze CRUD pod vlastním náhodným ID. Všech 39 PHP + 2 JS testů/lint prošlo, reálných 26 268 hráčů ve 106 dávkách (~34 MiB). První upload skončil HTTP 503 a ponechal komponentu 1.2.30/balíček 1.2.29; po ověření stavu proběhla jediná opakovaná idempotentní instalace úspěšně. Správce rozšíření potvrzuje komponentu i balíček 1.2.30; Nastavení hlásí 1.2.30. Čerstvé frontendové SHA-256 před/po jsou shodné pro všech 8 soupisek včetně ID, polí/poznámek, nastavení/pořadí (20/20/20/19/17/20/19/7), 68 hráčů seznamu, 18 Oprav a 28 řádků reportu. Editace ON, oddíl 11011 a dosud prázdný live kalendář beze změny. Žádná aktualizace hráčů, přesun či import nebyly při nasazení spuštěny; plný běh tlačítka na live proto čeká na uživatelské ověření. Lokální instalace tohoto stroje zůstává na 1.2.26.
• 2026-10-19: 1.2.29 nasazena na live, archiv com_druzstva-1.2.29.zip (SHA-256 f859e094e851b83e785fc3783e22634e4e7ac7d3c73eabe63602e273318b0494). Instalace úspěšná, komponenta i balíček 1.2.29 ověřeny. Jméno i záhlaví na soupisce A zůstaly vlevo a plně viditelné při maximálním vodorovném posunu 725 px, všech 20 jmen má připnutý sloupec. Čerstvý před/po snímek všech osmi soupisek (20/20/20/19/18/19/19/7), jejich polí/poznámek, 68 hráčů seznamu, 18 oprav a 20+7 řádků reportu souhlasí. Editace ON a oddíl 11011 beze změny; žádné importy, přesuny hráčů ani kontroly nebyly spuštěny.
• 2026-10-19: 1.2.28 nasazena na live, archiv com_druzstva-1.2.28.zip (SHA-256 d599b47fe713f48cf2c6f731b1bf5bf50aca0f7e60020e7b015c5d0cc4beb8a6). Instalátor úspěšný; komponenta i balíček 1.2.28 ověřeny ve správci rozšíření a verze v Nastavení. Před/po frontendový snímek potvrdil shodu všech osmi soupisek včetně polí/poznámek (20/20/20/19/18/19/19/7), seznamu 68 hráčů, 18 oprav a 20+7 řádků reportu. Editace zůstala ON, oddíl 11011 nezměněn. Bez importu kalendáře, změn hráčů či spuštění kontroly. Nové MHD vyžaduje opětovné nahrání XLS; export/uzamčený kalendář na live neověřován, protože jsme nepřepínali editaci.
• 2026-10-18: 1.2.26 nasazena na live, archiv com_druzstva-1.2.26.zip (SHA-256 FF3F6345DCB145DE8CEB6C454F88AD478E2BE7911077B2B3FC62E1C416165AF9). Instalace úspěšná; verze 1.2.26 ověřena v Nastavení. Změna šablony: při editaci OFF se schovají vysvětlující odstavce Změna/Hotovo/Poznámka, kalendářní výřez a soupisky zůstávají. Live editace byla ON a zůstala ON; při tomto stavu vysvětlení zůstává zobrazené. Před/po frontendové hashe B–HOST a Opravy souhlasí. Soupiska A a odvozený Seznam se liší od předinstalačního snímku; A se navíc změnila i mezi dvěma následnými čteními. Může jít o souběžnou editaci, takže zachování těchto dvou pohledů není potvrzeno; kontrola sama nic neměnila. Žádné úpravy hráčů, import ani kontrola hostování nebyly spuštěny.
• 2026-10-18: předchozí lokální instalace 1.2.26 zachována a ověřena; editace OFF na localhostu, vysvětlující odstavce skryté, kalendářní výřez zachovaný. Snímek calendar-126-before.json potvrdil komponentové tabulky a 501 kalendářních zápasů beze změny.
• 2026-10-18: lokálně ověřeno 1.2.25, balíček com_druzstva-1.2.25.zip. Kalendář má trvalý vertikální posuvník; při vypnuté editaci zobrazuje horní část soupisky rozpis odpovídajícího družstva včetně soupeře, místnosti a kolizí (ostatní družstva oddílu hrající ve stejný den). Soupiska A lokálně zobrazuje 11 utkání; 3 data mají kolize. Seznam kalendáře má 71 řádků v posuvné oblasti vysoké 576 px. Testy názvů, rozsahu oddílu, nejednoznačnosti a escapování prošly. Instalace úspěšná, před/po snímek potvrdil nezměněná původní data a 501 zápasů; editace zůstala vypnutá. Live zůstává 1.2.23.
• 2026-10-18: lokálně 1.2.24, přesný nainstalovaný archiv com_druzstva-1.2.24-20261018-145803-04e041f3c822.zip (SHA-256 začíná 04e041f3c822). Úsporný XLS import přes dočasnou MySQL tabulku, opravy přístupů a souběhu, SQL stránkování a ochrany čtečky; viz ../docs/revize-1.2.24.md. Instalátor úspěšný, snímek před/po potvrdil nezměněné komponentové tabulky, členství a historii 501 zápasů kalendáře. Editace zůstala vypnutá. Anonymní přímé URL vrací 403, přihlášené stránky a filtry fungují. Live zůstává 1.2.23; žádný skutečný import ani kontrola hostování při instalaci nespouštěny. Základní com_druzstva-1.2.24.zip je starší mezisestavení, nikoli tento ověřený balíček.
• 2026-10-18: live 1.2.23, přesný archiv com_druzstva-1.2.23-20261018-091825-6dff3f871f8b.zip. Položka menu Kalendář i odkaz Otevřít Kalendář na Nastavení jsou viditelné jen při vypnuté editaci. Srovnání před/po ověřilo shodu zobrazených řádků soupisek (20/20/20/19/18/19/19/7), seznamu 68 hráčů a 18 oprav. Předchozí poznámka o 501 kalendářních zápasech na live byla nepřesná: tato fixture je lokální; při předchozím nasazení byl live kalendář prázdný.
• 2026-10-18: lokálně ověřeno 1.2.22 (nenasazeno na live), balíček com_druzstva-1.2.22.zip. Kalendář má časovou vazbu na editaci: Nahrát kalendář jen při zapnuté Editaci povolena, vlastní stránka Kalendář jen při vypnuté editaci. Výběr domovského oddílu nad zdrojem dat. Původní data beze změny.
• 2026-10-18: live 1.2.21, balíček com_druzstva-1.2.21.zip. Výběr domovského oddílu na stránce Nastavení přesunut nad část ZDROJ DAT ODDÍLU; verze a rozvržení ověřeny, původní data beze změny.
• 2026-10-18: live 1.2.20, balíček com_druzstva-1.2.20.zip. Kalendář se sloupcem Hrací místnost, Info přejmenováno na Nastavení hned za Intro; původní soupisky, hráči, seznam a opravy zachovány. Kalendář zatím prázdný, čeká na nahrání XLS.

• 2026-10-16: live 1.2.18, balíček com_druzstva-1.2.18.zip. Oddíl za jménem v Seznamu hráčů, 68/68 hráčů s oddílem; původní hodnoty, soupisky, nastavení a výsledky kontroly zachovány.

• 2026-10-13: live 1.2.12, balíček com_druzstva-1.2.12.zip. Kompaktní soupiska s kódem v nadpisu a popisky před poli; data, nastavení a výsledky kontroly zachovány.

• 2026-10-13: live 1.2.11, balíček com_druzstva-1.2.11.zip. Domovský oddíl za Hráčem v Kontrole hostování; původní soupisky, nastavení a výsledky kontroly zachovány. Kontrola při nasazení nebyla spuštěna.

• 2026-10-13: live 1.2.10, balíček com_druzstva-1.2.10-20261013-202038-41466f60896d.zip. Hrací den a jednořádkové Stejné číslo hned pod Názvem družstva; původní hráči, nastavení, seznam, opravy a menu beze změny.

• 2026-10-12: live 1.2.9, balíček com_druzstva-1.2.9-20261012-200115-7bc8db767ca9.zip. Editovatelné nastavení soupisek, názvy v menu a dvouřádkové vystředěné záhlaví s dynamickou šířkou. Původní data ověřena beze změny.

• 2026-10-11: live 1.2.1, balíček com_druzstva-1.2.1.zip. Světle zelené řádky KA/ZK ověřeny; hráči, pořadí i spolupracovní pole všech soupisek zachovány.

• 2026-10-11: live 1.2.0, balíček com_druzstva-1.2.0-20261011-091205-bc793447fb2b.zip. Instalace úspěšná, původní hráči i pořadí všech soupisek zachovány.