Gestalte den Mitgliederbereich nach Brand-UI-Kit 14 neu

Eine Navigation (Meine Bibliothek, Programme, Meine Lizenzen, Konto-Menü) mit der freigegebenen Wortmarke,
Startseite ohne erfundene Inhalte, Bibliothek mit Inhaltsart-Filter und einer Karte je Medienidentität
(„Verwendet in“), Programm-/Moduldetail, Film und Material im Zusammenhang mit Begleitmaterial und Weg zurück,
Lizenzübersicht mit Detailseite je Berechtigung. Alle Größen aus der Größenskala (ADR-44, neues Token --card-min).

Tests bewusst angepasst: Der Film spielt auf der Kontextseite statt eingebettet im Programm, Download-Links tragen
ein Symbol, der Platzhalter ist ein dekoratives Element, die Wortmarke ist das freigegebene Logo. Die Vorschau der
Bibliothekskarte in der Verwaltung nutzt dieselbe Komponente.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-22 17:56:16 +01:00
1 parent 9f070fbab2
commit 2e6260acca
41 files changed
+3742 -1093

No files matched your search

+421
View File
@@ -0,0 +1,421 @@
<?php
namespace Tests\Feature;
use App\Domain\Catalog\ArticleService;
use App\Domain\Catalog\Composition;
use App\Domain\Catalog\CompositionDisplayRelease;
use App\Domain\Catalog\ContentService;
use App\Domain\Catalog\EditorialContentKind;
use App\Domain\Catalog\LicenseArticle;
use App\Domain\Catalog\Offer;
use App\Domain\Catalog\OfferService;
use App\Domain\Entitlement\Grant;
use App\Domain\Entitlement\GrantIssuer;
use App\Http\LibraryCatalog;
use App\Http\SignedLink;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
/**
* Mitgliederbereich nach Brand-UI-Kit 14 (ADR-45): Navigation, ehrliche Leerzustände, programmübergreifende Medienliste,
* Film und Material im Zusammenhang, Lizenzübersicht und -detail. Rechte entscheidet weiter allein DecideAccess.
*/
class MemberAreaV2Test extends TestCase
{
use RefreshDatabase;
private ContentService $content;
private ArticleService $articles;
private OfferService $offers;
protected function setUp(): void
{
parent::setUp();
$this->content = app(ContentService::class);
$this->articles = app(ArticleService::class);
$this->offers = app(OfferService::class);
}
// ---------------------------------------------------------------------------------------------------------------
// Navigation und Startseite
// ---------------------------------------------------------------------------------------------------------------
public function test_a_new_member_sees_the_navigation_and_honest_empty_states_without_invented_content(): void
{
$member = User::factory()->create(['name' => 'Tina Trainerin']);
$page = $this->actingAs($member)->get(route('member.dashboard'))->assertOk();
$page->assertSee('Willkommen zurück, Tina Trainerin.')
->assertSee('Noch nichts in der Bibliothek')
->assertSee('Meine Bibliothek')
->assertSee('Meine Lizenzen')
->assertSee('Mein Konto')
->assertSee(route('member.profile'), false)
->assertSee(route('member.offers'), false)
->assertSee(route('logout'), false)
// Es gibt weder Verlauf noch Favoriten; beides erscheint deshalb nicht, auch nicht als Platzhalter.
->assertDontSee('Zuletzt')
->assertDontSee('Favorit')
->assertDontSee('Beispiel');
}
public function test_the_navigation_marks_the_current_area_and_has_one_way_to_each_area(): void
{
$member = User::factory()->create();
$this->actingAs($member);
$this->assertCurrent(route('member.library'), $this->get(route('member.library'))->getContent());
$this->assertCurrent(route('member.programs'), $this->get(route('member.programs'))->getContent());
$this->assertCurrent(route('member.grants'), $this->get(route('member.grants'))->getContent());
}
public function test_the_former_materials_page_is_a_filter_of_the_library(): void
{
$this->actingAs(User::factory()->create())
->get(route('member.materials'))
->assertRedirect(route('member.library', ['art' => 'material']));
}
// ---------------------------------------------------------------------------------------------------------------
// Bibliothek: Mehrfachverwendung und Deduplizierung
// ---------------------------------------------------------------------------------------------------------------
public function test_a_medium_in_two_programs_is_one_library_card_but_stays_in_both_programs(): void
{
$scenario = $this->scenario();
$member = $this->memberWith([$scenario['articleA'], $scenario['articleB']]);
// Übergreifende Liste: ein Film, eine Karte (Regel zur Mehrfachverwendung, Abnahmefall B11).
$films = collect(app(LibraryCatalog::class)->index($member)['materials'])->where('type', 'film');
$this->assertCount(1, $films);
$this->assertGreaterThanOrEqual(2, count($films->first()['used_in']), 'Verwendet in nennt beide Programme.');
$page = $this->actingAs($member)->get(route('member.library', ['art' => 'film']))->assertOk();
$this->assertSame(1, substr_count($page->getContent(), 'mb-card-title">Lara im Park<'));
// Innerhalb jedes Programms steht der Film an seiner Stelle (Abnahmefälle B09/B10).
$this->actingAs($member)->get(route('member.program', $scenario['programA']))->assertOk()->assertSee('Lara im Park');
$this->actingAs($member)->get(route('member.program', $scenario['programB']))->assertOk()->assertSee('Lara im Park');
}
public function test_equal_titles_of_different_media_are_not_merged(): void
{
$scenario = $this->scenario();
$member = $this->memberWith([$scenario['articleA'], $scenario['articleB']]);
$documents = collect(app(LibraryCatalog::class)->index($member)['materials'])->where('type', 'material');
$this->assertSame(2, $documents->where('title', 'Gesprächsimpulse')->count(), 'Zwei Elemente mit gleichem Titel bleiben zwei Karten (B12).');
}
public function test_the_type_filter_shows_only_that_type_and_counts_what_the_other_filters_leave(): void
{
$scenario = $this->scenario();
$member = $this->memberWith([$scenario['articleA'], $scenario['articleB']]);
$page = $this->actingAs($member)->get(route('member.library', ['art' => 'programm']))->assertOk();
$page->assertSee('Stark im Miteinander')->assertSee('Grenzen erkennen')->assertDontSee('mb-card-title">Lara im Park<', false);
$page->assertSee('Filme (1)')->assertSee('Programme (2)');
$this->actingAs($member)->get(route('member.library', ['art' => 'film', 'q' => 'Park']))
->assertSee('mb-card-title">Lara im Park<', false);
$this->actingAs($member)->get(route('member.library', ['q' => 'gibtesnicht']))
->assertSee('Keine Treffer');
}
// ---------------------------------------------------------------------------------------------------------------
// Film und Material im Zusammenhang
// ---------------------------------------------------------------------------------------------------------------
public function test_a_film_opens_in_its_context_with_player_companions_and_the_way_back(): void
{
$scenario = $this->scenario();
$member = $this->memberWith([$scenario['articleB']]);
$page = $this->actingAs($member)
->get(route('member.content', ['composition' => $scenario['programB']->id, 'version' => $scenario['film']->id]))
->assertOk()
->assertSee('<video', false)
->assertSee('Zurück zu Grenzen erkennen')
->assertSee('Begleitmaterial')
->assertSee('Gesprächsimpulse');
// Programm B erlaubt Streamen, Laden und Ansehen: Herunterladen wird angeboten, nur über den geschützten Weg.
$page->assertSee('Herunterladen');
$this->assertStringContainsString('/bereich/ausgabe/', $page->getContent());
$this->assertStringNotContainsString('inhalte/park.mp4', $page->getContent(), 'Keine Dateiadresse in der Seite.');
}
public function test_download_is_offered_only_where_the_grant_allows_it(): void
{
$scenario = $this->scenario();
$member = $this->memberWith([$scenario['articleA']]);
// Programm A erlaubt nur Streamen und Ansehen: Der Film ist spielbar, ein Download-Link fehlt.
$page = $this->actingAs($member)
->get(route('member.content', ['composition' => $scenario['programA']->id, 'version' => $scenario['film']->id]))
->assertOk()
->assertSee('<video', false)
->assertSee('Das Herunterladen ist in deinen Berechtigungen nicht enthalten');
$this->assertStringNotContainsString('/laden?', $page->getContent());
$this->assertDoesNotMatchRegularExpression('#/bereich/ausgabe/\d+/\d+/\d+/laden#', $page->getContent());
// Der Download selbst bleibt serverseitig verweigert, auch bei erratener Adresse.
$release = $scenario['articleA']->currentRelease;
$url = SignedLink::temporary('member.media', now()->addMinutes(5), [
'article' => $scenario['articleA']->id,
'release' => $release->id,
'version' => $scenario['film']->id,
'action' => 'laden',
'reader' => $member->id,
]);
$this->actingAs($member)->get($url)->assertForbidden();
}
public function test_without_a_grant_the_context_page_gives_the_reason_but_no_media_address(): void
{
$scenario = $this->scenario();
$stranger = User::factory()->create();
$page = $this->actingAs($stranger)
->get(route('member.content', ['composition' => $scenario['programB']->id, 'version' => $scenario['film']->id]))
->assertForbidden()
->assertSee('Nicht enthalten')
->assertDontSee('<video', false);
$this->assertStringNotContainsString('/bereich/ausgabe/', $page->getContent());
}
public function test_a_place_that_is_not_in_the_program_is_not_found(): void
{
$scenario = $this->scenario();
$member = $this->memberWith([$scenario['articleA']]);
$other = $this->content->publishElementVersion($this->content->createElement('film', 'film', 'Fremder Film'), null, ['file' => 'inhalte/fremd.mp4']);
$this->actingAs($member)
->get(route('member.content', ['composition' => $scenario['programA']->id, 'version' => $other->id]))
->assertNotFound();
}
public function test_a_program_that_is_not_released_for_display_is_not_found(): void
{
$scenario = $this->scenario(release: false);
$member = $this->memberWith([$scenario['articleA']]);
$this->actingAs($member)->get(route('member.program', $scenario['programA']))->assertNotFound();
$this->actingAs($member)
->get(route('member.content', ['composition' => $scenario['programA']->id, 'version' => $scenario['film']->id]))
->assertNotFound();
}
// ---------------------------------------------------------------------------------------------------------------
// Meine Lizenzen
// ---------------------------------------------------------------------------------------------------------------
public function test_two_grants_for_one_article_stay_two_entries_and_their_rights_are_never_combined(): void
{
$scenario = $this->scenario();
$member = User::factory()->create();
$this->claim($member, $scenario['articleA'], 'Streaming privat', 'ehrenamtlich', ['film' => ['streamen']]);
$this->claim($member, $scenario['articleA'], 'Download kommerziell', 'kommerziell', ['document' => ['laden']]);
$page = $this->actingAs($member)->get(route('member.grants'))->assertOk();
$this->assertSame(2, substr_count($page->getContent(), 'class="mb-license '), 'Je Berechtigung ein Eintrag (B17).');
$page->assertSee('Ehrenamtlich')->assertSee('Kommerziell');
$grant = Grant::query()->whereJsonContains('rights_snapshot->purpose', 'ehrenamtlich')->firstOrFail();
$detail = $this->actingAs($member)->get(route('member.grant', $grant))->assertOk();
$detail->assertSee('Film ansehen');
// Das Recht „Dokument herunterladen“ gehört zur anderen Berechtigung und steht hier nicht als Recht.
$detail->assertDontSee('Dokument herunterladen</li>', false);
// Nicht enthaltene Aktionen der enthaltenen Inhalte werden benannt, nicht aus anderen Erwerben ergänzt.
$detail->assertSee('Film herunterladen ist in diesem Erwerb nicht enthalten.')
->assertSee('Dokument herunterladen ist in diesem Erwerb nicht enthalten.');
}
public function test_the_displayed_status_follows_the_access_rule(): void
{
$scenario = $this->scenario();
$member = User::factory()->create();
$active = $this->claim($member, $scenario['articleA'], 'Aktiv', 'ehrenamtlich', ['film' => ['streamen']]);
$expired = $this->claim($member, $scenario['articleB'], 'Abgelaufen', 'ehrenamtlich', ['film' => ['streamen']]);
$future = $this->claim($member, $scenario['articleB'], 'Später', 'kommerziell', ['film' => ['streamen']]);
$expired->update(['valid_until' => now()->subDay()]);
$future->update(['valid_from' => now()->addWeek()]);
$this->actingAs($member);
$this->get(route('member.grants'))->assertSee('Aktiv (1)')->assertSee('Inaktiv (2)')->assertSee('Alle (3)');
$this->get(route('member.grants', ['status' => 'aktiv']))->assertOk()->assertDontSee('Abgelaufen')->assertDontSee('Noch nicht gültig');
$this->get(route('member.grants', ['status' => 'inaktiv']))->assertOk()->assertSee('Abgelaufen')->assertSee('Noch nicht gültig');
$this->get(route('member.grant', $expired))->assertOk()->assertSee('Der Zeitraum dieser Berechtigung ist abgelaufen.');
$this->assertTrue($active->fresh()->valid_until === null);
}
public function test_a_revoked_grant_stays_visible_as_inactive_with_its_reason(): void
{
$scenario = $this->scenario();
$member = User::factory()->create();
$grant = $this->claim($member, $scenario['articleA'], 'Weg', 'ehrenamtlich', ['film' => ['streamen']]);
$grant->update(['status' => 'widerrufen', 'status_reason' => 'Rückerstattung']);
$this->actingAs($member)->get(route('member.grants'))->assertSee('Widerrufen')->assertSee('Inaktiv (1)');
$this->actingAs($member)->get(route('member.grant', $grant))->assertOk()->assertSee('Diese Berechtigung wurde widerrufen. Grund: Rückerstattung');
// Eine widerrufene Berechtigung öffnet keine Inhalte.
$this->actingAs($member)->get(route('member.library'))->assertSee('Noch nichts in der Bibliothek');
}
public function test_another_accounts_grant_is_not_visible_and_the_page_invents_no_license_document(): void
{
$scenario = $this->scenario();
$owner = User::factory()->create();
$other = User::factory()->create();
$grant = $this->claim($owner, $scenario['articleA'], 'Fremd', 'ehrenamtlich', ['film' => ['streamen']]);
$this->actingAs($other)->get(route('member.grant', $grant))->assertNotFound();
$this->get(route('member.grants'))->assertDontSee('Stark im Miteinander');
$this->actingAs($owner)->get(route('member.grant', $grant))
->assertOk()
->assertSee('Stark im Miteinander')
->assertSee('Kostenloser Abruf')
->assertDontSee('Lizenzbedingungen')
->assertDontSee('PDF');
}
public function test_guests_are_sent_to_the_login_for_every_member_page(): void
{
$scenario = $this->scenario();
foreach ([route('member.dashboard'), route('member.library'), route('member.grants'), route('member.program', $scenario['programA']), route('member.content', ['composition' => $scenario['programA']->id, 'version' => $scenario['film']->id])] as $url) {
$this->get($url)->assertRedirect('/anmelden');
}
}
// ---------------------------------------------------------------------------------------------------------------
// Aufbau der Testdaten
// ---------------------------------------------------------------------------------------------------------------
/**
* Programm A „Stark im Miteinander“ (Modul „Gefühle einordnen“ mit Film und Dokument; nur Streamen und Ansehen) und
* Programm B „Grenzen erkennen“ (derselbe Film, ein anderes Dokument mit gleichem Titel; auch Laden). Dasselbe Medium
* steht damit in zwei Programmen.
*
* @return array<string, mixed>
*/
private function scenario(bool $release = true): array
{
$film = $this->content->publishElementVersion($this->content->createElement('film', 'film', 'Lara im Park'), null, ['file' => 'inhalte/park.mp4']);
$docA = $this->content->publishElementVersion($this->content->createElement('uebung', 'document', 'Gesprächsimpulse'), 'Fragen für das Gespräch.');
$docB = $this->content->publishElementVersion($this->content->createElement('uebung', 'document', 'Gesprächsimpulse'), 'Andere Fragen.');
$moduleKind = EditorialContentKind::query()->where('slug', 'modul')->firstOrFail();
$programKind = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail();
$module = $this->content->publishComposition(
tap($this->content->createComposition('Gefühle einordnen'), function (Composition $item) use ($moduleKind): void {
$item->editorial_content_kind_id = $moduleKind->id;
$item->save();
}),
[['role' => 'Film', 'target' => $film], ['role' => 'Arbeitsblatt', 'target' => $docA]],
);
$programA = $this->content->publishComposition(
tap($this->content->createComposition('Stark im Miteinander'), function (Composition $item) use ($programKind): void {
$item->editorial_content_kind_id = $programKind->id;
$item->save();
}),
[['role' => 'Modul', 'target' => $module]],
);
$programB = $this->content->publishComposition(
tap($this->content->createComposition('Grenzen erkennen'), function (Composition $item) use ($programKind): void {
$item->editorial_content_kind_id = $programKind->id;
$item->save();
}),
[['role' => 'Film', 'target' => $film], ['role' => 'Arbeitsblatt', 'target' => $docB]],
);
if ($release) {
$displayer = User::factory()->create();
foreach ([$module, $programA, $programB] as $version) {
app(CompositionDisplayRelease::class)->release($version, $displayer);
}
}
$articleA = $this->articles->create('programm-a');
$this->articles->publishRelease($articleA, $programA, 'Programm A.');
$articleB = $this->articles->create('programm-b');
$this->articles->publishRelease($articleB, $programB, 'Programm B.');
$this->grantsOf($articleA, ['film' => ['streamen'], 'document' => ['ansehen']], 'Programm A');
$this->grantsOf($articleB, ['film' => ['streamen', 'laden'], 'document' => ['ansehen', 'laden']], 'Programm B');
return [
'film' => $film,
'programA' => $programA->composition,
'programB' => $programB->composition,
'articleA' => $articleA->fresh(),
'articleB' => $articleB->fresh(),
];
}
/** @var array<int, Offer> Angebote der Szenarien je Artikel */
private array $offerOf = [];
/**
* @param array<string, list<string>> $capabilities
*/
private function grantsOf(LicenseArticle $article, array $capabilities, string $name): void
{
$rights = $this->offers->createRightsProfile($name, 'ehrenamtlich', $capabilities);
$offer = $this->offers->create($name);
$this->offers->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']);
$this->offerOf[$article->id] = $offer;
}
/**
* @param list<LicenseArticle> $articles
*/
private function memberWith(array $articles): User
{
$member = User::factory()->create();
foreach ($articles as $article) {
app(GrantIssuer::class)->claim($member, $this->offerOf[$article->id]);
}
return $member;
}
/**
* Eigene Berechtigung mit eigenem Rechteprofil (anderer Zweck und andere Aktionen) für denselben Artikel.
*
* @param array<string, list<string>> $capabilities
*/
private function claim(User $member, LicenseArticle $article, string $name, string $purpose, array $capabilities): Grant
{
$rights = $this->offers->createRightsProfile($name, $purpose, $capabilities);
$offer = $this->offers->create($name);
$this->offers->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']);
$acquisition = app(GrantIssuer::class)->claim($member, $offer);
return $acquisition->grants->first();
}
private function assertCurrent(string $url, string $html): void
{
$this->assertMatchesRegularExpression('#<a href="'.preg_quote($url, '#').'"[^>]*aria-current="page"#', $html, 'Der aktuelle Bereich ist in der Navigation markiert: '.$url);
$this->assertSame(2, preg_match_all('#<a href="'.preg_quote($url, '#').'"[^>]*aria-current="page"#', $html), 'Kopfzeile und untere Leiste markieren ihn.');
}
protected function tearDown(): void
{
$this->offerOf = [];
parent::tearDown();
}
}