FIX EV3-357 névütközés blokkolása a gyártó-összevonásnál

A megrendelő a 2. körös döntési lapon két külön csoportnak (27, 28) ugyanazt a
végleges nevet adta ("MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT") - a szándéka szerint egy
cégről van szó. Végrehajtva ebből két azonos nevű aktív gyártó maradt volna, vagyis
a takarítás maga állított volna elő duplikátumot. A parancs ezt nem vette észre.

- buildPlan új 'blocking' listát ad: a végrehajtás UTÁNI aktív névállományban
  keres ütközést. Két eset: két lap-csoport ugyanarra a névre kerülne, vagy a
  végleges név egy összevonásban részt nem vevő, meglévő gyártó neve.
  Csak a terv által okozott ütközést jelzi, a lapon kívül már meglévő
  duplikátumokat nem.
- producers:dedupe blokkoló esetén nem hajt végre semmit, --force mellett sem;
  a lapot kell javítani (a csoportokat egybetenni, vagy eltérő nevet adni).

A valódi lapon igazolva: a javítatlan változatot --apply --force-szal is
elutasította (exit 1), a 28 -> 27 átcsoportosítás után átengedte.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
E98Developer 2026-09-15 06:23:19 +02:00
parent 38d20e7feb
commit 7839db472e
3 changed files with 181 additions and 1 deletions

View File

@ -64,6 +64,18 @@ public function handle(ProducerDeduplicator $deduplicator): int
$this->summarize($merges); $this->summarize($merges);
// A névütközés blokkoló: a végrehajtás duplikátumot állítana elő. A --force sem
// kerüli meg - a lapot kell javítani.
if (($plan['blocking'] ?? []) !== []) {
$this->newLine();
foreach ($plan['blocking'] as $blocking) {
$this->error(' BLOKKOLÓ: ' . $blocking);
}
$this->error('A végrehajtás blokkolva, amíg a döntési lap nincs javítva.');
return self::FAILURE;
}
if (! $this->option('apply')) { if (! $this->option('apply')) {
$this->newLine(); $this->newLine();
$this->info('Ez csak kimutatás volt. A végrehajtáshoz: --apply'); $this->info('Ez csak kimutatás volt. A végrehajtáshoz: --apply');

View File

@ -372,7 +372,78 @@ public function buildPlan(array $decisions): array
]; ];
} }
return ['merges' => $merges, 'errors' => $errors, 'skipped' => $skipped]; return [
'merges' => $merges,
'errors' => $errors,
'skipped' => $skipped,
'blocking' => $this->detectNameCollisions($merges),
];
}
/**
* Névütközés: két gyártó ugyanarra a névre kerülne a végrehajtás után.
*
* Ez akkor fordul elő, ha a megrendelő két KÜLÖN lap-csoportnak ugyanazt a végleges
* nevet adja (a szándéka szerint egy cégről van szó), vagy ha a végleges név egy
* olyan gyártó neve, amely nem vesz részt az összevonásban. Mindkét esetben két
* azonos nevű aktív gyártó maradna - vagyis a takarítás maga állítana elő
* duplikátumot. Ezért ez BLOKKOLÓ hiba: a végrehajtás csak a lap javítása (a
* csoportok egybetétele) után indulhat, és a --force sem kerüli meg.
*
* @param array<int, array> $merges
* @return array<int, string>
*/
private function detectNameCollisions(array $merges): array
{
$mergedAway = [];
$keeperGroup = [];
$keeperFinalName = [];
foreach ($merges as $merge) {
$keeperGroup[$merge['keeper_id']] = $merge['group'];
$keeperFinalName[$merge['keeper_id']] = $merge['final_name'];
foreach ($merge['from'] as $from) {
$mergedAway[$from['id']] = true;
}
}
// A végrehajtás UTÁNI aktív névállomány
$resulting = [];
foreach ($this->activeMembers() as $member) {
$producer = $member['producer'];
if (isset($mergedAway[$producer->id])) {
continue;
}
$name = $keeperFinalName[$producer->id] ?? (string) $producer->name;
$resulting[NameNormalizer::normalize($name)][] = [
'id' => $producer->id,
'name' => $name,
'group' => $keeperGroup[$producer->id] ?? null,
];
}
$blocking = [];
foreach ($resulting as $entries) {
// Csak azt jelezzük, amit EZ a terv okoz - a lapon kívüli, már meglévő
// duplikátumokat nem (azok egy következő kör dolgai).
if (count($entries) < 2 || array_filter(array_column($entries, 'group'), fn ($g) => $g !== null) === []) {
continue;
}
$parts = array_map(fn ($e) => $e['group'] !== null
? $e['group'] . '. csoport (#' . $e['id'] . ')'
: 'a lapon kívüli #' . $e['id'] . ' gyártó', $entries);
$blocking[] = 'Névütközés: ' . implode(' és ', $parts) . ' ugyanarra a névre kerülne: "'
. $entries[0]['name'] . '". Ha ugyanaz a cég, tedd őket egy csoportba (azonos '
. 'csoportszám); ha nem, adj nekik eltérő végleges nevet.';
}
return $blocking;
} }
/** /**

View File

@ -323,3 +323,100 @@ function decisionsFor(array $rows): array
@unlink($path); @unlink($path);
}); });
/**
* Kitöltött döntési lap írása a parancs számára (a fejlécnév alapján olvassa vissza).
*
* @param array<int, array{group: int, id: int, final_name: ?string}> $rows
*/
function writeDecisionSheet(string $path, array $rows): void
{
$spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', ProducersDedupeReport::COLUMN_GROUP);
$sheet->setCellValue('B1', ProducersDedupeReport::COLUMN_ID);
$sheet->setCellValue('C1', ProducersDedupeReport::COLUMN_FINAL_NAME);
foreach ($rows as $i => $row) {
$sheet->setCellValue('A' . ($i + 2), $row['group']);
$sheet->setCellValue('B' . ($i + 2), $row['id']);
$sheet->setCellValue('C' . ($i + 2), $row['final_name'] ?? '');
}
(new \PhpOffice\PhpSpreadsheet\Writer\Xlsx($spreadsheet))->save($path);
}
test('két csoport azonos végleges névvel blokkoló névütközés', function () {
// A megrendelő két külön csoportnak ugyanazt a nevet adta (egy cégről van szó).
// Végrehajtva két azonos nevű gyártó maradna - a takarítás maga gyártana duplikátumot.
$a1 = producer('MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT');
$a2 = producer('MARS MAGYARORSZÁG ÉRTÉKESÍTO BT');
$b1 = producer('MARS MO ÉRTÉKESÍTŐ BT (WRIGLEY)');
$b2 = producer('MARS MO ÉRTÉKESÍTO BT (WRIGLEY)');
$plan = $this->deduplicator->buildPlan([
['group' => 27, 'id' => $a1->id, 'final_name' => 'MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT'],
['group' => 27, 'id' => $a2->id, 'final_name' => null],
['group' => 28, 'id' => $b1->id, 'final_name' => 'MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT'],
['group' => 28, 'id' => $b2->id, 'final_name' => null],
]);
expect($plan['blocking'])->toHaveCount(1)
->and($plan['blocking'][0])->toContain('27. csoport')->toContain('28. csoport');
});
test('egy csoportba téve ugyanaz a döntés már nem ütközik', function () {
$a1 = producer('MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT');
$a2 = producer('MARS MAGYARORSZÁG ÉRTÉKESÍTO BT');
$b1 = producer('MARS MO ÉRTÉKESÍTŐ BT (WRIGLEY)');
$b2 = producer('MARS MO ÉRTÉKESÍTO BT (WRIGLEY)');
$plan = $this->deduplicator->buildPlan([
['group' => 27, 'id' => $a1->id, 'final_name' => 'MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT'],
['group' => 27, 'id' => $a2->id, 'final_name' => null],
['group' => 27, 'id' => $b1->id, 'final_name' => 'MARS MAGYARORSZÁG ÉRTÉKESÍTŐ BT'],
['group' => 27, 'id' => $b2->id, 'final_name' => null],
]);
expect($plan['blocking'])->toBe([])
->and($plan['merges'])->toHaveCount(1)
->and($plan['merges'][0]['from'])->toHaveCount(3);
});
test('a lapon kívüli, meglévő gyártó nevére nevezés is blokkoló', function () {
$outside = producer('Biopont Kft.');
$a = producer('Biopont');
$b = producer('BIOPONT ');
$plan = $this->deduplicator->buildPlan([
['group' => 1, 'id' => $a->id, 'final_name' => 'Biopont Kft.'],
['group' => 1, 'id' => $b->id, 'final_name' => null],
]);
expect($plan['blocking'])->toHaveCount(1)
->and($plan['blocking'][0])->toContain('lapon kívüli #' . $outside->id);
});
test('a parancs névütközésnél --force mellett sem hajt végre semmit', function () {
$a1 = producer('Danone');
$a2 = producer('Danone ');
$b1 = producer('Danone Kft');
$b2 = producer('DANONE KFT');
$moved = productFor($a2, 'X1');
$path = storage_path('app/private/teszt_nevutkozes.xlsx');
writeDecisionSheet($path, [
['group' => 1, 'id' => $a1->id, 'final_name' => 'Danone Kft'],
['group' => 1, 'id' => $a2->id, 'final_name' => null],
['group' => 2, 'id' => $b1->id, 'final_name' => 'Danone Kft'],
['group' => 2, 'id' => $b2->id, 'final_name' => null],
]);
$this->artisan('producers:dedupe', ['file' => $path, '--apply' => true, '--force' => true])
->assertExitCode(1);
expect($moved->refresh()->producer_id)->toBe($a2->id)
->and(DB::table('producers')->where('status', DbStatusFieldEnum::archive)->count())->toBe(0);
@unlink($path);
});