d2d.emegrendeles.hu/app/Http/Controllers/api/v1/MaryKerOrderController.php
E98Developer 788f5ce2df ADD EV3-461 Mary-Ker API: rendelésazonosító hosszkorlát-védelem (1.5), kizárási szabályok külön szolgáltatásban
- a 25 karakternél hosszabb vagy üres humanId-jú rendelés kimarad az unprocessed listából, hibaként naplózva
- a korlát konfigurálható (maryker.order_id_max_length), a hosszt karakterben számolja
- a kizárási szabályok (azonosító, vevőkód, cikkszám) a MaryKerOrderEligibility szolgáltatásba kerültek:
  egy feldolgozatlan-lekérdezés és PHP-oldali szűrés a rendelésenkénti alkérdések helyett (nincs index, B-03)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 06:29:01 +02:00

165 lines
7.0 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\MaryKerOrderEligibility;
use App\Services\MaryKerOrderMapper;
use Carbon\Carbon;
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
{
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 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.
*
* 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
{
$updateDate = Carbon::now();
$header = $this->header($updateDate);
$supplierId = $request->user()?->supplier_id;
if (! $supplierId) {
return $this->forbidden($header);
}
$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',
])
->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);
$items = $this->mapper->itemBlocks($page->getCollection());
OrderArchive::query()->toBase()->whereIn('id', $ids)->update(['APILastGetting' => $updateDate]);
$page->setCollection($page->getCollection()->map(fn (OrderArchive $order) => [
'orderId' => $order->humanId,
'APICallBackId' => $callbackIds[$order->id],
'confirmedAt' => $order->confirmed,
'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', [
'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);
}
/**
* 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();
}
/** @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);
}
}