diff --git a/app/Http/Controllers/api/v1/MaryKerOrderController.php b/app/Http/Controllers/api/v1/MaryKerOrderController.php index 946a9b6..44baf4c 100644 --- a/app/Http/Controllers/api/v1/MaryKerOrderController.php +++ b/app/Http/Controllers/api/v1/MaryKerOrderController.php @@ -4,11 +4,10 @@ use App\Http\Controllers\Controller; use App\Models\OrderArchive; -use App\Models\OrderArchivesItem; use App\Services\MaryKerLogger; +use App\Services\MaryKerOrderEligibility; use App\Services\MaryKerOrderMapper; use Carbon\Carbon; -use Illuminate\Database\Eloquent\Builder; use Illuminate\Http\JsonResponse; use Illuminate\Http\Request; use Illuminate\Support\Facades\Validator; @@ -25,17 +24,20 @@ */ class MaryKerOrderController extends Controller { - public function __construct(private readonly MaryKerOrderMapper $mapper) {} + public function __construct( + private readonly MaryKerOrderMapper $mapper, + private readonly MaryKerOrderEligibility $eligibility, + ) {} /** * Feldolgozatlan rendelések (confirmed nem null, APIConfirmed null), régi elöl, lapozva. * - * Idempotens a találati halmaz szempontjából: a lista csak az APIConfirmed-től és a vevőkód meglététől függ, - * ezért ugyanazt adja, amíg a setProcessed meg nem történik. Az APICallBackId-t csak az első lekérésnél + * Idempotens a találati halmaz szempontjából: a lista csak az APIConfirmed-től és az adatok hiánytalanságától + * függ, ezért ugyanazt adja, amíg a setProcessed meg nem történik. Az APICallBackId-t csak az első lekérésnél * generálja, utána stabil. Az egyetlen mellékhatás az APILastGetting bélyeg. * - * Az a rendelés, amelynek telephelyéhez nincs beszállítói vevőkód, kimarad a listából (Apolló nem tudná - * párosítani), és hibaként bekerül a maryker naplóba, amíg a kódot rögzítik. + * Ami Apollónak hiányos (azonosító, vevőkód, cikkszám), az a rendelés kimarad a listából, és hibaként + * bekerül a maryker naplóba, amíg az adatot rögzítik (ld. MaryKerOrderEligibility). */ public function unProcessed(Request $request): JsonResponse { @@ -47,12 +49,8 @@ public function unProcessed(Request $request): JsonResponse return $this->forbidden($header); } - $this->logOrdersWithoutCustomerCode($supplierId); - $withoutProductNumber = $this->ordersWithoutProductNumber($supplierId); - - $page = $this->pending($supplierId) - ->whereExists($this->customerCode($supplierId)) - ->whereNotIn('id', $withoutProductNumber) + $page = OrderArchive::query() + ->whereIn('id', $this->eligibility->eligibleOrderIds($supplierId)) ->select([ 'id', 'humanId', 'confirmed', 'sumPrice', 'deliveryDate', 'note', 'profit_center_id', 'contactName', 'profit_center_name', 'deliveryAddressId', 'deliveryAddressName', 'deliveryAddress', @@ -131,78 +129,6 @@ public function setProcessed(Request $request): JsonResponse return responder()->success($result)->respond(null, $header); } - /** A beszállító megerősített, még nem visszaigazolt rendelései. */ - private function pending(int $supplierId): Builder - { - return OrderArchive::query() - ->where('supplier_id', $supplierId) - ->whereNotNull('confirmed') - ->whereNull('APIConfirmed'); - } - - /** Alkérdés: van-e a rendelés telephelyéhez rögzített, nem üres beszállítói vevőkód. */ - private function customerCode(int $supplierId): \Closure - { - return fn ($query) => $query->selectRaw('1') - ->from('profit_center_supplier_codes') - ->whereColumn('profit_center_supplier_codes.profit_center_id', 'order_archives.profit_center_id') - ->where('profit_center_supplier_codes.supplier_id', $supplierId) - ->whereNotNull('profit_center_supplier_codes.customerCode') - ->where('profit_center_supplier_codes.customerCode', '<>', '') - ->whereNull('profit_center_supplier_codes.deleted_at'); - } - - /** A vevőkód nélküli rendelések kimaradnak a listából: hibaként naplózzuk őket (rendelésenként óránként egyszer). */ - private function logOrdersWithoutCustomerCode(int $supplierId): void - { - $this->pending($supplierId) - ->whereNotExists($this->customerCode($supplierId)) - ->orderBy('id')->limit(500) - ->get(['id', 'humanId', 'profit_center_id']) - ->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], - )); - } - - /** - * Azok a (vevőkóddal rendelkező, feldolgozatlan) rendelések, amelyeknek van üres cikkszámú (supplierProductNumber) - * tétele. Az ilyen rendelés teljes egészében kimarad a listából: Apolló a tételt nem tudná párosítani, a tétel - * szó nélküli elhagyása pedig a fejléc összegével nem egyező rendelést adna. Hibaként naplózzuk (rendelésenként - * óránként egyszer), a hibás tétel azonosítóival. - * - * Egyetlen csoportos lekérdezés, nem korrelált alkérdés: az order_archives_items táblán nincs index az - * order_archive_id-n, ezért a rendelésenkénti keresés minden rendelésnél végigolvasná a táblát (backlog B-03). - * - * @return array a kizárt rendelések azonosítói - */ - private function ordersWithoutProductNumber(int $supplierId): array - { - $pendingIds = $this->pending($supplierId)->whereExists($this->customerCode($supplierId))->pluck('id'); - if ($pendingIds->isEmpty()) { - return []; - } - - $badItems = OrderArchivesItem::whereIn('order_archive_id', $pendingIds) - ->where(fn ($query) => $query->whereNull('supplierProductNumber')->orWhere('supplierProductNumber', '')) - ->get(['id', 'order_archive_id']) - ->groupBy('order_archive_id'); - - $humanIds = OrderArchive::whereIn('id', $badItems->keys())->pluck('humanId', 'id'); - foreach ($badItems as $orderId => $items) { - MaryKerLogger::once( - 'error', - "product-number:{$orderId}", - 'MaryKer: a rendelés kimarad az unprocessed listából, van olyan tétele, aminek nincs beszállítói cikkszáma', - ['orderId' => $orderId, 'humanId' => $humanIds[$orderId] ?? null, 'itemIds' => $items->pluck('id')->all()], - ); - } - - return $badItems->keys()->all(); - } - /** * Az üres APICallBackId-kat feltölti (versenyhelyzet-biztosan: csak null-t ír felül), majd visszaadja * az összes megadott rendelés azonosítóját id => uuid alakban. diff --git a/app/Services/MaryKerOrderEligibility.php b/app/Services/MaryKerOrderEligibility.php new file mode 100644 index 0000000..239bd62 --- /dev/null +++ b/app/Services/MaryKerOrderEligibility.php @@ -0,0 +1,124 @@ + 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 $orders + * @return Collection + */ + 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 $orders + * @return Collection + */ + 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 $orders + * @return Collection + */ + 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; + } +} diff --git a/config/maryker.php b/config/maryker.php index 558fe46..041b807 100644 --- a/config/maryker.php +++ b/config/maryker.php @@ -20,6 +20,9 @@ // Rendelés / oldal az unprocessed válaszban. 'per_page' => (int) env('MARYKER_API_PER_PAGE', 50), + // A rendelésazonosító (humanId) megengedett legnagyobb hossza: Anita (Multi.hu) szerint legfeljebb 25 karakter. + 'order_id_max_length' => (int) env('MARYKER_ORDER_ID_MAX_LENGTH', 25), + // Egy setProcessed kérésben visszaigazolható APICallBackId-k felső határa. 'set_processed_max' => (int) env('MARYKER_API_SET_PROCESSED_MAX', 500), diff --git a/tests/Feature/MaryKerApiTest.php b/tests/Feature/MaryKerApiTest.php index d11149b..8aa656a 100644 --- a/tests/Feature/MaryKerApiTest.php +++ b/tests/Feature/MaryKerApiTest.php @@ -507,6 +507,90 @@ function profitCenterBlock(): array }); }); +describe('rendelésazonosító hossza (1.5)', function () { + it('a pontosan 25 karakteres azonosító még kiadható, a 26 karakteres kimarad', function () { + $spy = maryKerLogSpy(); + maryKerUser($this->mary); + $ok = maryKerOrder($this->mary, ['humanId' => str_repeat('A', 25)]); + $tooLong = maryKerOrder($this->mary, ['humanId' => str_repeat('B', 26)]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk() + ->assertJsonCount(1, 'data') + ->assertJsonPath('pagination.total', 1) + ->assertJsonPath('data.0.orderId', $ok->humanId); + + $spy->shouldHaveReceived('error')->once()->withArgs( + fn ($message, $context) => str_contains($message, 'humanId') + && $context['orderId'] === $tooLong->id && $context['humanId'] === $tooLong->humanId + && $context['length'] === 26 && $context['max'] === 25 + ); + }); + + it('a hosszt karakterben számolja, nem bájtban (ékezetes betűk)', function () { + maryKerUser($this->mary); + $accented = maryKerOrder($this->mary, ['humanId' => str_repeat('é', 25)]); // 50 bájt, 25 karakter + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(1, 'data')->assertJsonPath('data.0.orderId', $accented->humanId); + }); + + it('az üres vagy hiányzó azonosítójú rendelés kimarad, és hibaként naplózódik', function (?string $humanId) { + $spy = maryKerLogSpy(); + maryKerUser($this->mary); + $order = maryKerOrder($this->mary, ['humanId' => $humanId]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(0, 'data')->assertJsonPath('pagination.total', 0); + + $spy->shouldHaveReceived('error')->once()->withArgs(fn ($message, $context) => $context['orderId'] === $order->id && $context['length'] === 0); + })->with(['üres szöveg' => [''], 'null' => [null]]); + + it('a korlát konfigurálható', function () { + config(['maryker.order_id_max_length' => 10]); + maryKerUser($this->mary); + maryKerOrder($this->mary, ['humanId' => 'MARY/AKG/26/0001']); // 16 karakter + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(0, 'data'); + }); + + it('a kimaradt rendelést nem érinti az APILastGetting és az APICallBackId, a javítás után megjelenik', function () { + maryKerUser($this->mary); + $order = maryKerOrder($this->mary, ['humanId' => str_repeat('C', 30)]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(0, 'data'); + expect($order->fresh()->APICallBackId)->toBeNull()->and($order->fresh()->APILastGetting)->toBeNull(); + + $order->update(['humanId' => 'MARY/AKG/26/0001']); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(1, 'data'); + }); + + it('több hiba esetén is csak egy hibát naplóz rendelésenként (az elsőt: azonosító, vevőkód, cikkszám sorrendben)', function () { + $spy = maryKerLogSpy(); + maryKerUser($this->mary); + $bare = ProfitCenter::factory()->create(['postCode' => '1111']); // vevőkód sincs + $order = maryKerOrder($this->mary, ['humanId' => str_repeat('D', 40), 'profit_center_id' => $bare->id]); + maryKerItem($order, ['supplierProductNumber' => null]); // cikkszám sincs + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(0, 'data'); + + $spy->shouldHaveReceived('error')->once(); + }); + + it('a másik beszállító túl hosszú azonosítójú rendelése nem zavarja a Mary-Ker listát', function () { + $spy = maryKerLogSpy(); + maryKerUser($this->mary); + maryKerOrder($this->mary); + maryKerOrder($this->other, ['humanId' => str_repeat('E', 40)]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(1, 'data'); + $spy->shouldNotHaveReceived('error'); + }); + + it('a valós formátum 25 karakter alatt marad (4 betűs beszállító + 6 betűs telephely + év + 4 jegyű sorszám)', function () { + // MARY/ABCDEF/26/0001 = 19 karakter: a spec 5. pontja szerinti legrosszabb valós eset + 6 karakter tartalék + expect(strlen('MARY/ABCDEF/26/0001'))->toBe(19)->toBeLessThanOrEqual(config('maryker.order_id_max_length')); + }); +}); + describe('vevőkód nélküli rendelések', function () { it('kimaradnak a listából és a lapozás összegéből, a vevőkódosak maradnak', function () { maryKerUser($this->mary);