d2d.emegrendeles.hu/app/Http/Controllers/api/v1/MaryKerOrderController.php
E98Developer 759c5f5b52 ADD EV3-461 Mary-Ker API: orderSum 4 tizedesjegy, profitCenter blokk, vevőkód nélküli rendelések kizárása, maryker napló
- orderSum legfeljebb 4 tizedesjegyre kerekítve (lebegőpontos zaj nélkül)
- profitCenter blokk: sellerProfitCenterId (vevőkód), név, cím és kontaktadatok a megrendelés pillanatképéből
- a pillanatkép-cím szerkezetét az élő rekord adja, ha egyezik; különben bontás + figyelmeztetés
- a vevőkód nélküli telephely rendelése kimarad az unprocessed listából, hibaként naplózva
- saját maryker naplócsatorna (MaryKerLogger), ismétlődő események óránként egyszer

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-21 14:28:57 +02:00

211 lines
9.2 KiB
PHP

<?php
namespace App\Http\Controllers\api\v1;
use App\Http\Controllers\Controller;
use App\Models\OrderArchive;
use App\Services\MaryKerLogger;
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;
use Illuminate\Support\Str;
/**
* Mary-Ker (Apolló) rendeléslekérő és visszaigazoló API (EV3-461).
*
* A Hooreyca-mintától (OrderController) szándékosan elkülönített: saját útvonal, saját token. A szűrés
* a token tulajdonosának supplier_id-jából jön, így a token más beszállító rendeléséhez nem fér hozzá.
*
* Az order_archives írásai szándékosan toBase()-en mennek: nincs modell-esemény, így nem íródik át
* az updated_by / updated_at az API-felhasználóra, és nincs mit kiszivárogtatni a válaszba.
*/
class MaryKerOrderController extends Controller
{
/** A válaszban szereplő számok tizedesjegyeinek maximuma. */
private const DECIMALS = 4;
public function __construct(private readonly MaryKerOrderMapper $mapper) {}
/**
* 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
* 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.
*/
public function unProcessed(Request $request): JsonResponse
{
$updateDate = Carbon::now();
$header = $this->header($updateDate);
$supplierId = $request->user()?->supplier_id;
if (! $supplierId) {
return $this->forbidden($header);
}
$this->logOrdersWithoutCustomerCode($supplierId);
$page = $this->pending($supplierId)
->whereExists($this->customerCode($supplierId))
->select([
'id', 'humanId', 'confirmed', 'sumPrice', 'deliveryDate', 'note', 'profit_center_id', 'contactName',
'profit_center_name', 'deliveryAddressId', 'deliveryAddressName', 'deliveryAddress',
])
->orderBy('id')
->paginate(max(1, (int) config('maryker.per_page')));
$ids = $page->getCollection()->pluck('id');
$callbackIds = $this->ensureCallbackIds($ids->all());
$profitCenters = $this->mapper->profitCenterBlocks($page->getCollection(), $supplierId);
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),
'orderDeliveryDate' => $order->deliveryDate,
'orderDescription' => (string) $order->note,
'profitCenter' => $profitCenters[$order->id],
]));
MaryKerLogger::channel()->info('MaryKer unprocessed', [
'userId' => $request->user()->id, 'page' => $page->currentPage(), 'orderIds' => $ids->all(),
]);
return responder()->success($page)->respond(null, $header);
}
/**
* Visszaigazolás: az APICallBackId-k alapján beállítja az APIConfirmed-et.
* Kötelezően nem üres tömb; egy elem csak akkor "updated", ha a token beszállítójáé, lekért és még
* nem visszaigazolt rendeléshez tartozik.
*/
public function setProcessed(Request $request): JsonResponse
{
$updateDate = Carbon::now();
$header = $this->header($updateDate);
$supplierId = $request->user()?->supplier_id;
if (! $supplierId) {
return $this->forbidden($header);
}
// A kliens nem biztos, hogy JSON Content-Type-ot küld (a Hooreyca sem teszi), ezért a nyers törzset olvassuk.
$body = json_decode($request->getContent(), true);
$validator = Validator::make(is_array($body) ? $body : [], [
'APICallBackId' => ['required', 'array', 'min:1', 'max:' . (int) config('maryker.set_processed_max')],
'APICallBackId.*' => ['required', 'string', 'max:36', 'distinct'],
]);
if (! is_array($body) || $validator->fails()) {
$message = is_array($body) ? $validator->errors()->first() : 'A kérés törzse nem érvényes JSON objektum.';
MaryKerLogger::channel()->warning('MaryKer setProcessed invalid data', ['userId' => $request->user()->id, 'message' => $message]);
return responder()->error('invalid data', $message)->respond(422, $header);
}
$result = [];
foreach ($body['APICallBackId'] as $callbackId) {
$updated = OrderArchive::query()->toBase()
->where('supplier_id', $supplierId)
->where('APICallBackId', $callbackId)
->whereNotNull('confirmed')
->whereNotNull('APILastGetting')
->whereNull('APIConfirmed')
->update(['APIConfirmed' => $updateDate]);
$result[$callbackId] = $updated ? 'updated' : 'invalid Id';
}
MaryKerLogger::channel()->info('MaryKer setProcessed', ['userId' => $request->user()->id, 'result' => $result]);
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],
));
}
/**
* 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.
*
* @param array<int, int> $orderIds
* @return array<int, string>
*/
private function ensureCallbackIds(array $orderIds): array
{
$missing = OrderArchive::query()->toBase()->whereIn('id', $orderIds)->whereNull('APICallBackId')->pluck('id');
foreach ($missing as $id) {
OrderArchive::query()->toBase()->where('id', $id)->whereNull('APICallBackId')
->update(['APICallBackId' => (string) Str::orderedUuid()]);
}
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
{
$header = parseAPIVersionFromNamespace(__NAMESPACE__);
$header['processedTime'] = $time->format('Y.m.d. H:i:s.u');
return $header;
}
private function forbidden(array $header): JsonResponse
{
return responder()->error('forbidden', 'A tokenhez nem tartozik beszállító.')->respond(403, $header);
}
}