ADD EV3-461 maryker:delivery-addresses parancs a telephelyek és szállítási címek Excel-exportjához

Az Apolló-oldali szállítási alegység-azonosító egyeztetéséhez: profitcenterenként egy sor,
több szállítási címes telephelynél címenként egy sor (a multiAddress jelzőt követve, mint a
megrendelő felület), a Hooreyca azonosítóval, a nameId betűkóddal és a beszállítói vevőkóddal.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
E98Developer 2026-10-19 21:54:40 +02:00
parent 07481f75ce
commit 03cc551e40
2 changed files with 299 additions and 0 deletions

View File

@ -0,0 +1,182 @@
<?php
namespace App\Console\Commands;
use App\Models\ProfitCenter;
use App\Models\Supplier;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\DB;
use PhpOffice\PhpSpreadsheet\Cell\DataType;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Style\Alignment;
use PhpOffice\PhpSpreadsheet\Style\Fill;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
class MaryKerDeliveryAddressReport extends Command
{
protected $signature = 'maryker:delivery-addresses
{--supplier=MARY : a beszállító betűkódja (nameId)}
{--path= : a kimeneti xlsx útvonala}';
protected $description = 'Excelt készít a beszállító telephelyeiről és szállítási címeiről (EV3-461, szállítási alegység-azonosító egyeztetéséhez)';
public const TYPE_BASE = 'alap cím';
public const TYPE_DELIVERY = 'szállítási cím';
private const HEADERS = [
'Profitcenter ID', 'Név', 'Hooreyca azonosító', 'Betűkód (nameId)', 'Beszállítói vevőkód',
'Cím típusa', 'Cím', 'Cím azonosító', 'Cím megnevezése', 'Apolló-kód (kitöltendő)', 'Megjegyzés',
];
public function handle(): int
{
$supplier = Supplier::where('nameId', $this->option('supplier'))->first();
if (! $supplier) {
$this->error('Nincs ilyen betűkódú beszállító: ' . $this->option('supplier'));
return self::FAILURE;
}
$rows = $this->rows($supplier);
$path = $this->option('path') ?: storage_path(
'app/private/' . strtolower($supplier->nameId) . '_szallitasi_cimek_' . now()->format('Y-m-d') . '.xlsx'
);
if (! is_dir(dirname($path))) {
mkdir(dirname($path), 0775, true);
}
(new Xlsx($this->spreadsheet($supplier, $rows)))->save($path);
$profitCenters = count(array_unique(array_column($rows, 0)));
$deliveryRows = count(array_filter($rows, fn ($row) => $row[5] === self::TYPE_DELIVERY));
$warnings = count(array_filter($rows, fn ($row) => $row[10] !== ''));
$this->info('Elkészült: ' . $path);
$this->line(" {$profitCenters} profitcenter, " . count($rows) . " sor, ebből {$deliveryRows} szállítási cím");
if ($warnings > 0) {
$this->warn(" {$warnings} sorban van megjegyzés (adatrögzítési eltérés), nézd át.");
}
return self::SUCCESS;
}
/**
* Egy sor / profitcenter, vagy ha a profitcenter több szállítási címes, egy sor / cím.
* Ugyanazt a szabályt követi, mint a megrendelő felület (OrderController::createParameter):
* a "multiAddress" jelző dönt, nem a címrekordok száma.
*
* @return array<int, array<int, mixed>>
*/
public function rows(Supplier $supplier): array
{
$profitCenters = $supplier->profitCenter()
->with(['address' => fn ($query) => $query->orderBy('id'), 'supplierCustomerCodes'])
->orderBy('name')
->get();
$rows = [];
foreach ($profitCenters as $profitCenter) {
$head = [
$profitCenter->id,
$profitCenter->name,
(string) $profitCenter->hooreycaId,
(string) $profitCenter->nameId,
(string) $profitCenter->supplierCustomerCodes->firstWhere('supplier_id', $supplier->id)?->customerCode,
];
foreach ($this->addressRows($profitCenter) as $addressRow) {
$rows[] = array_merge($head, $addressRow);
}
}
return $rows;
}
/**
* @return array<int, array{0: string, 1: string, 2: string, 3: string, 4: string, 5: string}>
* [típus, cím, cím azonosító, cím megnevezése, Apolló-kód, megjegyzés]
*/
private function addressRows(ProfitCenter $profitCenter): array
{
$addresses = $profitCenter->address;
if ((bool) $profitCenter->multiAddress) {
if ($addresses->isEmpty()) {
return [[self::TYPE_DELIVERY, '', '', '', '', 'A több szállítási cím be van kapcsolva, de nincs szállítási cím rögzítve.']];
}
return $addresses->map(fn ($address) => [
self::TYPE_DELIVERY, $address->fullAddress, (string) $address->id, (string) $address->name, '', '',
])->all();
}
if ((bool) $profitCenter->addressEqual) {
$extra = $addresses->count();
return [[self::TYPE_BASE, $profitCenter->fullAddress, '', '', '', $extra > 0
? "A telephely címe az alap cím, de {$extra} további címrekord is van rögzítve - ezek a megrendelő felületen nem jelennek meg."
: '']];
}
$first = $addresses->first();
if (! $first) {
return [[self::TYPE_BASE, '', '', '', '', 'Az alap cím nem egyezik a telephely címével, de nincs címrekord rögzítve.']];
}
return [[self::TYPE_BASE, $first->fullAddress, (string) $first->id, (string) $first->name, '', $addresses->count() > 1
? 'Több címrekord van rögzítve, de a megrendelő felületen csak az első jelenik meg.'
: '']];
}
private function spreadsheet(Supplier $supplier, array $rows): Spreadsheet
{
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setTitle('Szállítási címek');
$sheet->setCellValue('A1', $supplier->name . ' - telephelyek és szállítási címek');
$sheet->getStyle('A1')->getFont()->setBold(true)->setSize(16);
$sheet->setCellValue('A2', 'EV3-461 · Adatforrás: ' . DB::connection()->getDatabaseName()
. ' adatbázis · Készült: ' . now()->format('Y-m-d H:i'));
$sheet->setCellValue('A3', 'Ahol a telephelynek több szállítási címe van, címenként egy sor szerepel. '
. 'A sárga "Apolló-kód" oszlopot a Multi.hu tölti ki a cím azonosítója mellé.');
$headerRow = 5;
foreach (self::HEADERS as $index => $text) {
$sheet->setCellValueByColumnAndRow($index + 1, $headerRow, $text);
}
$range = 'A' . $headerRow . ':K' . $headerRow;
$sheet->getStyle($range)->getFont()->setBold(true)->getColor()->setARGB('FFFFFFFF');
$sheet->getStyle($range)->getFill()->setFillType(Fill::FILL_SOLID)->getStartColor()->setARGB('FF44546A');
$sheet->getStyle($range)->getAlignment()->setWrapText(true)->setVertical(Alignment::VERTICAL_CENTER);
$row = $headerRow;
foreach ($rows as $values) {
$row++;
foreach ($values as $index => $value) {
// Szövegként írjuk (vevőkód, betűkód): az Excel ne vágja le a vezető nullákat.
$sheet->setCellValueExplicitByColumnAndRow(
$index + 1,
$row,
$value,
is_int($value) ? DataType::TYPE_NUMERIC : DataType::TYPE_STRING
);
}
}
if ($row > $headerRow) {
$sheet->getStyle('J' . ($headerRow + 1) . ':J' . $row)->getFill()
->setFillType(Fill::FILL_SOLID)->getStartColor()->setARGB('FFFFF2CC');
$sheet->getStyle('K' . ($headerRow + 1) . ':K' . $row)->getFont()->getColor()->setARGB('FF9C5700');
}
foreach (['A' => 12, 'B' => 38, 'C' => 18, 'D' => 16, 'E' => 18, 'F' => 15, 'G' => 44, 'H' => 14, 'I' => 30, 'J' => 22, 'K' => 60] as $column => $width) {
$sheet->getColumnDimension($column)->setWidth($width);
}
$sheet->freezePane('A' . ($headerRow + 1));
$sheet->setAutoFilter($range);
return $spreadsheet;
}
}

View File

@ -0,0 +1,117 @@
<?php
use App\Console\Commands\MaryKerDeliveryAddressReport;
use App\Models\Address;
use App\Models\ProfitCenter;
use App\Models\ProfitCenterSupplierCode;
use App\Models\Supplier;
use Illuminate\Foundation\Testing\RefreshDatabase;
use PhpOffice\PhpSpreadsheet\IOFactory;
use Tests\TestCase;
uses(TestCase::class, RefreshDatabase::class);
function reportProfitCenter(Supplier $supplier, array $attributes = []): ProfitCenter
{
$profitCenter = ProfitCenter::factory()->create(array_merge(['hooreycaId' => 'AKG', 'nameId' => 'AKGB'], $attributes));
$supplier->profitCenter()->attach($profitCenter->id);
return $profitCenter;
}
function reportAddress(ProfitCenter $profitCenter, string $name, string $street): Address
{
return Address::create([
'name' => $name, 'postCode' => '7623', 'city' => 'Pécs', 'street' => $street,
'attachable_id' => $profitCenter->id, 'attachable_type' => ProfitCenter::class,
]);
}
beforeEach(function () {
$this->supplier = Supplier::factory()->create(['nameId' => 'MARY']);
$this->command = app(MaryKerDeliveryAddressReport::class);
});
it('egyetlen alap sort ad a telephelynek, ha nincs több szállítási cím', function () {
$profitCenter = reportProfitCenter($this->supplier, ['multiAddress' => '0', 'addressEqual' => '1']);
$rows = $this->command->rows($this->supplier);
expect($rows)->toHaveCount(1)
->and($rows[0][0])->toBe($profitCenter->id)
->and($rows[0][2])->toBe('AKG')
->and($rows[0][3])->toBe('AKGB')
->and($rows[0][5])->toBe(MaryKerDeliveryAddressReport::TYPE_BASE)
->and($rows[0][6])->toBe($profitCenter->fullAddress)
->and($rows[0][7])->toBe('')
->and($rows[0][10])->toBe('');
});
it('szállítási címenként egy sort ad, a cím azonosítójával', function () {
$profitCenter = reportProfitCenter($this->supplier, ['multiAddress' => '1', 'addressEqual' => '0']);
$first = reportAddress($profitCenter, 'Kórház', 'Rákóczi út 2.');
$second = reportAddress($profitCenter, 'Kávézó', 'Ifjúság útja 13');
$rows = $this->command->rows($this->supplier);
expect($rows)->toHaveCount(2)
->and($rows[0][5])->toBe(MaryKerDeliveryAddressReport::TYPE_DELIVERY)
->and($rows[0][7])->toBe((string) $first->id)
->and($rows[0][8])->toBe('Kórház')
->and($rows[1][7])->toBe((string) $second->id)
->and($rows[1][8])->toBe('Kávézó');
});
it('a jelzőt követi, nem a címrekordok számát, és figyelmeztet az eltérésre', function () {
$profitCenter = reportProfitCenter($this->supplier, ['multiAddress' => '0', 'addressEqual' => '1']);
reportAddress($profitCenter, 'Maradvány', 'Régi utca 1.');
$rows = $this->command->rows($this->supplier);
expect($rows)->toHaveCount(1)
->and($rows[0][5])->toBe(MaryKerDeliveryAddressReport::TYPE_BASE)
->and($rows[0][10])->toContain('1 további címrekord');
});
it('jelzi, ha a több szállítási cím be van kapcsolva, de nincs cím rögzítve', function () {
reportProfitCenter($this->supplier, ['multiAddress' => '1']);
$rows = $this->command->rows($this->supplier);
expect($rows)->toHaveCount(1)->and($rows[0][10])->not->toBe('');
});
it('a beszállítói vevőkódot szövegként, a vezető nullákkal adja vissza', function () {
$profitCenter = reportProfitCenter($this->supplier, ['multiAddress' => '0', 'addressEqual' => '1']);
ProfitCenterSupplierCode::create([
'profit_center_id' => $profitCenter->id, 'supplier_id' => $this->supplier->id, 'customerCode' => '002934',
]);
expect($this->command->rows($this->supplier)[0][4])->toBe('002934');
});
it('csak az adott beszállító telephelyeit listázza', function () {
reportProfitCenter($this->supplier, ['multiAddress' => '0', 'addressEqual' => '1']);
ProfitCenter::factory()->create(['hooreycaId' => 'IDEGEN']);
expect($this->command->rows($this->supplier))->toHaveCount(1);
});
it('xlsx fájlt készít a megadott útvonalra', function () {
reportProfitCenter($this->supplier, ['multiAddress' => '0', 'addressEqual' => '1']);
$path = sys_get_temp_dir() . '/maryker_cimek_' . uniqid() . '.xlsx';
$this->artisan('maryker:delivery-addresses', ['--path' => $path])->assertSuccessful();
$sheet = IOFactory::load($path)->getActiveSheet();
expect($sheet->getCell('A5')->getValue())->toBe('Profitcenter ID')
->and($sheet->getCell('C6')->getValue())->toBe('AKG')
->and($sheet->getCell('D6')->getValue())->toBe('AKGB')
->and($sheet->getCell('F6')->getValue())->toBe(MaryKerDeliveryAddressReport::TYPE_BASE);
unlink($path);
});
it('hibával áll le, ha nincs ilyen betűkódú beszállító', function () {
$this->artisan('maryker:delivery-addresses', ['--supplier' => 'NINCS'])->assertFailed();
});