ADD EV3-473 gyártó-összevonás felületről ütközés feloldásához

Valódi tesztelés közben előkerült eset (két aktív gyártó, pl. "Szarvas" és
"Szarvasi"): az alias-felvétel eddig csak elutasította az ütközést, de nem
adott módot a tényleges összevonásra a felületről - csak a
producers:dedupe-report -> Excel -> producers:dedupe --apply láncon
keresztül, fejlesztői hozzáféréssel.

Új "Gyártó összevonása" gomb a megtekintő oldalon: a nézett gyártó marad a
keeper, a kiválasztott aktív gyártó beolvad, a neve automatikusan aliasként
kerül fel. A ProducerDeduplicator::apply() egyetlen kézzel épített
merge-bejegyzéssel hívva, Excel nélkül. A jelentés fájlba írása kiemelve a
CLI parancsból, hogy a felületi összevonás is CLI-vel visszagörgethető
maradjon.

Az alias-ütközés hibaüzenete (ha aktív gyártóval ütközik) mostantól a
dedikált ActiveProducerNameCollisionException-on át utal az összevonás
gombra.

Mellékesen javítva: a jelentés-fájlnév másodperc pontosságú volt, ami egy
másodpercen belüli két összevonásnál csendben felülírta volna az előzőt
(mikroszekundumra pontosítva), és az Aliasok relation manager nem frissült
a más komponensről történő összevonás után (5s poll, ugyanaz a minta, mint
a LinesRelationManager-en).
This commit is contained in:
E98Developer 2026-09-19 07:19:12 +02:00
parent 0cbc8c2f58
commit bd41dabc5a
8 changed files with 258 additions and 14 deletions

View File

@ -219,18 +219,7 @@ private function summarize(array $merges): void
private function writeReport(array $report): string private function writeReport(array $report): string
{ {
$path = $this->option('report') ?: storage_path( return app(ProducerDeduplicator::class)->writeReport($report, $this->option('report') ?: null);
'app/private/producers-dedupe-' . now()->format('Y-m-d_His') . '.json'
);
$directory = dirname($path);
if (! is_dir($directory)) {
mkdir($directory, 0775, true);
}
file_put_contents($path, json_encode($report, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
return $path;
} }
private function rollback(ProducerDeduplicator $deduplicator, string $path): int private function rollback(ProducerDeduplicator $deduplicator, string $path): int

View File

@ -2,10 +2,108 @@
namespace App\Filament\Resources\Producers\Pages; namespace App\Filament\Resources\Producers\Pages;
use App\Enums\DbStatusFieldEnum;
use App\Filament\Resources\Producers\ProducerResource; use App\Filament\Resources\Producers\ProducerResource;
use App\Models\Producer;
use App\Models\Product;
use App\Services\ProducerDeduplicator;
use Filament\Actions\Action;
use Filament\Forms\Components\Placeholder;
use Filament\Forms\Components\Select;
use Filament\Notifications\Notification;
use Filament\Resources\Pages\ViewRecord; use Filament\Resources\Pages\ViewRecord;
use Filament\Schemas\Components\Utilities\Get;
use Illuminate\Support\Facades\DB;
class ViewProducer extends ViewRecord class ViewProducer extends ViewRecord
{ {
protected static string $resource = ProducerResource::class; protected static string $resource = ProducerResource::class;
protected function getHeaderActions(): array
{
return [
$this->mergeProducerAction(),
];
}
/**
* Két aktív gyártó összevonása felületről, Excel/CLI nélkül - EV3-473, 7. lépés.
* Valódi tesztelés közben előkerült eset: az admin a felületen böngészve veszi
* észre, hogy két aktív gyártó ugyanaz a cég, de az alias-felvétel elutasítja az
* ütközést, és korábban nem volt mód a tényleges összevonásra máshogy, csak a
* producers:dedupe-report -> Excel -> producers:dedupe --apply láncon, ami
* fejlesztői hozzáférést igényel.
*
* A megtekintett gyártó MINDIG a keeper marad (nincs átnevezés) - ez a felhasználói
* szándék, hiszen már ezen az oldalon áll. A ProducerDeduplicator::apply() egyetlen,
* kézzel épített merge-bejegyzéssel hívva (buildPlan()/Excel nélkül) - ez már
* automatikusan aliast is ír a beolvasztott névből (lásd 4. fázis).
*/
protected function mergeProducerAction(): Action
{
return Action::make('mergeProducer')
->label('Gyártó összevonása')
->icon('heroicon-o-arrows-pointing-in')
->color('warning')
->visible(fn (Producer $record) => $record->status === DbStatusFieldEnum::active)
->schema([
Select::make('loser_id')
->label('Melyik aktív gyártót olvasszuk be ide?')
->options(fn (Producer $record) => Producer::query()
->whereNotIn('status', [DbStatusFieldEnum::archive, DbStatusFieldEnum::deleted])
->where('id', '!=', $record->id)
->orderBy('name')
->pluck('name', 'id'))
->searchable()
->required()
->live(),
Placeholder::make('impact')
->label('Hatás')
->content(function (Get $get) {
$loserId = $get('loser_id');
if (blank($loserId)) {
return 'Válassz gyártót a hatás megtekintéséhez.';
}
$products = Product::where('producer_id', $loserId)->count();
$orderItems = DB::table('order_archives_items')->where('producer_id', $loserId)->count();
$pricelistLines = DB::table('pricelist_file_lines')->where('producer_id', $loserId)->count();
return "Átírandó: {$products} termék, {$orderItems} rendelési tétel, "
. "{$pricelistLines} árlista-sor. A kiválasztott gyártó archiválódik, "
. 'a neve automatikusan alias lesz a jelenlegi gyártó alatt.';
}),
])
->modalHeading('Gyártó összevonása')
->modalSubmitActionLabel('Összevonás')
->requiresConfirmation()
->action(function (array $data, Producer $record) {
$loser = Producer::findOrFail($data['loser_id']);
$deduplicator = app(ProducerDeduplicator::class);
$report = $deduplicator->apply([[
'keeper_id' => $record->id,
'keeper_name' => $record->name,
'final_name' => $record->name,
'rename' => false,
'from' => [['id' => $loser->id, 'name' => $loser->name]],
]]);
$reportPath = $deduplicator->writeReport($report);
Notification::make()
->title('Gyártók összevonva')
->body(sprintf(
'"%s" beolvadt "%s" alá. %d termék, %d rendelési tétel, %d árlista-sor átírva. Jelentés: %s',
$loser->name,
$record->name,
$report['totals']['products'] ?? 0,
$report['totals']['order_archives_items'] ?? 0,
$report['totals']['pricelist_file_lines'] ?? 0,
basename($reportPath),
))
->success()
->send();
});
}
} }

View File

@ -2,6 +2,7 @@
namespace App\Filament\Resources\Producers\RelationManagers; namespace App\Filament\Resources\Producers\RelationManagers;
use App\Support\Exceptions\ActiveProducerNameCollisionException;
use App\Support\NameNormalizer; use App\Support\NameNormalizer;
use App\Support\ProducerAliasResolver; use App\Support\ProducerAliasResolver;
use Closure; use Closure;
@ -50,6 +51,12 @@ public function form(Schema $schema): Schema
try { try {
app(ProducerAliasResolver::class) app(ProducerAliasResolver::class)
->assertNameAvailable($value, $this->getOwnerRecord()->id); ->assertNameAvailable($value, $this->getOwnerRecord()->id);
} catch (ActiveProducerNameCollisionException $e) {
// Ez nem feltétlenül hiba: lehet, hogy a két gyártó
// valóban ugyanaz a cég. A "Gyártó összevonása" gomb
// (ViewProducer fejléc) pont erre a helyzetre való.
$fail($e->getMessage() . ' Ha ugyanaz a cég, használd a '
. '"Gyártó összevonása" gombot az oldal tetején.');
} catch (RuntimeException $e) { } catch (RuntimeException $e) {
$fail($e->getMessage()); $fail($e->getMessage());
} }
@ -74,6 +81,11 @@ public function table(Table $table): Table
->dateTime('Y-m-d H:i'), ->dateTime('Y-m-d H:i'),
]) ])
->defaultSort('created_at', 'desc') ->defaultSort('created_at', 'desc')
// A "Gyártó összevonása" gomb (ViewProducer fejléc) a producer_aliases táblát
// egy MÁSIK Livewire-komponensből (page-szintű action) írja - a relation
// manager erről magától nem értesül. Poll-lal frissül, ugyanaz a minta, mint
// a PricelistFiles LinesRelationManager-jén (háttérfolyamat frissíti a sorokat).
->poll('5s')
->headerActions([ ->headerActions([
CreateAction::make() CreateAction::make()
->mutateDataUsing(function (array $data): array { ->mutateDataUsing(function (array $data): array {

View File

@ -732,4 +732,27 @@ public function rollback(array $report): array
return $restored; return $restored;
} }
/**
* A jelentés lemezre írása - ugyanabba a helyre és ugyanolyan formában, akár a CLI
* `producers:dedupe --report`, akár a felületi gyártó-összevonás (EV3-473, 7. lépés)
* hívja. Enélkül egy felületről indított összevonás nem lenne fejlesztői kézzel
* visszagörgethető a meglévő `producers:dedupe --rollback`-kal.
*/
public function writeReport(array $report, ?string $path = null): string
{
// Mikroszekundum a névben: a felületi összevonás (EV3-473, 7. lépés) miatt már
// reális, hogy egy másodpercen belül több jelentés is készül - a másodperc
// pontosságú név csendben felülírta volna az előzőt.
$path ??= storage_path('app/private/producers-dedupe-' . now()->format('Y-m-d_His_u') . '.json');
$directory = dirname($path);
if (! is_dir($directory)) {
mkdir($directory, 0775, true);
}
file_put_contents($path, json_encode($report, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
return $path;
}
} }

View File

@ -0,0 +1,18 @@
<?php
namespace App\Support\Exceptions;
use RuntimeException;
/**
* Az alias-jelölt neve egy MÁSIK, aktív gyártóéval ütközik - ez a `RuntimeException`
* egy megkülönböztetett alesete, hogy a felhasználói felület fel tudja ajánlani a
* két gyártó összevonását (EV3-473, 7. lépés), ne csak elutasítsa a kérést.
*/
class ActiveProducerNameCollisionException extends RuntimeException
{
public function __construct(string $message, public readonly int $collidingProducerId)
{
parent::__construct($message);
}
}

View File

@ -5,6 +5,7 @@
use App\Enums\DbStatusFieldEnum; use App\Enums\DbStatusFieldEnum;
use App\Models\Producer; use App\Models\Producer;
use App\Models\ProducerAlias; use App\Models\ProducerAlias;
use App\Support\Exceptions\ActiveProducerNameCollisionException;
use RuntimeException; use RuntimeException;
/** /**
@ -50,8 +51,9 @@ public function assertNameAvailable(string $name, ?int $ignoreProducerId = null)
->first(fn ($p) => NameNormalizer::normalize($p->name) === $normalized); ->first(fn ($p) => NameNormalizer::normalize($p->name) === $normalized);
if ($collidingProducer) { if ($collidingProducer) {
throw new RuntimeException( throw new ActiveProducerNameCollisionException(
"A(z) \"{$name}\" név ütközik a(z) #{$collidingProducer->id} ({$collidingProducer->name}) aktív gyártóval." "A(z) \"{$name}\" név ütközik a(z) #{$collidingProducer->id} ({$collidingProducer->name}) aktív gyártóval.",
collidingProducerId: $collidingProducer->id,
); );
} }

View File

@ -7,6 +7,7 @@
use App\Filament\Resources\Producers\RelationManagers\AliasesRelationManager; use App\Filament\Resources\Producers\RelationManagers\AliasesRelationManager;
use App\Models\Producer; use App\Models\Producer;
use App\Models\ProducerAlias; use App\Models\ProducerAlias;
use App\Models\Product;
use App\Models\Role; use App\Models\Role;
use App\Models\User; use App\Models\User;
use Filament\Actions\CreateAction; use Filament\Actions\CreateAction;
@ -102,6 +103,94 @@ function actAsDeveloperForProducers(): User
expect(ProducerAlias::count())->toBe(0); expect(ProducerAlias::count())->toBe(0);
}); });
test('a Gyártó összevonása gomb csak aktív gyártónál látszik', function () {
$this->actingAs(actAsDeveloperForProducers());
$active = Producer::create(['name' => 'Danone', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
$archived = Producer::create(['name' => 'Danone Kft', 'status' => DbStatusFieldEnum::archive, 'canSee' => 0]);
Livewire::test(ViewProducer::class, ['record' => $active->getRouteKey()])
->assertActionVisible('mergeProducer');
Livewire::test(ViewProducer::class, ['record' => $archived->getRouteKey()])
->assertActionHidden('mergeProducer');
});
test('a Gyártó összevonása gomb ténylegesen összevonja a két aktív gyártót', function () {
$this->actingAs(actAsDeveloperForProducers());
$reportsBefore = collect(glob(storage_path('app/private/producers-dedupe-*.json')));
$keeper = Producer::create(['name' => 'Szarvasi', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
$loser = Producer::create(['name' => 'Szarvas', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
$product = Product::create([
'name' => 'Teszt termék',
'supplierProductNumber' => 'SKU1',
'producer_id' => $loser->id,
'unitValue' => 1,
'note' => '',
'status' => DbStatusFieldEnum::active,
'canSee' => 1,
]);
Livewire::test(ViewProducer::class, ['record' => $keeper->getRouteKey()])
->callAction('mergeProducer', data: ['loser_id' => $loser->id]);
expect($loser->refresh()->status)->toBe(DbStatusFieldEnum::archive)
->and($loser->note)->toContain('Összevonva ide: #' . $keeper->id)
->and($keeper->refresh()->name)->toBe('Szarvasi') // nincs átnevezés
->and($product->refresh()->producer_id)->toBe($keeper->id);
$alias = ProducerAlias::where('producer_id', $keeper->id)->sole();
expect($alias->name)->toBe('Szarvas');
collect(glob(storage_path('app/private/producers-dedupe-*.json')))
->diff($reportsBefore)
->each(fn ($path) => @unlink($path));
});
test('a felületi összevonás jelentés-fájlt ír, ami CLI-vel visszagörgethető', function () {
$this->actingAs(actAsDeveloperForProducers());
$keeper = Producer::create(['name' => 'Szarvasi', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
$loser = Producer::create(['name' => 'Szarvas', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
$before = collect(glob(storage_path('app/private/producers-dedupe-*.json')));
Livewire::test(ViewProducer::class, ['record' => $keeper->getRouteKey()])
->callAction('mergeProducer', data: ['loser_id' => $loser->id]);
$after = collect(glob(storage_path('app/private/producers-dedupe-*.json')));
$newFiles = $after->diff($before);
expect($newFiles)->toHaveCount(1);
$report = json_decode(file_get_contents($newFiles->first()), true);
expect($report['merges'][0]['keeper_id'])->toBe($keeper->id);
app(\App\Services\ProducerDeduplicator::class)->rollback($report);
expect($loser->refresh()->status)->toBe(DbStatusFieldEnum::active);
@unlink($newFiles->first());
});
test('a relation manager elutasítja az aktív gyártóval ütköző alias-t', function () {
$this->actingAs(actAsDeveloperForProducers());
Producer::create(['name' => 'Szarvas', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
$producer = Producer::create(['name' => 'Szarvasi', 'status' => DbStatusFieldEnum::active, 'canSee' => 1]);
Livewire::test(AliasesRelationManager::class, [
'ownerRecord' => $producer,
'pageClass' => ViewProducer::class,
])
->callTableAction(CreateAction::class, data: ['name' => 'Szarvas'])
->assertHasTableActionErrors(['name']);
expect(ProducerAlias::count())->toBe(0);
});
test('csak azoknak a szerepköröknek látszik a menüpont, akik elérik az admin felületet', function () { test('csak azoknak a szerepköröknek látszik a menüpont, akik elérik az admin felületet', function () {
$developer = actAsDeveloperForProducers(); $developer = actAsDeveloperForProducers();

View File

@ -162,6 +162,19 @@ function makeAlias(Producer $producer, string $name, string $source = 'backfill'
->toThrow(RuntimeException::class); ->toThrow(RuntimeException::class);
}); });
test('az aktív gyártóval ütköző assertNameAvailable dedikált exception-t dob, ami az összevonásra utal', function () {
// EV3-473, 7. lépés: a felület ezt az exception-típust ismeri fel, hogy a
// "Gyártó összevonása" gombra tudjon utalni a hibaüzenetben.
makeProducer('Szarvas');
try {
(new ProducerAliasResolver)->assertNameAvailable('Szarvas');
$this->fail('Az assertNameAvailable-nek dobnia kellett volna.');
} catch (\App\Support\Exceptions\ActiveProducerNameCollisionException $e) {
expect($e->collidingProducerId)->toBeInt();
}
});
test('az assertNameAvailable dob, ha a név egy másik alias-szal ütközik', function () { test('az assertNameAvailable dob, ha a név egy másik alias-szal ütközik', function () {
$producer = makeProducer('Kőröstej Kft.'); $producer = makeProducer('Kőröstej Kft.');
$other = makeProducer('Bonduelle'); $other = makeProducer('Bonduelle');