feat(seo): MusicFestival JSON-LD on homepage (Wave 2 entity)

Establishes e-Ventschau as a recurring festival brand for Knowledge Graph
and AI search: a MusicFestival entity on / linking the venue (Place with
structured PostalAddress + geo), organizer (e.V.), the chain of published
editions (subEvent) and social profiles (sameAs).

Data-driven & editable (no hardcoding, no schema drift):
- SiteSettings gains nullable JSON columns socialLinks + contactAddress,
  updated in schema.prisma AND the migration together.
- /admin/setup form + settings API persist them; getSiteSettings normalizes.
- Organization JSON-LD (rendered on every page) converted to an async
  getOrganizationJsonLd() so the editable social list feeds its sameAs;
  Facebook kept as a fallback so the site-wide entity never loses it.

Pure builders (buildMusicFestivalJsonLd + buildPlace, normalizeSocialLinks,
normalizeContactAddress) are TDD-covered in src/lib/__tests__. tsc + build green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: mrwind-up-bird

prisma/migrations/20260703000000_add_settings_social_and_address/migration.sql

@@ -0,0 +1,4 @@
+-- Wave 2 SEO: editable social profiles + structured venue/contact address.
+-- Both nullable JSONB, no default — existing rows keep working unchanged.
+ALTER TABLE "SiteSettings" ADD COLUMN "socialLinks" JSONB;
+ALTER TABLE "SiteSettings" ADD COLUMN "contactAddress" JSONB;

prisma/schema.prisma

@@ -98,6 +98,8 @@ model SiteSettings {
   openaiApiKeyEncrypted String?  @db.Text
   openaiModel     String   @default("auto")
   maintenanceMode Boolean  @default(false)
+  socialLinks     Json?
+  contactAddress  Json?
   createdAt       DateTime @default(now())
   updatedAt       DateTime @updatedAt
 

src/app/(public)/page.tsx

@@ -1,6 +1,6 @@
 import type { Metadata } from 'next'
 import { getSiteSettings } from '@/lib/menu'
-import { buildMetadata, websiteJsonLd } from '@/lib/seo'
+import { buildMetadata, websiteJsonLd, getMusicFestivalJsonLd } from '@/lib/seo'
 import JsonLd from '@/components/JsonLd'
 import HomepageSectionRenderer from '@/components/sections/HomepageSectionRenderer'
 import NoirElement from '@/components/noir/sections/NoirElement'
@@ -39,11 +39,15 @@ export async function generateMetadata(): Promise<Metadata> {
 }
 
 export default async function HomePage() {
-  const sections = await getHomepageSections()
+  const [sections, festivalJsonLd] = await Promise.all([
+    getHomepageSections(),
+    getMusicFestivalJsonLd(),
+  ])
 
   return (
     <div className="nh">
       <JsonLd data={websiteJsonLd} />
+      {festivalJsonLd && <JsonLd data={festivalJsonLd} />}
       {sections.length > 0 ? (
         // Editor-composed homepage: ordered/visible elements from /admin/sections
         <HomepageSectionRenderer sections={sections} />

src/app/admin/setup/page.tsx

@@ -26,6 +26,17 @@ interface SiteSettings {
   hasOpenaiApiKey: boolean
   openaiModel: string
   maintenanceMode: boolean
+  socialLinks: string[] | null
+  contactAddress: {
+    venueName?: string
+    street?: string
+    postalCode?: string
+    locality?: string
+    region?: string
+    country?: string
+    lat?: number
+    lng?: number
+  } | null
 }
 
 interface MenuItem {
@@ -74,6 +85,10 @@ export default function SetupPage() {
   const [openaiModel, setOpenaiModel] = useState('auto')
   const [showApiKey, setShowApiKey] = useState(false)
   const [maintenanceMode, setMaintenanceMode] = useState(false)
+  const [socialLinksText, setSocialLinksText] = useState('')
+  const [address, setAddress] = useState({
+    venueName: '', street: '', postalCode: '', locality: '', region: '', country: '', lat: '', lng: '',
+  })
 
   const fetchData = useCallback(async () => {
     try {
@@ -96,6 +111,13 @@ export default function SetupPage() {
       setHasOpenaiApiKey(settingsData.hasOpenaiApiKey ?? false)
       setOpenaiModel(settingsData.openaiModel ?? 'auto')
       setMaintenanceMode(settingsData.maintenanceMode ?? false)
+      setSocialLinksText(Array.isArray(settingsData.socialLinks) ? settingsData.socialLinks.join('\n') : '')
+      const ca = settingsData.contactAddress ?? {}
+      setAddress({
+        venueName: ca.venueName ?? '', street: ca.street ?? '', postalCode: ca.postalCode ?? '',
+        locality: ca.locality ?? '', region: ca.region ?? '', country: ca.country ?? '',
+        lat: ca.lat != null ? String(ca.lat) : '', lng: ca.lng != null ? String(ca.lng) : '',
+      })
 
       // Separate top-level items (with children already included from API)
       const topLevel = menuData.filter((item) => !item.parentId)
@@ -116,11 +138,23 @@ export default function SetupPage() {
     setSaved(false)
     setError('')
     try {
+      const socialLinks = socialLinksText.split('\n').map((s) => s.trim()).filter(Boolean)
+      const contactAddress = {
+        venueName: address.venueName.trim() || undefined,
+        street: address.street.trim() || undefined,
+        postalCode: address.postalCode.trim() || undefined,
+        locality: address.locality.trim() || undefined,
+        region: address.region.trim() || undefined,
+        country: address.country.trim() || undefined,
+        lat: address.lat.trim() ? Number(address.lat) : undefined,
+        lng: address.lng.trim() ? Number(address.lng) : undefined,
+      }
       const res = await fetch('/api/admin/settings', {
         method: 'PUT',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
           siteName, logoUrl, backgroundImage, darkMode, themeSlug, logoMode, openaiModel, maintenanceMode,
+          socialLinks, contactAddress,
           ...(openaiApiKey ? { openaiApiKey } : {}),
         }),
       })
@@ -485,6 +519,69 @@ export default function SetupPage() {
         </div>
       </div>
 
+      {/* Contact & Social Media (structured data / JSON-LD) */}
+      <div className="glass rounded-2xl p-6">
+        <h2 className="text-lg font-display font-bold text-brand-text mb-1">
+          Kontakt & Social Media
+        </h2>
+        <p className="text-sm text-brand-text-muted mb-4">
+          Fließt in die strukturierten Daten (JSON-LD) für Google &amp; Co. — Veranstaltungsort und Social-Profile des Festivals.
+        </p>
+
+        <div className="space-y-4">
+          <div>
+            <label className="block text-xs font-medium text-brand-text-muted mb-1">
+              Social-Media-Profile
+            </label>
+            <textarea
+              value={socialLinksText}
+              onChange={(e) => setSocialLinksText(e.target.value)}
+              rows={3}
+              className="input-glass w-full text-sm font-mono"
+              placeholder={'https://www.facebook.com/...\nhttps://www.instagram.com/e.ventschau/'}
+            />
+            <p className="text-[11px] text-brand-text-muted mt-1.5">
+              Eine URL pro Zeile (Facebook, Instagram, YouTube …). Erscheint als „sameAs“ in den strukturierten Daten.
+            </p>
+          </div>
+
+          <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
+            <div className="sm:col-span-2">
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Veranstaltungsort</label>
+              <input type="text" value={address.venueName} onChange={(e) => setAddress({ ...address, venueName: e.target.value })} className="input-glass w-full text-sm" placeholder="Hof Thiele" />
+            </div>
+            <div className="sm:col-span-2">
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Straße &amp; Nr.</label>
+              <input type="text" value={address.street} onChange={(e) => setAddress({ ...address, street: e.target.value })} className="input-glass w-full text-sm" placeholder="Am Bruch 1-2" />
+            </div>
+            <div>
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">PLZ</label>
+              <input type="text" value={address.postalCode} onChange={(e) => setAddress({ ...address, postalCode: e.target.value })} className="input-glass w-full text-sm" placeholder="21371" />
+            </div>
+            <div>
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Ort</label>
+              <input type="text" value={address.locality} onChange={(e) => setAddress({ ...address, locality: e.target.value })} className="input-glass w-full text-sm" placeholder="Tosterglope-Ventschau" />
+            </div>
+            <div>
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Bundesland</label>
+              <input type="text" value={address.region} onChange={(e) => setAddress({ ...address, region: e.target.value })} className="input-glass w-full text-sm" placeholder="Niedersachsen" />
+            </div>
+            <div>
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Land (ISO)</label>
+              <input type="text" value={address.country} onChange={(e) => setAddress({ ...address, country: e.target.value })} className="input-glass w-full text-sm" placeholder="DE" />
+            </div>
+            <div>
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Breitengrad (lat)</label>
+              <input type="text" inputMode="decimal" value={address.lat} onChange={(e) => setAddress({ ...address, lat: e.target.value })} className="input-glass w-full text-sm font-mono" placeholder="53.207676" />
+            </div>
+            <div>
+              <label className="block text-xs font-medium text-brand-text-muted mb-1">Längengrad (lng)</label>
+              <input type="text" inputMode="decimal" value={address.lng} onChange={(e) => setAddress({ ...address, lng: e.target.value })} className="input-glass w-full text-sm font-mono" placeholder="10.859330" />
+            </div>
+          </div>
+        </div>
+      </div>
+
       {/* Background Image */}
       <div className="glass rounded-2xl p-6">
         <h2 className="text-lg font-display font-bold text-brand-text mb-1">

src/app/api/admin/settings/route.ts

@@ -69,6 +69,17 @@ export async function PUT(request: Request) {
       : null
   }
 
+  // socialLinks (string[]) and contactAddress (object) are free-form JSON columns.
+  // Send [] / {} to clear them; the read path normalizes junk away.
+  const socialLinksUpdate =
+    body.socialLinks !== undefined
+      ? { socialLinks: Array.isArray(body.socialLinks) ? body.socialLinks : null }
+      : {}
+  const contactAddressUpdate =
+    body.contactAddress !== undefined
+      ? { contactAddress: body.contactAddress && typeof body.contactAddress === 'object' ? body.contactAddress : null }
+      : {}
+
   const settings = await prisma.siteSettings.upsert({
     where: { tenantId: tenant.id },
     update: {
@@ -81,6 +92,8 @@ export async function PUT(request: Request) {
       openaiModel: body.openaiModel ?? undefined,
       maintenanceMode: body.maintenanceMode !== undefined ? body.maintenanceMode : undefined,
       ...openaiKeyUpdate,
+      ...socialLinksUpdate,
+      ...contactAddressUpdate,
     },
     create: {
       tenantId: tenant.id,
@@ -93,6 +106,8 @@ export async function PUT(request: Request) {
       openaiModel: body.openaiModel ?? 'auto',
       maintenanceMode: body.maintenanceMode ?? false,
       ...openaiKeyUpdate,
+      ...socialLinksUpdate,
+      ...contactAddressUpdate,
     },
   })
 

src/app/layout.tsx

@@ -1,7 +1,7 @@
 import type { Metadata } from 'next'
 import { Inter, Playfair_Display, Space_Grotesk, IBM_Plex_Mono } from 'next/font/google'
 import JsonLd from '@/components/JsonLd'
-import { organizationJsonLd } from '@/lib/seo'
+import { getOrganizationJsonLd } from '@/lib/seo'
 import { getSiteSettings } from '@/lib/menu'
 import { getTheme, themeToStyleString } from '@/lib/themes'
 import './globals.css'
@@ -75,7 +75,7 @@ export default async function RootLayout({
 }: {
   children: React.ReactNode
 }) {
-  const settings = await getSiteSettings()
+  const [settings, organizationLd] = await Promise.all([getSiteSettings(), getOrganizationJsonLd()])
   // NEXT_PUBLIC_THEME_OVERRIDE lets a preview deploy force a theme without
   // mutating the shared production DB (e.g. previewing 'noir' before go-live).
   const theme = getTheme(process.env.NEXT_PUBLIC_THEME_OVERRIDE || settings.themeSlug || 'eventschau')
@@ -94,7 +94,7 @@ export default async function RootLayout({
       suppressHydrationWarning
     >
       <head>
-        <JsonLd data={organizationJsonLd} />
+        <JsonLd data={organizationLd} />
         <style dangerouslySetInnerHTML={{ __html: themeStyle }} />
         {settings.faviconUrl && <link rel="icon" href={settings.faviconUrl} />}
         <script

src/lib/__tests__/seo.test.ts

@@ -1,6 +1,6 @@
 import { test } from 'node:test'
 import assert from 'node:assert/strict'
-import { buildMetadata } from '../seo'
+import { buildMetadata, buildMusicFestivalJsonLd } from '../seo'
 
 // buildMetadata must emit alternates.canonical so tracking-param variants
 // (?utm_*, ?fbclid) collapse to a single indexable URL in Search Console.
@@ -16,3 +16,75 @@ test('buildMetadata canonical matches the OpenGraph url', () => {
   const md = buildMetadata(null, '/events/foo', { title: 'Foo', description: 'x' })
   assert.equal(String(md.alternates?.canonical ?? ''), String(md.openGraph?.url ?? ''))
 })
+
+// ── MusicFestival JSON-LD (homepage entity) ────────────────────────────────
+const festivalInput = {
+  siteUrl: 'https://e-ventschau.de',
+  name: 'e-Ventschau',
+  description: 'Benefiz-Festival',
+  image: 'https://res.cloudinary.com/x/logo.png',
+  organizerName: 'e-Ventschau e. V.',
+  sameAs: ['https://www.facebook.com/groups/436038379848640/', 'https://www.instagram.com/e.ventschau/'],
+  address: {
+    venueName: 'Hof Thiele',
+    street: 'Am Bruch 1-2',
+    postalCode: '21371',
+    locality: 'Tosterglope-Ventschau',
+    region: 'Niedersachsen',
+    country: 'DE',
+    lat: 53.207676,
+    lng: 10.85933,
+  },
+  featured: {
+    title: 'e-Ventschau 2026',
+    slug: 'e-ventschau-2026',
+    startDate: new Date('2026-08-07T16:00:00.000Z'),
+    endDate: new Date('2026-08-08T22:00:00.000Z'),
+    locationName: 'Hof Thiele',
+  },
+  editions: [
+    { title: 'e-Ventschau 2026', slug: 'e-ventschau-2026', startDate: new Date('2026-08-07T16:00:00.000Z'), endDate: new Date('2026-08-08T22:00:00.000Z') },
+    { title: 'e-Ventschau 2025', slug: 'e-ventschau-2025', startDate: new Date('2025-08-08T16:00:00.000Z'), endDate: null },
+  ],
+}
+
+test('buildMusicFestivalJsonLd returns null when there is no featured edition to anchor dates', () => {
+  assert.equal(buildMusicFestivalJsonLd({ ...festivalInput, featured: null }), null)
+})
+
+test('buildMusicFestivalJsonLd builds a MusicFestival with Place, geo, organizer, subEvents and sameAs', () => {
+  const ld: any = buildMusicFestivalJsonLd(festivalInput)
+  assert.equal(ld['@type'], 'MusicFestival')
+  assert.equal(ld.url, 'https://e-ventschau.de/')
+  assert.equal(ld.startDate, '2026-08-07T16:00:00.000Z')
+  assert.equal(ld.endDate, '2026-08-08T22:00:00.000Z')
+  assert.equal(ld.eventAttendanceMode, 'https://schema.org/OfflineEventAttendanceMode')
+  assert.equal(ld.location['@type'], 'Place')
+  assert.equal(ld.location.name, 'Hof Thiele')
+  assert.equal(ld.location.address.streetAddress, 'Am Bruch 1-2')
+  assert.equal(ld.location.address.addressLocality, 'Tosterglope-Ventschau')
+  assert.equal(ld.location.address.addressCountry, 'DE')
+  assert.equal(ld.location.geo.latitude, 53.207676)
+  assert.equal(ld.location.geo.longitude, 10.85933)
+  assert.equal(ld.organizer.name, 'e-Ventschau e. V.')
+  assert.equal(ld.subEvent.length, 2)
+  assert.equal(ld.subEvent[0].url, 'https://e-ventschau.de/events/e-ventschau-2026')
+  assert.equal(ld.subEvent[1].endDate, undefined) // null endDate is omitted, not serialized
+  assert.deepEqual(ld.sameAs, festivalInput.sameAs)
+})
+
+test('buildMusicFestivalJsonLd omits location entirely when there is no address and no fallback name', () => {
+  const ld: any = buildMusicFestivalJsonLd({
+    ...festivalInput,
+    address: null,
+    featured: { ...festivalInput.featured, locationName: null },
+  })
+  assert.equal('location' in ld, false)
+})
+
+test('buildMusicFestivalJsonLd falls back to featured.locationName for the Place name', () => {
+  const ld: any = buildMusicFestivalJsonLd({ ...festivalInput, address: null })
+  assert.equal(ld.location.name, 'Hof Thiele')
+  assert.equal('address' in ld.location, false)
+  assert.equal('geo' in ld.location, false)
+})

src/lib/__tests__/settings-normalize.test.ts

@@ -0,0 +1,46 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { normalizeSocialLinks, normalizeContactAddress } from '../settings-normalize'
+
+// socialLinks is a free-form JSON column; only clean, non-empty URL strings survive.
+test('normalizeSocialLinks keeps trimmed non-empty strings and drops junk', () => {
+  assert.deepEqual(
+    normalizeSocialLinks(['  https://a  ', '', 42, null, 'https://b']),
+    ['https://a', 'https://b'],
+  )
+})
+
+test('normalizeSocialLinks returns [] for anything that is not an array', () => {
+  assert.deepEqual(normalizeSocialLinks(null), [])
+  assert.deepEqual(normalizeSocialLinks('https://x'), [])
+  assert.deepEqual(normalizeSocialLinks(undefined), [])
+})
+
+// contactAddress is a free-form JSON column; strings are trimmed, geo is coerced to
+// finite numbers (the admin form submits them as text), empty fields are dropped.
+test('normalizeContactAddress trims strings, coerces numeric geo, drops empties', () => {
+  const a = normalizeContactAddress({
+    venueName: ' Hof Thiele ',
+    street: ' Am Bruch 1-2 ',
+    postalCode: '21371',
+    locality: 'Tosterglope-Ventschau',
+    region: '',
+    country: '',
+    lat: '53.207676',
+    lng: '10.85933',
+  })
+  assert.equal(a?.venueName, 'Hof Thiele')
+  assert.equal(a?.street, 'Am Bruch 1-2')
+  assert.equal(a?.postalCode, '21371')
+  assert.equal(a?.locality, 'Tosterglope-Ventschau')
+  assert.equal(a?.region, undefined)
+  assert.equal(a?.country, undefined)
+  assert.equal(a?.lat, 53.207676)
+  assert.equal(a?.lng, 10.85933)
+})
+
+test('normalizeContactAddress returns null when nothing usable is present', () => {
+  assert.equal(normalizeContactAddress({ street: '', lat: '', lng: 'abc' }), null)
+  assert.equal(normalizeContactAddress(null), null)
+  assert.equal(normalizeContactAddress('nope'), null)
+})