monitor/api/tests/Unit/Controller/StreamControllerTest.php
fds2610-bot 10ecad93d5 Phase 3-5 der Neuausrichtung: Board/Monitor-Wand live, SSE-Push, Agenten-Animation
Setzt Visualization.md Abschnitt 9, Phasen 3-5 vollstaendig um:

Phase 3 (Kanban-Board live): Board zeigt echte Ticket-Daten aus GET /api/v1/tickets
(office-api.js), Klick auf eine Spalte oeffnet ein Modal mit Titel/Beschreibung/Typ und
einem Link auf die Codeberg-Quelle bei per Sync angelegten Tickets (F4).

Phase 4 (Monitor-Wand live): Event-, System- und KPI-Monitor zeigen echte Daten,
Klick-Modals fuer alle drei. Neuer SSE-Endpoint GET /api/v1/stream (F13) meldet per
ChangeFeed-Fingerabdruck, welche Ressourcen sich geaendert haben; office-realtime.js nutzt
EventSource mit Polling-Fallback. KPI-Monitor zeichnet eine eigene SVG-Sparkline (F10, kein
Chart-Lib) sobald KPIs gemeldet wurden, sonst weiterhin der Phase-2-Platzhalter (F7 bleibt
inhaltlich offen). API-Antworten tragen jetzt CORS-Header, da Frontend (:8090) und API
(:8091) im Docker-Compose-Setup unterschiedliche Origins sind.

Phase 5 (Agenten & Animation): resolveAgentVisualState bildet gemeldete Agenten-Zustaende
auf Ort/Pose ab; Agenten-Avatare sind eine per CSS transition animierte, von Board/
Schreibtisch-Moebeln entkoppelte Schicht, die zwischen Schreibtisch, Board, Monitor-Wand und
einer neuen Kaffee-Ecke laufen. Idle-Varianten (Zeitung/Kaffee/Schwaetzchen) werden rein
kosmetisch client-seitig zufaellig ausgeloest (F8), eine AnimationQueue serialisiert
Update-Animationen bei vielen gleichzeitigen Ereignissen (F9).

29 Node-Tests (100% Line-Coverage office-scene.js) und neue PHPUnit-Tests fuer
Response::stream(), ChangeFeed, StreamController und die neuen Repository::fingerprint()-
Methoden. PHP/Docker-Ausfuehrung konnte in dieser Umgebung nicht verifiziert werden (kein
PHP verfuegbar) - vor dem Merge bitte `docker compose run --rm api composer test` pruefen.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-28 17:50:44 +02:00

103 lines
3.1 KiB
PHP

<?php
declare(strict_types=1);
namespace Monitor\Api\Tests\Controller;
use Monitor\Api\Controller\StreamController;
use Monitor\Api\Db\Database;
use Monitor\Api\Http\Request;
use Monitor\Api\Realtime\ChangeFeed;
use Monitor\Api\Repository\AgentRepository;
use Monitor\Api\Repository\EventRepository;
use Monitor\Api\Repository\KpiRepository;
use Monitor\Api\Repository\SystemRepository;
use Monitor\Api\Repository\TicketRepository;
use PHPUnit\Framework\TestCase;
final class StreamControllerTest extends TestCase
{
private TicketRepository $tickets;
private ChangeFeed $changeFeed;
protected function setUp(): void
{
$db = Database::inMemory();
$this->tickets = new TicketRepository($db);
$this->changeFeed = new ChangeFeed(
$this->tickets,
new EventRepository($db),
new SystemRepository($db),
new KpiRepository($db),
new AgentRepository($db)
);
}
public function testStreamSendsHeartbeatsWhenNothingChanges(): void
{
$controller = new StreamController(
$this->changeFeed,
maxIterations: 2,
pollIntervalSeconds: 0,
sleep: function (int $seconds): void {
},
);
$response = $controller->stream(Request::create('GET', '/api/v1/stream'));
self::assertTrue($response->isStream());
$output = $this->captureWriterOutput($response->writer());
self::assertStringContainsString(': heartbeat', $output);
self::assertStringNotContainsString('event: update', $output);
}
public function testStreamEmitsUpdateEventWhenAResourceChangesBetweenPolls(): void
{
$tickets = $this->tickets;
$pollCount = 0;
$controller = new StreamController(
$this->changeFeed,
maxIterations: 2,
pollIntervalSeconds: 0,
sleep: function (int $seconds) use (&$pollCount, $tickets): void {
$pollCount++;
if ($pollCount === 1) {
$tickets->create(['title' => 'Neu waehrend des Wartens']);
}
},
);
$response = $controller->stream(Request::create('GET', '/api/v1/stream'));
$output = $this->captureWriterOutput($response->writer());
self::assertStringContainsString('event: update', $output);
self::assertStringContainsString('"tickets"', $output);
self::assertSame(2, $pollCount);
}
public function testStreamStopsAfterMaxIterations(): void
{
$pollCount = 0;
$controller = new StreamController(
$this->changeFeed,
maxIterations: 3,
pollIntervalSeconds: 0,
sleep: function (int $seconds) use (&$pollCount): void {
$pollCount++;
},
);
$this->captureWriterOutput($controller->stream(Request::create('GET', '/api/v1/stream'))->writer());
self::assertSame(3, $pollCount);
}
private function captureWriterOutput(\Closure $writer): string
{
ob_start();
$writer();
return (string) ob_get_clean();
}
}