Webklar-Kundenbereich/server/services/zeiten/zeitlogik.js

import { zuUtc, ausUtc, wochentag, plusTage } from '../termine/zeit.js'
import { BUNDESLAENDER, feiertageImZeitraum } from '../termine/feiertage.js'

/**
 * Oeffnungszeiten live: Zeitlogik (rein, Europe/Berlin).
 * Kein Appwrite, keine Config, kein eigener Zeitgeber: Aufrufer geben Daten und 'now' hinein.
 * Alles rechnet in Berliner Wanduhrzeit ueber termine/zeit.js; Kalendertage nur mit plusTage, nie als Vielfache von Tages-Millisekunden.
 *
 * Datenform (Spec 2.1): daten = { land, plaene: [{ id, kurz, name, haupt, tage: { 1..7: { modus, fenster } } }],
 *   feiertage: { 'YYYY-MM-DD': { modus, fenster } }, ausnahmen: [{ id, art: 'urlaub'|'sondertag', von, bis, text,
 *   modus, fenster, plan: null|planId }], ... }. modus: 'zu' | 'zeiten' | 'rund' | 'vereinbarung';
 *   fenster: [['09:00','12:30'], ...] (nur bei 'zeiten'; 'bis' vor 'von' = bis zum Folgetag).
 *
 * Alle Funktionen sind tolerant gegenueber kaputten gespeicherten Daten (unbekannter Modus, fehlende Tage,
 * unlesbare Fenster => zu), werfen aber bei einem ungueltigen Tag-Argument (Programmierfehler).
 */

const TAG_RE = /^\d{4}-\d{2}-\d{2}$/
const ZEIT_RE = /^\d{2}:\d{2}$/
const MODI = Object.freeze(['zu', 'zeiten', 'rund', 'vereinbarung'])
const STANDARD_LAND = 'RP'

const pad = (n) => String(n).padStart(2, '0')

/** Ist t ein echter Kalendertag 'YYYY-MM-DD' (kein 30.02.)? */
function gueltigerTag(t) {
  return typeof t === 'string' && TAG_RE.test(t) && plusTage(t, 0) === t
}

function pruefeTag(t, name) {
  if (!gueltigerTag(t)) throw new RangeError(`${name}: ungueltiger Tag ${String(t)}`)
}

/** 'HH:MM' (auch '24:00') -> Minuten seit 00:00, sonst null. */
function minuten(hhmm) {
  if (typeof hhmm !== 'string' || !ZEIT_RE.test(hhmm)) return null
  const h = Number(hhmm.slice(0, 2))
  const m = Number(hhmm.slice(3, 5))
  if (m > 59 || h > 24 || (h === 24 && m !== 0)) return null
  return h * 60 + m
}

const textOderNull = (t) => (typeof t === 'string' && t.trim() !== '' ? t : null)

// ------------------------------------------------------------------ Plaene

/** Der Hauptplan (haupt: true) oder null. */
export function hauptplan(daten) {
  const plaene = daten?.plaene
  if (!Array.isArray(plaene)) return null
  return plaene.find((p) => p && p.haupt === true) ?? null
}

/** Der Plan mit diesem Kurznamen ([a-z0-9-], exakter Vergleich) oder null. */
export function planNachKurz(daten, kurz) {
  const plaene = daten?.plaene
  if (!Array.isArray(plaene) || typeof kurz !== 'string' || kurz === '') return null
  return plaene.find((p) => p && p.kurz === kurz) ?? null
}

/** Bundesland der Daten; fehlend oder unbekannt = Vorgabe RP (Spec 2.1). */
export function landVon(daten) {
  return BUNDESLAENDER.includes(daten?.land) ? daten.land : STANDARD_LAND
}

// ------------------------------------------------------------------ Wanduhr -> UTC

/**
 * Berliner Wanduhr -> UTC-Zeitpunkt wie zuUtc, aber ohne null: Faellt die Zeit in die Luecke der
 * Maerz-Umstellung (02:00-02:59), gilt die erste existierende Minute danach (03:00). Doppelte Zeiten
 * (Oktober) ergeben das erste Vorkommen, '24:00' den Folgetag 00:00. Ungueltige Eingabe wirft RangeError.
 */
export function zuUtcOderDanach(tag, hhmm) {
  const direkt = zuUtc(tag, hhmm)
  if (direkt) return direkt
  const min = minuten(hhmm)
  if (!gueltigerTag(tag) || min === null) throw new RangeError(`ungueltige Wanduhrzeit ${String(tag)} ${String(hhmm)}`)
  for (let m = min + 1; m <= 1440; m += 1) {
    const kandidat = zuUtc(tag, `${pad(Math.floor(m / 60))}:${pad(m % 60)}`)
    if (kandidat) return kandidat
  }
  throw new RangeError(`keine existierende Wanduhrzeit nach ${tag} ${hhmm}`)
}

// ------------------------------------------------------------------ Tagesbild

/** Gespeicherte Fenster -> nur brauchbare, nach Beginn sortiert, als Kopie ('24:00' nur als Ende, von != bis). */
function sauberFenster(roh) {
  if (!Array.isArray(roh)) return []
  const fenster = []
  for (const e of roh) {
    if (!Array.isArray(e) || e.length !== 2) continue
    const von = minuten(e[0])
    const bis = minuten(e[1])
    if (von === null || bis === null || von >= 1440 || von === bis) continue
    fenster.push([e[0], e[1]])
  }
  return fenster.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
}

/** { modus, fenster } eines gespeicherten Tageseintrags: unbekannter Modus oder 'zeiten' ohne Fenster = zu. */
export function modusUndFenster(eintrag) {
  const modus = MODI.includes(eintrag?.modus) ? eintrag.modus : 'zu'
  if (modus !== 'zeiten') return { modus, fenster: [] }
  const fenster = sauberFenster(eintrag.fenster)
  return fenster.length ? { modus, fenster } : { modus: 'zu', fenster: [] }
}

/**
 * Die geltende Ausnahme dieser Art fuer Plan und Tag: planbezogene schlagen globale (plan null),
 * bei Gleichstand gewinnt die spaeter angelegte (hoeherer Index). Ausnahmen mit unlesbarem Zeitraum,
 * von > bis oder fuer einen anderen Plan zaehlen nicht; fehlendes 'bis' = ein Tag.
 */
function ausnahmeFuer(daten, planId, tag, art) {
  const liste = Array.isArray(daten?.ausnahmen) ? daten.ausnahmen : []
  let treffer = null
  let trefferRang = -1
  for (const a of liste) {
    if (!a || a.art !== art) continue
    const von = a.von
    const bis = a.bis ?? a.von
    if (typeof von !== 'string' || typeof bis !== 'string' || !TAG_RE.test(von) || !TAG_RE.test(bis)) continue
    if (tag < von || tag > bis) continue
    const global = a.plan === null || a.plan === undefined
    if (!global && a.plan !== planId) continue
    const rang = global ? 0 : 1
    // Liste in Anlegereihenfolge: bei gleichem Rang ersetzt der spaetere (>=)
    if (rang >= trefferRang) {
      treffer = a
      trefferRang = rang
    }
  }
  return treffer
}

/**
 * Feiertage je (Jahr, Land), einmal berechnet: Map tag -> { name, art: 'feiertag'|'pruefen' }.
 * Begrenzt, damit beliebige Jahre den Speicher nicht fuellen.
 */
const FEIERTAGE_CACHE = new Map()
function feiertageDesJahres(jahr, land) {
  const schluessel = `${jahr}|${land}`
  let karte = FEIERTAGE_CACHE.get(schluessel)
  if (!karte) {
    karte = new Map()
    for (const e of feiertageImZeitraum(`${jahr}-01-01`, `${jahr}-12-31`, land)) {
      karte.set(e.tag, Object.freeze({ name: e.name, art: e.art }))
    }
    if (FEIERTAGE_CACHE.size >= 200) FEIERTAGE_CACHE.clear()
    FEIERTAGE_CACHE.set(schluessel, karte)
  }
  return karte
}

/**
 * Das Tagesbild eines Plans an einem Berliner Kalendertag (Spec 6, spezifisch vor allgemein):
 * Sondertag > Betriebsurlaub > Feiertag (Abweichung oder Vorgabe) > Wochenplan.
 *
 * Rueckgabe { tag, art: 'regulaer'|'feiertag'|'urlaub'|'sondertag', name, modus, fenster }:
 * - name: Feiertagsname, bei Urlaub/Sondertag der Text der Ausnahme, sonst null.
 * - Urlaub ist immer zu. Gesetzlicher Feiertag ohne Abweichung ist zu; ein „bitte pruefen“-Tag
 *   (Heiligabend, Silvester, ...) folgt dem Wochenplan (art 'regulaer'), ausser der Kunde hat unter
 *   daten.feiertage[tag] eine Abweichung gespeichert (dann art 'feiertag' mit dem Namen des Tages).
 * - fenster ist immer ein neues Array (bei 'zu', 'rund', 'vereinbarung' leer); 'bis' kann '24:00' sein.
 */
export function tagesbild(daten, plan, tag) {
  pruefeTag(tag, 'tag')
  const planId = plan?.id

  const sonder = ausnahmeFuer(daten, planId, tag, 'sondertag')
  if (sonder) return { tag, art: 'sondertag', name: textOderNull(sonder.text), ...modusUndFenster(sonder) }

  const urlaub = ausnahmeFuer(daten, planId, tag, 'urlaub')
  if (urlaub) return { tag, art: 'urlaub', name: textOderNull(urlaub.text), modus: 'zu', fenster: [] }

  const feiertag = feiertageDesJahres(tag.slice(0, 4), landVon(daten)).get(tag)
  if (feiertag) {
    const abweichung = daten?.feiertage?.[tag]
    if (abweichung && MODI.includes(abweichung.modus)) {
      return { tag, art: 'feiertag', name: feiertag.name, ...modusUndFenster(abweichung) }
    }
    if (feiertag.art === 'feiertag') return { tag, art: 'feiertag', name: feiertag.name, modus: 'zu', fenster: [] }
  }

  return { tag, art: 'regulaer', name: null, ...modusUndFenster(plan?.tage?.[wochentag(tag)]) }
}

// ------------------------------------------------------------------ Oeffnungsintervalle

/**
 * Zusammengefuegte Oeffnungsintervalle [{ vonMs, bisMs }] (UTC-Millisekunden, sortiert) fuer die
 * Berliner Kalendertage vonTag bis bisTag (inklusive).
 * - Fenster gehoeren zum Starttag; 'bis' vor 'von' laeuft bis zum Folgetag und folgt der Regel des Starttags
 *   (auch wenn der Folgetag Feiertag, Urlaub oder zu ist). Ein am letzten Tag beginnendes Fenster wird
 *   bis zu seinem Ende geliefert.
 * - Enthalten ist auch das vom Vortag in vonTag hineinlaufende Fenster, ungekuerzt (es beginnt vor vonTag 00:00).
 * - 'rund' = 00:00 bis Folgetag 00:00; 'zu' und 'vereinbarung' ergeben nichts.
 * - Ueberlappende und aneinander grenzende Intervalle (auch ueber Tage) sind zusammengefuegt.
 * - Fenster in der Maerz-Luecke beginnen/enden um 03:00, Fenster ohne Dauer fallen weg.
 * vonTag nach bisTag => []. Ungueltige Tage werfen RangeError.
 */
export function oeffnungsIntervalle(daten, plan, vonTag, bisTag) {
  pruefeTag(vonTag, 'vonTag')
  pruefeTag(bisTag, 'bisTag')
  if (vonTag > bisTag) return []

  const bereichStart = zuUtcOderDanach(vonTag, '00:00').getTime()
  const roh = []
  const nimm = (vonMs, bisMs) => {
    if (bisMs > vonMs && bisMs > bereichStart) roh.push({ vonMs, bisMs })
  }

  for (let tag = plusTage(vonTag, -1); tag <= bisTag; tag = plusTage(tag, 1)) {
    const bild = tagesbild(daten, plan, tag)
    if (bild.modus === 'rund') {
      nimm(zuUtcOderDanach(tag, '00:00').getTime(), zuUtcOderDanach(tag, '24:00').getTime())
    } else if (bild.modus === 'zeiten') {
      for (const [von, bis] of bild.fenster) {
        const ueberMitternacht = bis <= von
        nimm(
          zuUtcOderDanach(tag, von).getTime(),
          zuUtcOderDanach(ueberMitternacht ? plusTage(tag, 1) : tag, bis).getTime(),
        )
      }
    }
  }

  roh.sort((a, b) => a.vonMs - b.vonMs || a.bisMs - b.bisMs)
  const zusammen = []
  for (const i of roh) {
    const letztes = zusammen[zusammen.length - 1]
    if (letztes && i.vonMs <= letztes.bisMs) letztes.bisMs = Math.max(letztes.bisMs, i.bisMs)
    else zusammen.push({ vonMs: i.vonMs, bisMs: i.bisMs })
  }
  return zusammen
}

// ------------------------------------------------------------------ Texte, Status und Wechsel

const WOCHENTAGE = Object.freeze(['Montag', 'Dienstag', 'Mittwoch', 'Donnerstag', 'Freitag', 'Samstag', 'Sonntag'])
const MINUTE_MS = 60 * 1000
const STUNDE_MS = 60 * MINUTE_MS
const SUCH_TAGE = 60 // Spec 6: keine Oeffnung in 60 Tagen => „Derzeit geschlossen“
const RUND_TAGE = 7 // durchgehend mindestens 7 Tage => „Rund um die Uhr geoeffnet“
const WECHSEL_TAGE = 8 // Spec 4.1: wechsel deckt 8 Tage ab
const WOCHEN_TAGE = 6 // bis hierhin nennt der Text den Wochentag, danach das Datum
const MAX_TAGE_LISTE = 366

const KURZ_OFFEN = 'Geöffnet'
const KURZ_ZU = 'Geschlossen'
const KURZ_VEREINBARUNG = 'Nach Vereinbarung'

function pruefeJetzt(now) {
  if (!(now instanceof Date) || !Number.isFinite(now.getTime())) throw new RangeError('now: ungueltiger Zeitpunkt')
  return now.getTime()
}

/**
 * Uhrzeit im Fliesstext: '09:00' => '9 Uhr', '18:30' => '18:30 Uhr', '09:05' => '9:05 Uhr';
 * '00:00' und '24:00' => 'Mitternacht' (nie „24 Uhr“). Ungueltige Eingabe wirft RangeError.
 */
export function uhrText(hhmm) {
  const min = minuten(hhmm)
  if (min === null) throw new RangeError(`uhrText: ungueltige Uhrzeit ${String(hhmm)}`)
  if (min === 0 || min === 1440) return 'Mitternacht'
  const h = Math.floor(min / 60)
  const m = min % 60
  return m === 0 ? `${h} Uhr` : `${h}:${pad(m)} Uhr`
}

/** 'YYYY-MM-DD' -> 'TT.MM.' */
const datumText = (tag) => `${tag.slice(8, 10)}.${tag.slice(5, 7)}.`

const wochentagsName = (tag) => WOCHENTAGE[wochentag(tag) - 1]

/** Kalendertage von bis nach (0..max) oder null, wenn weiter weg (nur ueber plusTage gezaehlt). */
function tagAbstand(von, bis, max) {
  let tag = von
  for (let n = 0; n <= max; n += 1) {
    if (tag === bis) return n
    tag = plusTage(tag, 1)
  }
  return null
}

/** Letzter Tag der zusammenhaengenden Urlaubstage ab tag (tag selbst ist Urlaub). */
function urlaubBis(daten, plan, tag) {
  let letzter = tag
  for (let i = 0; i < 400; i += 1) {
    const naechster = plusTage(letzter, 1)
    if (tagesbild(daten, plan, naechster).art !== 'urlaub') break
    letzter = naechster
  }
  return letzter
}

/** Text fuer ein laufendes Intervall, das um bisMs endet (jetzt = Berliner Wanduhr von nowMs). */
function offenText(bisMs, nowMs, jetzt) {
  const siebenTage = zuUtcOderDanach(plusTage(jetzt.tag, RUND_TAGE), jetzt.uhrzeit).getTime()
  if (bisMs >= siebenTage) return 'Rund um die Uhr geöffnet'
  const ende = ausUtc(new Date(bisMs))
  if (bisMs - nowMs <= 24 * STUNDE_MS) return `Jetzt geöffnet · schließt um ${uhrText(ende.uhrzeit)}`
  // Schluss genau um Mitternacht: der Tag, der endet („bis Dienstag Mitternacht“), nicht der Folgetag
  const tag = ende.uhrzeit === '00:00' ? plusTage(ende.tag, -1) : ende.tag
  return tagAbstand(jetzt.tag, tag, WOCHEN_TAGE) === null
    ? `Jetzt geöffnet · bis ${datumText(tag)} um ${uhrText(ende.uhrzeit)}`
    : `Jetzt geöffnet · bis ${wochentagsName(tag)} ${uhrText(ende.uhrzeit)}`
}

/** Text fuer die naechste Oeffnung (vonMs) von heute (Berliner Kalendertag) aus gesehen. */
function oeffnetText(vonMs, heute) {
  const start = ausUtc(new Date(vonMs))
  // Beginn um 00:00 heisst „0 Uhr“: „um Mitternacht“ wuerde als Tagesende gelesen
  const zeit = start.uhrzeit === '00:00' ? '0 Uhr' : uhrText(start.uhrzeit)
  const abstand = tagAbstand(heute, start.tag, WOCHEN_TAGE)
  if (abstand === 0) return `Geschlossen · öffnet heute um ${zeit}`
  if (abstand === 1) return `Geschlossen · öffnet morgen um ${zeit}`
  if (abstand === null) return `Geschlossen · öffnet am ${datumText(start.tag)} um ${zeit}`
  return `Geschlossen · öffnet ${wochentagsName(start.tag)} um ${zeit}`
}

/**
 * Status zum Zeitpunkt nowMs auf Basis fertiger Intervalle (muessen den Tag des Zeitpunkts minus 1 bis
 * mindestens 60 Tage danach abdecken, siehe oeffnungsIntervalle).
 */
function statusAus(daten, plan, nowMs, intervalle) {
  const jetzt = ausUtc(new Date(nowMs))
  const heute = jetzt.tag

  const laufend = intervalle.find((i) => i.vonMs <= nowMs && nowMs < i.bisMs)
  if (laufend) return { offen: true, text: offenText(laufend.bisMs, nowMs, jetzt), kurz: KURZ_OFFEN }

  const bild = tagesbild(daten, plan, heute)
  if (bild.modus === 'vereinbarung') return { offen: null, text: 'Heute nach Vereinbarung', kurz: KURZ_VEREINBARUNG }
  if (bild.modus === 'zu' && bild.art === 'urlaub') {
    const bis = datumText(urlaubBis(daten, plan, heute))
    return { offen: false, text: `Heute geschlossen (Betriebsurlaub bis ${bis})`, kurz: KURZ_ZU }
  }
  if (bild.modus === 'zu' && bild.art === 'feiertag') {
    const grund = bild.name ? `Feiertag: ${bild.name}` : 'Feiertag'
    return { offen: false, text: `Heute geschlossen (${grund})`, kurz: KURZ_ZU }
  }

  const grenze = plusTage(heute, SUCH_TAGE)
  const naechste = intervalle.find((i) => i.vonMs > nowMs)
  if (naechste && ausUtc(new Date(naechste.vonMs)).tag <= grenze) {
    return { offen: false, text: oeffnetText(naechste.vonMs, heute), kurz: KURZ_ZU }
  }
  return { offen: false, text: 'Derzeit geschlossen', kurz: KURZ_ZU }
}

/**
 * Status eines Plans zum Zeitpunkt now (Date, immer Parameter): { offen: true|false|null, text, kurz }.
 * Texte nach Spec 6 (ohne Anrede, nie „24 Uhr“); offen null = nach Vereinbarung. Wirft RangeError bei
 * ungueltigem now.
 */
export function statusZu(daten, plan, now) {
  const nowMs = pruefeJetzt(now)
  const heute = ausUtc(now).tag
  // 60 Tage Vorschau fuer die naechste Oeffnung; ein laenger laufendes Intervall ist ohnehin >= 7 Tage
  return statusAus(daten, plan, nowMs, oeffnungsIntervalle(daten, plan, heute, plusTage(heute, SUCH_TAGE)))
}

/**
 * Alle Statuswechsel der naechsten 8 Tage: [{ ab (UTC-ms), tag (Berliner Datum bei ab), offen, text, kurz }].
 * Der erste Eintrag gilt ab Beginn der aktuellen Minute; danach ein Eintrag je Aenderung von offen/text/kurz
 * an einer Intervallgrenze (Oeffnen/Schliessen) und an jeder Berliner Mitternacht (z. B. „morgen“ -> „heute“).
 * Nicht enthalten sind Textwechsel mitten am Tag, die nur die Restdauer betreffen (bis Dienstag -> schliesst um).
 */
export function wechselListe(daten, plan, now) {
  const startMs = Math.floor(pruefeJetzt(now) / MINUTE_MS) * MINUTE_MS
  const start = ausUtc(new Date(startMs))
  const endeMs = zuUtcOderDanach(plusTage(start.tag, WECHSEL_TAGE), start.uhrzeit).getTime()
  // 8 Tage Wechsel + 60 Tage Vorschau fuer den letzten Eintrag
  const intervalle = oeffnungsIntervalle(daten, plan, start.tag, plusTage(start.tag, WECHSEL_TAGE + SUCH_TAGE))

  const kandidaten = new Set([startMs])
  const vormerken = (ms) => {
    if (ms > startMs && ms < endeMs) kandidaten.add(ms)
  }
  for (const i of intervalle) {
    vormerken(i.vonMs)
    vormerken(i.bisMs)
  }
  for (let n = 1; n <= WECHSEL_TAGE; n += 1) vormerken(zuUtcOderDanach(plusTage(start.tag, n), '00:00').getTime())

  const liste = []
  let vorher = null
  for (const ms of [...kandidaten].sort((a, b) => a - b)) {
    const s = statusAus(daten, plan, ms, intervalle)
    if (vorher && vorher.offen === s.offen && vorher.text === s.text && vorher.kurz === s.kurz) continue
    vorher = s
    liste.push({ ab: ms, tag: ausUtc(new Date(ms)).tag, offen: s.offen, text: s.text, kurz: s.kurz })
  }
  return liste
}

/**
 * Tagesbilder fuer die API: anzahl aufeinanderfolgende Tage ab vonTag als
 * [{ datum, art, name, modus, fenster }] (wie tagesbild, nur heisst der Tag „datum“).
 * Ungueltiger Tag oder anzahl ausserhalb 0..366 wirft RangeError.
 */
export function tageListe(daten, plan, vonTag, anzahl) {
  pruefeTag(vonTag, 'vonTag')
  if (!Number.isInteger(anzahl) || anzahl < 0 || anzahl > MAX_TAGE_LISTE) {
    throw new RangeError(`anzahl: ungueltig ${String(anzahl)}`)
  }
  const liste = []
  let tag = vonTag
  for (let i = 0; i < anzahl; i += 1) {
    const b = tagesbild(daten, plan, tag)
    liste.push({ datum: b.tag, art: b.art, name: b.name, modus: b.modus, fenster: b.fenster })
    tag = plusTage(tag, 1)
  }
  return liste
}

// ------------------------------------------------------------------ Hinweise

/** Rang der Hinweisarten (Spec 4.1): der Browser zeigt den gueltigen Hinweis mit dem hoechsten Rang. */
export const HINWEIS_RANG = Object.freeze({ wichtig: 4, urlaub: 3, aktion: 2, info: 1 })

const HINWEIS_VORLAUF_TAGE = 8 // Spec 4.1: aktuell gueltige Hinweise + Beginn in 8 Tagen
const ENDLOS_MS = 8.64e15 // letzter darstellbarer Date-Wert: „ohne Ende“ bleibt eine vergleichbare Zahl (JSON-tauglich)
const KNOPF_ARTEN = Object.freeze(['link', 'anruf'])

const fehlt = (v) => v === undefined || v === null || v === ''

/**
 * Zeitraum eines Hinweises als UTC-Millisekunden { ab, bis }: von = Beginn 00:00, bis = Ende 24:00 (also der
 * Beginn des Folgetags), beides in Berliner Zeit. Fehlt von, beginnt der Hinweis „schon immer“ (ab 0), fehlt bis,
 * endet er nie (bis 8.64e15, der letzte darstellbare Date-Wert). Ein vorhandener, aber unlesbarer Tag
 * (oder ein Hinweis, der kein Objekt ist) ergibt null.
 */
export function hinweisZeitraum(h) {
  if (!h || typeof h !== 'object') return null
  const { von, bis } = h
  if ((!fehlt(von) && !gueltigerTag(von)) || (!fehlt(bis) && !gueltigerTag(bis))) return null
  return {
    ab: fehlt(von) ? 0 : zuUtcOderDanach(von, '00:00').getTime(),
    bis: fehlt(bis) ? ENDLOS_MS : zuUtcOderDanach(bis, '24:00').getTime(),
  }
}

/** Knopf eines Hinweises als Kopie { art, ziel, text } oder null, wenn er unbrauchbar ist (Task 8 prueft beim Speichern). */
function knopfKopie(k) {
  if (!k || typeof k !== 'object' || !KNOPF_ARTEN.includes(k.art) || typeof k.ziel !== 'string' || k.ziel === '') return null
  return { art: k.art, ziel: k.ziel, text: typeof k.text === 'string' ? k.text : '' }
}

/**
 * Die zum Zeitpunkt now gueltigen Hinweise sowie die, die in hoechstens 8 Tagen beginnen:
 * [{ art, text, knopf, ab, bis, rang }] in gespeicherter Reihenfolge, ohne interne IDs. Die Auswahl des
 * anzuzeigenden Hinweises trifft der Browser (hoechster Rang, bei Gleichstand spaeterer Beginn).
 * Uebersprungen werden Hinweise ohne Text, mit unbekannter Art, unlesbaren Tagen oder bis <= von.
 * „8 Tage“ = dieselbe Wanduhrzeit 8 Kalendertage spaeter (minutengenau, wie wechselListe).
 */
export function gueltigeHinweise(daten, now) {
  const nowMs = pruefeJetzt(now)
  const jetzt = ausUtc(now)
  const grenzeMs = zuUtcOderDanach(plusTage(jetzt.tag, HINWEIS_VORLAUF_TAGE), jetzt.uhrzeit).getTime()
  const liste = Array.isArray(daten?.hinweise) ? daten.hinweise : []

  const ergebnis = []
  for (const h of liste) {
    if (!h || typeof h.text !== 'string' || h.text.trim() === '') continue
    if (typeof h.art !== 'string' || !Object.hasOwn(HINWEIS_RANG, h.art)) continue
    const z = hinweisZeitraum(h)
    if (!z || z.bis <= z.ab || z.bis <= nowMs || z.ab > grenzeMs) continue
    ergebnis.push({ art: h.art, text: h.text, knopf: knopfKopie(h.knopf), ab: z.ab, bis: z.bis, rang: HINWEIS_RANG[h.art] })
  }
  return ergebnis
}

// ------------------------------------------------------------------ JSON-LD und Google-Text

const WOCHENTAGE_EN = Object.freeze(['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'])
const SONDER_TAGE = 60 // Spec 4.3/3.4: Sonderzeiten der naechsten 60 Tage (heute inklusive)

/** Ist das einzige/gemeinte Fenster 00:00–24:00 (= rund um die Uhr)? */
const ganztags = (f) => f[0] === '00:00' && f[1] === '24:00'

/** Ende fuer Anzeige und JSON-LD: nie '24:00', sondern '00:00' (closes < opens = Folgetag). */
const endeAnzeige = (bis) => (bis === '24:00' ? '00:00' : bis)

/**
 * Oeffnungspaare [opens, closes] eines Tagesbildes fuer JSON-LD: 'rund' und ein Fenster 00:00–24:00 =
 * 00:00–23:59, Fenster ueber Mitternacht mit closes < opens, Ende 24:00 als 00:00; 'zu' und 'vereinbarung' = [].
 */
function ldPaare(modus, fenster) {
  if (modus === 'rund') return [['00:00', '23:59']]
  if (modus !== 'zeiten') return []
  return fenster.map((f) => (ganztags(f) ? ['00:00', '23:59'] : [f[0], endeAnzeige(f[1])]))
}

const ldSpezifikation = (extra) => ({ '@type': 'OpeningHoursSpecification', ...extra })

/**
 * Sonderzeiten der naechsten 60 Tage (heute bis heute + 59) als zusammenhaengende Laeufe gleicher Zeiten:
 * [{ von, bis, text, name, zeiten }] mit zeiten = JSON-String der Tagesfenster; gleiche aufeinanderfolgende
 * Sondertage (Art 'feiertag'/'urlaub'/'sondertag', nicht 'regulaer') sind ein Lauf. Mit gruppeNachGrund
 * trennen auch unterschiedliche Namen/Arten die Laeufe (Google-Text), sonst nicht (JSON-LD).
 */
function sonderLaeufe(daten, plan, heute, gruppeNachGrund, zeitenVon) {
  const laeufe = []
  let lauf = null
  for (const t of tageListe(daten, plan, heute, SONDER_TAGE)) {
    if (t.art === 'regulaer') {
      lauf = null
      continue
    }
    const zeiten = zeitenVon(t)
    const grund = gruppeNachGrund ? `${t.art}|${t.name ?? ''}` : ''
    if (lauf && lauf.zeiten === zeiten && lauf.grund === grund && plusTage(lauf.bis, 1) === t.datum) {
      lauf.bis = t.datum
    } else {
      lauf = { von: t.datum, bis: t.datum, zeiten, grund, tag: t }
      laeufe.push(lauf)
    }
  }
  return laeufe
}

/**
 * Daten fuer schema.org: { openingHoursSpecification, specialOpeningHoursSpecification, neuerBlock }.
 * - openingHoursSpecification: je Wochentag und Fenster ein Eintrag { '@type', dayOfWeek, opens, closes };
 *   Fenster ueber Mitternacht mit closes < opens, Ende 24:00 als '00:00', „rund“ 00:00–23:59,
 *   „nach Vereinbarung“ und „zu“ ausgelassen.
 * - specialOpeningHoursSpecification: Feiertage mit Abweichung oder Vorgabe, Urlaub und Sondertage der naechsten
 *   60 Tage (heute bis heute + 59, ein laufender Zeitraum beginnt heute) als { '@type', validFrom, validThrough,
 *   opens, closes }; aufeinanderfolgende Tage mit gleichen Zeiten sind ein Zeitraum, geschlossen = 00:00–00:00.
 *   „Nach Vereinbarung“ kennt JSON-LD nicht: an Sondertagen zaehlt es als geschlossen (sonst blieben die
 *   Wochenzeiten des Tages stehen).
 * - neuerBlock: vollstaendiger Block { '@context': 'https://schema.org', '@type': 'LocalBusiness', ... } ohne
 *   name/address/url (die setzt das Website-Skript; das https-Literal liefert deshalb der Server).
 * Ohne Plan (null) sind beide Listen leer.
 */
export function jsonLdFuer(daten, plan, now) {
  pruefeJetzt(now)
  const heute = ausUtc(now).tag

  const woche = []
  const sonder = []
  if (plan && typeof plan === 'object') {
    for (let tag = 1; tag <= 7; tag += 1) {
      const { modus, fenster } = modusUndFenster(plan.tage?.[tag])
      for (const [opens, closes] of ldPaare(modus, fenster)) {
        woche.push(ldSpezifikation({ dayOfWeek: WOCHENTAGE_EN[tag - 1], opens, closes }))
      }
    }
    const geschlossen = [['00:00', '00:00']]
    const zeitenVon = (t) => JSON.stringify(ldPaare(t.modus, t.fenster))
    for (const lauf of sonderLaeufe(daten, plan, heute, false, zeitenVon)) {
      const paare = ldPaare(lauf.tag.modus, lauf.tag.fenster)
      for (const [opens, closes] of paare.length ? paare : geschlossen) {
        sonder.push(ldSpezifikation({ validFrom: lauf.von, validThrough: lauf.bis, opens, closes }))
      }
    }
  }

  return {
    openingHoursSpecification: woche,
    specialOpeningHoursSpecification: sonder,
    neuerBlock: {
      '@context': 'https://schema.org',
      '@type': 'LocalBusiness',
      openingHoursSpecification: woche.map((e) => ({ ...e })),
      specialOpeningHoursSpecification: sonder.map((e) => ({ ...e })),
    },
  }
}

/** Tageszeiten als Text: „09:00–12:30, 13:30–18:00“, „geschlossen“, „rund um die Uhr“, „nach Vereinbarung“ (nie '24:00'). */
function tagText(modus, fenster) {
  if (modus === 'rund' || (modus === 'zeiten' && fenster.length === 1 && ganztags(fenster[0]))) return 'rund um die Uhr'
  if (modus === 'vereinbarung') return 'nach Vereinbarung'
  if (modus !== 'zeiten') return 'geschlossen'
  return fenster.map((f) => `${f[0]}–${endeAnzeige(f[1])}`).join(', ')
}

/**
 * Text zum Kopieren in das Google-Profil (Spec 3.4 Bereich 6): sieben Zeilen Montag bis Sonntag
 * („Montag: 09:00–12:30, 13:30–18:00“, „Sonntag: geschlossen“), danach, durch eine Leerzeile getrennt, die
 * Sonderzeiten der naechsten 60 Tage („12.10.–16.10.: geschlossen (Betriebsurlaub)“, „03.10.: geschlossen
 * (Tag der Deutschen Einheit)“; aufeinanderfolgende Tage mit gleichen Zeiten und gleichem Grund in einer Zeile).
 * Zeilen mit \n getrennt, kein abschliessender Zeilenumbruch. Ohne Plan ''.
 */
export function googleText(daten, plan, now) {
  pruefeJetzt(now)
  const heute = ausUtc(now).tag
  if (!plan || typeof plan !== 'object') return ''

  const zeilen = []
  for (let tag = 1; tag <= 7; tag += 1) {
    const { modus, fenster } = modusUndFenster(plan.tage?.[tag])
    zeilen.push(`${WOCHENTAGE[tag - 1]}: ${tagText(modus, fenster)}`)
  }

  const laeufe = sonderLaeufe(daten, plan, heute, true, (t) => tagText(t.modus, t.fenster))
  if (laeufe.length) {
    zeilen.push('', `Sonderzeiten (nächste ${SONDER_TAGE} Tage):`)
    for (const lauf of laeufe) {
      const datum = lauf.von === lauf.bis ? datumText(lauf.von) : `${datumText(lauf.von)}–${datumText(lauf.bis)}`
      const grund = lauf.tag.name ?? (lauf.tag.art === 'urlaub' ? 'Betriebsurlaub' : null)
      zeilen.push(`${datum}: ${lauf.zeiten}${grund ? ` (${grund})` : ''}`)
    }
  }
  return zeilen.join('\n')
}

// ------------------------------------------------------------------ Erinnerung

const ERINNERUNG_TAGE = 7 // Spec 7: Tage in 1–7 Tagen
const ERINNERUNG_VON = '08:00' // Berliner Zeit, einschliesslich
const ERINNERUNG_BIS = '20:00' // Berliner Zeit, ausschliesslich

/** Hat der Kunde fuer diesen Tag unter daten.feiertage schon eine Abweichung gespeichert? */
function abweichungGespeichert(daten, tag) {
  const f = daten?.feiertage
  return !!f && typeof f === 'object' && Object.hasOwn(f, tag) && !!f[tag] && typeof f[tag] === 'object'
}

/**
 * Feiertage und „bitte pruefen“-Tage des Landes in 1–7 Berliner Tagen ab heute, zu denen der Kunde erinnert werden
 * soll: [{ tag, name, art: 'feiertag'|'pruefen' }]. Nicht dabei sind Tage, an denen der Hauptplan an diesem
 * Wochentag ohnehin zu ist, eine Ausnahme (Urlaub/Sondertag, global oder fuer den Hauptplan) den Tag abdeckt oder
 * der Kunde unter daten.feiertage[tag] schon eine Abweichung gespeichert hat. Ohne Hauptplan [].
 */
export function erinnerungsTage(daten, now) {
  pruefeJetzt(now)
  const haupt = hauptplan(daten)
  if (!haupt) return []
  const heute = ausUtc(now).tag

  const ergebnis = []
  for (const e of feiertageImZeitraum(plusTage(heute, 1), plusTage(heute, ERINNERUNG_TAGE), landVon(daten))) {
    if (modusUndFenster(haupt.tage?.[wochentag(e.tag)]).modus === 'zu') continue
    if (ausnahmeFuer(daten, haupt.id, e.tag, 'urlaub') || ausnahmeFuer(daten, haupt.id, e.tag, 'sondertag')) continue
    if (abweichungGespeichert(daten, e.tag)) continue
    ergebnis.push({ tag: e.tag, name: e.name, art: e.art })
  }
  return ergebnis
}

/** Liegt now zwischen 08:00 (einschliesslich) und 20:00 (ausschliesslich) Berliner Zeit? */
export function imErinnerungsfenster(now) {
  pruefeJetzt(now)
  const { uhrzeit } = ausUtc(now)
  return uhrzeit >= ERINNERUNG_VON && uhrzeit < ERINNERUNG_BIS
}