Per Hoener b57c24a3c4
Deploy / validate-dispatch (push) Successful in 1s
Deploy / scheduled-rebuild-dev (push) Skipped
Deploy / scheduled-rebuild-master (push) Skipped
Deploy / rollback-dev (push) Skipped
Deploy / rollback-master (push) Skipped
Deploy / changes (push) Successful in 6s
Deploy / app-quality (push) Successful in 1m16s
Deploy / secret-scan (push) Successful in 4s
Deploy / security-deps (push) Successful in 18s
Deploy / context (push) Successful in 1s
Deploy / app-image (push) Successful in 1m28s
Deploy / deploy-master (push) Skipped
Deploy / deploy-dev (push) Successful in 13s
feat: build official Goldebek municipal website
2026-09-19 15:09:27 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00
2026-09-18 23:37:19 +02:00

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 Seiten
  • content/news/*.json: aktuelle Meldungen
  • content/events/events.json: Veranstaltungskalender
  • data/municipality.json: Basisdaten und Geschichte
  • data/council.json: Bürgermeister, Gemeindevertretung und Steuern
  • data/services.json: Dörpshuus, Alltagshilfe, Mobilität und Fahrbücherei
  • data/clubs.json: Vereine und Gruppen
  • data/sources.json: zentrales Quellenregister
  • src/lib/content/: Zod-Schemata und typisierter Zugriff
  • src/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

  1. Eine JSON-Datei nach dem Schema NewsItem unter content/news/ anlegen.
  2. Quelle, lastVerified und Status pflegen.
  3. Die Datei in src/lib/content/index.ts registrieren.
  4. npm run data:validate und 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

  1. Quelle in data/sources.json anlegen oder aktualisieren.
  2. In den Fachdaten auf die sourceId verweisen.
  3. lastVerified auf das tatsächliche Prüfdatum setzen.
  4. Bei einem inhaltlichen Konflikt die Entscheidung aus goldebek_website_briefing/goldebek_data_2026-09-18.json beachten.
  5. Nicht bestätigte Angaben als needs-verification führen oder ganz aus dem öffentlichen Datensatz herauslassen.

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.

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.

S
Description
Webseite Goldebek
Readme
8.8 MiB
Languages
TypeScript 61.3%
CSS 18.3%
JavaScript 15.5%
Shell 4.3%
Dockerfile 0.6%