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).
A ProducerDeduplicator::apply() mostantól minden összevonáskor aliast ír a
vesztes gyártók nevéből, és átnevezésnél a keeper eredeti nevéből is - ez
utóbbi sehol máshol nem maradna meg. Ha egy vesztesnek már volt alias-a egy
korábbi összevonásból, azt átpontozza az új keeperre, nehogy elárvuljon.
Ütközésnél a végrehajtás nem szakad meg, csak figyelmeztetést gyűjt a
jelentésbe. A rollback() mindkét műveletet szimmetrikusan visszagörgeti.
Két forrásból dolgozik: az archivált gyártók note mezőjéből (láncolást is
követve, ha a célrekord maga is tovább olvadt), illetve a producers:dedupe
--report JSON jelentéseiből, névalapú feloldással - a jelentésekben szereplő
ID-k környezetenként eltérnek. Ütközés esetén kihagyja és jelenti a jelöltet,
kétszeri futtatás nem hoz létre duplikált aliast.
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>
101 javaslat egy kupacban túl sok egy kézi átnézéshez, ráadásul nagyon eltérő
mérlegelést igényelnek: a "Békás Kft." és a "Békás Kft" között nincs mit
eldönteni, a "Dénes Natura" és a "Dénes Natura Kft" között viszont van.
- ProducerDeduplicator::differenceCategory(): a LEGKEVÉSBÉ agresszív átalakítás,
ami már egy kulcsra hozza a csoport tagjait - csak írásjel / egybeírás /
ékezet / cégforma / vegyes.
- a riport ebben a sorrendben írja ki a csoportokat (elöl a gyakorlatilag
eldöntött esetek), és a "csak írásjel" kategóriánál előre beírja a javaslatot;
a többinél a végleges név üresen marad, a javaslat a Megjegyzés oszlopban.
A d2d másolaton: 14 csak írásjel (előre kitöltve, azonnal végrehajtható),
7 egybeírás, 8 ékezet, 72 cégforma - utóbbi 87 vár a megrendelő döntésére.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
A takarítás első köre után is maradtak nyilvánvaló duplikátumok: "Békás Kft." /
"Békás Kft", "Gast Food" / "Gast-Food", "Alföldi Tej" / "Alfölditej". A
NameNormalizer csak a kis/nagybetűt, a / és _ szeparátort és a többszörös
szóközt kezeli - az írásjelekhez, a kötőjelhez, az egybeíráshoz és az
ékezethez nem nyúl.
A szabályt SZÁNDÉKOSAN nem lazítottuk, mert két, ellentétes igényű feladatot
szolgál ki: az import-párosításnál egy téves egyezés csendben rossz gyártóhoz
rendelne termékeket, a takarítási javaslatnál viszont a megrendelő nemet mond
rá. Ezért a kettő szétválik.
- ProducerDeduplicator::looseCandidateGroups(): megengedőbb kulcs (írásjel,
ékezet, szóköz elhagyása) KIZÁRÓLAG javaslatokhoz. A különböző cégformát
(Kft vs Zrt) itt sem vonja össze - az valódi különbség, nem elírás -, a
cégforma nélküli név viszont párba állhat, ha csak egyféle forma van.
- producers:dedupe-report --loose: a javaslatok "ellenőrizendő" típussal, ÜRES
végleges névvel kerülnek a lapra, a javaslat a Megjegyzés oszlopban. Így az
alapértelmezett viselkedés a "nem nyúlunk hozzá", a döntés tudatos kitöltés.
- buildPlan: az üres végleges név mostantól KIHAGYÁS, nem hiba - ez a javaslat
elutasításának módja. A kihagyott csoportokat a parancs tételesen kiírja.
- buildPlan bármely aktív gyártót elfogad a lapon, nem csak a szigorú
duplikátumok tagjait.
A d2d másolaton az első kör után: 0 biztos duplikáció, 101 ellenőrizendő
javaslat 241 rekorddal.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
A megelőzés után a már felhalmozódott adat takarítása: 70 duplikált névcsoport,
146 rekord, ebből 76 beolvasztandó.
Két parancs, mert a kivezetés három környezeten megy (local -> d2d -> éles), és
minden környezetnek SAJÁT duplikátum-készlete van - a döntési lapot ezért ott
kell újragenerálni, nem beégetett ID-listával dolgozunk.
- producers:dedupe-report — döntési xlsx a megrendelőnek. A megtartandó a
legtöbb TERMÉKKEL rendelkező rekord (döntetlennél több rendelési tétel, majd
régebbi rekord); a végleges nevet a megrendelő hagyja jóvá, mert 48 csoport
csak kis/nagybetűben tér el, és az írásmód üzleti döntés.
- producers:dedupe — alapból csak kimutatás, --apply hajt végre.
A lapot FEJLÉCNÉV alapján olvassa, nem oszlopbetű szerint, így a megrendelő
beszúrhat oszlopot vagy átrendezheti a lapot anélkül, hogy eltörne.
Hiányos csoportot és ismeretlen azonosítót visszautasít.
- Visszafordíthatóság: a jelentés SORONKÉNT tárolja a régi producer_id-t, mert
a fordított leképezés azokat a sorokat is átírná, amelyek eredetileg is a
megtartott rekordra mutattak. --rollback ebből állít vissza.
- Tartós nyom a jelentésfájltól függetlenül: a beolvasztott rekord archive +
canSee=0 lesz, és a note-jába kerül, hova olvadt be.
- A két nagy táblán nincs index a producer_id-n, ezért táblánként EGY UPDATE
fut CASE leképezéssel - 76 külön WHERE 76 teljes scant jelentene.
Mért eredmény a d2d másolaton: 27 mp alatt 314 termék + 27 272 archív + 115
árlista-sor átírva; a vizsgált árlistán a "Módosult" sorok 126 -> 23, a
gyártó-diffek 114 -> 2. Visszagörgetés után minden szám visszaállt, és az
újraszámolt diff ismét 126 - az ok-okozat mindkét irányban igazolt.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Egy beszállítóhoz egyszerre legfeljebb egy nyitott végrehajtás tartozhat: egy
execution_failed fájl után a termékek félig frissített állapotban vannak, egy új
import erre a kevert alapra rétegződne rá (és a validálás is ehhez számolná a
diffeket); két párhuzamos végrehajtás pedig nem determinisztikus eredményt adna.
- új PricelistGuard service: egyetlen igazságforrás a blokkoláshoz
- mind a NÉGY belépési pont véd: modern Filament create, régebbi
PriceListProcessor oldal, legacy Admin\PriceListController import, konzol
parancs. A legacy import a legfontosabb - az közvetlenül ír a products
táblába, megkerülve a modult, és a beszállítókat ma még nagyrészt ott kezelik.
- az `inprogress` önmagában nem blokkol: az előfeldolgozás és a validálás
egyetlen terméket sem ír, csak a már elindult végrehajtás számít
- a beszállító nem tűnik el a select listából, hanem konkrét magyarázatot kap a
felhasználó arról, melyik fájl blokkol és miért
- blokkolt beszállítónál másik fájl jóváhagyása sem indítható
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>