tsv08kulmbach-website/bin/dateien-init.php

<?php

declare(strict_types=1);

/**
 * Ordnerstruktur der Dateiablage /dateien anlegen: Jahr → Abteilung.
 *
 *   2026/
 *     Fußball/
 *     Jugend/
 *     Turnen/
 *     Feste und Aktionen/
 *
 * Warum diese Reihenfolge: das Jahr außen hält die oberste Ebene für immer kurz
 * (ein Eintrag pro Jahr) und macht die Grenze zum Archiv sichtbar. Die Abteilungen
 * innen sind bewusst dieselben wie die Bereiche der Website — dann ist beim Hochladen
 * schon klar, auf welche Seite das Material später gehört. Wer ein Ereignis bündeln
 * will, legt darin einen Ordner mit Datum voran an („2026-08-15 Sommerfest"); der
 * sortiert sich dann von selbst richtig ein.
 *
 * Tiefer als diese zwei Ebenen wird nichts vorgegeben: die hochladenden Personen
 * stehen meist mit dem Handy am Spielfeldrand, und jede zusätzliche Ebene wird
 * ignoriert oder falsch getroffen.
 *
 * Idempotent — vorhandene Ordner bleiben unberührt. Im Januar für das neue Jahr
 * einmal neu aufrufen (oder das Vereins-Konto legt den Jahresordner selbst an).
 *
 * NUR CLI. Die Ordner müssen auf dem Server entstehen, nicht per FTP hochgeladen
 * werden: macOS und Linux normalisieren Umlaute unterschiedlich (NFD/NFC), sonst
 * steht „Fußball" am Ende zweimal da.
 *
 * Aufruf:  php bin/dateien-init.php [Jahr]     (ohne Argument: laufendes Jahr)
 */
if (PHP_SAPI !== 'cli') {
    exit(1);
}

require dirname(__DIR__) . '/app/bootstrap.php';

const DATEIEN_ABTEILUNGEN = ['Fußball', 'Jugend', 'Turnen', 'Feste und Aktionen'];

// Europe/Berlin, weil PHP global auf UTC läuft — sonst kippt das Jahr am 31.12. zu früh.
$year = (string) ($argv[1] ?? (new DateTimeImmutable('now', new DateTimeZone('Europe/Berlin')))->format('Y'));

if (!preg_match('/^20\d{2}$/', $year)) {
    fwrite(STDERR, "Ungültiges Jahr: {$year}\nAufruf: php bin/dateien-init.php [Jahr]\n");
    exit(1);
}

$root = STORAGE_PATH . '/dateien/uploads';
if (!is_dir($root)) {
    fwrite(STDERR, "storage/dateien/uploads/ fehlt — erst die Dateiablage einrichten (siehe CLAUDE.md).\n");
    exit(1);
}
if (!is_writable($root)) {
    fwrite(STDERR, "storage/dateien/uploads/ ist nicht beschreibbar.\n");
    exit(1);
}

$paths = [$year];
foreach (DATEIEN_ABTEILUNGEN as $abteilung) {
    $paths[] = $year . '/' . $abteilung;
}

$created = 0;
$failed = 0;
foreach ($paths as $rel) {
    $dir = $root . '/' . $rel;
    if (is_dir($dir)) {
        echo "·  {$rel} (gibt es schon)\n";
        continue;
    }
    if (!mkdir($dir, 0775, true) && !is_dir($dir)) {
        fwrite(STDERR, "✗  {$rel} konnte nicht angelegt werden\n");
        $failed++;
        continue;
    }
    echo "✓  {$rel}\n";
    $created++;
}

echo "\n{$created} Ordner angelegt" . ($failed > 0 ? ", {$failed} fehlgeschlagen" : '') . ".\n";
exit($failed > 0 ? 1 : 0);