presseportale/app/Console/Commands/ReportPressReleaseViews.php
Kevin Adametz 1c38c820f4 reports: Kohortenalter ab Stichtag statt ab --to; legacy:settle-unpaid kennt bereits ersetzte Quellen; dev: Basiswert 0.1 vom Live-System ausgewertet
view-distribution rechnete das Alter der Kohorten ab dem Enddatum des
Fensters, die Zähler stehen aber immer auf heute — mit einem --to in der
Vergangenheit waren alle Kohorten um die Verzögerung des Laufs zu jung.
Das Alter zählt jetzt ab dem Stichtag der Erhebung (Feld stichtag), junge
Kohorten fallen bei altem Enddatum leer aus.

settle-unpaid meldete beim zweiten Lauf einen Posten, dessen Quelle der
erste Lauf schon per MAN-Rechnung ersetzt hatte (superseded), als
Konflikt. Solche Quellen zählen jetzt als already_reissued.

Basiswerte Block 0: Live-Erhebung vom 21.09.2026 (gleiches Fenster,
Median 126/303 statt 98/200) eingetragen, Kohortenzeile mit Alters-
Versatz erklärt, letzter Schritt für 0.1 benannt (Lauf ohne --to).
Protokoll: Nach-Deploy-Schritte, Lesart von Audit und Rechnungslauf.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-21 15:32:32 +00:00

125 lines
4.7 KiB
PHP
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Console\Commands;
use App\Services\PressRelease\ViewDistributionReport;
use Illuminate\Console\Command;
use Illuminate\Support\Carbon;
/**
* Basiswert der Aufrufzahlen (Roadmap 0.1).
*
* Muss gemessen sein, BEVOR die erste Maßnahme aus Block 1 live geht — ohne
* Vergleichspunkt wird jede spätere Bewertung eine Vermutung. Die Verteilung
* entscheidet zugleich E2: ob die Absenderansicht Rohzahlen zeigt oder eine
* Einordnung gegen den Portalschnitt.
*/
class ReportPressReleaseViews extends Command
{
protected $signature = 'press-releases:view-distribution
{--months=3 : Zeitraum in Monaten rückwärts}
{--from= : Startdatum, überschreibt --months}
{--to= : Enddatum (Standard: heute)}
{--json : Ausgabe als JSON statt als Tabelle}';
protected $description = 'Basiswert: Verteilung der Aufrufzahlen je Portal (Median, Quartile, Häufigkeiten).';
public function handle(ViewDistributionReport $report): int
{
$to = $this->option('to') !== null ? Carbon::parse((string) $this->option('to')) : Carbon::now();
$from = $this->option('from') !== null
? Carbon::parse((string) $this->option('from'))
: $to->copy()->subMonths(max(1, (int) $this->option('months')));
$data = $report->build($from, $to);
if ($this->option('json')) {
$this->line((string) json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
return self::SUCCESS;
}
$this->info("Aufrufzahlen je Portal — veröffentlicht {$data['from']} bis {$data['to']}");
foreach ($data['portals'] as $portal) {
$this->newLine();
$this->line("<comment>{$portal['label']}</comment>");
$rows = [];
foreach ($portal['segments'] as $segment) {
$s = $segment['stats'];
if ($s['anzahl'] === 0) {
$rows[] = [$segment['segment'], 0, '–', '–', '–', '–', '–', '–', '–'];
continue;
}
$rows[] = [
$segment['segment'],
$s['anzahl'],
$s['min'],
$s['p10'],
$s['p25'],
$s['median'],
$s['p75'],
$s['p90'],
$s['max'],
];
}
$this->table(['Bestand', 'PMs', 'Min', 'P10', 'P25', 'Median', 'P75', 'P90', 'Max'], $rows);
$gesamt = $portal['segments'][0]['stats'];
if ($gesamt['anzahl'] === 0) {
continue;
}
$this->line(sprintf(
' Mittelwert %s gegenüber Median %d%s',
$gesamt['mittelwert'],
$gesamt['median'],
// Die Schiefe ist die eigentliche Antwort auf E2: Zieht eine
// Handvoll Ausreißer den Schnitt nach oben, liegt der typische
// Absender darunter und eine Rohzahl liest sich für ihn als
// Misserfolg.
$gesamt['mittelwert'] > $gesamt['median'] * 1.25
? ' ← rechtsschief, Rohzahlen wirken für die Mehrheit enttäuschend'
: '',
));
$verteilung = [];
foreach ($gesamt['verteilung'] as $klasse => $anzahl) {
$anteil = $gesamt['anzahl'] > 0 ? round($anzahl / $gesamt['anzahl'] * 100) : 0;
$verteilung[] = [$klasse.' Aufrufe', $anzahl, $anteil.' %'];
}
$this->table(['Klasse', 'PMs', 'Anteil'], $verteilung);
$kohorten = [];
foreach ($portal['cohorts'] as $cohort) {
$kohorten[] = [
$cohort['alter'],
$cohort['anzahl'],
$cohort['median'] ?? '–',
$cohort['mittelwert'] ?? '–',
];
}
if ($kohorten !== []) {
$this->line(" <comment>Aufrufe nach Alter am Stichtag {$data['stichtag']} (nur Meldungen seit dem Relaunch)</comment>");
$this->table(['Alter der Meldung', 'PMs', 'Median', 'Mittelwert'], $kohorten);
// Der Gesamtmedian oben hängt an der Altersmischung des
// Fensters und ist zwischen zwei Messzeitpunkten nicht
// vergleichbar. Die einzelne Kohorte ist es.
$this->line(' Als Basiswert die KOHORTE festhalten, nicht den Gesamtmedian — nur sie ist später identisch erhebbar.');
}
}
return self::SUCCESS;
}
}