# Handoff – Chronik des PBV Trier (Stand 23.09.2026) Dieses Dokument ist für eine neue Claude-Session (oder eine andere Person) gedacht, die an der Chronik weiterarbeitet. Es beschreibt Zweck, Aufbau, Konventionen, Arbeitsweise und offene Punkte. Der Ordner ist **in sich geschlossen** – alle Pfade in der Chronik sind relativ zu diesem Ordner, die Skripte finden ihre Dateien über ihren eigenen Speicherort. Er kann beliebig verschoben werden. ## 1. Worum es geht Der **Pool Billard Verband Bezirk Trier e.V. (PBV Trier)** organisiert seit 1983 den Pool-Billard-Ligabetrieb in der Region Trier. Auftraggeber ist **Marcus May, 1. Vorsitzender seit 16.06.2019**. Ziel: eine belastbare Vereinschronik aus fragmentierten Quellen (alte Website, Website-Datenbank, Vorstandsarchiv, Festschrift 2013, Ranglisten-Datenbank des Sportwarts, Cuescore-Turnierausdrucke), Saison für Saison mit Originaldokumenten und Fotos als Belege. ## 2. Was liegt hier | Datei / Ordner | Zweck | |---|---| | `Gesamtchronik.md` | **Quelle der Wahrheit.** Verbandsgeschichte, Meilensteine, Vorstandsübersicht, alle Saisons 1983/84–2026/27, Übersichtstabelle der Meister, Vereinsregister, Fotoarchiv, Quellen | | `Gesamtchronik.html` | Daraus generierte Web-Fassung (Inhaltsverzeichnis, Lightbox für Fotos, Medaillenfarben, Quellen-Chips). **Nie von Hand editieren** – nach jeder Änderung an der MD neu erzeugen | | `md_to_html.py` | Generator: `python md_to_html.py` (aus beliebigem Verzeichnis; nur Standardbibliothek). Erkennt die unten beschriebenen Markdown-Muster | | `Pruefbericht_Gesamtchronik.md` | Prüfprotokoll 17./18.09.2026 und 23.09.2026: alle Einzelbefunde, Korrekturen, Dateiprobleme und 16 Nachträge (u. a. Kap. 8 App-Datenbank, Kap. 11 entfernte Dokumente, Kap. 13 TRL-Datenbank, Kap. 14 Cuescore-PDFs und Abschlusstabelle 2015/16, Kap. 15 Umbenennung, Kap. 16 alte Website). Kap. 1–14 nennen die **alten** Dateinamen und Pfade auf Rohquellen, die nicht mehr im Projekt liegen – Übersetzung über `umbenennung_2026-09-18.csv` | | `README.md` | Kurzüberblick, Vorstandsliste, Hinweis zur Datenlage | | `1980er/` … `2020er/` | Jahresordner, **benannt nach dem Startjahr der Saison** (`2010er/2015/` = Saison 2015/16, `2020er/2021/` = 2021/22). Enthalten die Belegdokumente (PDF) und Fotos; 2017/18–2024/25 zusätzlich `korrespondenz/` mit den Newslettern; `2020er/2024/meisterfeier/` mit 32 Fotos | | `quellen/` | Saisonübergreifende Quellen: `festschrift-2013/` (Festschrift „30 Jahre PBV“, 48 Seiten mit Textlayer, plus `fotos/` mit 33 Ausschnitten), `praesentation_wie-alles-anfing.pdf`, `vorstand/` (Vorstandslisten 2003/2016, Vereinsadressen 2004/05 und 2016/17), `vereinsregister/` (Registerauszüge 2022, Merkblatt des Amtsgerichts 2018) | | `Alte Website/` | FTP-Spiegel der alten Website `www.pbv-trier.de` (Dateistand 25.08.2017), von Marcus May beigesteuert. **Kein Belegbestand** – am 23.09.2026 vollständig ausgewertet (Prüfbericht Kap. 16): 135 Dateien waren byte-identisch mit vorhandenen Belegen, 3 Funde wurden übernommen, der Rest bewusst nicht. Enthält weiterhin die 242 Spieltagsergebnisse 2016/17 (`lfdsaison/VB1/`) und die FTP-Logs mit dem Verzeichnis der 152 verschollenen Dokumente | | `umbenennung_2026-09-18.csv` | Zuordnung alt → neu für alle 443 Belegdateien der Umbenennung vom 18.09.2026 (73 davon gelöscht: 72 Dubletten, 1 Registeranmeldung mit Protokoll) – zum Nachschlagen, wenn ältere Notizen noch alte Namen nennen | | `pdf_verarbeitung.py`, `pdf_verarbeitung_log.txt` | **Historisch** (April 2026): hat die Rohquellen-PDFs in die Jahresordner einsortiert; die Quellordner existieren nicht mehr. Nur als Dokumentation der Einsortier-Regeln aufheben, nicht ausführen | Bestand: 238 PDFs, 96 Bilder, 39 Newsletter (35 HTML, 4 PDF), 1 Textdatei – insgesamt 334 Belegdateien, ca. 180 MB. **Nicht (mehr) in diesem Ordner:** die Rohquellen (`_Erledigt/`, `Spielbetrieb/`, `VonAktuellerWebsite/`, `webbuild/`) und der Ordner **`TRL_Handoff/`** (Access-Datenbank „TRL Saisonstart 2017-2018.accdb“ des Ranglistenprogramms, Parser `trl_parser.py`/`trl_export.py`, CSV-Exporte, Bericht `TRL_Auswertung_1998-2017.md` mit eigenem `HANDOFF.md`). Marcus May hat sie separat abgelegt. Die Chronik nennt sie nur noch namentlich, ohne Pfad. ## 3. Namensschema der Belegdateien Alle Belegdateien heißen `_[_].` – nur Kleinbuchstaben und ASCII (ä → ae, ß → ss), `_` trennt die Felder, `-` trennt Wörter innerhalb eines Feldes. Ordnernamen ebenfalls klein. - **``**: die Saison, zu der das Dokument *inhaltlich* gehört, als `2015-16` (Startjahr vierstellig, Endjahr zweistellig). Eine GV im Juni 2018 gehört zur Saison 2017/18; eine „Übersicht der Änderungen für die Saison 2018/19“ zur Saison 2018/19. Saisonübergreifende Quellen tragen statt der Saison ein Datum (`vorstand_2003-05.pdf`, `vereinsregister_2022-08-09_aktuell.pdf`) oder `historisch`. - **``** (Dokumentart): `abschlusstabellen`, `toprangliste` (+ `_vl`/`_bl`/`_kl`), `rangliste` (Website-Export mit Tabelle und Spielerrangliste, + `_vl`/`_bl`), `pokal` (+ `_runde1`, `_achtelfinale` … `_finale`), `supercup`, `vem`, `vdm`, `mannschaften`, `ligen`, `spielplan`, `termine`, `satzung`, `dfb`, `aenderungen`, `gv` (+ `_einladung`, `_antrag_`, `_antraege`, `_anwesenheitsliste`), `rundschreiben` (+ Thema), `newsletter` (+ Thema), `anfangszeiten`, `meldelisten`, `spielbericht`, `hygienekonzept`, `meisterfeier`; Fotos: `mannschaftsfoto`, `vereinsfoto`, `zeitung`, `foto`. - **``**: Liga, Runde, Thema, Name (`bv-bollendorf`, `marcus-may`) oder Format: `_foto` (Siegerfoto), `_cuescore` (Turnierausdruck), `_screenshot`, `_scan`; bei Fotoserien Datum und laufende Nummer (`2024-25_meisterfeier_2025-07-05_01.jpg`). - Beispiele: `1983-84_abschlusstabellen.pdf`, `2004-05_toprangliste_vl.pdf`, `2016-17_pokal_halbfinale.pdf`, `2017-18_gv_antrag_marcus-may.pdf`, `2021-22_newsletter_pausierung-2g-plus.html`, `2024-25_vem_cuescore.pdf`, `2023-24_vdm_foto.jpg`. - `md_to_html.py` leitet Bildunterschriften aus dem Schema ab (`2017-18_vem_foto.jpg` → „VEM 2017/18“); die Zuordnung `CAPTION_TYP` im Skript bei neuen Typen ergänzen. - Ein Dokument liegt genau einmal vor (Dubletten wurden am 18.09.2026 entfernt); eine Datei, deren Inhalt einer anderen Saison entspricht als ihr Ursprungsname, gehört in den Ordner ihres Inhalts. ## 4. Aufbau eines Saisonabschnitts (Konventionen) ```markdown #### Saison 2015/16 ⬅ Spielerpässe abgeschafft, Qualifikationsmodus - Stichpunkte zu Modus, Mannschaftszahl, Ereignissen → Quelle: `2010er/2015/2015-16_aenderungen.pdf` | Mannschaftsmeisterschaft | VL (11) | BL (8) | KL (6) | |---|---|---|---| | Platz 1 | **BC Billardclub** (45 Punkte) | **BC Wasserliesch II** | **BC Heiligkreuz II** | | Platz 2 | … | … | … | | Platz 3 | … | … | … | → Quelle: `2010er/2015/2015-16_abschlusstabellen.pdf` *Bemerkung kursiv direkt unter der Tabelle* | Turnier | VEM (Datum) | VDM (Datum) | |---|---|---| | Platz 1 | **Name (Verein)** | **Name / Name (Verein)** | | … Platz 4 | → Quellen: `pfad1.pdf`, `pfad2.pdf`, Foto: `2010er/2015/2015-16_vem_foto.jpg`, Foto: `2010er/2015/2015-16_vdm_foto.jpg` | Einzelwertung | VL | BL | KL | |---|---|---|---| | Platz 1–3 | … | - **Mannschaften:** VL (…): …; BL (…): … - **Pokal:** Runden mit Ergebnissen; **Finale Datum: A 14:10 B** → Quelle: `…` - **Supercup:** … - *(Spielplan: `…`; DFB: `…`)* ← Saison-Notiz, Pfade darin werden zu Links > **Generalversammlung Datum** (Ort, Anwesende): Wahlen, Beschlüsse → Quellen: `…` ``` Regeln, die `md_to_html.py` auswertet: - Tabellen, deren erste Kopfzelle mit **Mannschaftsmeisterschaft**, **Einzelwertung** oder **Turnier** beginnt, werden als Podium gerendert (Zeilen „Platz 1–4“ bekommen Medaillenfarben). - `→ Quelle: \`pfad\`` bzw. `→ Quellen: \`a\`, \`b\`, Foto: \`bild\`` werden zu Chips/Links; Bilder in `Foto:` öffnen sich in der Lightbox. - Fotogalerie: `**Fotos (Quelle):** \`pfad\` – Unterschrift; \`pfad\` – Unterschrift` (als Listenpunkt oder Absatz). - `*(…)*`-Notizen: Backtick-Pfade darin werden verlinkt. - Alle Pfade **relativ zu diesem Ordner**, ohne führendes `Chronik/`. - Kennzeichnungen: **†** = aus der TRL-Datenbank berechnet, praktisch gesichert; **‡** = wahrscheinlich; **„(offen)“** = mehrere Kandidaten; **\*** = nur aus dem Website-Archiv; **?** = nicht dokumentiert. Fußnote dazu unter der Übersichtstabelle. - Punktgleiche werden mit „/“ in einer Zelle genannt; Vereinsnamen so, wie sie zur jeweiligen Saison hießen (Umbenennungen im Vereinsregister). ## 5. Redaktionelle Regeln (Entscheidungen des Auftraggebers) 1. **Nicht in die Chronik:** E-Mails, Versammlungsprotokolle, Kassenberichte, Word-/Excel-Dateien (am 18.09.2026 entfernt – Fakten daraus bleiben ohne Quellenangabe stehen), Datenbank-Backups, Website-Exporte als Rohdaten. Vereinsinterne Turniere (Burg Open, Mitternachtsturnier, Friday Night, Vatertagsturnier) gehören nicht hinein; das Regelfest-Turnier 16.08.2019 war ein PBV-Turnier. 2. **Immer behalten:** Spielberichte, Ergebnislisten, Ranglisten, Spielpläne, Anträge, Satzungen/DFB, Newsletter-HTML, Fotos, VEM/VDM/Pokal/Supercup-Ergebnisse, Cuescore-Ausdrucke. 3. **Keine personenbezogenen Daten** außer Namen und Vereinen: keine Adressen, Geburtsdaten, Telefonnummern, E-Mail-Adressen (Cuescore-PDFs enthalten Kontaktadressen – nicht übernehmen). Beim Hausverbots-Konflikt BIG Trier / BV Bollendorf (Okt. 2025) wird der Spielername bewusst nicht genannt. 4. **Neue Dateien** werden nach dem Namensschema (Abschnitt 3) benannt, in den Jahresordner der Saison gelegt und als `→ Quellen:` verlinkt; Fotos aus PDFs werden als `_vem_foto.jpg` / `_vdm_foto.jpg` extrahiert. Den Originalnamen ggf. im Prüfbericht notieren. 5. Vermutungen kennzeichnen, nie als Fakt darstellen (siehe Lehre aus 2015/16 unten). 6. Sprache: Deutsch, Anführungszeichen „…“, Abkürzungen VL/BL/KL, VEM/VDM, DFB = Durchführungsbestimmung, GV/JHV, SC = Supercup. ## 6. Typischer Arbeitsablauf ```bash # Text aus PDFs lesen (alle Chronik-PDFs haben einen Textlayer, außer den in Prüfbericht Kap. 4.3 genannten Scans) python -c "import pdfplumber; p=pdfplumber.open('2020er/2025/xyz.pdf'); print('\n'.join(pg.extract_text() or '' for pg in p.pages))" # Nach jeder Änderung an Gesamtchronik.md: python md_to_html.py # Link-Check (alle Backtick-Pfade müssen existieren; reine Dateinamen ohne Ordner # im Fotoarchiv/Quellen-Kapitel sowie Muster mit * und sind erlaubt) python - <<'EOF' import re, os, glob s = open('Gesamtchronik.md', encoding='utf-8').read() for p in sorted(set(re.findall(r'`([^`\n]+)`', s))): if re.search(r'[\\/].*\.(pdf|jpe?g|png|md|html|txt)$', p) and '<' not in p and not (glob.glob(p) if '*' in p else os.path.exists(p)): print('FEHLT:', p) EOF ``` Benötigt: Python 3 (getestet mit 3.14), `pdfplumber` zum Lesen, optional `PyMuPDF` (`fitz`) zum Extrahieren von Bildern aus PDFs. `md_to_html.py` braucht keine Zusatzpakete. Bei Scans ohne Textlayer erst prüfen, ob eine Textlayer-Version existiert; OCR nur, wenn nötig. Wenn Marcus May neue PDFs liefert (bisher: ins Projekt-Root gelegt): Text extrahieren → Ergebnisse gegen die Chronik querprüfen → Abweichungen korrigieren und im Prüfbericht als Nachtrag dokumentieren → Datei in den Jahresordner verschieben → verlinken → HTML neu erzeugen → Link-Check. ## 7. Gesicherte Eckdaten (Kurzfassung) - Gründung 05.06./07.07.1983 als „Pool-Billard-Verband Stadt und Kreis Trier“; e.V. seit 04.02.1991 (VR 2487, AG Wittlich). 1. Vorsitzende: Dühr (–1998), Weiler (1998–2001), Messer (2001–2003), Lenz (2003–2004), Weiler (2004–2016), Keller (2016–2019), **May seit 2019** (Wiederwahl 2022, 2025). Vorstand 2025/26: May, Lauterbach, Andreas (Sportwart), Bruder (stv. SW), Schulz (Schatzmeister). - Ligen: bis 1989/90 eine Liga; 1990/91 BL + KL; 1991/92–2015/16 VL/BL/KL; ab 2016/17 VL/BL; 2020/21 eingleisig (nicht gespielt). Spielmodus 5 Einzel + 1 Doppel ab 2011/12, **4 Einzel + 2 Doppel ab 2025/26** (GV 13.07.2025, 20:10). - COVID: 2019/20 abgebrochen (Vereinsabstimmung 23.06.2020), 2020/21 nach zwei Spieltagen, 2021/22 nach dem 27.11.2021 (nur Pokal – BIG Pool Sharks –, VEM und VDM zu Ende gespielt). - Rekorde: PBC Fell VL-Meister 8× in Folge 2003/04–2010/11; Pool Devils Triple 2025/26 (Meisterschaft, Pokal, Supercup – erstes Triple seit PBC Fell 2008/09); BIG Trier 3 BL-Meister 2025/26 ungeschlagen. - 2015/16 (offizielle Abschlusstabelle, seit 18.09.2026): VL BC Billardclub vor VfB Welschbillig und BIG MAC; BL BC Wasserliesch II; KL BC Heiligkreuz II. - VEM 2022 Plein, 2023 J. Schmitt, 2024 Neumann, 2025 und 2026 Hoewer; VDM 2022 Engel/Mühlen, 2023 Fritzsch/Steiner, 2023/24 Heinz/Prison, 2024/25 Thomann/Nussberger, 2026 J. Schmitt/Kaczor – alle per Cuescore-PDF belegt. - Ehrenmitglieder: Albert Dühr, Fritz Söder (1998), Willi Galeazzi, Dietmar Mattes (2019). Kay Güldner = Kay Kirchen (Heirat). - 2026/27: Saisonstart 05.09.2026, neue PBV-App (Neuentwicklung für flexible Spielmodi); JHV 09.08.2026 mit Antrag auf Drei-Ligen-System mit Playoffs – Ergebnis unbekannt. **Lehre aus 2015/16:** Die aus der TRL-Datenbank (ohne Doppel) geschätzten Meister können falsch sein – BIG MAC (Modell 57 %) wurde tatsächlich nur Dritter. Die verbleibenden ‡/„(offen)“-Meister 2011/12–2014/15 (BL/KL 2013/14, KL 2014/15 u. a.) sind vom Vorstand nicht bestätigt. ## 8. Offene Punkte | Punkt | Was fehlt | |---|---| | VEM 04.05.2019, Supercup 18.05.2019 | Ergebnisse – Cuescore-PDFs der BIG Trier könnten sie liefern (hat für 2022–2026 funktioniert) | | Pokal und Supercup 2010/11–2015/16 | keine Unterlagen; BL/KL-Endstände 2015/16 inzwischen vorhanden | | **Archiv `E:\PBV\Billard_Historie` des früheren Webmasters** | Aussichtsreichster offener Punkt (Prüfbericht Kap. 16.4): Die FTP-Logs der alten Website nennen 152 hochgeladene, heute fehlende Dateien – darunter Satzungen und Durchführungsbestimmungen vor 2015, der komplette Pokal 2002/03 und 2003/04, VEM 2002/03 und 2003/04, GV-Ladung und Anträge 2004. Marcus May fragen, ob dieses Laufwerk oder eine Sicherung existiert | | Supercup 25.05.2003 | Die Historie-Seite der Website sagt „Meister VL = Pokalsieger" (kein Supercup), die FTP-Logs nennen aber eine Datei `030525supercup.pdf`. Vermutlich eine entfallene Ansetzung – nicht aufgelöst | | Meister 2011/12–2014/15 (‡/offen) | Bestätigung durch den Vorstand oder Abschlusstabellen | | JHV 09.08.2026 | Protokoll; Abstimmung über das Drei-Ligen-System | | Newsletter ab 2022 | Inhalte nur per MailerLite-Export erreichbar; im Archiv nur Ankündigungs-HTML | | Saison 2026/27 | läuft seit 05.09.2026 – Ergebnisse folgen | | Mannschaftslisten | Für 2018/19 und 2022/23 gibt es keine Website-Mannschaftsliste (die gleichnamigen Exporte enthielten andere Saisons und wurden umsortiert); 2024/25 nur die vorläufige Meldung vom 13.08.2024 | ## 9. Verlauf - **April 2026:** Grundgerüst der Chronik aus den Rohquellen (`pdf_verarbeitung.py`). - **17.09.2026:** Vollständige Prüfung gegen alle PDFs (Prüfbericht Kap. 0–7), Vorstandsarchiv 2016–2026 ausgewertet, Rohquellen nach `_Erledigt/` verschoben, HTML-Fassung mit Lightbox und Fotoleisten, Festschrift als Einzelseiten-PDF mit Textlayer. - **18.09.2026:** Abgleich mit der Datenbank der PBV-App (Kap. 8), Präsentation „Wie alles anfing“ (Kap. 9), Bilder aus PDFs extrahiert (Kap. 10), interne Dokumente entfernt (Kap. 11), Website-Downloads (Kap. 12), TRL-Datenbank ausgewertet (Kap. 13), Cuescore-PDFs und Abschlusstabelle 2015/16 eingearbeitet (Kap. 14), Quellen-Kapitel auf vorhandene Dateien reduziert, Skripte in den Chronik-Ordner verlegt und auf relative Pfade umgestellt; **alle 443 Belegdateien nach dem Namensschema umbenannt, nach Inhalt einsortiert, 72 Dubletten gelöscht** (Kap. 15, `umbenennung_2026-09-18.csv`). Web-Veröffentlichung als claude.ai-Artefakt wurde getestet und auf Wunsch wieder gelöscht (Limits: 255 Dateien/64 MB je Artefakt, 15 MB je Datei – die Festschrift mit 44 MB passt nicht). - **23.09.2026:** Ordner `Alte Website` (FTP-Spiegel, 743 Dateien) ausgewertet (Kap. 16). Übernommen: Supercup 2001/02, 2002/03 und 2004/05 als nicht ausgetragen belegt; die 13 Begegnungen des letzten Spieltags 2002/03 (zweiseitige Abschlusstabellen-PDF ersetzt die einseitige); Meisterfeier 04.06.2011 mit Plakat `2010er/2010/2010-11_meisterfeier_plakat.jpg`. Bewusst draußen geblieben: 242 Spieltagsergebnisse 2016/17, VEM/VDM-Termine 2011-2016, Antrag „Beste Dame“, Formulare, Technikgeschichte der Website. `md_to_html.py`: Detail `plakat` ergibt jetzt die Bildunterschrift „… (Plakat)“.