d2d.emegrendeles.hu/app/Services/MaryKerOrderEligibility.php
E98Developer 788f5ce2df ADD EV3-461 Mary-Ker API: rendelésazonosító hosszkorlát-védelem (1.5), kizárási szabályok külön szolgáltatásban
- a 25 karakternél hosszabb vagy üres humanId-jú rendelés kimarad az unprocessed listából, hibaként naplózva
- a korlát konfigurálható (maryker.order_id_max_length), a hosszt karakterben számolja
- a kizárási szabályok (azonosító, vevőkód, cikkszám) a MaryKerOrderEligibility szolgáltatásba kerültek:
  egy feldolgozatlan-lekérdezés és PHP-oldali szűrés a rendelésenkénti alkérdések helyett (nincs index, B-03)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 06:29:01 +02:00

125 lines
5.2 KiB
PHP

<?php
namespace App\Services;
use App\Models\OrderArchive;
use App\Models\OrderArchivesItem;
use App\Models\ProfitCenterSupplierCode;
use Illuminate\Support\Collection;
/**
* Eldönti, hogy a beszállító feldolgozatlan rendelései közül melyek adhatók ki a Mary-Ker API-n (EV3-461).
*
* Egy rendelés kimarad, ha Apolló nem tudná helyesen feldolgozni:
* 1. a rendelésazonosítója (humanId) üres, vagy hosszabb a megengedettnél (specifikáció 5. pont);
* 2. a telephelyéhez nincs beszállítói vevőkód (specifikáció 3.2 pont);
* 3. van olyan tétele, aminek nincs beszállítói cikkszáma (specifikáció 3.3 pont): a tétel szó nélküli elhagyása
* a fejléc összegével nem egyező rendelést adna.
*
* A kimaradást hibaként naplózzuk a maryker csatornán (rendelésenként óránként egyszer, ld. MaryKerLogger::once),
* és csak az első találó okot: ha a hiba megszűnik, a rendelés a következő lekéréskor megjelenik.
*
* Szándékosan egyetlen "feldolgozatlan" lekérdezés és PHP-oldali szűrés, nem rendelésenkénti alkérdések: az
* order_archives és az order_archives_items táblán nincs index (backlog B-03), így minden korrelált alkérdés
* végigolvasná a több százezer / milliós táblát.
*/
class MaryKerOrderEligibility
{
/** Egy lekérésnél legfeljebb ennyi kihagyott rendelést naplózunk kategóriánként. */
private const MAX_LOGGED = 500;
/**
* @return array<int, int> a kiadható rendelések azonosítói, növekvő sorrendben
*/
public function eligibleOrderIds(int $supplierId): array
{
$pending = OrderArchive::query()
->where('supplier_id', $supplierId)
->whereNotNull('confirmed')
->whereNull('APIConfirmed')
->orderBy('id')
->get(['id', 'humanId', 'profit_center_id']);
$pending = $this->withValidOrderId($pending);
$pending = $this->withCustomerCode($pending, $supplierId);
$pending = $this->withProductNumbers($pending);
return $pending->pluck('id')->all();
}
/**
* @param Collection<int, OrderArchive> $orders
* @return Collection<int, OrderArchive>
*/
private function withValidOrderId(Collection $orders): Collection
{
$max = (int) config('maryker.order_id_max_length');
[$valid, $invalid] = $orders->partition(
fn (OrderArchive $order) => $order->humanId !== null && $order->humanId !== '' && mb_strlen($order->humanId) <= $max
);
$invalid->take(self::MAX_LOGGED)->each(fn (OrderArchive $order) => MaryKerLogger::once(
'error',
"order-id:{$order->id}",
'MaryKer: a rendelés kimarad az unprocessed listából, a rendelésazonosító (humanId) üres vagy hosszabb a megengedettnél',
['orderId' => $order->id, 'humanId' => $order->humanId, 'length' => mb_strlen((string) $order->humanId), 'max' => $max],
));
return $valid;
}
/**
* @param Collection<int, OrderArchive> $orders
* @return Collection<int, OrderArchive>
*/
private function withCustomerCode(Collection $orders, int $supplierId): Collection
{
if ($orders->isEmpty()) {
return $orders;
}
$withCode = ProfitCenterSupplierCode::where('supplier_id', $supplierId)
->whereIn('profit_center_id', $orders->pluck('profit_center_id')->filter()->unique())
->whereNotNull('customerCode')->where('customerCode', '<>', '')
->pluck('profit_center_id')->flip();
[$valid, $missing] = $orders->partition(fn (OrderArchive $order) => $withCode->has($order->profit_center_id));
$missing->take(self::MAX_LOGGED)->each(fn (OrderArchive $order) => MaryKerLogger::once(
'error',
"customer-code:{$order->id}",
'MaryKer: a rendelés kimarad az unprocessed listából, a telephelyhez nincs beszállítói vevőkód',
['orderId' => $order->id, 'humanId' => $order->humanId, 'profitCenterId' => $order->profit_center_id],
));
return $valid;
}
/**
* @param Collection<int, OrderArchive> $orders
* @return Collection<int, OrderArchive>
*/
private function withProductNumbers(Collection $orders): Collection
{
if ($orders->isEmpty()) {
return $orders;
}
$badItems = OrderArchivesItem::whereIn('order_archive_id', $orders->pluck('id'))
->where(fn ($query) => $query->whereNull('supplierProductNumber')->orWhere('supplierProductNumber', ''))
->get(['id', 'order_archive_id'])
->groupBy('order_archive_id');
[$valid, $invalid] = $orders->partition(fn (OrderArchive $order) => ! $badItems->has($order->id));
$invalid->take(self::MAX_LOGGED)->each(fn (OrderArchive $order) => MaryKerLogger::once(
'error',
"product-number:{$order->id}",
'MaryKer: a rendelés kimarad az unprocessed listából, van olyan tétele, aminek nincs beszállítói cikkszáma',
['orderId' => $order->id, 'humanId' => $order->humanId, 'itemIds' => $badItems[$order->id]->pluck('id')->all()],
));
return $valid;
}
}