chore: update document approval workflow and bug fixes

Modules/ProjectManagement/app/Models/ProjectMilestone.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace Modules\ProjectManagement\Models;
+
+use App\Traits\HasPublicIdentifier;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Modules\ProjectManagement\Enums\WeatherCondition;
+
+class ProjectMilestone extends Model
+{
+    use HasPublicIdentifier;
+
+    protected $fillable = [
+        'project_id',
+        'name',
+        'description',
+        'planned_date',
+        'actual_date',
+        'sort_order',
+        'weight_percentage',
+        'is_default',
+        'weather_impacted',
+        'weather_condition',
+        'weather_delay_days',
+        'weather_notes',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'planned_date' => 'date',
+            'actual_date' => 'date',
+            'weight_percentage' => 'decimal:2',
+            'is_default' => 'boolean',
+            'weather_impacted' => 'boolean',
+            'weather_condition' => WeatherCondition::class,
+        ];
+    }
+
+    public function project(): BelongsTo
+    {
+        return $this->belongsTo(Project::class);
+    }
+
+    // --- Accessors ---
+
+    public function getIsCompletedAttribute(): bool
+    {
+        return $this->actual_date !== null;
+    }
+
+    public function getIsOverdueAttribute(): bool
+    {
+        return !$this->is_completed
+            && $this->planned_date
+            && $this->planned_date->isPast();
+    }
+
+    public function getStatusAttribute(): string
+    {
+        if ($this->is_completed) return 'completed';
+        if ($this->is_overdue) return 'overdue';
+        return 'upcoming';
+    }
+
+    public function getStatusColorAttribute(): string
+    {
+        return match ($this->status) {
+            'completed' => 'emerald',
+            'overdue' => 'amber',
+            default => 'gray',
+        };
+    }
+
+    public function getDaysDelayedAttribute(): int
+    {
+        if (!$this->is_completed || !$this->planned_date) return 0;
+
+        $diff = $this->planned_date->diffInDays($this->actual_date, false);
+        return max(0, $diff);
+    }
+}