README

Online elállási/felmondási nyilatkozat (45/2014. (II. 26.) Korm. rendelet) Laravel csomag: űrlap a fogyasztóknak, a nyilatkozat tárolása, és tartós adathordozós e-mail visszaigazolás mind a fogyasztónak, mind a kereskedőnek.

🤖 AI-ügynökök / AI conversations: a determinisztikus telepítési útmutató a AGENTS.md fájlban van. Ha ezt a csomagot egy AI-nak adod telepítésre, hivatkozz arra.

Telepítés

composer require cegem360/laravel-withdrawal

A csomag migrációja automatikusan betöltődik, tehát php artisan migrate futtatásával a withdrawal_declarations tábla publikálás nélkül is létrejön. Publikáld a konfigurációt:

php artisan vendor:publish --tag=withdrawal-config
php artisan migrate

A migráció publikálása (php artisan vendor:publish --tag=withdrawal-migrations) OPCIONÁLIS, csak akkor szükséges, ha testre szeretnéd szabni a migrációt (pl. további oszlopok hozzáadása).

Opcionálisan publikálhatók a nézetek és a nyelvi fájlok is:

php artisan vendor:publish --tag=withdrawal-views
php artisan vendor:publish --tag=withdrawal-lang

Konfiguráció (.env)

Route-ok

A csomag a következő elnevezett route-okat regisztrálja (a config('withdrawal.route.prefix') előtag alatt, web middleware csoporttal):

• withdrawal.form — GET, az elállási/felmondási nyilatkozat űrlapja.
• withdrawal.submit — POST, a nyilatkozat beküldése.
• withdrawal.success — GET, köszönő oldal a sikeres beküldés után.

Az URL-előtag az WITHDRAWAL_ROUTE_PREFIX környezeti változóval konfigurálható (alapértelmezett: elallasi-nyilatkozat). Ha a fogadó alkalmazásban már foglalt ez az útvonal-előtag, állítsd át más értékre az ütközés elkerülése érdekében.

Esemény

Sikeres beküldéskor a csomag kibocsátja a Cegem360\Withdrawal\Events\WithdrawalDeclarationSubmitted eseményt, amely a létrehozott WithdrawalDeclaration modellt hordozza ($event->declaration). Ezt saját listenerekben feliratkozva bővítheted (pl. CRM-szinkron, egyéb értesítések).

A csomag emellett automatikusan elküld két e-mailt:

• Fogyasztói visszaigazolás — tartós adathordozós visszaigazolás a nyilatkozatot beküldő fogyasztónak.
• Kereskedői értesítés — az WITHDRAWAL_NOTIFY_EMAIL címre.

Opcionális Filament admin felület

A csomag tartalmaz egy opcionális, csak olvasható Filament v5 admin nézetet a beérkezett nyilatkozatokhoz. Ehhez telepítened kell a filament/filament csomagot a saját alkalmazásodban, majd regisztrálnod kell a plugint a panel providerben:

use Cegem360\Withdrawal\Filament\WithdrawalPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(WithdrawalPlugin::make());
}

A Filament réteg (WithdrawalPlugin és WithdrawalDeclarationResource) csak akkor töltődik be, ha a fogadó alkalmazás explicit regisztrálja a plugint — a csomag magja Filament nélkül is teljes értékűen működik.

Jogi megjegyzés

Ez a csomag technikai eszközt biztosít a 45/2014. (II. 26.) Korm. rendelet szerinti elállási/felmondási nyilatkozat fogadásához és visszaigazolásához. Nem minősül jogi tanácsadásnak; a konkrét szerződési feltételek és tájékoztatási kötelezettségek betartásáért a csomagot használó kereskedő felel.

Licenc

MIT.