GastroOps
Samodzielnie zbudowane offline-first PWA Nuxt 4 — projekt produktu, architektura, implementacja, testy i wdrożenie wykonane przez jednego developera — które zastępuje papierowe logi HACCP cyfrowym monitoringiem temperatur, zadaniami i ścieżkami audytu dla małych firm gastronomicznych.
Informacje o projekcie
- Rola
- Zdefiniowałem workflowy operacyjne i samodzielnie zbudowałem produkt, architekturę offline, integracje, testy oraz środowisko demo.
- Okres
- Lipiec 2026 · Niezależny prototyp produktu
- Zespół
- Projekt samodzielny · 1 developer
Wyzwanie
Małe firmy spożywcze — lodziarnie, kawiarnie, food trucki — potrzebują zgodności HACCP, ale papierowe logi są podatne na błędy i łatwo je zgubić. Rozwiązanie cyfrowe musi przetrwać niestabilny internet w sezonowych lub mobilnych lokalizacjach.
Kluczowa decyzja
Kolejkować każdą mutację lokalnie i synchronizować ją idempotentnie po powrocie sieci, aby praca HACCP nie zależała od połączenia.
Podejście
Zbudowane jako pełne offline-first PWA w Nuxt 4, Vue 3 i Pinia do kolejki offline. Kluczową decyzją było kolejkowanie wszystkich mutacji lokalnie i asynchroniczna synchronizacja po ponownym połączeniu, zamiast wymagania stałej łączności — niezbędne dla food trucków i sezonowych lokali. Dane serwerowe płyną przez adapter repozytorium Baserow, dostępny tylko z serwera Nitro. Kody QR na urządzeniach umożliwiają szybki check-in do logowania temperatur. System obejmuje szablony kontroli z zakresami, automatyczne wykrywanie niezgodności, śledzenie dostaw z traceability partii oraz eksport gotowy pod Sanepid. Deterministyczny tryb demo działa w pamięci bez usług zewnętrznych.
Kluczowe elementy
- Architektura offline-first z lokalnymi draftami, UUID i idempotentnym sync po reconnect
- Serwerowy adapter Baserow do chmurowej persystencji
- Check-in urządzeń QR do szybkiego logowania temperatur
- Automatyczne wykrywanie niezgodności i workflow działań korygujących
- Eksport Sanepid w formatach JSON i CSV
- Pełny zestaw modułów HACCP: temperatury, czyszczenie, dostawy, szkodniki, odpady, woda, szkolenia
Architektura
- Nuxt 4 z Vue 3 i TypeScript strict
- Nuxt UI 4 i Tailwind CSS dla komponentów UI
- Pinia wyłącznie do kolejki offline
- Plugin Vite PWA dla service workera i cache
- API serwera Nitro z adapterem Baserow
- Walidacja Zod na wszystkich granicach danych
- Testy jednostkowe Vitest i e2e Playwright
Rezultat
Kompletne MVP działające w pełni offline i integrujące się z Baserow do sync w chmurze, zastępujące papierową dokumentację HACCP mobilnym workflow cyfrowym.
Wewnątrz produktu
