import

Skill do automatycznego tworzenia klas importu danych z plików Excel dla frameworka CatchAdmin. Oszczędza czas przy budowaniu funkcjonalności importu — generuje gotową strukturę PHP z obsługą mapowania kolumn, walidacją danych i integracją z modelami. Idealne dla deweloperów pracujących z modułami CatchAdmin, którzy chcą szybko dodać możliwość wgrywania danych z arkuszy kalkulacyjnych.

1. Umieść skill w katalogu .claude/skills/ swojego projektu CatchAdmin, w folderze 08-import. Skill będzie dostępny jako szablon do generowania klas importu.

2. Kiedy potrzebujesz nowej klasy importu, wskaż Claude'owi nazwę modułu i model (np. "Utwórz klasę importu dla modelu User w module Users"). Skill wygeneruje plik w ścieżce modules/{Module}/Import/{Model}.php.

3. Zdefiniuj mapowanie kolumn Excel — określ, które kolumny arkusza odpowiadają polom modelu. Domyślnie kolumny numerowane są od 0 (kolumna A = $row[0], kolumna B = $row[1] itd.).

4. Jeśli potrzebujesz walidacji danych, dodaj reguły w metodzie collection() — skill zawiera przykład z walidacją pól name i email. Wiersze, które nie przejdą walidacji, zostaną pominięte.

5. Zintegruj klasę importu z kontrolerem — przekaż instancję klasy do metody obsługującej żądanie importu i wywołaj $import->import($request->file()). Framework automatycznie przetworzy plik Excel i utworzy rekordy w bazie danych.