README

Kurzüberblick

Die README ist die Arbeitsdoku: Was liegt wo, was darf überschrieben werden und was bleibt auf dem Server.

Grundprinzip

dnns.ch ist der öffentliche statische Hub. dnnspit ist der private Pflegebereich unter tools/.

• Design liegt zentral in assets/css/site.css.
• JavaScript liegt zentral in assets/js/.
• Öffentliche Seiten liegen in eigenen Ordnern wie timeline/, events/, sports/, photos/, media/, movies/, series/, watchlist/, movie-lists/ und recipes/.
• dnnspit-Seiten liegen unter tools/.
• Live-Daten, Auth-Dateien und Tokens werden nicht in Updatepakete oder datenfreie Fullversionen gepackt.

Öffentliche Bereiche

Der öffentliche Hub bleibt visuell eigenständig. Unterseiten können Split-Hero, Statistikleisten, Filter und eigene Kartenlayouts nutzen, sollen aber gezielt über Body-Klassen gestylt werden.

dnnspit Bereiche

tools/index.html ist der dnnspit-Hub. Navigation und Hub sind seit 0.9.86 konsistent gegliedert.

• Inhalte: Posts und Rezepte.
• Pflege & Sync: Media Editor, TMDb Fetch, Massenabgleich, Bild-Cache, Letterboxd und Media Stats.
• Watch: Serien Watch, Season Ratings, Movie Watch, Watchlist und Movie Lists.
• Daten & JSON: Daten-Manager, Events Manager, Sports Manager, CSV-Editor als Altimport und Changelog-Editor.
• Photos: Image-Tool, Photo-Alben Manager, Photos-Alben CSV und Photos-Bilder CSV.
• System: Backup-Manager, Systemcheck, README und Changelog.

Events & Sports

Events und Sports laufen öffentlich JSON-only. Kanonische Live-Daten sind events/events.json und sports/sports.json.

• Öffentliche Seiten lesen nicht mehr aus CSV.
• CSV bleibt nur als Altimport im Manager relevant.
• Backup, Restore und Systemcheck prüfen die JSON-Dateien.
• Die Timeline liest Events und Sports aus JSON und verhindert Dubletten.
• Timeline-Einträge zeigen Typ und Kategorie/Sportart als getrennte Pills mit sichtbarem Trenner.
• Die Timeline nutzt Suche, Jahrfilter und Bereichsfilter. Der frühere Highlight-Filter wurde im RC entfernt.

Media Workflow

Der Media-Bereich ist der größte dnnspit-Bereich und bleibt in Pflege/Sync sowie Watch getrennt.

• TMDb-Fetch ergänzt Metadaten, überschreibt aber keine eigenen Ratings, Notizen, Listenplätze oder Fortschritte.
• Movie Lists schützen Reihenfolge, Listenplätze, Ratings und Notizen.
• Movie Lists unterstützen Einzelfetch, manuelle TMDb-ID-Korrektur, Sammelfetch für offene TMDb-Metadaten sowie Zähler und Filter.
• Watchlist-Filme können als gesehen zu Movies übernommen werden.
• Media Stats und die öffentliche Media-Statistik bleiben eigenständige Ansichten.

Letterboxd Import / Export

Das Letterboxd-Modul liegt unter tools/media-letterboxd.html.

• Öffentliche Letterboxd-Listenlinks und CSV-Dateien können geladen werden.
• Standardziel ist immer „Neue Liste“.
• Vorhandene Listen werden nur bewusst ergänzt.
• Importe können TMDb-Metadaten nachladen und offene Treffer protokollieren.
• Vorhandene dnns.ch-Listen können als Letterboxd-kompatible CSV exportiert werden.

Daten, Backups und Sicherheit

Live-Daten liegen auf dem Server und dürfen durch Pakete nicht ersetzt werden.

• Updatepakete enthalten nur geänderte Code-, HTML-, CSS-, JS-, PHP- und Doku-Dateien.
• Datenfreie Fullversionen enthalten keine JSON-/CSV-Nutzerdaten.
• Vor größeren Uploads ein Live-Daten-Backup im Backup-Manager erstellen.
• auth-config.js, echte Tokens und Server-Konfigurationen gehören nicht in ZIPs.

Updatepakete

Namensschema:

dnns.ch_0.9.xx_Kurzbeschreibung-Updatepaket.zip

dnns.ch_0.9.xx_Kurzbeschreibung-Fullversion-ohne-Nutzerdaten.zip

• Versionsnummer in 0.0.01-Schritten erhöhen.
• Changelog und README aktualisieren.
• Footer-Versionen und Cache-Busting konsistent halten.
• Keine Live-Daten in Updatepaket oder Fullversion.
• Syntax grob prüfen, besonders bei JS/PHP-Änderungen.

Upload-Checkliste

1. Live-Daten-Backup erstellen.
2. Updatepaket öffnen und Dateiliste prüfen.
3. Sicherstellen, dass keine Nutzerdaten enthalten sind.
4. Dateien auf den Webspace hochladen.
5. Browsercache umgehen oder Cache-Busting prüfen.
6. dnnspit-Systemcheck öffnen.
7. Betroffene öffentliche Seite testen.

Release-Checkliste 1.0.00

• Systemcheck live starten und Versionen, Footer, Cache-Busting, JSON-only und Aufräumfunde prüfen.
• Nur eindeutig alte Systemcheck-/Asset-Dateien löschen; keine Nutzerdaten, Configs, tools/data, Backups oder Media-Bilder über generische Aufräumwege entfernen.
• Öffentliche Seiten öffnen: /, /timeline/, /events/, /sports/, /recap/, /media/, /movie-lists/, /posts/, /photos/, /recipes/.
• dnnspit prüfen: Hub, Navigation, Backup/Restore, Events/Sports Manager, Media Editor, Bild-Cache und Systemcheck.
• Updatepaket und datenfreie Fullversion auf ausgeschlossene Dateien prüfen.
• Nach Upload hart neu laden oder Inkognito testen.

Fehlersuche

• Cache-Busting prüfen, z. B. site.css?v=0.9.xx.
• Sicherstellen, dass die richtige Datei hochgeladen wurde.
• Prüfen, ob die Seite eine eigene Body-Klasse nutzt.
• Bei dnnspit prüfen, ob page-tools-hub oder eine passende Tool-Klasse greift.
• Bei Letterboxd/TMDb Statusmeldungen lesen und offene Titel über die TMDb-Offen-Filter prüfen.
• Bei Speicherproblemen Systemcheck und Backup-Manager prüfen.

Systemcheck Plus

Seit 0.9.87 prüft der Systemcheck zusätzlich Versionsreste, Footer-Versionen, Asset-Cache-Busting, öffentliche Events/Sports-CSV-Verweise, JSON-only-Quellen und den Media-Bild-Cache.

• Fehler sind Upload-Blocker oder echte Inkonsistenzen.
• Hinweise sind meist bewusst serverabhängig, zum Beispiel Auth-Dateien, Backups oder optionale Live-Daten.
• Der Bild-Cache-Audit löscht nichts. Alte Bildnamen werden sichtbar gemacht und können separat bewertet werden.
• Aufräumfunde im Systemcheck können seit 0.9.96 manuell gelöscht werden. Die Löschliste ist serverseitig auf alte Systemcheck-Scripte, nicht referenzierte versionierte JS-Dateien und Backup-/Archivdateien im Webroot begrenzt.

Recap / Jahresrückblick

Der öffentliche Recap ist als erste Jahresrückblick-Schicht vorbereitet. Media ist die primäre Datenquelle, Events, Sports, Timeline, Posts und Photos werden optional ergänzt, wenn die jeweiligen Dateien auf dem Server vorhanden sind.

• Media liefert Watchtime, Movies, Episoden, Top Movies, Top Serien, Monate und Tage.
• Events und Sports laufen aus den JSON-Dateien.
• Photos werden über photos/alben.csv als Reisen/Momente ergänzt.
• Fehlende optionale Quellen brechen die Seite nicht.

Aktueller stabiler Stand

Aktueller Arbeitsstand: 1.0.00 Stable

Basis: 0.9.97 Recap/Home/Serien Polish.

Schwerpunkt zuletzt: RC-Vorbereitung, Versionskonsistenz, Systemcheck-Aufräumen und Paket-Hygiene.