svennickel
49ce079900
Im Je-Satz-Modus ist die Satzdifferenz nach der Spielpunkte-Differenz vollstaendig redundant (Spielpunkte-Differenz = 2 x Satzdifferenz) — die naechste Stufe, die wirklich trennt, sind die Tore (#306-Konzept, Abschnitt 0 und 3). Die Sortierung haengt am MODUS, nicht an neuen tabellenwertung- Werten: so wirkt die Tore-Stufe automatisch in Differenz-, Quotienten-, Buchholz- und Direktvergleichs-Varianten, ohne die Auswahlliste zu verdoppeln. getTabelleSpieltag(), teamstatistikAktualisieren() und getTabelleDirekterVergleich() ermitteln die Wertung des Modus jeweils per eigenem kleinen SELECT und schieben bei Wertung 4 die Stufe tore_differenz DESC (bzw. tore_quotient) ZWISCHEN Spielpunkte und Punkte; die Satz-Stufe bleibt als letzter Tie-Break dahinter — sie schadet nie, und solange Tore noch NULL sind, ordnet die Tabelle exakt wie bisher. Die Summen entstehen als SUM ueber CASE je Begegnung ohne COALESCE: NULL traegt nichts bei, unbekannt wird niemals 0:0. Die Platzvergabe (geteilte Plaetze) beachtet die Tore an beiden Stellen (teamstatistik und HTML-Tabelle) mit — ohne das teilten sich zwei nur durch Tore getrennte Teams Platz 1, gemessen am Zwischenstand dieses Schrittes. Die HTML-Tabelle zeigt die neue Stufe: im Je-Satz-Modus steht zwischen der Saetze- und der Spiele-Spalte eine Tore-Spalte (Differenz bzw. Quotient, absolut als Tooltip/Beiwert, "-" wo Tore unbekannt sind). Die JSON-Ansicht bekommt die tore_*-Felder additiv ueber die ohnehin rohen Team-Zeilen. Fuer alle anderen Modi entsteht BYTEIDENTISCHES SQL — nicht behauptet, sondern geloggt: beide Fassungen im Testserver mit einem Query-Log instrumentiert, 18 getTabelleSpieltag-Aufrufe (9 Ligen x 2 Spieltage) und 19 teamstatistik-Laeufe verglichen. Saemtliche Unterschiede betreffen ausschliesslich die Je-Satz-Liga (2 Zusatzspalten, 2 Subselects, eine ORDER-Stufe); jede Query einer Nicht-4-Liga ist Byte fuer Byte gleich. Dazu dieselbe Messlatte wie bisher: 11 Modi + 11 Begegnungen unveraendert gespeichert, Datenbank-Dump (778 Zeilen): 0 Unterschiede; Frontend-Dump (9 Ligen x 3 Ansichten + 8 Statistiken): jede Abweichung ist eine HINZUGEKOMMENE Zeile der Tore-Spalte der Je-Satz-Liga, keine einzige bestehende Zeile geaendert oder entfernt. Und der Fall, fuer den die Stufe da ist, ist konstruiert und gemessen (Prueflige H): eine Remis-Begegnung, beide Teams mit Begegnungspunkten 1, Spielpunkte-Differenz 0 und Satz-Differenz 0, aber Toren 35:34 gegen 34:35. Alte Kette: beide Platz 1, alphabetisch sortiert (Adler vor Zebras). Neue Kette: Zebras (+1 Tore) Platz 1, Adler (-1) Platz 2 — in team.platz wie in der angezeigten Tabelle.
SportsManager
DEV/STAGE environments
| LV | HOSTER | DOMAIN | BRANCH |
|---|---|---|---|
| DTFB | Kicktemp | stage.dtfb.de | dev |
| TFVHH | Kicktemp | stage.kickern-hamburg.de | dev |
| STFVH | DTFB | stage.stfv.de | sportsmanager2-stage |
| MTFV | DTFB | stage.mtfv.de | ? |
| TFVSH | DTFB | relaunch.tfvsh.de | ? |
PROD environments
| LV | HOSTER | DOMAIN | BRANCH |
|---|---|---|---|
| DTFB | Kicktemp | dtfb.de | production |
| TFVHH | Kicktemp | kickern-hamburg.de | production |
| MTFV | DTFB | mtfv.de | sportsmanager2-prod |
| TFVSH | DTFB | tfvsh.de | sportsmanager2-prod |
| STFVH | DTFB | stfv.de | sportsmanager2-prod |
Test setup
Installation
To start joomla and the database, run
docker-compose up -d
Release creation
To create a release execute
npm run release
Deployment
Deployment can only be done manually right now (sad)
To do this go to
Testserver Extension Installer Site
and upload the zip file found in ./package/packages
Development Tools
If you are using Intellij, there is a plugin named Joomla! which helps with resolving
joomla specific database prefixes like #__
To set it up, insert into the configuration popup which follows after you enable the framework support:
Joomla install path: ./data/joomla_data
JConfig: ./data/joomla_data/configuration.php
This works only with mounted volumes. However, mounted volumes will slow down the joomla instance significantly.
The current setup does not use mounted volumes. An alternative would be to download joomla and use that installation
Debugging (with Docker/Intellij)
-
Start Docker Container (see above)
-
Create a terminal for that container
docker exec -it <container_name> bash -
install xdebug within the container since joomla does not come with xdebug preinstalled
pecl install xdebug -
restart the container
-
In Intellij Go to File | Settings | Languages & Frameworks | PHP | Servers and setup your server
name anything host localhost port 8080 debugger xdebug use the path mapping and map the repo structure to the container content
File/Directory path on server <path>/com_sportsmanager/src/structure/administrator/components /var/www/html/administrator/components <path>/com_sportsmanager/src/structure/components /var/www/html/components -
Click on "Start Listening for PHP Debug Connections" in the top row of intellij
-
(Not sure if optional) Install a browser extension by Jetbrains
https://chromewebstore.google.com/detail/xdebug-helper-by-jetbrain/aoelhdemabeimdhedkidlnbkfhnhgnhm
How to release
Hint: for technical details regarding the release process have a look into .github/...
To create a release these steps need to be followed
- make sure all needed code changes are merged from dev -> stage -> prod, since releases may only be build on prod branch
- give pull requests meaningful names and label them enhancement/bug/chore since labels and names are used for release note generation Hint: if a specific pull request should be ignored, add the label changelog-ignore
- tag a commit (recommended is the latest merge on prod). The pipeline is listening for any tag fitting
v[0-9]+.[0-9]+.[0-9]+git tag -a v1.2.3 1a2b3c4 -m "Release version 1.2.3" - push the tag
git push origin --tags - the tag push will trigger the pipeline, and it will create the release and store in GitHub
A release can be created again anytime by deleting the release from GitHub, deleting the tag (from GitHub and additionally from git) and repeating step 3 and 4
Further: merges from dev to stage and from stage to prod can only be done by creating pull requests. These pull requests will be automatically labeled as changelog-ignore