monitor/api/tests/Unit/Repository/AgentRepositoryTest.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

123 lines
3.8 KiB
PHP

<?php
declare(strict_types=1);
namespace Monitor\Api\Tests\Repository;
use InvalidArgumentException;
use Monitor\Api\Db\Database;
use Monitor\Api\Http\NotFoundException;
use Monitor\Api\Repository\AgentRepository;
use Monitor\Api\Repository\TicketRepository;
use PHPUnit\Framework\TestCase;
final class AgentRepositoryTest extends TestCase
{
private AgentRepository $repository;
private TicketRepository $tickets;
protected function setUp(): void
{
$db = Database::inMemory();
$this->repository = new AgentRepository($db, deskCount: 2);
$this->tickets = new TicketRepository($db);
}
public function testRegisterAssignsLowestFreeDesk(): void
{
$first = $this->repository->register('Alice', 'entwickler');
$second = $this->repository->register('Bob', 'qa');
self::assertSame(0, $first['agent']['desk_index']);
self::assertSame(1, $second['agent']['desk_index']);
self::assertNotSame($first['api_key'], $second['api_key']);
self::assertArrayNotHasKey('api_key_hash', $first['agent']);
}
public function testUserRoleNeverGetsADesk(): void
{
$result = $this->repository->register('Carol', 'user');
self::assertNull($result['agent']['desk_index']);
}
public function testOverflowAgentGetsNoDeskWhenAllOccupied(): void
{
$this->repository->register('Alice', 'entwickler');
$this->repository->register('Bob', 'qa');
$third = $this->repository->register('Dan', 'product_owner');
self::assertNull($third['agent']['desk_index']);
}
public function testRegisterRejectsUnknownRole(): void
{
$this->expectException(InvalidArgumentException::class);
$this->repository->register('Eve', 'ceo');
}
public function testFindByApiKeyReturnsMatchingAgent(): void
{
$result = $this->repository->register('Alice', 'entwickler');
$found = $this->repository->findByApiKey($result['api_key']);
self::assertNotNull($found);
self::assertSame($result['agent']['id'], $found['id']);
}
public function testFindByApiKeyReturnsNullForUnknownKey(): void
{
self::assertNull($this->repository->findByApiKey('does-not-exist'));
}
public function testUpdateActivityChangesStateAndTicket(): void
{
$result = $this->repository->register('Alice', 'entwickler');
$id = (int) $result['agent']['id'];
$ticketId = (int) $this->tickets->create(['title' => 'Testticket'])['id'];
$updated = $this->repository->updateActivity($id, 'working', $ticketId);
self::assertSame('working', $updated['state']);
self::assertSame($ticketId, $updated['current_ticket_id']);
}
public function testUpdateActivityRejectsUnknownTicket(): void
{
$result = $this->repository->register('Alice', 'entwickler');
$this->expectException(InvalidArgumentException::class);
$this->repository->updateActivity((int) $result['agent']['id'], 'working', 999);
}
public function testUpdateActivityThrowsForUnknownAgent(): void
{
$this->expectException(NotFoundException::class);
$this->repository->updateActivity(999, 'working', null);
}
public function testAllListsAgentsWithoutApiKeyHash(): void
{
$this->repository->register('Alice', 'entwickler');
$this->repository->register('Bob', 'qa');
$all = $this->repository->all();
self::assertCount(2, $all);
foreach ($all as $agent) {
self::assertArrayNotHasKey('api_key_hash', $agent);
}
}
public function testFingerprintChangesWhenAnAgentIsRegistered(): void
{
$before = $this->repository->fingerprint();
$this->repository->register('Alice', 'entwickler');
self::assertNotSame($before, $this->repository->fingerprint());
}
}