wip

app/Console/Commands/TriggerRecurringInvoiceGeneration.php

+<?php
+
+namespace App\Console\Commands;
+
+use App\Jobs\GenerateRecurringInvoices;
+use Illuminate\Console\Command;
+
+class TriggerRecurringInvoiceGeneration extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'invoices:generate-recurring {--queue : Whether the job should be queued}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Generate invoices for active recurring schedules';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): void
+    {
+        if ($this->option('queue')) {
+            GenerateRecurringInvoices::dispatch();
+
+            $this->info('Recurring invoice generation has been queued.');
+        } else {
+            GenerateRecurringInvoices::dispatchSync();
+
+            $this->info('Recurring invoices have been generated.');
+        }
+    }
+}

app/Enums/Accounting/DayOfMonth.php

 namespace App\Enums\Accounting;
 
 use App\Enums\Concerns\ParsesEnum;
+use Carbon\CarbonImmutable;
 use Filament\Support\Contracts\HasLabel;
+use Illuminate\Support\Carbon;
 
 enum DayOfMonth: int implements HasLabel
 {
             self::ThirtyFirst => '31st',
         };
     }
+
+    public function isFirst(): bool
+    {
+        return $this === self::First;
+    }
+
+    public function isLast(): bool
+    {
+        return $this === self::Last;
+    }
+
+    public function resolveDate(Carbon | CarbonImmutable $date): Carbon | CarbonImmutable
+    {
+        if ($this->isLast()) {
+            return $date->endOfMonth();
+        }
+
+        return $date->day(min($this->value, $date->daysInMonth));
+    }
 }

app/Filament/Company/Resources/Sales/RecurringInvoiceResource/Pages/ViewRecurringInvoice.php

 
 use App\Enums\Accounting\DocumentType;
 use App\Filament\Company\Resources\Sales\ClientResource;
+use App\Filament\Company\Resources\Sales\InvoiceResource;
 use App\Filament\Company\Resources\Sales\RecurringInvoiceResource;
 use App\Filament\Infolists\Components\DocumentPreview;
 use App\Models\Accounting\RecurringInvoice;
 use Filament\Support\Enums\IconPosition;
 use Filament\Support\Enums\IconSize;
 use Filament\Support\Enums\MaxWidth;
+use Illuminate\Support\Str;
 
 class ViewRecurringInvoice extends ViewRecord
 {
                         RecurringInvoice::getUpdateScheduleAction(Action::class)
                             ->outlined(),
                     ]),
+                SimpleAlert::make('readyToApprove')
+                    ->info()
+                    ->title('Ready to Approve')
+                    ->description('This recurring invoice is ready for approval. Review the details, and approve it when you’re ready to start generating invoices.')
+                    ->visible(fn (RecurringInvoice $record) => $record->isDraft() && $record->hasSchedule())
+                    ->columnSpanFull()
+                    ->actions([
+                        RecurringInvoice::getApproveDraftAction(Action::class)
+                            ->outlined(),
+                    ]),
                 Section::make('Invoice Details')
                     ->columns(4)
                     ->schema([
                                         return $record->getTimelineDescription();
                                     }),
                                 TextEntry::make('occurrences_count')
-                                    ->label('Invoices Created')
-                                    ->visible(fn (RecurringInvoice $record) => $record->occurrences_count > 0),
+                                    ->label('Created to Date')
+                                    ->visible(static fn (RecurringInvoice $record) => $record->occurrences_count > 0)
+                                    ->color('primary')
+                                    ->weight(FontWeight::SemiBold)
+                                    ->suffix(fn (RecurringInvoice $record) => Str::of(' invoice')->plural($record->occurrences_count))
+                                    ->url(static fn (RecurringInvoice $record) => InvoiceResource::getUrl()),
                                 TextEntry::make('end_date')
                                     ->label('Ends On')
                                     ->date()

app/Jobs/GenerateRecurringInvoices.php

+<?php
+
+namespace App\Jobs;
+
+use App\Enums\Accounting\RecurringInvoiceStatus;
+use App\Models\Accounting\RecurringInvoice;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Foundation\Queue\Queueable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+
+class GenerateRecurringInvoices implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+    use SerializesModels;
+
+    /**
+     * Execute the job.
+     */
+    public function handle(): void
+    {
+        RecurringInvoice::query()
+            ->where('status', RecurringInvoiceStatus::Active)
+            ->chunk(100, function ($recurringInvoices) {
+                foreach ($recurringInvoices as $recurringInvoice) {
+                    $recurringInvoice->generateDueInvoices();
+                }
+            });
+    }
+}

app/Models/Accounting/RecurringInvoice.php

 use App\Enums\Accounting\EndType;
 use App\Enums\Accounting\Frequency;
 use App\Enums\Accounting\IntervalType;
+use App\Enums\Accounting\InvoiceStatus;
 use App\Enums\Accounting\Month;
 use App\Enums\Accounting\RecurringInvoiceStatus;
 use App\Enums\Setting\PaymentTerms;
 use Guava\FilamentClusters\Forms\Cluster;
 use Illuminate\Database\Eloquent\Attributes\CollectedBy;
 use Illuminate\Database\Eloquent\Attributes\ObservedBy;
+use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Support\Carbon;
         'payment_terms' => PaymentTerms::class,
         'frequency' => Frequency::class,
         'interval_type' => IntervalType::class,
+        'interval_value' => 'integer',
         'month' => Month::class,
         'day_of_month' => DayOfMonth::class,
         'day_of_week' => DayOfWeek::class,
         return "Repeat every {$interval}{$dayDescription}";
     }
 
-    /**
-     * Get a human-readable description of when the schedule ends.
-     */
     public function getEndDescription(): string
     {
         if (! $this->end_type) {
         };
     }
 
-    /**
-     * Get the schedule timeline description.
-     */
     public function getTimelineDescription(): string
     {
         $parts = [];
         return implode(', ', $parts);
     }
 
-    /**
-     * Get next occurrence date based on the schedule.
-     */
-    public function calculateNextDate(): ?Carbon
+    public function calculateNextDate(?Carbon $lastDate = null): ?Carbon
     {
-        $lastDate = $this->last_date ?? $this->start_date;
+        $lastDate ??= $this->last_date;
+
+        if (! $lastDate && $this->start_date) {
+            return $this->start_date;
+        }
+
         if (! $lastDate) {
             return null;
         }
         $nextDate = match (true) {
             $this->frequency->isDaily() => $lastDate->addDay(),
 
-            $this->frequency->isWeekly() => $lastDate->addWeek(),
+            $this->frequency->isWeekly() => $this->calculateNextWeeklyDate($lastDate),
 
-            $this->frequency->isMonthly() => $lastDate->addMonth(),
+            $this->frequency->isMonthly() => $this->calculateNextMonthlyDate($lastDate),
 
-            $this->frequency->isYearly() => $lastDate->addYear(),
+            $this->frequency->isYearly() => $this->calculateNextYearlyDate($lastDate),
 
             $this->frequency->isCustom() => $this->calculateCustomNextDate($lastDate),
 
             default => null
         };
 
-        // Check if we've reached the end
-        if ($this->hasReachedEnd($nextDate)) {
+        if (! $nextDate || $this->hasReachedEnd($nextDate)) {
             return null;
         }
 
         return $nextDate;
     }
 
-    public function calculateNextDueDate(): ?Carbon
+    public function calculateNextWeeklyDate(Carbon $lastDate): ?Carbon
     {
-        $nextDate = $this->calculateNextDate();
-        if (! $nextDate) {
-            return null;
-        }
+        return $lastDate->copy()->next($this->day_of_week->value);
+    }
 
-        $terms = $this->payment_terms;
-        if (! $terms) {
-            return $nextDate;
-        }
+    public function calculateNextMonthlyDate(Carbon $lastDate): ?Carbon
+    {
+        return match (true) {
+            $lastDate->equalTo($this->start_date) => $lastDate->copy()->day(
+                min($this->day_of_month->value, $lastDate->daysInMonth)
+            ),
 
-        return $nextDate->addDays($terms->getDays());
+            default => $lastDate->copy()->addMonth()->day(
+                min($this->day_of_month->value, $lastDate->copy()->addMonth()->daysInMonth)
+            ),
+        };
     }
 
-    /**
-     * Calculate next date for custom intervals
-     */
-    protected function calculateCustomNextDate(Carbon $lastDate): ?\Carbon\Carbon
+    public function calculateNextYearlyDate(Carbon $lastDate): ?Carbon
     {
-        $value = $this->interval_value ?? 1;
+        return match (true) {
+            $lastDate->equalTo($this->start_date) => $lastDate->copy()
+                ->month($this->month->value)
+                ->day(min($this->day_of_month->value, $lastDate->daysInMonth)),
+
+            default => $lastDate->copy()
+                ->addYear()
+                ->month($this->month->value)
+                ->day(min($this->day_of_month->value, $lastDate->copy()->addYear()->month($this->month->value)->daysInMonth))
+        };
+    }
+
+    protected function calculateCustomNextDate(Carbon $lastDate): ?Carbon
+    {
+        $interval = $this->interval_value ?? 1;
 
         return match ($this->interval_type) {
-            IntervalType::Day => $lastDate->addDays($value),
-            IntervalType::Week => $lastDate->addWeeks($value),
-            IntervalType::Month => $lastDate->addMonths($value),
-            IntervalType::Year => $lastDate->addYears($value),
+            IntervalType::Day => $lastDate->copy()->addDays($interval),
+
+            IntervalType::Week => match (true) {
+                $lastDate->equalTo($this->start_date) => $lastDate->copy()->next($this->day_of_week->value),
+
+                $lastDate->dayOfWeek === $this->day_of_week->value => $lastDate->copy()->addWeeks($interval),
+
+                default => $lastDate->copy()->next($this->day_of_week->value),
+            },
+
+            IntervalType::Month => match (true) {
+                $lastDate->equalTo($this->start_date) => $lastDate->copy()->day(
+                    min($this->day_of_month->value, $lastDate->daysInMonth)
+                ),
+
+                default => $lastDate->copy()->addMonths($interval)->day(
+                    min($this->day_of_month->value, $lastDate->copy()->addMonths($interval)->daysInMonth)
+                ),
+            },
+
+            IntervalType::Year => match (true) {
+                $lastDate->equalTo($this->start_date) => $lastDate->copy()
+                    ->month($this->month->value)
+                    ->day(min($this->day_of_month->value, $lastDate->daysInMonth)),
+
+                default => $lastDate->copy()
+                    ->addYears($interval)
+                    ->month($this->month->value)
+                    ->day(min($this->day_of_month->value, $lastDate->copy()->addYears($interval)->month($this->month->value)->daysInMonth))
+            },
+
             default => null
         };
     }
 
-    /**
-     * Check if the schedule has reached its end
-     */
+    public function calculateNextDueDate(): ?Carbon
+    {
+        if (! $nextDate = $this->calculateNextDate()) {
+            return null;
+        }
+
+        if (! $terms = $this->payment_terms) {
+            return $nextDate;
+        }
+
+        return $nextDate->copy()->addDays($terms->getDays());
+    }
+
     public function hasReachedEnd(?Carbon $nextDate = null): bool
     {
         if (! $this->end_type) {
                             ->visible(
                                 fn (Forms\Get $get) => Frequency::parse($get('frequency'))->isYearly() ||
                                 IntervalType::parse($get('interval_type'))?->isYear()
-                            ),
+                            )
+                            ->live()
+                            ->afterStateUpdated(function (Forms\Set $set, Forms\Get $get, $state) {
+                                $dayOfMonth = DayOfMonth::parse($get('day_of_month'));
+                                $frequency = Frequency::parse($get('frequency'));
+                                $intervalType = IntervalType::parse($get('interval_type'));
+                                $month = Month::parse($state);
+
+                                if (($frequency->isYearly() || $intervalType?->isYear()) && $month && $dayOfMonth) {
+                                    $date = $dayOfMonth->resolveDate(today()->month($month->value))->toImmutable();
+
+                                    $adjustedStartDate = $date->lt(today())
+                                        ? $dayOfMonth->resolveDate($date->addYear()->month($month->value))
+                                        : $dayOfMonth->resolveDate($date->month($month->value));
+
+                                    $adjustedDay = min($dayOfMonth->value, $adjustedStartDate->daysInMonth);
+
+                                    $set('day_of_month', $adjustedDay);
+
+                                    $set('start_date', $adjustedStartDate);
+                                }
+                            }),
 
                         Forms\Components\Select::make('day_of_month')
                             ->label('Day of Month')
-                            ->options(DayOfMonth::class)
+                            ->options(function (Forms\Get $get) {
+                                $month = Month::parse($get('month')) ?? Month::January;
+
+                                $daysInMonth = Carbon::createFromDate(null, $month->value)->daysInMonth;
+
+                                return collect(DayOfMonth::cases())
+                                    ->filter(static fn (DayOfMonth $dayOfMonth) => $dayOfMonth->value <= $daysInMonth || $dayOfMonth->isLast())
+                                    ->mapWithKeys(fn (DayOfMonth $dayOfMonth) => [$dayOfMonth->value => $dayOfMonth->getLabel()]);
+                            })
                             ->softRequired()
                             ->visible(
                                 fn (Forms\Get $get) => Frequency::parse($get('frequency'))?->isMonthly() ||
                                 Frequency::parse($get('frequency'))?->isYearly() ||
                                 IntervalType::parse($get('interval_type'))?->isMonth() ||
                                 IntervalType::parse($get('interval_type'))?->isYear()
-                            ),
+                            )
+                            ->live()
+                            ->afterStateUpdated(function (Forms\Set $set, Forms\Get $get, $state) {
+                                $dayOfMonth = DayOfMonth::parse($state);
+                                $frequency = Frequency::parse($get('frequency'));
+                                $intervalType = IntervalType::parse($get('interval_type'));
+                                $month = Month::parse($get('month'));
+
+                                if (($frequency->isMonthly() || $intervalType?->isMonth()) && $dayOfMonth) {
+                                    $date = $dayOfMonth->resolveDate(today())->toImmutable();
+
+                                    $adjustedStartDate = $date->lt(today())
+                                        ? $dayOfMonth->resolveDate($date->addMonth())
+                                        : $dayOfMonth->resolveDate($date);
+
+                                    $set('start_date', $adjustedStartDate);
+                                }
+
+                                if (($frequency->isYearly() || $intervalType?->isYear()) && $month && $dayOfMonth) {
+                                    $date = $dayOfMonth->resolveDate(today()->month($month->value))->toImmutable();
+
+                                    $adjustedStartDate = $date->lt(today())
+                                        ? $dayOfMonth->resolveDate($date->addYear()->month($month->value))
+                                        : $dayOfMonth->resolveDate($date->month($month->value));
+
+                                    $set('start_date', $adjustedStartDate);
+                                }
+                            }),
 
                         Forms\Components\Select::make('day_of_week')
                             ->label('Day of Week')
                             ->visible(
                                 fn (Forms\Get $get) => Frequency::parse($get('frequency'))?->isWeekly() ||
                                 IntervalType::parse($get('interval_type'))?->isWeek()
-                            ),
+                            )
+                            ->live()
+                            ->afterStateUpdated(function (Forms\Set $set, $state) {
+                                $dayOfWeek = DayOfWeek::parse($state);
+
+                                $adjustedStartDate = today()->is($dayOfWeek->name)
+                                    ? today()
+                                    : today()->next($dayOfWeek->name);
+
+                                $set('start_date', $adjustedStartDate);
+                            }),
                     ])->columns(2),
 
                 CustomSection::make('Dates & Time')
                     ->schema([
                         Forms\Components\DatePicker::make('start_date')
                             ->label('First Invoice Date')
-                            ->softRequired(),
+                            ->softRequired()
+                            ->live()
+                            ->minDate(today())
+                            ->closeOnDateSelection()
+                            ->afterStateUpdated(function (Forms\Set $set, $state) {
+                                $startDate = Carbon::parse($state);
+
+                                $dayOfWeek = DayOfWeek::parse($startDate->dayOfWeek);
+
+                                $set('day_of_week', $dayOfWeek);
+                            }),
 
                         Forms\Components\Group::make(function (Forms\Get $get) {
                             $components = [];
             'status' => RecurringInvoiceStatus::Active,
         ]);
     }
+
+    public function generateInvoice(): ?Invoice
+    {
+        if (! $this->shouldGenerateInvoice()) {
+            return null;
+        }
+
+        $nextDate = $this->next_date ?? $this->calculateNextDate();
+
+        if (! $nextDate) {
+            return null;
+        }
+
+        $dueDate = $this->calculateNextDueDate();
+
+        $invoice = $this->invoices()->create([
+            'company_id' => $this->company_id,
+            'client_id' => $this->client_id,
+            'logo' => $this->logo,
+            'header' => $this->header,
+            'subheader' => $this->subheader,
+            'invoice_number' => Invoice::getNextDocumentNumber($this->company),
+            'date' => $nextDate,
+            'due_date' => $dueDate,
+            'status' => InvoiceStatus::Draft,
+            'currency_code' => $this->currency_code,
+            'discount_method' => $this->discount_method,
+            'discount_computation' => $this->discount_computation,
+            'discount_rate' => $this->discount_rate,
+            'subtotal' => $this->subtotal,
+            'tax_total' => $this->tax_total,
+            'discount_total' => $this->discount_total,
+            'total' => $this->total,
+            'terms' => $this->terms,
+            'footer' => $this->footer,
+            'created_by' => auth()->id(),
+            'updated_by' => auth()->id(),
+        ]);
+
+        $this->replicateLineItems($invoice);
+
+        $this->update([
+            'last_date' => $nextDate,
+            'next_date' => $this->calculateNextDate($nextDate),
+            'occurrences_count' => ($this->occurrences_count ?? 0) + 1,
+        ]);
+
+        return $invoice;
+    }
+
+    public function replicateLineItems(Model $target): void
+    {
+        $this->lineItems->each(function (DocumentLineItem $lineItem) use ($target) {
+            $replica = $lineItem->replicate([
+                'documentable_id',
+                'documentable_type',
+                'subtotal',
+                'total',
+                'created_by',
+                'updated_by',
+                'created_at',
+                'updated_at',
+            ]);
+
+            $replica->documentable_id = $target->id;
+            $replica->documentable_type = $target->getMorphClass();
+            $replica->save();
+
+            $replica->adjustments()->sync($lineItem->adjustments->pluck('id'));
+        });
+    }
+
+    public function shouldGenerateInvoice(): bool
+    {
+        if (! $this->isActive() || $this->hasReachedEnd()) {
+            return false;
+        }
+
+        $nextDate = $this->calculateNextDate();
+
+        if (! $nextDate || $nextDate->startOfDay()->isFuture()) {
+            return false;
+        }
+
+        return true;
+    }
+
+    public function generateDueInvoices(): void
+    {
+        $maxIterations = 100;
+
+        for ($i = 0; $i < $maxIterations; $i++) {
+            $result = $this->generateInvoice();
+
+            if (! $result) {
+                break;
+            }
+
+            $this->refresh();
+        }
+    }
 }

app/Observers/RecurringInvoiceObserver.php

 
 namespace App\Observers;
 
+use App\Enums\Accounting\RecurringInvoiceStatus;
+use App\Models\Accounting\DocumentLineItem;
 use App\Models\Accounting\RecurringInvoice;
+use Illuminate\Support\Facades\DB;
 
 class RecurringInvoiceObserver
 {
-    /**
-     * Handle the RecurringInvoice "updated" event.
-     */
-    public function updated(RecurringInvoice $recurringInvoice): void
+    public function saving(RecurringInvoice $recurringInvoice): void
     {
-        $recurringInvoice->updateQuietly([
-            'next_date' => $recurringInvoice->calculateNextDate(),
+        if (($recurringInvoice->isDirty('start_date') && ! $recurringInvoice->last_date) || $this->otherScheduleDetailsChanged($recurringInvoice)) {
+            $recurringInvoice->next_date = $recurringInvoice->calculateNextDate();
+        }
+
+        if ($recurringInvoice->end_type?->isAfter() && $recurringInvoice->occurrences_count >= $recurringInvoice->max_occurrences) {
+            $recurringInvoice->status = RecurringInvoiceStatus::Ended;
+            $recurringInvoice->ended_at = now();
+        }
+    }
+
+    public function saved(RecurringInvoice $recurringInvoice): void
+    {
+        if ($recurringInvoice->wasChanged('status')) {
+            $recurringInvoice->generateDueInvoices();
+        }
+    }
+
+    protected function otherScheduleDetailsChanged(RecurringInvoice $recurringInvoice): bool
+    {
+        return $recurringInvoice->isDirty([
+            'frequency',
+            'interval_type',
+            'interval_value',
+            'month',
+            'day_of_month',
+            'day_of_week',
+            'end_type',
+            'max_occurrences',
+            'end_date',
         ]);
     }
 
-    /**
-     * Handle the RecurringInvoice "deleted" event.
-     */
     public function deleted(RecurringInvoice $recurringInvoice): void
     {
-        //
+        DB::transaction(function () use ($recurringInvoice) {
+            $recurringInvoice->lineItems()->each(function (DocumentLineItem $lineItem) {
+                $lineItem->delete();
+            });
+        });
     }
 }

database/factories/Accounting/RecurringInvoiceFactory.php

 
 namespace Database\Factories\Accounting;
 
+use App\Enums\Accounting\DayOfMonth;
+use App\Enums\Accounting\DayOfWeek;
+use App\Enums\Accounting\EndType;
+use App\Enums\Accounting\Frequency;
+use App\Enums\Accounting\IntervalType;
+use App\Enums\Accounting\Month;
+use App\Enums\Accounting\RecurringInvoiceStatus;
+use App\Enums\Setting\PaymentTerms;
+use App\Models\Accounting\RecurringInvoice;
+use App\Models\Common\Client;
 use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Carbon;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Accounting\RecurringInvoice>
+ * @extends Factory<RecurringInvoice>
  */
 class RecurringInvoiceFactory extends Factory
 {
+    /**
+     * The name of the factory's corresponding model.
+     */
+    protected $model = RecurringInvoice::class;
+
     /**
      * Define the model's default state.
      *
     public function definition(): array
     {
         return [
-            //
+            'company_id' => 1,
+            'client_id' => Client::inRandomOrder()->value('id'),
+            'status' => RecurringInvoiceStatus::Draft,
+
+            // Schedule configuration
+            'frequency' => Frequency::Monthly,
+            'day_of_month' => DayOfMonth::First,
+
+            // Date configuration
+            'start_date' => now()->addMonth()->startOfMonth(),
+            'end_type' => EndType::Never,
+
+            // Invoice configuration
+            'payment_terms' => PaymentTerms::DueUponReceipt,
+            'currency_code' => 'USD',
+
+            // Timestamps and user tracking
+            'terms' => $this->faker->sentence,
+            'footer' => $this->faker->sentence,
+            'created_by' => 1,
+            'updated_by' => 1,
         ];
     }
+
+    public function weekly(DayOfWeek $dayOfWeek = DayOfWeek::Monday): self
+    {
+        return $this->state([
+            'frequency' => Frequency::Weekly,
+            'day_of_week' => $dayOfWeek,
+        ]);
+    }
+
+    public function monthly(DayOfMonth $dayOfMonth = DayOfMonth::First): self
+    {
+        return $this->state([
+            'frequency' => Frequency::Monthly,
+            'day_of_month' => $dayOfMonth,
+        ]);
+    }
+
+    public function yearly(Month $month = Month::January, DayOfMonth $dayOfMonth = DayOfMonth::First): self
+    {
+        return $this->state([
+            'frequency' => Frequency::Yearly,
+            'month' => $month,
+            'day_of_month' => $dayOfMonth,
+        ]);
+    }
+
+    public function custom(IntervalType $intervalType, int $intervalValue = 1): self
+    {
+        return $this->state([
+            'frequency' => Frequency::Custom,
+            'interval_type' => $intervalType,
+            'interval_value' => $intervalValue,
+        ]);
+    }
+
+    public function withEndDate(Carbon $endDate): self
+    {
+        return $this->state([
+            'end_type' => EndType::On,
+            'end_date' => $endDate,
+        ]);
+    }
+
+    public function withMaxOccurrences(int $maxOccurrences): self
+    {
+        return $this->state([
+            'end_type' => EndType::After,
+            'max_occurrences' => $maxOccurrences,
+        ]);
+    }
+
+    public function autoSend(string $time = '09:00'): self
+    {
+        return $this->state([
+            'auto_send' => true,
+            'send_time' => $time,
+        ]);
+    }
 }

package-lock.json

             }
         },
         "node_modules/@rollup/rollup-android-arm-eabi": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.29.1.tgz",
-            "integrity": "sha512-ssKhA8RNltTZLpG6/QNkCSge+7mBQGUqJRisZ2MDQcEGaK93QESEgWK2iOpIDZ7k9zPVkG5AS3ksvD5ZWxmItw==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.29.2.tgz",
+            "integrity": "sha512-s/8RiF4bdmGnc/J0N7lHAr5ZFJj+NdJqJ/Hj29K+c4lEdoVlukzvWXB9XpWZCdakVT0YAw8iyIqUP2iFRz5/jA==",
             "cpu": [
                 "arm"
             ],
             ]
         },
         "node_modules/@rollup/rollup-android-arm64": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.29.1.tgz",
-            "integrity": "sha512-CaRfrV0cd+NIIcVVN/jx+hVLN+VRqnuzLRmfmlzpOzB87ajixsN/+9L5xNmkaUUvEbI5BmIKS+XTwXsHEb65Ew==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.29.2.tgz",
+            "integrity": "sha512-mKRlVj1KsKWyEOwR6nwpmzakq6SgZXW4NUHNWlYSiyncJpuXk7wdLzuKdWsRoR1WLbWsZBKvsUCdCTIAqRn9cA==",
             "cpu": [
                 "arm64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-darwin-arm64": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.29.1.tgz",
-            "integrity": "sha512-2ORr7T31Y0Mnk6qNuwtyNmy14MunTAMx06VAPI6/Ju52W10zk1i7i5U3vlDRWjhOI5quBcrvhkCHyF76bI7kEw==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.29.2.tgz",
+            "integrity": "sha512-vJX+vennGwygmutk7N333lvQ/yKVAHnGoBS2xMRQgXWW8tvn46YWuTDOpKroSPR9BEW0Gqdga2DHqz8Pwk6X5w==",
             "cpu": [
                 "arm64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-darwin-x64": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.29.1.tgz",
-            "integrity": "sha512-j/Ej1oanzPjmN0tirRd5K2/nncAhS9W6ICzgxV+9Y5ZsP0hiGhHJXZ2JQ53iSSjj8m6cRY6oB1GMzNn2EUt6Ng==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.29.2.tgz",
+            "integrity": "sha512-e2rW9ng5O6+Mt3ht8fH0ljfjgSCC6ffmOipiLUgAnlK86CHIaiCdHCzHzmTkMj6vEkqAiRJ7ss6Ibn56B+RE5w==",
             "cpu": [
                 "x64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-freebsd-arm64": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.29.1.tgz",
-            "integrity": "sha512-91C//G6Dm/cv724tpt7nTyP+JdN12iqeXGFM1SqnljCmi5yTXriH7B1r8AD9dAZByHpKAumqP1Qy2vVNIdLZqw==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.29.2.tgz",
+            "integrity": "sha512-/xdNwZe+KesG6XJCK043EjEDZTacCtL4yurMZRLESIgHQdvtNyul3iz2Ab03ZJG0pQKbFTu681i+4ETMF9uE/Q==",
             "cpu": [
                 "arm64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-freebsd-x64": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.29.1.tgz",
-            "integrity": "sha512-hEioiEQ9Dec2nIRoeHUP6hr1PSkXzQaCUyqBDQ9I9ik4gCXQZjJMIVzoNLBRGet+hIUb3CISMh9KXuCcWVW/8w==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.29.2.tgz",
+            "integrity": "sha512-eXKvpThGzREuAbc6qxnArHh8l8W4AyTcL8IfEnmx+bcnmaSGgjyAHbzZvHZI2csJ+e0MYddl7DX0X7g3sAuXDQ==",
             "cpu": [
                 "x64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.29.1.tgz",
-            "integrity": "sha512-Py5vFd5HWYN9zxBv3WMrLAXY3yYJ6Q/aVERoeUFwiDGiMOWsMs7FokXihSOaT/PMWUty/Pj60XDQndK3eAfE6A==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.29.2.tgz",
+            "integrity": "sha512-h4VgxxmzmtXLLYNDaUcQevCmPYX6zSj4SwKuzY7SR5YlnCBYsmvfYORXgiU8axhkFCDtQF3RW5LIXT8B14Qykg==",
             "cpu": [
                 "arm"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.29.1.tgz",
-            "integrity": "sha512-RiWpGgbayf7LUcuSNIbahr0ys2YnEERD4gYdISA06wa0i8RALrnzflh9Wxii7zQJEB2/Eh74dX4y/sHKLWp5uQ==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.29.2.tgz",
+            "integrity": "sha512-EObwZ45eMmWZQ1w4N7qy4+G1lKHm6mcOwDa+P2+61qxWu1PtQJ/lz2CNJ7W3CkfgN0FQ7cBUy2tk6D5yR4KeXw==",
             "cpu": [
                 "arm"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-arm64-gnu": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.29.1.tgz",
-            "integrity": "sha512-Z80O+taYxTQITWMjm/YqNoe9d10OX6kDh8X5/rFCMuPqsKsSyDilvfg+vd3iXIqtfmp+cnfL1UrYirkaF8SBZA==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.29.2.tgz",
+            "integrity": "sha512-Z7zXVHEXg1elbbYiP/29pPwlJtLeXzjrj4241/kCcECds8Zg9fDfURWbZHRIKrEriAPS8wnVtdl4ZJBvZr325w==",
             "cpu": [
                 "arm64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-arm64-musl": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.29.1.tgz",
-            "integrity": "sha512-fOHRtF9gahwJk3QVp01a/GqS4hBEZCV1oKglVVq13kcK3NeVlS4BwIFzOHDbmKzt3i0OuHG4zfRP0YoG5OF/rA==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.29.2.tgz",
+            "integrity": "sha512-TF4kxkPq+SudS/r4zGPf0G08Bl7+NZcFrUSR3484WwsHgGgJyPQRLCNrQ/R5J6VzxfEeQR9XRpc8m2t7lD6SEQ==",
             "cpu": [
                 "arm64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-loongarch64-gnu": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.29.1.tgz",
-            "integrity": "sha512-5a7q3tnlbcg0OodyxcAdrrCxFi0DgXJSoOuidFUzHZ2GixZXQs6Tc3CHmlvqKAmOs5eRde+JJxeIf9DonkmYkw==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.29.2.tgz",
+            "integrity": "sha512-kO9Fv5zZuyj2zB2af4KA29QF6t7YSxKrY7sxZXfw8koDQj9bx5Tk5RjH+kWKFKok0wLGTi4bG117h31N+TIBEg==",
             "cpu": [
                 "loong64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-powerpc64le-gnu": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.29.1.tgz",
-            "integrity": "sha512-9b4Mg5Yfz6mRnlSPIdROcfw1BU22FQxmfjlp/CShWwO3LilKQuMISMTtAu/bxmmrE6A902W2cZJuzx8+gJ8e9w==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.29.2.tgz",
+            "integrity": "sha512-gIh776X7UCBaetVJGdjXPFurGsdWwHHinwRnC5JlLADU8Yk0EdS/Y+dMO264OjJFo7MXQ5PX4xVFbxrwK8zLqA==",
             "cpu": [
                 "ppc64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.29.1.tgz",
-            "integrity": "sha512-G5pn0NChlbRM8OJWpJFMX4/i8OEU538uiSv0P6roZcbpe/WfhEO+AT8SHVKfp8qhDQzaz7Q+1/ixMy7hBRidnQ==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.29.2.tgz",
+            "integrity": "sha512-YgikssQ5UNq1GoFKZydMEkhKbjlUq7G3h8j6yWXLBF24KyoA5BcMtaOUAXq5sydPmOPEqB6kCyJpyifSpCfQ0w==",
             "cpu": [
                 "riscv64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-s390x-gnu": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.29.1.tgz",
-            "integrity": "sha512-WM9lIkNdkhVwiArmLxFXpWndFGuOka4oJOZh8EP3Vb8q5lzdSCBuhjavJsw68Q9AKDGeOOIHYzYm4ZFvmWez5g==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.29.2.tgz",
+            "integrity": "sha512-9ouIR2vFWCyL0Z50dfnon5nOrpDdkTG9lNDs7MRaienQKlTyHcDxplmk3IbhFlutpifBSBr2H4rVILwmMLcaMA==",
             "cpu": [
                 "s390x"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-x64-gnu": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.29.1.tgz",
-            "integrity": "sha512-87xYCwb0cPGZFoGiErT1eDcssByaLX4fc0z2nRM6eMtV9njAfEE6OW3UniAoDhX4Iq5xQVpE6qO9aJbCFumKYQ==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.29.2.tgz",
+            "integrity": "sha512-ckBBNRN/F+NoSUDENDIJ2U9UWmIODgwDB/vEXCPOMcsco1niTkxTXa6D2Y/pvCnpzaidvY2qVxGzLilNs9BSzw==",
             "cpu": [
                 "x64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-linux-x64-musl": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.29.1.tgz",
-            "integrity": "sha512-xufkSNppNOdVRCEC4WKvlR1FBDyqCSCpQeMMgv9ZyXqqtKBfkw1yfGMTUTs9Qsl6WQbJnsGboWCp7pJGkeMhKA==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.29.2.tgz",
+            "integrity": "sha512-jycl1wL4AgM2aBFJFlpll/kGvAjhK8GSbEmFT5v3KC3rP/b5xZ1KQmv0vQQ8Bzb2ieFQ0kZFPRMbre/l3Bu9JA==",
             "cpu": [
                 "x64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-win32-arm64-msvc": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.29.1.tgz",
-            "integrity": "sha512-F2OiJ42m77lSkizZQLuC+jiZ2cgueWQL5YC9tjo3AgaEw+KJmVxHGSyQfDUoYR9cci0lAywv2Clmckzulcq6ig==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.29.2.tgz",
+            "integrity": "sha512-S2V0LlcOiYkNGlRAWZwwUdNgdZBfvsDHW0wYosYFV3c7aKgEVcbonetZXsHv7jRTTX+oY5nDYT4W6B1oUpMNOg==",
             "cpu": [
                 "arm64"
             ],
             ]
         },
         "node_modules/@rollup/rollup-win32-ia32-msvc": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.29.1.tgz",
-            "integrity": "sha512-rYRe5S0FcjlOBZQHgbTKNrqxCBUmgDJem/VQTCcTnA2KCabYSWQDrytOzX7avb79cAAweNmMUb/Zw18RNd4mng==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.29.2.tgz",
+            "integrity": "sha512-pW8kioj9H5f/UujdoX2atFlXNQ9aCfAxFRaa+mhczwcsusm6gGrSo4z0SLvqLF5LwFqFTjiLCCzGkNK/LE0utQ==",
             "cpu": [
                 "ia32"
             ],
             ]
         },
         "node_modules/@rollup/rollup-win32-x64-msvc": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.29.1.tgz",
-            "integrity": "sha512-+10CMg9vt1MoHj6x1pxyjPSMjHTIlqs8/tBztXvPAx24SKs9jwVnKqHJumlH/IzhaPUaj3T6T6wfZr8okdXaIg==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.29.2.tgz",
+            "integrity": "sha512-p6fTArexECPf6KnOHvJXRpAEq0ON1CBtzG/EY4zw08kCHk/kivBc5vUEtnCFNCHOpJZ2ne77fxwRLIKD4wuW2Q==",
             "cpu": [
                 "x64"
             ],
             }
         },
         "node_modules/fast-glob": {
-            "version": "3.3.2",
-            "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.2.tgz",
-            "integrity": "sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==",
+            "version": "3.3.3",
+            "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+            "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
                 "@nodelib/fs.walk": "^1.2.3",
                 "glob-parent": "^5.1.2",
                 "merge2": "^1.3.0",
-                "micromatch": "^4.0.4"
+                "micromatch": "^4.0.8"
             },
             "engines": {
                 "node": ">=8.6.0"
             }
         },
         "node_modules/rollup": {
-            "version": "4.29.1",
-            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.29.1.tgz",
-            "integrity": "sha512-RaJ45M/kmJUzSWDs1Nnd5DdV4eerC98idtUOVr6FfKcgxqvjwHmxc5upLF9qZU9EpsVzzhleFahrT3shLuJzIw==",
+            "version": "4.29.2",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.29.2.tgz",
+            "integrity": "sha512-tJXpsEkzsEzyAKIaB3qv3IuvTVcTN7qBw1jL4SPPXM3vzDrJgiLGFY6+HodgFaUHAJ2RYJ94zV5MKRJCoQzQeA==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
                 "npm": ">=8.0.0"
             },
             "optionalDependencies": {
-                "@rollup/rollup-android-arm-eabi": "4.29.1",
-                "@rollup/rollup-android-arm64": "4.29.1",
-                "@rollup/rollup-darwin-arm64": "4.29.1",
-                "@rollup/rollup-darwin-x64": "4.29.1",
-                "@rollup/rollup-freebsd-arm64": "4.29.1",
-                "@rollup/rollup-freebsd-x64": "4.29.1",
-                "@rollup/rollup-linux-arm-gnueabihf": "4.29.1",
-                "@rollup/rollup-linux-arm-musleabihf": "4.29.1",
-                "@rollup/rollup-linux-arm64-gnu": "4.29.1",
-                "@rollup/rollup-linux-arm64-musl": "4.29.1",
-                "@rollup/rollup-linux-loongarch64-gnu": "4.29.1",
-                "@rollup/rollup-linux-powerpc64le-gnu": "4.29.1",
-                "@rollup/rollup-linux-riscv64-gnu": "4.29.1",
-                "@rollup/rollup-linux-s390x-gnu": "4.29.1",
-                "@rollup/rollup-linux-x64-gnu": "4.29.1",
-                "@rollup/rollup-linux-x64-musl": "4.29.1",
-                "@rollup/rollup-win32-arm64-msvc": "4.29.1",
-                "@rollup/rollup-win32-ia32-msvc": "4.29.1",
-                "@rollup/rollup-win32-x64-msvc": "4.29.1",
+                "@rollup/rollup-android-arm-eabi": "4.29.2",
+                "@rollup/rollup-android-arm64": "4.29.2",
+                "@rollup/rollup-darwin-arm64": "4.29.2",
+                "@rollup/rollup-darwin-x64": "4.29.2",
+                "@rollup/rollup-freebsd-arm64": "4.29.2",
+                "@rollup/rollup-freebsd-x64": "4.29.2",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.29.2",
+                "@rollup/rollup-linux-arm-musleabihf": "4.29.2",
+                "@rollup/rollup-linux-arm64-gnu": "4.29.2",
+                "@rollup/rollup-linux-arm64-musl": "4.29.2",
+                "@rollup/rollup-linux-loongarch64-gnu": "4.29.2",
+                "@rollup/rollup-linux-powerpc64le-gnu": "4.29.2",
+                "@rollup/rollup-linux-riscv64-gnu": "4.29.2",
+                "@rollup/rollup-linux-s390x-gnu": "4.29.2",
+                "@rollup/rollup-linux-x64-gnu": "4.29.2",
+                "@rollup/rollup-linux-x64-musl": "4.29.2",
+                "@rollup/rollup-win32-arm64-msvc": "4.29.2",
+                "@rollup/rollup-win32-ia32-msvc": "4.29.2",
+                "@rollup/rollup-win32-x64-msvc": "4.29.2",
                 "fsevents": "~2.3.2"
             }
         },

routes/console.php

 <?php
 
+use App\Console\Commands\TriggerRecurringInvoiceGeneration;
 use App\Console\Commands\UpdateOverdueInvoices;
 use Illuminate\Support\Facades\Schedule;
 
 Schedule::command(UpdateOverdueInvoices::class)->everyFiveMinutes();
+Schedule::command(TriggerRecurringInvoiceGeneration::class, ['--queue'])->everyMinute();