From 5a320837a98dc7a6aa260cee136731dedb59043d Mon Sep 17 00:00:00 2001 From: E98Developer Date: Wed, 21 Oct 2026 15:29:27 +0200 Subject: [PATCH] =?UTF-8?q?ADD=20EV3-461=20Mary-Ker=20API:=20items=20blokk?= =?UTF-8?q?,=20cikksz=C3=A1m=20n=C3=A9lk=C3=BCli=20t=C3=A9telt=20tartalmaz?= =?UTF-8?q?=C3=B3=20rendel=C3=A9sek=20kiz=C3=A1r=C3=A1sa?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - items: sellerItemNumber, name, packMultiplier, packName (sellerUnit), producerName, orderNumber, price, sumPrice - sumPrice = quantity * unitMultiplier * price, legfeljebb 4 tizedesjegyre kerekítve - az üres cikkszámú tételt tartalmazó rendelés teljes egészében kimarad, hibaként naplózva (maryker csatorna) - a cikkszám-ellenőrzés egyetlen csoportos lekérdezés: az order_archives_items.order_archive_id nem indexelt - a tételösszegek és a fejléc összege közti centeltérés ismert (backlog B-11), a spec-képlet marad Co-Authored-By: Claude Sonnet 5.5 --- .../api/v1/MaryKerOrderController.php | 56 +++++-- app/Services/MaryKerOrderMapper.php | 57 +++++++ tests/Feature/MaryKerApiTest.php | 150 +++++++++++++++++- 3 files changed, 248 insertions(+), 15 deletions(-) diff --git a/app/Http/Controllers/api/v1/MaryKerOrderController.php b/app/Http/Controllers/api/v1/MaryKerOrderController.php index 306ee8e..946a9b6 100644 --- a/app/Http/Controllers/api/v1/MaryKerOrderController.php +++ b/app/Http/Controllers/api/v1/MaryKerOrderController.php @@ -4,6 +4,7 @@ use App\Http\Controllers\Controller; use App\Models\OrderArchive; +use App\Models\OrderArchivesItem; use App\Services\MaryKerLogger; use App\Services\MaryKerOrderMapper; use Carbon\Carbon; @@ -24,9 +25,6 @@ */ class MaryKerOrderController extends Controller { - /** A válaszban szereplő számok tizedesjegyeinek maximuma. */ - private const DECIMALS = 4; - public function __construct(private readonly MaryKerOrderMapper $mapper) {} /** @@ -50,9 +48,11 @@ public function unProcessed(Request $request): JsonResponse } $this->logOrdersWithoutCustomerCode($supplierId); + $withoutProductNumber = $this->ordersWithoutProductNumber($supplierId); $page = $this->pending($supplierId) ->whereExists($this->customerCode($supplierId)) + ->whereNotIn('id', $withoutProductNumber) ->select([ 'id', 'humanId', 'confirmed', 'sumPrice', 'deliveryDate', 'note', 'profit_center_id', 'contactName', 'profit_center_name', 'deliveryAddressId', 'deliveryAddressName', 'deliveryAddress', @@ -63,18 +63,19 @@ public function unProcessed(Request $request): JsonResponse $ids = $page->getCollection()->pluck('id'); $callbackIds = $this->ensureCallbackIds($ids->all()); $profitCenters = $this->mapper->profitCenterBlocks($page->getCollection(), $supplierId); + $items = $this->mapper->itemBlocks($page->getCollection()); OrderArchive::query()->toBase()->whereIn('id', $ids)->update(['APILastGetting' => $updateDate]); - // TODO 1.2: items (sellerItemNumber, packMultiplier, packName, price, sumPrice ...) $page->setCollection($page->getCollection()->map(fn (OrderArchive $order) => [ 'orderId' => $order->humanId, 'APICallBackId' => $callbackIds[$order->id], 'confirmedAt' => $order->confirmed, - 'orderSum' => $this->number($order->sumPrice), + 'orderSum' => $this->mapper->number($order->sumPrice), 'orderDeliveryDate' => $order->deliveryDate, 'orderDescription' => (string) $order->note, 'profitCenter' => $profitCenters[$order->id], + 'items' => $items[$order->id], ])); MaryKerLogger::channel()->info('MaryKer unprocessed', [ @@ -166,6 +167,42 @@ private function logOrdersWithoutCustomerCode(int $supplierId): void )); } + /** + * 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. @@ -185,15 +222,6 @@ private function ensureCallbackIds(array $orderIds): array return OrderArchive::query()->toBase()->whereIn('id', $orderIds)->pluck('APICallBackId', 'id')->all(); } - /** - * Pénzösszeg / mennyiség a partnerrel egyeztetett formátumban: legfeljebb 4 tizedesjegy (specifikáció 2. pont). - * A tárolt double lebegőpontos zajt hordoz (pl. 258817.12149533), ezért kerekítjük. - */ - private function number(float|int|string|null $value): ?float - { - return $value === null ? null : round((float) $value, self::DECIMALS); - } - /** @return array{apiVersion: string, processedTime: string} */ private function header(Carbon $time): array { diff --git a/app/Services/MaryKerOrderMapper.php b/app/Services/MaryKerOrderMapper.php index 2b63315..ffbbf41 100644 --- a/app/Services/MaryKerOrderMapper.php +++ b/app/Services/MaryKerOrderMapper.php @@ -4,6 +4,7 @@ use App\Models\Address; use App\Models\OrderArchive; +use App\Models\OrderArchivesItem; use App\Models\ProfitCenter; use App\Models\ProfitCenterSupplierCode; use Illuminate\Support\Collection; @@ -13,6 +14,9 @@ */ class MaryKerOrderMapper { + /** A válaszban szereplő számok tizedesjegyeinek maximuma. */ + private const DECIMALS = 4; + /** * A "profitCenter" blokk rendelésenként. A cím a megrendeléskor rögzített pillanatkép * (order_archives.deliveryAddress / deliveryAddressName), nem az élő törzsadat. @@ -69,6 +73,59 @@ public function profitCenterBlocks(Collection $orders, int $supplierId): array return $blocks; } + /** + * Az "items" blokk rendelésenként (specifikáció 3.3 pont). + * + * A sumPrice a specifikáció szerint számított: quantity * unitMultiplier * price. Figyelem: az order_archives_items + * price oszlopa double(8,2), ezért ahol a megrendeléskori egységár több tizedesjegyű volt, a tételösszegek + * a fejléc összegétől (order_archives.sumPrice) centekkel eltérhetnek (backlog B-11). + * + * @param Collection $orders + * @return array>> rendelés id => tételek + */ + public function itemBlocks(Collection $orders): array + { + $items = OrderArchivesItem::whereIn('order_archive_id', $orders->pluck('id')) + ->orderBy('id') + ->get(['id', 'order_archive_id', 'name', 'supplierProductNumber', 'unitMultiplier', 'sellerUnit', 'producer_name', 'quantity', 'price']) + ->groupBy('order_archive_id'); + + $blocks = []; + foreach ($orders as $order) { + $blocks[$order->id] = $items->get($order->id, collect())->map(fn (OrderArchivesItem $item) => [ + // string marad, a vezető nullák megmaradnak + 'sellerItemNumber' => (string) $item->supplierProductNumber, + 'name' => (string) $item->name, + 'packMultiplier' => $this->number($item->unitMultiplier), + 'packName' => (string) $item->sellerUnit, + 'producerName' => (string) $item->producer_name, + 'orderNumber' => $this->number($item->quantity), + 'price' => $this->number($item->price), + 'sumPrice' => $this->itemSum($item), + ])->values()->all(); + } + + return $blocks; + } + + /** + * Pénzösszeg / mennyiség a partnerrel egyeztetett formátumban: legfeljebb 4 tizedesjegy (specifikáció 2. pont). + * A tárolt double lebegőpontos zajt hordoz (pl. 258817.12149533), ezért kerekítjük. + */ + public function number(float|int|string|null $value): ?float + { + return $value === null ? null : round((float) $value, self::DECIMALS); + } + + private function itemSum(OrderArchivesItem $item): ?float + { + if ($item->quantity === null || $item->unitMultiplier === null || $item->price === null) { + return null; + } + + return $this->number($item->quantity * $item->unitMultiplier * $item->price); + } + /** * IDEIGLENES (EV3-461, 2. szakasz előtt): több szállítási címes telephelynél, ha a rendelésen van kiválasztott cím, * a vevőkód után "_{Address.id}" kerül; egyébként a sima vevőkód. A több címes jelzőt a megrendelő felülethez diff --git a/tests/Feature/MaryKerApiTest.php b/tests/Feature/MaryKerApiTest.php index dabdd21..d11149b 100644 --- a/tests/Feature/MaryKerApiTest.php +++ b/tests/Feature/MaryKerApiTest.php @@ -2,6 +2,7 @@ use App\Models\Address; use App\Models\OrderArchive; +use App\Models\OrderArchivesItem; use App\Models\ProfitCenter; use App\Models\ProfitCenterSupplierCode; use App\Models\Supplier; @@ -43,6 +44,21 @@ function maryKerOrder(Supplier $supplier, array $attributes = []): OrderArchive ], $attributes)); } +function maryKerItem(OrderArchive $order, array $attributes = []): OrderArchivesItem +{ + return OrderArchivesItem::create(array_merge([ + 'order_archive_id' => $order->id, + 'name' => 'Só jódozott vákuum 1kg', + 'supplierProductNumber' => '013500425', + 'unitMultiplier' => 12, + 'sellerUnit' => 'kart', + 'amountUnit' => 'db', + 'producer_name' => 'Hadászi Kft', + 'quantity' => 2, + 'price' => 172, + ], $attributes)); +} + function maryKerLogSpy(): Mockery\MockInterface { $spy = Log::spy(); @@ -173,7 +189,7 @@ function maryKerLogSpy(): Mockery\MockInterface $response = $this->getJson(MARYKER_UNPROCESSED)->assertOk(); expect(array_keys($response->json('data.0'))) - ->toBe(['orderId', 'APICallBackId', 'confirmedAt', 'orderSum', 'orderDeliveryDate', 'orderDescription', 'profitCenter']) + ->toBe(['orderId', 'APICallBackId', 'confirmedAt', 'orderSum', 'orderDeliveryDate', 'orderDescription', 'profitCenter', 'items']) ->and($response->getContent())->not->toContain('updated_by')->not->toContain('updated_at'); $fresh = $order->fresh(); @@ -359,6 +375,138 @@ function profitCenterBlock(): array }); }); +describe('items', function () { + it('a tételek mezőit a specifikáció szerint adja', function () { + maryKerUser($this->mary); + $order = maryKerOrder($this->mary); + maryKerItem($order); + + $items = $this->getJson(MARYKER_UNPROCESSED)->assertOk()->json('data.0.items'); + + // JSON-ban az egész érték .0 nélkül jelenik meg (12, 4128), ami a kliensnek ugyanaz a szám + expect($items)->toHaveCount(1)->and($items[0])->toEqual([ + 'sellerItemNumber' => '013500425', + 'name' => 'Só jódozott vákuum 1kg', + 'packMultiplier' => 12.0, + 'packName' => 'kart', + 'producerName' => 'Hadászi Kft', + 'orderNumber' => 2.0, + 'price' => 172.0, + 'sumPrice' => 4128.0, + ]); + }); + + it('a cikkszám string marad, a vezető nullákkal', function () { + maryKerUser($this->mary); + maryKerItem(maryKerOrder($this->mary), ['supplierProductNumber' => '016700060']); + + $response = $this->getJson(MARYKER_UNPROCESSED)->assertOk(); + + expect($response->getContent())->toContain('"sellerItemNumber":"016700060"') + ->and($response->json('data.0.items.0.sellerItemNumber'))->toBeString(); + }); + + it('a packName az eladói egységből (sellerUnit) jön, nem az amountUnit-ból', function () { + maryKerUser($this->mary); + maryKerItem(maryKerOrder($this->mary), ['sellerUnit' => 'zsák', 'amountUnit' => 'kg']); + + expect($this->getJson(MARYKER_UNPROCESSED)->json('data.0.items.0.packName'))->toBe('zsák'); + }); + + it('a sumPrice a mennyiség * egységszorzó * ár, legfeljebb 4 tizedesjegyre kerekítve', function (array $item, float $expected) { + maryKerUser($this->mary); + maryKerItem(maryKerOrder($this->mary), $item); + + expect($this->getJson(MARYKER_UNPROCESSED)->json('data.0.items.0.sumPrice'))->toEqual($expected); + })->with([ + 'egész szorzat' => [['quantity' => 10, 'unitMultiplier' => 42, 'price' => 308], 129360.0], + 'tizedes ár (a valós d2d tétel)' => [['quantity' => 1, 'unitMultiplier' => 5, 'price' => 811.42], 4057.1], + 'tizedes egységszorzó' => [['quantity' => 3, 'unitMultiplier' => 0.35, 'price' => 100.5], 105.525], + 'lebegőpontos zaj nélkül' => [['quantity' => 0.1, 'unitMultiplier' => 3, 'price' => 0.1], 0.03], + 'nulla mennyiség' => [['quantity' => 0, 'unitMultiplier' => 12, 'price' => 172], 0.0], + ]); + + it('hiányzó mennyiségnél, egységszorzónál vagy árnál az összeg null, nem nulla', function (string $missing) { + maryKerUser($this->mary); + maryKerItem(maryKerOrder($this->mary), [$missing => null]); + + expect($this->getJson(MARYKER_UNPROCESSED)->assertOk()->json('data.0.items.0.sumPrice'))->toBeNull(); + })->with(['quantity', 'unitMultiplier', 'price']); + + it('csak a saját rendelés tételeit adja, azonosító szerint rendezve', function () { + maryKerUser($this->mary); + $first = maryKerOrder($this->mary); + $second = maryKerOrder($this->mary); + maryKerItem($second, ['name' => 'második rendelés tétele']); + maryKerItem($first, ['name' => 'A']); + maryKerItem($first, ['name' => 'B']); + + $data = $this->getJson(MARYKER_UNPROCESSED)->assertOk()->json('data'); + + expect(array_column($data[0]['items'], 'name'))->toBe(['A', 'B']) + ->and(array_column($data[1]['items'], 'name'))->toBe(['második rendelés tétele']); + }); + + it('a tétel nélküli rendelés üres items tömböt kap', function () { + maryKerUser($this->mary); + maryKerOrder($this->mary); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonPath('data.0.items', []); + }); + + it('az üres vagy hiányzó cikkszámú tételt tartalmazó rendelés teljes egészében kimarad, és hibaként naplózódik', function (?string $productNumber) { + $spy = maryKerLogSpy(); + maryKerUser($this->mary); + $good = maryKerOrder($this->mary); + maryKerItem($good); + $bad = maryKerOrder($this->mary); + maryKerItem($bad); + $badItem = maryKerItem($bad, ['supplierProductNumber' => $productNumber]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk() + ->assertJsonCount(1, 'data') + ->assertJsonPath('pagination.total', 1) + ->assertJsonPath('data.0.orderId', $good->humanId); + + $spy->shouldHaveReceived('error')->once()->withArgs( + fn ($message, $context) => str_contains($message, 'cikkszám') + && $context['orderId'] === $bad->id && $context['humanId'] === $bad->humanId && $context['itemIds'] === [$badItem->id] + ); + })->with(['üres szöveg' => [''], 'null' => [null]]); + + it('a cikkszám nélküli rendelést nem érinti az APILastGetting és az APICallBackId', function () { + maryKerUser($this->mary); + $bad = maryKerOrder($this->mary); + maryKerItem($bad, ['supplierProductNumber' => null]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk(); + + expect($bad->fresh()->APICallBackId)->toBeNull()->and($bad->fresh()->APILastGetting)->toBeNull(); + }); + + it('a cikkszám pótlása után a rendelés megjelenik', function () { + maryKerUser($this->mary); + $order = maryKerOrder($this->mary); + $item = maryKerItem($order, ['supplierProductNumber' => null]); + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(0, 'data'); + + $item->update(['supplierProductNumber' => '0042']); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk() + ->assertJsonCount(1, 'data') + ->assertJsonPath('data.0.items.0.sellerItemNumber', '0042'); + }); + + it('a másik beszállító cikkszám nélküli rendelése nem zavarja a Mary-Ker listát', function () { + maryKerUser($this->mary); + $own = maryKerOrder($this->mary); + maryKerItem($own); + maryKerItem(maryKerOrder($this->other), ['supplierProductNumber' => null]); + + $this->getJson(MARYKER_UNPROCESSED)->assertOk()->assertJsonCount(1, 'data'); + }); +}); + 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);