Analyse: Zeitraum = abgeschlossene Tage, "Heute bisher" getrennt, Feinschliff

Final-Review-Fixwelle der Cockpit-Übersicht:

- F1 Collector: Der Zeitraum sind die range Kalendertage bis gestern (Berliner Tag),
  der Vorzeitraum die range Tage davor; heute steht getrennt in today { day, pv, visitors,
  contacts }. Kein Einbruch mehr am rechten Rand von Diagramm und Mini-Verläufen,
  kein falsches "x % weniger" tagsüber. Portal: weekdayStats bekommt die ganze Reihe
  (completedDays entfällt), "Vergleich ab" = firstDay + 2 x range, Kopfzeile
  "Analyse aktiv · Heute bisher: N Aufrufe · Stand: HH:MM Uhr" (alter Collector ohne today
  bleibt ohne "Heute bisher").
- F2 "direkt kontaktiert" zählt nur Telefon, E-Mail und WhatsApp (auch im Vorzeitraum),
  Links nach außen nicht.
- F3 Mini-Verlauf "Ø Zeit pro Seite": Tage ohne Messung sind Lücken statt 0-Tälern.
- F4 Fehlerfarbe beim Ausschalten rot, --an-faint auf 55 %, Achsenschrift per
  Container-Abfragen auf 11-12 px (y-Rand wächst mit der Stellenzahl, x-Beschriftungen mit
  Mindestabstand), Ranglisten-Anteile an allen Seitenaufrufen, Tippflächen bis 880 px
  mindestens 40 px hoch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

test/analyticsContract.test.js

@@ -4,6 +4,8 @@ import assert from 'node:assert/strict'
 import { createAnalyticsClient } from '../server/services/analyticsClient.js'
 import { createAdminServer, createPublicServer } from '../analytics/src/server.js'
 import { openDb } from '../analytics/src/db.js'
+import { computeStats } from '../analytics/src/stats.js'
+import { compareFrom, shortDay } from '../public/analyse-view.js'
 
 const SITE = 'abcdef0123456789abcd'
 const DOMAIN = 'kunde.example.com'
@@ -39,9 +41,18 @@ test('Vertrag: putSite -> Ereignisse -> getStats -> heatToken -> deleteSite', as
   await post({ t: 'ct', path: '/', kind: 'tel' })
   await post({ t: 'bn', a: 'accept' })
 
+  // Frisch gemessen: heute steht nur in `today`, der Zeitraum sind die abgeschlossenen Tage bis gestern
+  const jetzt = await client.getStats(SITE, '7')
+  assert.deepEqual(jetzt.today, { day: jetzt.today.day, pv: 3, visitors: 1, contacts: 1 })
+  assert.equal(jetzt.totals.pv, 0)
+  assert.ok(jetzt.today.day > jetzt.to && jetzt.series.every((d) => d.day <= jetzt.to))
+  // Um 36 Stunden zurückdatieren: liegt immer auf einem abgeschlossenen Tag des 7-Tage-Zeitraums
+  db.prepare('UPDATE events_raw SET ts = ts - 36 * 3600 * 1000 WHERE site = ?').run(SITE)
+
   const stats = await client.getStats(SITE, '7')
   assert.equal(stats.totals.pv, 3)
   assert.equal(stats.totals.contacts, 1)
+  assert.equal(stats.today.pv, 0)
   assert.equal(stats.series.length, 7)
   assert.equal(stats.series.reduce((n, d) => n + d.pv, 0), 3)
   assert.equal(stats.range, 7)
@@ -76,3 +87,22 @@ test('Vertrag: stopSite setzt active=0 und offSince, unbekannt zaehlt als erledi
   assert.equal(db.prepare('SELECT offSince FROM sites WHERE siteKey = ?').get(KEY2).offSince, row.offSince)
   assert.deepEqual(await client.stopSite('00000000000000000000'), { ok: true, missing: true })
 })
+
+test('Vertrag: "Vergleich ab" des Portals ist der erste Tag, an dem der Collector den Vorzeitraum als vollständig meldet', () => {
+  const firstDay = '2026-09-20'
+  const evDb = openDb(':memory:')
+  evDb.prepare('INSERT INTO sites (siteKey, projectId, domains, active) VALUES (?,?,?,1)').run(SITE, 'p1', '["a.de"]')
+  evDb.prepare("INSERT INTO events_raw (site, ts, type, path, vp, country, device) VALUES (?,?,'pv','/','d','DE','d')").run(SITE, Date.UTC(2026, 8, 20, 10))
+  for (const range of [7, 30]) {
+    const addDays = (day, n) => new Date(Date.UTC(+day.slice(0, 4), +day.slice(5, 7) - 1, +day.slice(8, 10) + n)).toISOString().slice(0, 10)
+    const at = (day) => computeStats(evDb, SITE, range, Date.parse(`${day}T10:00:00Z`))
+    const first = addDays(firstDay, 2 * range) // "Vergleich ab" laut Portal
+    const dayBefore = at(addDays(first, -1))
+    assert.equal(dayBefore.previous.complete, false, `range ${range}: am Tag davor noch nicht vollständig`)
+    assert.deepEqual(compareFrom(dayBefore), { ok: false, from: shortDay(first) })
+    const onDay = at(first)
+    assert.equal(onDay.previous.complete, true, `range ${range}: am Tag selbst vollständig`)
+    assert.equal(onDay.previous.from, firstDay)
+    assert.equal(compareFrom(onDay).from, '') // kein Datum mehr (der Vorzeitraum ist voll; ok bleibt false, denn es gibt nur 1 Aufruf)
+  }
+})