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:
parent
4d3be7d092
commit
5a320837a9
@ -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
|
||||
{
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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);
|
||||
|
||||
Loading…
Reference in New Issue
Block a user