Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,13 @@ AUTH_MODE=direct-discord
# FABRICA_INSTANCE_ID=
# FABRICA_INSTANCE_CREDENTIAL=

# Eigener LiveKit-Server fuers Bildschirmteilen im Vortrag, alle drei oder
# keiner. Gesetzt gilt er vor der Konsole. URL mit wss://, Secret mit
# mindestens 32 Zeichen (openssl rand -base64 48).
# LIVEKIT_URL=
# LIVEKIT_API_KEY=
# LIVEKIT_API_SECRET=

# Schluessel fuer Geheimnisse in der Datenbank (etwa das Token des Discord-Bots).
# Leer lassen: ignis legt beim ersten Bedarf storage/private/secret.key an, die
# Datei gehoert dann ins Backup. Selbst setzen mit: openssl rand -base64 32
Expand Down
2 changes: 1 addition & 1 deletion .github/webpackages-ref
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,4 @@
# 3. Im selben Commit composer.lock (composer update 'emergencyforge/*')
# und das Dist (npm run build) aus genau diesem Stand erneuern, sonst
# schlägt der Dist-Vergleich in php.yml fehl.
mail/v0.2.1
editor/v0.13.0
4 changes: 2 additions & 2 deletions composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
"illuminate/queue": "^11.0",
"symfony/console": "^7.0",
"dragonmantank/cron-expression": "^3.6",
"emergencyforge/editor-php": "^0.10",
"emergencyforge/editor-php": "^0.13",
"emergencyforge/http-kernel": "^0.1.3",
"emergencyforge/plugin-system": "^0.1",
"emergencyforge/health-check": "^0.1",
Expand All @@ -40,7 +40,7 @@
"emergencyforge/mail": "^0.2",
"emergencyforge/list-query": "^0.1",
"emergencyforge/ui-php": "^1.9",
"emergencyforge/training": "^0.6",
"emergencyforge/training": "^0.7",
"chillerlan/php-qrcode": "^6.0"
},
"autoload": {
Expand Down
14 changes: 7 additions & 7 deletions composer.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion plugins/training/assets/js/presentation.js
Original file line number Diff line number Diff line change
Expand Up @@ -1403,7 +1403,7 @@
let reason = '';
if (!canShare) reason = 'Bildschirm teilen geht nur im Browser';
else if (!share && via === 'direct' && audience > SCREEN_LIMIT) reason = 'Bildschirm teilen geht ohne EF Sync bis 15 Zuschauer';
const tip = reason || ((share ? share.via : via) === 'livekit' ? 'Über den Medienserver von EmergencyForge' : 'Direkt an jeden Zuschauer, bis 15');
const tip = reason || ((share ? share.via : via) === 'livekit' ? $('.ignis-segmented [data-live-mode="screen"]').dataset.livekitTip : 'Direkt an jeden Zuschauer, bis 15');
// Der Knopf im Wartebild sagt dasselbe wie der im Kopf, sonst täte er stumm nichts.
[$('.ignis-segmented [data-live-mode="screen"]'), $('[data-live-wait-share]')].forEach((button) => {
button.setAttribute('aria-disabled', reason ? 'true' : 'false');
Expand Down
7 changes: 3 additions & 4 deletions plugins/training/src/Controllers/PresentationController.php
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@
use EmergencyForge\Http\Response;
use Illuminate\Support\Carbon;
use InvalidArgumentException;
use Plugin\Training\AiDrafts;
use Plugin\Training\Converter;
use Plugin\Training\Models\Course;
use Plugin\Training\Models\Participation;
Expand Down Expand Up @@ -75,7 +74,7 @@ public function start(Request $request, string $course, string $session): Respon
if ($slides !== null && !$slides->viewsAsPdf()) {
return self::back('training/manage/' . $courseModel->id . '#termine', $slides->convert_status === Converter::FAILED ? 'Die Folien ließen sich nicht umwandeln.' : 'Die Folien werden noch umgewandelt.');
}
$live = Presentations::start($sessionModel, self::userId(), AiDrafts::client());
$live = Presentations::start($sessionModel, self::userId(), Presentations::roomTokens());
if ($live->wasRecentlyCreated) {
(new AuditLogger())->log(self::userId(), 'Vortrag gestartet', $sessionModel->title, 'Ausbildung', 0, ['change_type' => 'training_presentation_started']);
}
Expand Down Expand Up @@ -227,7 +226,7 @@ public function screen(Request $request, string $course, string $session): Respo
}
try {
// `direct`: der Host bekam einen LiveKit-Schlüssel, kam aber nicht in den Raum.
$result = Presentations::startScreen($live, self::userId(), AiDrafts::client(), $via === 'direct');
$result = Presentations::startScreen($live, self::userId(), Presentations::roomTokens(), $via === 'direct');
} catch (DomainException $e) {
return self::json(['error' => $e->getMessage()], 409);
}
Expand Down Expand Up @@ -256,7 +255,7 @@ public function roomToken(Request $request, string $course, string $session): Re
session_write_close();
}
try {
$token = Presentations::roomToken($live, $userId, AiDrafts::client());
$token = Presentations::roomToken($live, $userId, Presentations::roomTokens());
} catch (DomainException $e) {
// `unavailable`: ein Zuschauer bekam keinen Schlüssel, der Raum bleibt und er darf es wieder versuchen.
return match ($e->getMessage()) {
Expand Down
43 changes: 31 additions & 12 deletions plugins/training/src/Presentations.php
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,18 @@

namespace Plugin\Training;

use App\Auth\FabricaClient;
use App\Logging\Logger;
use App\Models\User;
use App\Support\AccountIdentity;
use DateTimeImmutable;
use DateTimeInterface;
use DomainException;
use EmergencyForge\Training\Presentation\Attendance as AttendanceRule;
use EmergencyForge\Training\Presentation\DrawEvent;
use EmergencyForge\Training\Presentation\LiveKitServer;
use EmergencyForge\Training\Presentation\Liveness;
use EmergencyForge\Training\Presentation\Question;
use EmergencyForge\Training\Presentation\RoomTokens;
use EmergencyForge\Training\Presentation\Signal;
use EmergencyForge\Training\Presentation\Visit;
use EmergencyForge\Training\Presentation\WatchTime;
Expand Down Expand Up @@ -64,10 +66,27 @@ final class Presentations
private const SIGNAL_WINDOW = 60;

/**
* Mit EF Sync (`$client`) bekommt der Vortrag einen Raum; der Name kommt vom Server und
* Woher die LiveKit-Schlüssel kommen: der eigene Server aus der `.env`,
* sonst die Konsole. Eine halb ausgefüllte `.env` legt den Vortrag nicht
* lahm, es gilt dann die Konsole und das Log sagt, was fehlt.
*/
public static function roomTokens(): ?RoomTokens
{
try {
$own = LiveKitServer::fromEnv($_ENV);
} catch (InvalidArgumentException $e) {
Logger::error('Eigener LiveKit-Server nicht nutzbar, es gilt die Konsole: ' . $e->getMessage());
$own = null;
}

return $own ?? AiDrafts::client();
}

/**
* Mit Schlüsselquelle (`$client`) bekommt der Vortrag einen Raum; der Name kommt vom Server und
* nie vom Browser. Den Schlüssel dafür holt erst roomToken().
*/
public static function start(Session $session, int $userId, ?FabricaClient $client = null): Presentation
public static function start(Session $session, int $userId, ?RoomTokens $client = null): Presentation
{
// Sperre auf dem Termin, damit zwei gleichzeitige Starts nur einen Vortrag anlegen.
$talk = Capsule::connection()->transaction(static function () use ($session, $userId, $client): Presentation {
Expand Down Expand Up @@ -306,20 +325,20 @@ private static function stopScreen(Presentation $row): void
}

/**
* Teilen beginnen. Mit Raum über LiveKit. Scheitert die Konsole, entfällt der Raum und
* Teilen beginnen. Mit Raum über LiveKit. Scheitert die Schlüsselquelle, entfällt der Raum und
* es geht direkt weiter, solange der Host die Zuschauer allein versorgen kann. Mit
* `$direct` (der Host kam nicht in den Raum) fragt niemand die Konsole und der Raum bleibt.
* `$direct` (der Host kam nicht in den Raum) fragt niemand die Schlüsselquelle und der Raum bleibt.
*
* @return array{via:'livekit'|'direct', url?:string, token?:string}
* @throws DomainException `too_many` ohne LiveKit bei mehr als SCREEN_LIMIT Zuschauern, `ended`, `not_host`
*/
public static function startScreen(Presentation $p, int $userId, ?FabricaClient $client, bool $direct = false): array
public static function startScreen(Presentation $p, int $userId, ?RoomTokens $client, bool $direct = false): array
{
$room = $p->room;
$token = null;
$failed = false;
if (!$direct && $client !== null && $room !== null) {
// Vor der Sperre, damit eine langsame Konsole die Zeile nicht festhält.
// Vor der Sperre, damit eine langsame Schlüsselquelle die Zeile nicht festhält.
try {
$token = self::key($room, $userId, true, $client);
} catch (\RuntimeException) {
Expand All @@ -344,7 +363,7 @@ public static function startScreen(Presentation $p, int $userId, ?FabricaClient
$row->mode = 'screen';
$row->screen_via = $live ? 'livekit' : 'direct';
if ($failed && $row->room === $room) {
// Die Konsole lieferte dem Host nichts; ohne seinen Schlüssel taugt der Raum nicht.
// Die Schlüsselquelle lieferte dem Host nichts; ohne seinen Schlüssel taugt der Raum nicht.
$row->room = null;
}
$row->version++;
Expand All @@ -357,16 +376,16 @@ public static function startScreen(Presentation $p, int $userId, ?FabricaClient
}

/**
* Raum-Schlüssel für einen Zuschauer oder den Host. Scheitert die Konsole beim Host,
* Raum-Schlüssel für einen Zuschauer oder den Host. Scheitert die Schlüsselquelle beim Host,
* fällt der Raum des Vortrags weg (ein laufendes LiveKit-Teilen endet mit ihm) und alles
* läuft über die Abfrage weiter; die Version steigt, damit alle Fenster es merken. Bei einem
* Zuschauer ändert sich nichts am Vortrag, denn viele fragen gleichzeitig und ein
* kurzer Fehler soll niemandem den Raum nehmen.
*
* @return array{url:string, token:string}
* @throws DomainException `ended`, `no_room` ohne Raum, ohne Konsole oder wenn der Host keinen Schlüssel bekam, `unavailable` wenn ein Zuschauer keinen bekam
* @throws DomainException `ended`, `no_room` ohne Raum, ohne Schlüsselquelle oder wenn der Host keinen Schlüssel bekam, `unavailable` wenn ein Zuschauer keinen bekam
*/
public static function roomToken(Presentation $p, int $userId, ?FabricaClient $client): array
public static function roomToken(Presentation $p, int $userId, ?RoomTokens $client): array
{
if ($p->ended_at !== null) {
throw new DomainException('ended');
Expand Down Expand Up @@ -409,7 +428,7 @@ public static function roomToken(Presentation $p, int $userId, ?FabricaClient $c
* @return array{url:string, token:string}
* @throws \RuntimeException
*/
private static function key(string $room, int $userId, bool $host, FabricaClient $client): array
private static function key(string $room, int $userId, bool $host, RoomTokens $client): array
{
$identity = 'u' . $userId . ($host ? '' : '-' . bin2hex(random_bytes(4)));
try {
Expand Down
10 changes: 6 additions & 4 deletions plugins/training/templates/presentation/_bar.php
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,16 @@
* @var list<array{id: int, name: string, initials: string, role: string}> $targets nur present
*/

use Plugin\Training\AiDrafts;
use EmergencyForge\Training\Presentation\LiveKitServer;
use Plugin\Training\Presentations;

$liveHost = Presentations::identity($presentation->presenter()->with('mitarbeiter')->first());
$livePresent = $liveRole === 'present';
$liveElapsed = max(0, time() - $presentation->started_at->getTimestamp());
// Mit EF Sync geht das Teilen über LiveKit; fällt die Konsole aus, zeigt sich das erst beim Start.
$liveKit = AiDrafts::client() !== null;
// Mit eigenem Server oder EF Sync geht das Teilen über LiveKit; fällt er aus, zeigt sich das erst beim Start.
$liveTokens = Presentations::roomTokens();
$liveKit = $liveTokens !== null;
$liveKitTip = $liveTokens instanceof LiveKitServer ? 'Über den eigenen Medienserver' : 'Über den Medienserver von EmergencyForge';
$e = static fn (string $value): string => htmlspecialchars($value, ENT_QUOTES);
ob_start();
?>
Expand Down Expand Up @@ -51,7 +53,7 @@
<div class="ignis-segmented ignis-segmented--sm" role="group" aria-label="Anzeige">
<?php // Ohne Folien heißt „Teilen beenden“ zurück ins Wartebild; dafür braucht es keinen Knopf. ?>
<button type="button" data-live-mode="slides" aria-pressed="true"<?= $slidesUrl === '' ? ' hidden' : '' ?>><i class="fa-solid fa-images" aria-hidden="true"></i> Folien</button>
<button type="button" data-live-mode="screen" aria-pressed="false" data-ignis-tooltip="<?= $liveKit ? 'Über den Medienserver von EmergencyForge' : 'Direkt an jeden Zuschauer, bis 15' ?>"><i class="fa-solid fa-display" aria-hidden="true"></i> Bildschirm</button>
<button type="button" data-live-mode="screen" aria-pressed="false" data-livekit-tip="<?= $e($liveKitTip) ?>" data-ignis-tooltip="<?= $liveKit ? $e($liveKitTip) : 'Direkt an jeden Zuschauer, bis 15' ?>"><i class="fa-solid fa-display" aria-hidden="true"></i> Bildschirm</button>
<button type="button" data-live-mode="pause" aria-pressed="false"><i class="fa-solid fa-mug-hot" aria-hidden="true"></i> Pause</button>
</div>
<button type="button" class="ignis-btn ignis-btn--secondary ignis-btn--sm" data-live-handover aria-expanded="false"><i class="fa-solid fa-right-left" aria-hidden="true"></i> <span>Weiterreichen</span></button>
Expand Down
2 changes: 1 addition & 1 deletion public/assets/dist/editor.css

Large diffs are not rendered by default.

92 changes: 46 additions & 46 deletions public/assets/dist/editor.iife.js

Large diffs are not rendered by default.

Loading
Loading