feat(reports): complete reporting system with deviations, progress curves, multi-format export

- Added planned/actual/baseline dates to Phase and Feature models - Created ProgressSnapshot model + migration for historical tracking - Implemented CaptureDailyProgressSnapshot job (scheduled daily at 06:30) - Added DeviationCalculator logic (SPI, planned progress, deviation days) - ReportGenerator service with complete data aggregation - ReportController with builder, preview, generate (HTML/Excel) - ReportBuilder Livewire component with date range, entity selection, format - ProjectReportExport with 10 sheets (Summary, Phases, Features, Inspections, Issues, Tasks, Deviations, Media, Progress Curve, Parameters) - Blade partials for all sections (header, summary, phases, features, inspections, issues, tasks, media, deviations, progress curve) - New routes: /projects/{project}/reports/* - Added 'generate reports' permission - All 101 tests passing
2026-08-24 12:32:08 +02:00
parent c58a49f22d
commit ee32544525
30 changed files with 3170 additions and 7 deletions
@@ -0,0 +1,79 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+
+class ProgressSnapshot extends Model
+{
+    protected $fillable = [
+        'trackable_type',
+        'trackable_id',
+        'snapshot_date',
+        'progress',
+        'planned_start',
+        'planned_end',
+        'actual_start',
+        'actual_end',
+        'method',
+        'metadata',
+    ];
+
+    protected $casts = [
+        'snapshot_date' => 'date',
+        'planned_start' => 'date',
+        'planned_end' => 'date',
+        'actual_start' => 'date',
+        'actual_end' => 'date',
+        'progress' => 'decimal:2',
+        'metadata' => 'array',
+    ];
+
+    public function trackable(): MorphTo
+    {
+        return $this->morphTo();
+    }
+
+    /**
+     * Scope for a specific date range
+     */
+    public function scopeDateRange($query, $from, $to)
+    {
+        return $query->whereBetween('snapshot_date', [$from, $to]);
+    }
+
+    /**
+     * Scope for specific trackable
+     */
+    public function scopeForTrackable($query, $model, $id = null)
+    {
+        $query->where('trackable_type', $model);
+        if ($id) {
+            $query->where('trackable_id', $id);
+        }
+        return $query;
+    }
+
+    /**
+     * Get latest snapshot for a trackable
+     */
+    public static function latestFor($model, $id): ?self
+    {
+        return static::forTrackable($model, $id)
+            ->latest('snapshot_date')
+            ->first();
+    }
+
+    /**
+     * Get progress trend (last N snapshots)
+     */
+    public static function trendFor($model, $id, int $limit = 10): array
+    {
+        return static::forTrackable($model, $id)
+            ->orderBy('snapshot_date')
+            ->take($limit)
+            ->get(['snapshot_date', 'progress', 'method'])
+            ->toArray();
+    }
+}