# 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. ```bash 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 ```bash 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: ```bash npm run data:validate npm run test ``` Einzeltermine stehen automatisch als ICS-Datei unter `/termine//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. ## 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.