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
This commit is contained in:
+78
-2
@@ -3,6 +3,7 @@
|
||||
namespace App\Models;
|
||||
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\MorphMany;
|
||||
use Illuminate\Database\Eloquent\SoftDeletes;
|
||||
|
||||
class Phase extends Model
|
||||
@@ -12,6 +13,7 @@ class Phase extends Model
|
||||
protected $fillable = [
|
||||
'project_id', 'name', 'description', 'order', 'color', 'progress_percent',
|
||||
'planned_start', 'planned_end', 'actual_start', 'actual_end',
|
||||
'baseline_start', 'baseline_end',
|
||||
];
|
||||
|
||||
protected $casts = [
|
||||
@@ -19,6 +21,8 @@ class Phase extends Model
|
||||
'planned_end' => 'date',
|
||||
'actual_start' => 'date',
|
||||
'actual_end' => 'date',
|
||||
'baseline_start' => 'date',
|
||||
'baseline_end' => 'date',
|
||||
];
|
||||
|
||||
public function project()
|
||||
@@ -61,13 +65,85 @@ class Phase extends Model
|
||||
return $this->hasMany(Task::class);
|
||||
}
|
||||
|
||||
public function progressSnapshots(): MorphMany
|
||||
{
|
||||
return $this->morphMany(ProgressSnapshot::class, 'trackable');
|
||||
}
|
||||
|
||||
/**
|
||||
* Deviation in days: positive = delayed, negative = early
|
||||
*/
|
||||
public function getDeviationDaysAttribute(): ?int
|
||||
{
|
||||
if (! $this->planned_end) {
|
||||
return null;
|
||||
}
|
||||
$end = $this->actual_end ?? now();
|
||||
|
||||
$end = $this->actual_end ?? now()->toDateString();
|
||||
|
||||
return $this->planned_end->diffInDays($end, false);
|
||||
}
|
||||
|
||||
/**
|
||||
* Start deviation: positive = delayed start, negative = early start
|
||||
*/
|
||||
public function getStartDeviationDaysAttribute(): ?int
|
||||
{
|
||||
if (! $this->planned_start) {
|
||||
return null;
|
||||
}
|
||||
$start = $this->actual_start ?? now()->toDateString();
|
||||
|
||||
return $this->planned_start->diffInDays($start, false);
|
||||
}
|
||||
|
||||
/**
|
||||
* Planned progress at a given date (linear interpolation)
|
||||
*/
|
||||
public function getPlannedProgressAtAttribute(?\Carbon\Carbon $date = null): float
|
||||
{
|
||||
$date = $date ?? now();
|
||||
|
||||
if (! $this->planned_start || ! $this->planned_end) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
if ($date <= $this->planned_start) {
|
||||
return 0;
|
||||
}
|
||||
if ($date >= $this->planned_end) {
|
||||
return 100;
|
||||
}
|
||||
|
||||
$totalDays = $this->planned_start->diffInDays($this->planned_end);
|
||||
$elapsedDays = $this->planned_start->diffInDays($date);
|
||||
|
||||
return round(($elapsedDays / $totalDays) * 100, 2);
|
||||
}
|
||||
|
||||
/**
|
||||
* Schedule Performance Index (SPI) = EV / PV
|
||||
*/
|
||||
public function getSpiAttribute(): ?float
|
||||
{
|
||||
$pv = $this->planned_progress_at; // Planned Value
|
||||
$ev = $this->progress_percent; // Earned Value (current progress)
|
||||
|
||||
if ($pv <= 0) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return round($ev / $pv, 2);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if phase is on track (SPI >= 0.95)
|
||||
*/
|
||||
public function getIsOnTrackAttribute(): ?bool
|
||||
{
|
||||
$spi = $this->spi;
|
||||
if ($spi === null) {
|
||||
return null;
|
||||
}
|
||||
return $spi >= 0.95;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user