ADD EV3-461 Mary-Ker API: items blokk, cikkszám nélküli tételt tartalmazó rendelések kizárása

- 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 <noreply@anthropic.com>
This commit is contained in:
E98Developer 2026-10-21 15:29:27 +02:00
parent 4d3be7d092
commit 5a320837a9
3 changed files with 248 additions and 15 deletions

View File

@ -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<int, int> 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
{

View File

@ -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<int, OrderArchive> $orders
* @return array<int, array<int, array<string, mixed>>> 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

View File

@ -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);