Website der Gemeinde Goldebek
Offizielle kommunale Informationswebsite auf Basis von Next.js 16 (App Router), React 19 und TypeScript. Die Anwendung rendert Seiten, Nachrichten und Termine serverseitig, lädt keine Tracker oder externen Schriftarten und wird als eigenständige Node.js-Anwendung gebaut.
Lokale Entwicklung
Voraussetzungen: die in .node-version angegebene Node.js-Version und npm.
npm ci
cp .env.example .env.local
npm run dev
APP_URL steuert Canonicals, Sitemap, robots.txt und absolute Metadaten. CALENDAR_URL wird vom weiterhin vorhandenen Laufzeit-Endpunkt GET /api/events benötigt, nicht vom Produktions-Build.
Qualitätschecks und Build
npm run data:validate
npm run lint
npm run typecheck
npm run test
npm run build
npm run test:e2e
Der Content-Validator prüft unter anderem Slugs, ISO-Daten, Quellen, lastVerified, abgelaufene Daten, private Veranstaltungsadressen und interne Links. Die CI- und Deployment-Workflows unter .gitea/workflows/ bleiben maßgeblich. Das Docker-Image verwendet den Next.js-Standalone-Build.
Content-Struktur
content/pages/pages.json: statische redaktionelle Seitencontent/news/*.json: aktuelle Meldungencontent/events/events.json: Veranstaltungskalenderdata/municipality.json: Basisdaten und Geschichtedata/council.json: Bürgermeister, Gemeindevertretung und Steuerndata/services.json: Dörpshuus, Alltagshilfe, Mobilität und Fahrbüchereidata/clubs.json: Vereine und Gruppendata/sources.json: zentrales Quellenregistersrc/lib/content/: Zod-Schemata und typisierter Zugriffsrc/lib/dates/: Europe/Berlin-Datumslogik und ICS-Ausgabe
Der öffentliche Stand darf nur verifizierte oder ausdrücklich dynamische Termine zeigen. needs-verification bleibt unsichtbar. Verwaltungsbezogene und volatile Daten benötigen sourceId und lastVerified.
Neue Meldung anlegen
- Eine JSON-Datei nach dem Schema
NewsItemuntercontent/news/anlegen. - Quelle,
lastVerifiedund Status pflegen. - Die Datei in
src/lib/content/index.tsregistrieren. npm run data:validateund die Tests ausführen.
Ein Bild benötigt einen präzisen Alt-Text. Wenn der Rechteinhaber eine Kennzeichnung verlangt, muss außerdem copyright gepflegt werden. Bilder dürfen erst nach dokumentierter Freigabe eingebunden werden.
Neuen Termin anlegen
Einen Datensatz in content/events/events.json ergänzen. Datum und Zeit werden als lokale Werte für Europe/Berlin gepflegt; der Wochentag wird nie gespeichert, sondern aus dem ISO-Datum berechnet. Pflicht sind mindestens ID, Slug, Titel, Startdatum, Zeitzone, Quelle, lastVerified und Status.
Straßenadressen werden nur ausgegeben, wenn privacyApproved: true gesetzt ist. Anschließend:
npm run data:validate
npm run test
Einzeltermine stehen automatisch als ICS-Datei unter /termine/<slug>/kalender.ics bereit, der Gesamtfeed unter /termine/kalender.ics.
Ratsmitglieder aktualisieren
Die aktuelle Liste steht in data/council.json. Vor einer Änderung die amtliche Quelle prüfen, lastVerified aktualisieren und den offenen Schreibweisen-Hinweis in CONTENT_CHECKLIST.md beachten. Ratsmitglieder werden ohne Rangfolge oder politische Wertung dargestellt.
Quellen und Prüfstände pflegen
- Quelle in
data/sources.jsonanlegen oder aktualisieren. - In den Fachdaten auf die
sourceIdverweisen. lastVerifiedauf das tatsächliche Prüfdatum setzen.- Bei einem inhaltlichen Konflikt die Entscheidung aus
goldebek_website_briefing/goldebek_data_2026-09-18.jsonbeachten. - Nicht bestätigte Angaben als
needs-verificationführen oder ganz aus dem öffentlichen Datensatz herauslassen.
Bilder und Copyright
Die derzeit eingebundenen Ortsbilder und die Wappengrafik liegen in goldebek_website_briefing/. Ihre Webnutzung wurde durch den Auftraggeber am 19.09.2026 bestätigt. Dateien werden weder hotgelinkt noch umgestaltet. Für neue Bilder sind Freigabe, Motivbeschreibung, Alt-Text und gegebenenfalls Fotografen-Copyright zu dokumentieren.
Jährliche Aktualisierung
Mindestens jährlich sowie vor dem Livegang sind zu prüfen:
- Einwohnerzahl und Stichtag
- Gemeindevertretung, Kontakte, Hebesätze und Hundesteuer
- Dörpshuus-Gebühren und Nutzungsbedingungen
- Buslinie und Betreiberlink
- Fahrbücherei-Fahrplan
- Veranstaltungskalender und Archivstatus
- Projektstände und Bauleitplanung
- externe Links, Quellen und
validUntil - Erklärung zur Barrierefreiheit und Rechtstexte
Datenschutz und Suche
Die Website verwendet keine Marketing-Cookies, Tracker, automatisch geladenen Karten, Drittanbieter-Schriftarten oder Video-Einbettungen. Ein Cookie-Banner ist für diese Grundkonfiguration nicht vorgesehen. Eine clientseitige Volltextsuche wurde bewusst nicht eingebaut: Die klare Informationsarchitektur und die geringe Inhaltsmenge erlauben kürzere Wege ohne zusätzlichen JavaScript-Suchindex. Das kann bei wachsendem Bestand neu bewertet werden.
Die Schrift Geist Sans wird als lokale Variable-Fontdatei unter public/fonts/Geist-Variable.woff2 ausgeliefert. Die zugehörige SIL Open Font License liegt als public/fonts/OFL-Geist.txt bei.
Deployment
npm run build erzeugt einen Standalone-Build. Die vorhandenen Gitea-Workflows übernehmen Tests, Build, Container-Scan, Docker-Compose-Deployment, Healthchecks und Rollback. Produktionswerte werden über die dort dokumentierten Variablen gesetzt; Secrets gehören nicht ins Repository.