<?php

namespace App\Ops\Tasks;

use App\Ops\Backup;

/**
 * Die tägliche Sicherung von Datenbank und Medien.
 *
 * Die schwerste Aufgabe im Plan, und die einzige, bei der das Ausführen in einer Webanfrage
 * wirklich etwas kostet: sie kopiert die Datenbank und den Medienordner. Der Besucher wartet
 * trotzdem nicht darauf – sie läuft nach der ausgelieferten Antwort. Was sie belegt, ist ein
 * PHP-Prozess des Hostings, einmal am Tag, für die Dauer einer Kopie.
 *
 * Wer einen echten Cronjob hat, sollte sie dort laufen lassen und hier abschalten. Wer keinen
 * hat, hat mit dieser Aufgabe eine tägliche Sicherung statt gar keiner – und das ist der Grund,
 * warum sie trotz ihres Gewichts im Plan steht.
 */
final class BackupTask implements Task
{
    public function __construct(private Backup $backup)
    {
    }

    public function name(): string
    {
        return 'backup';
    }

    public function label(): string
    {
        return 'Sicherung anlegen';
    }

    public function explanation(): string
    {
        return 'Ohne sie gibt es keinen Rückweg außer der von Hand angelegten Sicherung. Sie rotiert selbst und enthält Datenbank und Medien, aber weder .env noch vendor/.';
    }

    public function interval(): int
    {
        return 86400;
    }

    public function run(): string
    {
        $result = $this->backup->create('automatisch');
        $removed = $this->backup->rotate();

        return sprintf(
            '%s angelegt: %d Seite(n), %d Mediendatei(en).%s',
            $result['name'],
            $result['manifest']['inhalt']['seiten'],
            $result['manifest']['medien']['dateien'],
            [] === $removed ? '' : sprintf(' %d alte entfernt.', count($removed)),
        );
    }
}