Files
Webklar-Kundenbereich/test/publicZeiten.test.js
T
ClaudeandClaude Opus 5.5 d1f9176c99 Öffnungszeiten: öffentliche Route
GET /api/public/zeiten/v1/:siteKey mit CORS *, OPTIONS 204, 405, weichem ETag
ohne stand, Cache-Control max-age=60, Expose-Headers Date, Grenze 120 je Minute
und IP (zeiten/limits.js), 503 ohne Details und 404 für unbekannte Pfade.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 01:19:43 +00:00

349 lines
17 KiB
JavaScript

import { test, after, beforeEach, afterEach, mock } from 'node:test'
import assert from 'node:assert/strict'
import { readFileSync } from 'node:fs'
import { startAppwriteMock } from './support/appwriteMock.js'
import { schemaKeys } from './support/schema.js'
import { useTestEnv } from './support/testEnv.js'
import { ZEITEN_DATETIMES } from '../server/services/zeiten/schema.js'
// Oeffentliche Schnittstelle der Oeffnungszeiten (/api/public/zeiten/v1, Spezifikation 2026-10-04-oeffnungszeiten-live-design.md,
// Abschnitt 4.1): Router im Nachbau von Appwrite, feste Uhr (setzeUhrFuerTests), je Test eine eigene Client-Adresse (X-Forwarded-For).
const aw = await startAppwriteMock({
schema: {
portalFeatures: schemaKeys('portalFeatures'),
oeffnungszeiten: schemaKeys('oeffnungszeiten'),
zeitenErinnerungen: schemaKeys('zeitenErinnerungen'),
},
datetimes: ZEITEN_DATETIMES,
defaultLimit: 25,
})
useTestEnv({ appwriteUrl: aw.url, stripeUrl: 'http://127.0.0.1:1' })
const { config } = await import('../server/config.js')
const { deleteDocument } = await import('../server/services/appwriteAdmin.js')
const { startTestApp, send } = await import('./support/testApp.js')
const { kundenansichtCookie } = await import('./support/fixtures.js')
const { kundenansichtGuard } = await import('../server/middleware/kundenansichtGuard.js')
const { resetZeitenCacheForTests } = await import('../server/services/zeiten/cache.js')
const { speichereZeiten } = await import('../server/services/zeiten/speicher.js')
const { darfZeitenAnfrage } = await import('../server/services/zeiten/limits.js')
const { resetTermineLimitsForTests } = await import('../server/services/termine/limits.js')
const { default: router, setzeUhrFuerTests, resetPublicZeitenForTests } = await import('../server/routes/publicZeiten.js')
const app = await startTestApp({ '/': kundenansichtGuard, '/api/public/zeiten/v1': router })
after(() => Promise.all([app.close(), aw.close()]))
const BASIS = '/api/public/zeiten/v1'
const JETZT = new Date('2026-10-05T10:00:00.000Z') // Berlin: Montag 2026-10-05 12:00
const SITE_KEY = 'abcdabcdabcdabcd'
const KUNDE = 'c_kunde01'
const PROJEKT = 'p_projekt01'
const FEATURE_ID = 'f_p_projekt01_zeiten'
const P_STANDARD = 'p_aaaaaaa1'
const MODUS_VORHER = config.zeiten.mode
const FEATURE = { $id: FEATURE_ID, customerId: KUNDE, projectId: PROJEKT, siteKey: SITE_KEY, featureKey: 'zeiten', state: 'active', enabled: true }
const tage = (woche = {}) => {
const t = {}
for (let d = 1; d <= 7; d += 1) t[d] = woche[d] ? { modus: 'zeiten', fenster: [woche[d]] } : { modus: 'zu', fenster: [] }
return t
}
const eingabe = (extra = {}) => ({
land: 'RP',
plaene: [
{ id: P_STANDARD, kurz: 'standard', name: 'Standard', haupt: true, tage: tage({ 1: ['09:00', '18:00'], 2: ['09:00', '18:00'], 3: ['09:00', '18:00'], 4: ['09:00', '18:00'], 5: ['09:00', '18:00'] }) },
],
feiertage: {},
ausnahmen: [],
hinweise: [{ id: 'h_dauer001', art: 'info', text: 'Wir sind für Euch da.', knopf: null }],
kontakt: { an: true, telefon: '0171 1234567', adresse: 'Hauptstraße 1, 67722 Winnweiler', whatsapp: null },
...extra,
})
/** Funktion, Kunde und Projekt in den Nachbau legen; mit zeiten = false bleibt es beim leeren Dokument. */
async function legeAn({ feature = {}, kunde = { name: 'Frau Sonne', companyName: 'Bäckerei Sonnenschein' }, zeiten = true, extra = {} } = {}) {
aw.seed('portalFeatures', { ...FEATURE, ...feature })
if (kunde) aw.seed('customers', { $id: KUNDE, ...kunde })
aw.seed('websiteProjects', { $id: PROJEKT, customerId: KUNDE, projectName: 'Sonnenschein-Website' })
if (zeiten) await speichereZeiten({ feature: FEATURE, eingabe: eingabe(extra), version: 0, by: 'kunde', now: JETZT })
}
let clientIp = 0
let ip
/** Anfrage an die Schnittstelle: Pfad ab /v1, eigene Client-Adresse je Test. */
const api = (method, pfad, { ip: adresse = ip, headers = {}, ...opts } = {}) =>
send(method, BASIS + pfad, { ...opts, headers: { 'x-forwarded-for': adresse, ...headers } })
const lies = (pfad = `/${SITE_KEY}`, opts) => api('GET', pfad, opts)
beforeEach(async () => {
for (const collection of ['portalFeatures', 'oeffnungszeiten', 'zeitenErinnerungen', 'customers', 'websiteProjects']) {
for (const id of [...aw.docs(collection).keys()]) await deleteDocument(collection, id)
}
config.zeiten.mode = 'on'
resetZeitenCacheForTests()
resetTermineLimitsForTests()
resetPublicZeitenForTests()
setzeUhrFuerTests(() => JETZT)
mock.method(console, 'error', () => {})
mock.method(console, 'warn', () => {})
clientIp += 1
ip = `198.51.100.${clientIp}`
})
afterEach(() => {
config.zeiten.mode = MODUS_VORHER
mock.restoreAll()
resetPublicZeitenForTests()
})
const AKTIV_FALSE = { aktiv: false }
const NICHT_ERREICHBAR = { error: 'Vorübergehend nicht erreichbar.' }
// ---------------------------------------------------------------- CORS, Methoden
test('CORS * und OPTIONS 204', async () => {
const vorab = await api('OPTIONS', `/${SITE_KEY}`, { headers: { origin: 'https://baeckerei.example', 'access-control-request-method': 'GET' } })
assert.equal(vorab.status, 204)
assert.equal(vorab.headers.get('access-control-allow-origin'), '*')
assert.equal(vorab.headers.get('access-control-allow-methods'), 'GET, HEAD, OPTIONS')
assert.match(vorab.headers.get('access-control-allow-headers'), /If-None-Match/)
assert.equal(vorab.headers.get('access-control-max-age'), '86400')
assert.equal(vorab.body, null)
await legeAn()
const antwort = await lies(undefined, { headers: { origin: 'https://baeckerei.example' } })
assert.equal(antwort.status, 200)
assert.equal(antwort.headers.get('access-control-allow-origin'), '*')
assert.equal(antwort.headers.get('set-cookie'), null)
assert.equal(antwort.headers.get('x-content-type-options'), 'nosniff')
assert.match(antwort.headers.get('content-type'), /^application\/json/)
// der Preflight zaehlt nicht gegen die Grenze und ist auch auf unbekannten Pfaden ein 204
const anderswo = await api('OPTIONS', '/irgendwas/anderes')
assert.equal(anderswo.status, 204)
assert.equal(anderswo.headers.get('access-control-allow-origin'), '*')
})
test('nur GET/HEAD, sonst 405', async () => {
await legeAn()
for (const method of ['POST', 'PUT', 'PATCH', 'DELETE']) {
const res = await api(method, `/${SITE_KEY}`, { body: { a: 1 } })
assert.equal(res.status, 405, method)
assert.deepEqual(res.body, { error: 'Methode nicht erlaubt' }, method)
assert.equal(res.headers.get('access-control-allow-origin'), '*', `${method}: die Meldung bleibt fuer das Skript lesbar`)
}
const head = await api('HEAD', `/${SITE_KEY}`)
assert.equal(head.status, 200)
assert.equal(head.body, null, 'HEAD ohne Rumpf')
assert.match(head.headers.get('etag'), /^W\/"[A-Za-z0-9_-]{27}"$/)
assert.equal(head.headers.get('cache-control'), 'public, max-age=60')
})
// ---------------------------------------------------------------- Kopfzeilen, ETag
test('Cache-Control public, max-age=60 und Expose-Headers Date', async () => {
await legeAn()
const res = await lies()
assert.equal(res.status, 200)
assert.equal(res.headers.get('cache-control'), 'public, max-age=60')
assert.equal(res.headers.get('access-control-expose-headers'), 'Date')
assert.equal(res.body.aktiv, true)
assert.equal(res.body.stand, JETZT.toISOString())
assert.equal(res.body.plaene.length, 1)
assert.equal(res.body.firma.name, 'Bäckerei Sonnenschein')
// auch die kurze Antwort { aktiv: false } und die Fehlerantworten tragen die Date-Freigabe, damit das Skript die Serverzeit lesen kann
const leer = await lies('/zzzzzzzzzzzzzzzz')
assert.equal(leer.headers.get('access-control-expose-headers'), 'Date')
assert.equal(leer.headers.get('cache-control'), 'public, max-age=60')
const fremd = await api('POST', `/${SITE_KEY}`)
assert.equal(fremd.headers.get('access-control-expose-headers'), 'Date')
})
test('Antwort ohne interne IDs, Kundendaten und Zugangswerte', async () => {
await legeAn({ kunde: { name: 'Frau Sonne', companyName: 'Bäckerei Sonnenschein', email: 'sonne@example.com', phone: '0699' } })
const res = await lies()
const text = JSON.stringify(res.body)
for (const intern of [FEATURE_ID, KUNDE, PROJEKT, SITE_KEY, P_STANDARD, 'h_dauer001', 'Frau Sonne', 'sonne@example.com', 'Sonnenschein-Website']) {
assert.ok(!text.includes(intern), `Wert ${intern}`)
}
})
test('ETag bleibt gleich, obwohl stand sich ändert ⇒ 304', async () => {
await legeAn()
const erste = await lies()
assert.equal(erste.status, 200)
const etag = erste.headers.get('etag')
assert.match(etag, /^W\/"[A-Za-z0-9_-]{27}"$/, 'weiches ETag, sha1 base64url')
// der Speicher laeuft nach 30 s ab und die Antwort wird neu gebaut: gleiche Daten, neuer Zeitstempel (noch dieselbe Minute:
// der erste Eintrag von wechsel beginnt mit der aktuellen Minute und gehoert zum Body)
setzeUhrFuerTests(() => new Date(JETZT.getTime() + 30 * 1000))
const neu = await lies()
assert.equal(neu.status, 200)
assert.notEqual(neu.body.stand, erste.body.stand, 'stand ist neu')
assert.equal(neu.headers.get('etag'), etag, 'das ETag haengt nicht an stand')
const bedingt = await lies(undefined, { headers: { 'if-none-match': etag } })
assert.equal(bedingt.status, 304)
assert.equal(bedingt.body, null)
assert.equal(bedingt.headers.get('etag'), etag)
assert.equal(bedingt.headers.get('cache-control'), 'public, max-age=60')
assert.equal(bedingt.headers.get('access-control-allow-origin'), '*')
for (const wert of [etag.slice(2), `"abc", ${etag}`, '*']) {
const res = await lies(undefined, { headers: { 'if-none-match': wert } })
assert.equal(res.status, 304, wert)
}
const veraltet = await lies(undefined, { headers: { 'if-none-match': 'W/"nicht-mehr-aktuell"' } })
assert.equal(veraltet.status, 200)
})
test('ETag ändert sich mit dem Inhalt (Hinweis geändert) und ist für { aktiv: false } stabil', async () => {
await legeAn()
const vorher = (await lies()).headers.get('etag')
await speichereZeiten({ feature: FEATURE, eingabe: eingabe({ hinweise: [{ id: 'h_dauer001', art: 'info', text: 'Neuer Text', knopf: null }] }), version: 1, by: 'kunde', now: JETZT })
const nachher = await lies()
assert.equal(nachher.status, 200)
assert.equal(nachher.body.hinweise[0].text, 'Neuer Text')
assert.notEqual(nachher.headers.get('etag'), vorher)
const leer1 = await lies('/zzzzzzzzzzzzzzzz')
setzeUhrFuerTests(() => new Date(JETZT.getTime() + 5 * 60 * 1000))
const leer2 = await lies('/zzzzzzzzzzzzzzzz')
assert.deepEqual(leer1.body, AKTIV_FALSE)
assert.equal(leer1.headers.get('etag'), leer2.headers.get('etag'))
assert.equal((await lies('/zzzzzzzzzzzzzzzz', { headers: { 'if-none-match': leer1.headers.get('etag') } })).status, 304)
})
// ---------------------------------------------------------------- Grenze
test('121. Anfrage in einer Minute ⇒ 429 mit Retry-After', async () => {
await legeAn()
for (let i = 1; i <= 120; i += 1) {
const res = await lies()
assert.equal(res.status, 200, `Anfrage ${i}`)
}
const zuViele = await lies()
assert.equal(zuViele.status, 429)
assert.equal(zuViele.headers.get('retry-after'), '60')
assert.equal(zuViele.headers.get('access-control-allow-origin'), '*')
assert.equal(zuViele.headers.get('cache-control'), 'no-store')
assert.deepEqual(zuViele.body, { error: 'Zu viele Anfragen. Bitte versuch es gleich noch einmal.' })
// der Preflight zaehlt nicht, eine andere Adresse hat ihre eigene Grenze, nach einer Minute geht es wieder
assert.equal((await api('OPTIONS', `/${SITE_KEY}`)).status, 204)
assert.equal((await lies(undefined, { ip: '198.51.100.250' })).status, 200)
setzeUhrFuerTests(() => new Date(JETZT.getTime() + 60 * 1000))
assert.equal((await lies()).status, 200)
})
test('darfZeitenAnfrage: 120 je Minute und IP, IPv6 je /64, getrennt von den Zählern des Terminplaners', async () => {
const jetzt = new Date('2026-10-05T10:00:00.000Z')
for (let i = 0; i < 120; i += 1) assert.equal(darfZeitenAnfrage('203.0.113.9', jetzt), true, `Anfrage ${i + 1}`)
assert.equal(darfZeitenAnfrage('203.0.113.9', jetzt), false)
assert.equal(darfZeitenAnfrage('203.0.113.9', new Date(jetzt.getTime() + 59999)), false, 'das Fenster dauert 60 s')
assert.equal(darfZeitenAnfrage('203.0.113.9', new Date(jetzt.getTime() + 60000)), true)
assert.equal(darfZeitenAnfrage('203.0.113.10', jetzt), true, 'andere IP, anderer Zähler')
for (let i = 0; i < 120; i += 1) assert.equal(darfZeitenAnfrage('2001:db8:1:2:aaaa::1', jetzt), true)
assert.equal(darfZeitenAnfrage('2001:db8:1:2:bbbb::7', jetzt), false, 'dasselbe /64 teilt sich den Zähler')
assert.equal(darfZeitenAnfrage('2001:db8:1:3::1', jetzt), true)
const { darfAnfrage } = await import('../server/services/termine/limits.js')
assert.equal(darfAnfrage('203.0.113.9', jetzt), true, 'der Terminplaner zählt für dieselbe IP für sich')
})
// ---------------------------------------------------------------- Fehler
test('Appwrite-Fehler ⇒ 503 ohne Details', async () => {
await legeAn()
const RAW = 'Nachbau kaputt: geheimer Rohtext'
aw.failNext({ collection: 'portalFeatures', status: 500, message: RAW })
const res = await api('GET', `/${SITE_KEY}`)
assert.equal(res.status, 503)
assert.deepEqual(res.body, NICHT_ERREICHBAR)
assert.equal(res.headers.get('access-control-allow-origin'), '*')
assert.equal(res.headers.get('cache-control'), 'no-store')
assert.ok(!JSON.stringify(res.body).includes('Nachbau'))
assert.ok(console.error.mock.calls.length > 0, 'der Fehler steht im Log, nicht in der Antwort')
// nichts wurde gemerkt: danach geht es wieder
assert.equal((await lies()).status, 200)
})
// ---------------------------------------------------------------- aktiv:false
test('aktiv:false bei Schalter aus, unbekanntem Schlüssel, Zustand off/ordered/disabled', async () => {
await legeAn()
config.zeiten.mode = 'off'
const aus = await lies()
assert.equal(aus.status, 200)
assert.deepEqual(aus.body, AKTIV_FALSE)
assert.equal(aus.headers.get('access-control-allow-origin'), '*')
assert.equal(aus.headers.get('cache-control'), 'public, max-age=60')
config.zeiten.mode = 'on'
assert.equal((await lies()).body.aktiv, true)
assert.deepEqual((await lies('/zzzzzzzzzzzzzzzz')).body, AKTIV_FALSE, 'unbekannter Schluessel')
for (const kaputt of ['/ABCDABCDABCDABCD', '/abc', '/abcdabcdabcdabc1', `/${'a'.repeat(200)}`]) {
const res = await lies(kaputt)
assert.equal(res.status, 200, kaputt)
assert.deepEqual(res.body, AKTIV_FALSE, kaputt)
}
for (const state of ['off', 'ordered', 'disabled']) {
await legeAn({ feature: { state, enabled: false }, zeiten: false })
resetZeitenCacheForTests()
const res = await lies()
assert.equal(res.status, 200, state)
assert.deepEqual(res.body, AKTIV_FALSE, state)
}
for (const state of ['setup', 'active']) {
await legeAn({ feature: { state }, zeiten: false })
resetZeitenCacheForTests()
assert.equal((await lies()).body.aktiv, true, state)
}
})
test('Kunde gelöscht ⇒ aktiv:false', async () => {
await legeAn({ kunde: null })
assert.deepEqual((await lies()).body, AKTIV_FALSE)
})
// ---------------------------------------------------------------- Rest
test('unbekannter Pfad ⇒ 404 mit CORS', async () => {
for (const pfad of ['', '/', `/${SITE_KEY}/mehr`, '/a/b/c']) {
const res = await api('GET', pfad)
assert.equal(res.status, 404, pfad)
assert.deepEqual(res.body, { error: 'Nicht gefunden' }, pfad)
assert.equal(res.headers.get('access-control-allow-origin'), '*', pfad)
}
})
test('Kundenansicht-Cookie (Mitarbeiter im Portal eines Kunden) stört den öffentlichen Abruf nicht', async () => {
await legeAn()
const cookie = kundenansichtCookie()
const res = await lies(undefined, { cookie, headers: { 'x-kundenansicht': 'b'.repeat(32) } })
assert.equal(res.status, 200)
assert.equal(res.body.aktiv, true)
const abgelaufen = await lies(undefined, { cookie: kundenansichtCookie({ viewExpiresAt: Date.now() - 1000 }) })
assert.equal(abgelaufen.status, 200)
})
test('Reihenfolge in server/index.js: direkt nach dem Mount der News, hinter kundenansichtGuard, Termine unberührt', () => {
const quelle = readFileSync(new URL('../server/index.js', import.meta.url), 'utf8')
const guard = quelle.indexOf('app.use(kundenansichtGuard)')
const news = quelle.indexOf("app.use('/api/public/news', publicNewsRoutes)")
const zeiten = quelle.indexOf("app.use('/api/public/zeiten/v1', publicZeitenRoutes)")
const termine = quelle.indexOf("app.use('/api/public/termine/v1', publicTermineRoutes)")
assert.ok(guard >= 0 && news >= 0 && zeiten >= 0 && termine >= 0, 'alle Mounts gefunden')
assert.equal(quelle.indexOf("app.use('/api/public/zeiten/v1'", zeiten + 1), -1, 'nur einmal eingehaengt')
assert.ok(guard < zeiten, 'erst der Waechter der Kundenansicht')
assert.equal(quelle.slice(news, zeiten).split('\n').length, 2, 'unmittelbar die naechste Zeile')
assert.ok(termine < quelle.indexOf('app.use(express.json('), 'Termine bleibt vor dem globalen Parser')
assert.match(quelle, /import publicZeitenRoutes from '\.\/routes\/publicZeiten\.js'/)
})