Skąd się wziął projekt
Panel serwisu to wewnętrzne narzędzie dla techników serwisu telefonów — centralne miejsce do zarządzania zleceniami napraw, śledzenia przepływów kasowych i generowania oficjalnych dokumentów. Każda naprawa otrzymuje unikalny kod (format REP-XXXXX/M/YY) i 6-znakowy klucz dostępu używany w publicznym API, które pozwala klientom sprawdzać status naprawy przez stronę WordPress bez logowania.
Co było trudne
Serwis telefonów potrzebuje sprawnego systemu do śledzenia dziesiątek napraw jednocześnie — z historią statusów, danymi klienta i urządzenia, kosztami części i możliwością generowania kart przyjęcia i gwarancji wymaganych przez prawo. Dodatkowo klienci chcą sprawdzać status naprawy samodzielnie przez stronę internetową.
Jak to rozwiązałem
Zbudowałem fullstack aplikację Next.js 15 z App Router — API routes obsługują CRUD napraw, zarządzanie sesją i reset hasła. Prisma 6 z MySQL jako baza danych. React PDF Renderer generuje karty przyjęcia i gwarancji server-side. Publiczne API z autoryzacją przez klucz API (X-API-Key) i 6-znakowy klucz naprawy umożliwia integrację z witryną WordPress — dane klienta są maskowane (np. 'Ko***k', '12*****89'). TanStack Table obsługuje zaawansowaną tabelę z filtrowaniem, paginacją i sortowaniem.
Wynik
Działający panel administracyjny z zarządzaniem naprawami (statusy, dane klienta i urządzenia, koszty), rozliczeniami kasowymi (przychody i wydatki z podziałem na okresy), generowaniem PDF (karta przyjęcia i gwarancji) oraz publicznym API do sprawdzania statusu naprawy integrującym się ze stroną WordPress.
