d2d.emegrendeles.hu/app/Services/WorkCalendarService.php
E98Developer d26ba5e5e6 FIX EV3-466 hétvégi szállítási napok engedélyezése a heti sablonból
A DeliveryCalendarService 4. prioritása a WorkCalendarService::isWorkDay()-t
hívta, ami a naptárban nem szereplő napoknál a hétvégére esett vissza. Így egy
hétvégét is tartalmazó sablon szombat/vasárnap mezőit sosem érte el a
kiértékelés (5. prioritás), és csak egyedi felülbírálással lehetett hétvégi
szállítást engedni.

- WorkCalendarService: új isHoliday(), ami csak a work_calendars ünnepnap
  rekordjaira ad true-t, a naptári hétvégére nem. Az isWorkDay() változatlan.
- DeliveryCalendarService: a 4. prioritás mostantól isHoliday()-t használ, így
  a hétvégéről a heti sablon dönt. Ünnepnap továbbra is tilt.
- NextDeliveryDateCalculatorService: a szállítási nap keresése kikerült az
  isWorkDay() blokkból, különben a hétvége a következő szállítási nap
  számításánál továbbra is kimaradt volna. Az átfutási időbe az új
  countsTowardLeadTime() szerint a sablon hétvégi napjai is beleszámítanak,
  a H-P sablonok viselkedése változatlan.
- DeliveryCalendarWidget: a szürke "inaktív" festés csak a nem szállítási
  hétvégékre megy rá. Mellékesen a szállítási napok ciklusa $date->addDay()-jel
  mutálta a kollekció Carbon objektumait, ez copy()-ra javítva.

7 új teszt, köztük a H-P sablon regresszió-őre.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-24 15:59:59 +02:00

152 lines
4.7 KiB
PHP

<?php
namespace App\Services;
use App\Enums\DataSource;
use App\Enums\WorkDayType;
use App\Models\WorkCalendar;
use Illuminate\Support\Carbon;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;
class WorkCalendarService extends ServiceBase
{
/**
* Szinkronizálja a munkaszüneti napokat a szunetnapok.hu API-ból.
*/
public function syncFromApi(?int $year = null): bool
{
$year ??= now()->year;
$config = config('services.szunetnapok');
$apiKey = $config['key'] ?? null;
$apiUrl = rtrim($config['url'] ?? 'https://szunetnapok.hu/api/', '/');
$verify = $config['verify'] ?? true;
Log::channel('work_calendar')->info('WorkCalendar sync started.', [
'year' => $year,
'api_url' => $apiUrl,
'has_api_key' => !empty($apiKey),
'ssl_verify' => $verify,
]);
if (empty($apiKey)) {
$this->error->add('api', 'Hiányzó szunetnapok.hu API kulcs.');
Log::channel('work_calendar')->error('WorkCalendar sync failed: Missing API key.');
return false;
}
try {
$response = Http::withOptions(['verify' => $verify])
->get("{$apiUrl}/{$apiKey}/{$year}/json");
Log::channel('work_calendar')->info('WorkCalendar API response.', [
'status' => $response->status(),
'body' => $response->body(),
]);
if ($response->failed()) {
$this->error->add('api', 'Nem sikerült elérni a szunetnapok.hu API-t.');
return false;
}
} catch (\Exception $e) {
$this->error->add('api', 'Hálózati hiba az API hívás közben: ' . $e->getMessage());
Log::channel('work_calendar')->error('WorkCalendar sync API error (cURL/SSL):', [
'message' => $e->getMessage(),
'exception' => get_class($e),
]);
return false;
}
$data = $response->json();
if (($data['response'] ?? '') !== 'OK') {
$this->error->add('api', $data['message'] ?? 'Hibás válasz az API-tól.');
return false;
}
if (!isset($data['days']) || !is_array($data['days'])) {
Log::channel('work_calendar')->info('WorkCalendar sync: No days to process.');
return true;
}
$savedRecords = [];
foreach ($data['days'] as $day) {
$type = ($day['type'] == 1) ? WorkDayType::Holiday : WorkDayType::WorkingDay;
$record = WorkCalendar::updateOrCreate(
['date' => $day['date']],
[
'type' => $type,
'description' => $day['name'] ?? '',
'data_source' => DataSource::Api,
]
);
$savedRecords[] = $record->toArray();
}
Log::channel('work_calendar')->info('WorkCalendar sync completed.', [
'count' => count($savedRecords),
'records' => $savedRecords,
]);
return true;
}
/**
* Megállapítja, hogy az adott nap munkanap-e.
*/
public function isWorkDay(Carbon $date): bool
{
$record = WorkCalendar::where('date', $date->toDateString())->first();
if ($record) {
return $record->type === WorkDayType::WorkingDay;
}
// Ha nincs az adatbázisban, a hétvégék alapján döntünk
return !$date->isWeekend();
}
/**
* Megállapítja, hogy az adott nap hivatalos munkaszüneti nap-e.
*
* Az isWorkDay()-jel ellentétben a puszta naptári hétvégét NEM tekinti annak:
* csak a work_calendars táblában ünnepnapként rögzített dátumra ad true-t.
* A szállítási naptár ezt használja, hogy a heti sablon engedhessen hétvégi
* szállítást is (EV3-466).
*/
public function isHoliday(Carbon $date): bool
{
$record = WorkCalendar::where('date', $date->toDateString())->first();
return $record?->type === WorkDayType::Holiday;
}
/**
* Kiszámítja a következő érvényes munkanapot.
*/
public function getNextWorkDay(Carbon $date): Carbon
{
$nextDay = $date->copy()->addDay();
while (!$this->isWorkDay($nextDay)) {
$nextDay->addDay();
}
return $nextDay;
}
/**
* Visszaadja a megadott időszak munkaszüneti napjait és plusz munkanapjait.
*/
public function getCalendarEntries(Carbon $start, Carbon $end): Collection
{
return WorkCalendar::whereBetween('date', [$start->toDateString(), $end->toDateString()])
->orderBy('date')
->get();
}
}