deplay phase 1

dev/backups/phase2-offers-2026-04-17/FILES/models/Offer.php

@@ -0,0 +1,132 @@
+<?php
+
+namespace App\Models;
+
+use App\User;
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * Angebot (Modul 6).
+ *
+ * Ein Offer ist der logische Angebots-Kopf (Angebotsnummer, Status,
+ * Referenzen). Die Inhalte (Texte, Positionen, PDF) liegen versionsweise
+ * in {@see OfferVersion}. Nach dem ersten Versand ist jede Änderung
+ * eine neue Version (Entscheidung 17.1 Entwicklungsplan).
+ *
+ * @property int $id
+ * @property string $offer_number
+ * @property int $contact_id
+ * @property int|null $inquiry_id
+ * @property int|null $booking_id
+ * @property string $status
+ * @property int|null $current_version_id
+ * @property int $created_by
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property Carbon|null $deleted_at
+ * @property-read Contact $contact
+ * @property-read Lead|null $inquiry
+ * @property-read Booking|null $booking
+ * @property-read OfferVersion|null $currentVersion
+ * @property-read Collection|OfferVersion[] $versions
+ * @property-read Collection|OfferAccessToken[] $accessTokens
+ * @property-read User $creator
+ */
+class Offer extends Model
+{
+    use HasFactory, SoftDeletes;
+
+    public const STATUS_DRAFT     = 'draft';
+    public const STATUS_SENT      = 'sent';
+    public const STATUS_ACCEPTED  = 'accepted';
+    public const STATUS_DECLINED  = 'declined';
+    public const STATUS_EXPIRED   = 'expired';
+    public const STATUS_WITHDRAWN = 'withdrawn';
+
+    public const STATUSES = [
+        self::STATUS_DRAFT,
+        self::STATUS_SENT,
+        self::STATUS_ACCEPTED,
+        self::STATUS_DECLINED,
+        self::STATUS_EXPIRED,
+        self::STATUS_WITHDRAWN,
+    ];
+
+    protected $table = 'offers';
+
+    protected $fillable = [
+        'offer_number',
+        'contact_id',
+        'inquiry_id',
+        'booking_id',
+        'status',
+        'current_version_id',
+        'created_by',
+    ];
+
+    protected $casts = [
+        'contact_id'         => 'int',
+        'inquiry_id'         => 'int',
+        'booking_id'         => 'int',
+        'current_version_id' => 'int',
+        'created_by'         => 'int',
+    ];
+
+    public function contact(): BelongsTo
+    {
+        return $this->belongsTo(Contact::class);
+    }
+
+    public function inquiry(): BelongsTo
+    {
+        // Nach Modul 3 Phase 2: `Lead`-Model bildet die `inquiries`-Tabelle ab
+        return $this->belongsTo(Lead::class, 'inquiry_id');
+    }
+
+    public function booking(): BelongsTo
+    {
+        return $this->belongsTo(Booking::class);
+    }
+
+    public function currentVersion(): BelongsTo
+    {
+        return $this->belongsTo(OfferVersion::class, 'current_version_id');
+    }
+
+    public function versions(): HasMany
+    {
+        return $this->hasMany(OfferVersion::class)->orderBy('version_no');
+    }
+
+    public function accessTokens(): HasMany
+    {
+        return $this->hasMany(OfferAccessToken::class);
+    }
+
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    public function scopeStatus(Builder $q, string $status): Builder
+    {
+        return $q->where('status', $status);
+    }
+
+    public function scopeOpen(Builder $q): Builder
+    {
+        return $q->whereIn('status', [self::STATUS_DRAFT, self::STATUS_SENT]);
+    }
+
+    public function isEditable(): bool
+    {
+        return in_array($this->status, [self::STATUS_DRAFT, self::STATUS_SENT], true);
+    }
+}

dev/backups/phase2-offers-2026-04-17/FILES/models/OfferAccessToken.php

@@ -0,0 +1,120 @@
+<?php
+
+namespace App\Models;
+
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Str;
+
+/**
+ * Kundenseitiger Zugriffstoken für /angebot/{token} (Modul 6 / Phase D).
+ *
+ * In der Datenbank wird ausschließlich der SHA-256-Hash des Klartext-
+ * Tokens gespeichert. Der Klartext wird einmalig bei der Erzeugung
+ * zurückgegeben (siehe {@see self::generate()}) und an den Kunden
+ * per Mail-Link ausgeliefert.
+ *
+ * Pro Angebot + Version existiert genau ein aktiver Token; wird eine
+ * neue Version versendet, setzt der OfferService den Vorgänger auf
+ * `revoked_at`.
+ *
+ * @property int $id
+ * @property int $offer_id
+ * @property int $offer_version_id
+ * @property string $token_hash
+ * @property Carbon|null $expires_at
+ * @property Carbon|null $first_opened_at
+ * @property Carbon|null $revoked_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property-read Offer $offer
+ * @property-read OfferVersion $version
+ */
+class OfferAccessToken extends Model
+{
+    use HasFactory;
+
+    protected $table = 'offer_access_tokens';
+
+    protected $fillable = [
+        'offer_id',
+        'offer_version_id',
+        'token_hash',
+        'expires_at',
+        'first_opened_at',
+        'revoked_at',
+    ];
+
+    protected $casts = [
+        'offer_id'         => 'int',
+        'offer_version_id' => 'int',
+        'expires_at'       => 'datetime',
+        'first_opened_at'  => 'datetime',
+        'revoked_at'       => 'datetime',
+    ];
+
+    public function offer(): BelongsTo
+    {
+        return $this->belongsTo(Offer::class);
+    }
+
+    public function version(): BelongsTo
+    {
+        return $this->belongsTo(OfferVersion::class, 'offer_version_id');
+    }
+
+    public function scopeActive(Builder $q): Builder
+    {
+        return $q->whereNull('revoked_at')
+            ->where(function (Builder $q) {
+                $q->whereNull('expires_at')->orWhere('expires_at', '>', now());
+            });
+    }
+
+    /**
+     * Erzeugt ein neues Token für die angegebene Version und liefert
+     * den Klartext-Token zurück (nur einmalig abrufbar). In der
+     * Datenbank wird nur der Hash persistiert.
+     */
+    public static function generate(
+        Offer $offer,
+        OfferVersion $version,
+        ?Carbon $expiresAt = null
+    ): array {
+        $plain = Str::random(48);
+        $hash  = hash('sha256', $plain);
+
+        /** @var self $token */
+        $token = self::create([
+            'offer_id'         => $offer->id,
+            'offer_version_id' => $version->id,
+            'token_hash'       => $hash,
+            'expires_at'       => $expiresAt,
+        ]);
+
+        return ['plain' => $plain, 'token' => $token];
+    }
+
+    /**
+     * Lookup per Klartext-Token (konstantzeitig via DB-Unique-Index).
+     */
+    public static function findByPlainToken(string $plain): ?self
+    {
+        return self::where('token_hash', hash('sha256', $plain))->first();
+    }
+
+    public function isActive(): bool
+    {
+        if ($this->revoked_at !== null) {
+            return false;
+        }
+        if ($this->expires_at !== null && $this->expires_at->isPast()) {
+            return false;
+        }
+
+        return true;
+    }
+}

dev/backups/phase2-offers-2026-04-17/FILES/models/OfferFile.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace App\Models;
+
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * Datei-Anhang einer Angebotsversion (Modul 6).
+ *
+ * Struktur ist bewusst an {@see BookingFile} angelehnt (identifier,
+ * filename, dir, original_name, ext, mine, size), damit der vorhandene
+ * `FileRepository::store()` 1:1 wiederverwendet werden kann. `mine`
+ * bleibt so geschrieben (statt `mime`) zur Konsistenz mit der
+ * booking_files-Konvention.
+ *
+ * @property int $id
+ * @property int $offer_version_id
+ * @property string|null $identifier
+ * @property string $filename
+ * @property string $dir
+ * @property string $original_name
+ * @property string $ext
+ * @property string $mine
+ * @property int $size
+ * @property bool $include_in_pdf
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property-read OfferVersion $version
+ */
+class OfferFile extends Model
+{
+    use HasFactory;
+
+    protected $table = 'offer_files';
+
+    protected $fillable = [
+        'offer_version_id',
+        'identifier',
+        'filename',
+        'dir',
+        'original_name',
+        'ext',
+        'mine',
+        'size',
+        'include_in_pdf',
+    ];
+
+    protected $casts = [
+        'offer_version_id' => 'int',
+        'size'             => 'int',
+        'include_in_pdf'   => 'bool',
+    ];
+
+    public static array $iconExt = [
+        'default' => 'fa fa-file',
+        'pdf'     => 'fa fa-file-pdf',
+        'jpg'     => 'fa fa-file-image',
+        'jpeg'    => 'fa fa-file-image',
+        'png'     => 'fa fa-file-image',
+        'doc'     => 'fa fa-file-word',
+        'docx'    => 'fa fa-file-word',
+    ];
+
+    public function version(): BelongsTo
+    {
+        return $this->belongsTo(OfferVersion::class, 'offer_version_id');
+    }
+
+    public function getIconExt(): string
+    {
+        return self::$iconExt[$this->ext] ?? self::$iconExt['default'];
+    }
+
+    public function getURL(bool|string $do = false): string
+    {
+        return route('storage_file', [$this->id, 'offer', $do]);
+    }
+
+    public function getPath(): string
+    {
+        return \Storage::disk('offer')->path($this->dir . $this->filename);
+    }
+
+    public function formatBytes(int $precision = 2): string
+    {
+        $size = $this->size;
+        if ($size <= 0) {
+            return (string) $size;
+        }
+
+        $base     = log($size) / log(1024);
+        $suffixes = [' bytes', ' KB', ' MB', ' GB', ' TB'];
+
+        return round(1024 ** ($base - floor($base)), $precision) . $suffixes[floor($base)];
+    }
+}

dev/backups/phase2-offers-2026-04-17/FILES/models/OfferItem.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Models;
+
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * Position einer Angebotsversion (Modul 6).
+ *
+ * `travel_program_id` und `fewo_lodging_id` bleiben FK-frei, solange
+ * Modul 12 (v2-Reiseverwaltung) noch nicht nach Laravel migriert ist.
+ * `metadata` enthält einen Snapshot der Referenzdaten (Titel, Preis,
+ * Leistungen) — so bleiben Positionen lesbar, auch wenn das Original
+ * später gelöscht / migriert / umbenannt wird.
+ *
+ * @property int $id
+ * @property int $offer_version_id
+ * @property int $position
+ * @property string $type
+ * @property string $title
+ * @property string|null $description
+ * @property int $quantity
+ * @property float $price_per_unit
+ * @property float $total_price
+ * @property int|null $travel_program_id
+ * @property int|null $fewo_lodging_id
+ * @property array|null $metadata
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property-read OfferVersion $version
+ */
+class OfferItem extends Model
+{
+    use HasFactory;
+
+    public const TYPE_TRAVEL    = 'travel';
+    public const TYPE_SERVICE   = 'service';
+    public const TYPE_OPTION    = 'option';
+    public const TYPE_DISCOUNT  = 'discount';
+    public const TYPE_INSURANCE = 'insurance';
+    public const TYPE_CUSTOM    = 'custom';
+
+    protected $table = 'offer_items';
+
+    protected $fillable = [
+        'offer_version_id',
+        'position',
+        'type',
+        'title',
+        'description',
+        'quantity',
+        'price_per_unit',
+        'total_price',
+        'travel_program_id',
+        'fewo_lodging_id',
+        'metadata',
+    ];
+
+    protected $casts = [
+        'offer_version_id'  => 'int',
+        'position'          => 'int',
+        'quantity'          => 'int',
+        'price_per_unit'    => 'decimal:2',
+        'total_price'       => 'decimal:2',
+        'travel_program_id' => 'int',
+        'fewo_lodging_id'   => 'int',
+        'metadata'          => 'array',
+    ];
+
+    public function version(): BelongsTo
+    {
+        return $this->belongsTo(OfferVersion::class, 'offer_version_id');
+    }
+
+    /**
+     * Aus Menge × Einzelpreis den Positions-Gesamtpreis berechnen
+     * (Rabatte negativ — gehört in den Service-Layer zur Summierung).
+     */
+    public function calculateTotal(): float
+    {
+        return round($this->quantity * (float) $this->price_per_unit, 2);
+    }
+}

dev/backups/phase2-offers-2026-04-17/FILES/models/OfferTemplate.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Models;
+
+use App\User;
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * Wiederverwendbare Angebots-Vorlage (Modul 6).
+ *
+ * Liefert Default-Texte + Default-Positionen für neue Angebote.
+ * `default_items` ist ein JSON-Array von Positionen im Schema
+ * [{title, description, type, price_per_unit, quantity}, …].
+ *
+ * @property int $id
+ * @property int|null $branch_id
+ * @property string $name
+ * @property string|null $description
+ * @property string|null $default_headline
+ * @property string|null $default_intro
+ * @property string|null $default_itinerary
+ * @property string|null $default_closing
+ * @property array|null $default_items
+ * @property bool $is_active
+ * @property int $created_by
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property Carbon|null $deleted_at
+ * @property-read Branch|null $branch
+ * @property-read User $creator
+ */
+class OfferTemplate extends Model
+{
+    use HasFactory, SoftDeletes;
+
+    protected $table = 'offer_templates';
+
+    protected $fillable = [
+        'branch_id',
+        'name',
+        'description',
+        'default_headline',
+        'default_intro',
+        'default_itinerary',
+        'default_closing',
+        'default_items',
+        'is_active',
+        'created_by',
+    ];
+
+    protected $casts = [
+        'branch_id'     => 'int',
+        'default_items' => 'array',
+        'is_active'     => 'bool',
+        'created_by'    => 'int',
+    ];
+
+    public function branch(): BelongsTo
+    {
+        return $this->belongsTo(Branch::class);
+    }
+
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    public function scopeActive(Builder $q): Builder
+    {
+        return $q->where('is_active', true);
+    }
+}

dev/backups/phase2-offers-2026-04-17/FILES/models/OfferVersion.php

@@ -0,0 +1,126 @@
+<?php
+
+namespace App\Models;
+
+use App\User;
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+/**
+ * Version eines Angebots (Modul 6).
+ *
+ * Jede versendete Fassung wird hier festgehalten — Texte, Positionen
+ * und PDF bleiben damit unveränderlich, sobald ein Kunde sie per
+ * Freigabe-Link einsehen kann. Neue Änderungen nach dem Versand
+ * erzeugen eine neue Version (version_no = max+1, status = draft).
+ *
+ * @property int $id
+ * @property int $offer_id
+ * @property int $version_no
+ * @property string $status
+ * @property Carbon|null $valid_until
+ * @property float $total_price
+ * @property string|null $headline
+ * @property string|null $intro_text
+ * @property string|null $itinerary_text
+ * @property string|null $closing_text
+ * @property int|null $template_id
+ * @property string|null $pdf_path
+ * @property bool $pdf_archived
+ * @property Carbon|null $sent_at
+ * @property Carbon|null $accepted_at
+ * @property string|null $accepted_via
+ * @property array|null $template_document_ids
+ * @property int $created_by
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property-read Offer $offer
+ * @property-read OfferTemplate|null $template
+ * @property-read Collection|OfferItem[] $items
+ * @property-read Collection|OfferFile[] $files
+ * @property-read User $creator
+ */
+class OfferVersion extends Model
+{
+    use HasFactory;
+
+    public const STATUS_DRAFT      = 'draft';
+    public const STATUS_SENT       = 'sent';
+    public const STATUS_ACCEPTED   = 'accepted';
+    public const STATUS_DECLINED   = 'declined';
+    public const STATUS_EXPIRED    = 'expired';
+    public const STATUS_SUPERSEDED = 'superseded';
+
+    public const ACCEPTED_VIA_LINK  = 'customer_link';
+    public const ACCEPTED_VIA_ADMIN = 'admin';
+    public const ACCEPTED_VIA_MAIL  = 'email';
+
+    protected $table = 'offer_versions';
+
+    protected $fillable = [
+        'offer_id',
+        'version_no',
+        'status',
+        'valid_until',
+        'total_price',
+        'headline',
+        'intro_text',
+        'itinerary_text',
+        'closing_text',
+        'template_id',
+        'pdf_path',
+        'pdf_archived',
+        'sent_at',
+        'accepted_at',
+        'accepted_via',
+        'template_document_ids',
+        'created_by',
+    ];
+
+    protected $casts = [
+        'offer_id'              => 'int',
+        'version_no'            => 'int',
+        'valid_until'           => 'date',
+        'total_price'           => 'decimal:2',
+        'template_id'           => 'int',
+        'pdf_archived'          => 'bool',
+        'sent_at'               => 'datetime',
+        'accepted_at'           => 'datetime',
+        'template_document_ids' => 'array',
+        'created_by'            => 'int',
+    ];
+
+    public function offer(): BelongsTo
+    {
+        return $this->belongsTo(Offer::class);
+    }
+
+    public function template(): BelongsTo
+    {
+        return $this->belongsTo(OfferTemplate::class, 'template_id');
+    }
+
+    public function items(): HasMany
+    {
+        return $this->hasMany(OfferItem::class)->orderBy('position');
+    }
+
+    public function files(): HasMany
+    {
+        return $this->hasMany(OfferFile::class);
+    }
+
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    public function isEditable(): bool
+    {
+        return $this->status === self::STATUS_DRAFT;
+    }
+}