Platforma SaaS do przeglądów i dokumentacji w branży DDD
Opis projektu
Stworzyliśmy kompleksową platformę SaaS dla branży DDD (dezynsekcja, dezynfekcja, deratyzacja), która zmienia sposób, w jaki firmy przeprowadzają przeglądy urządzeń i tworzą dokumentację. Rozwiązanie łączy aplikację webową do zarządzania i raportowania z aplikacją mobilną do przeglądów w terenie. Razem tworzą spójny proces, który eliminuje papierologię i oszczędza godziny pracy administracyjnej.
Wyzwanie
Firmy DDD mierzą się z poważnym wąskim gardłem operacyjnym: ręcznie prowadzonymi przeglądami. Technicy w terenie musieli:
- Ręcznie sprawdzać każde urządzenie w obiektach klientów
- Odręcznie wypełniać protokoły z przeglądów
- Spędzać godziny w biurze na przepisywaniu notatek do oficjalnej dokumentacji
- Tworzyć osobne raporty dla różnych typów urządzeń i lokalizacji
- Zarządzać wieloma obiektami bez centralnego systemu
Takie podejście było czasochłonne, podatne na błędy i utrudniało utrzymanie spójnych standardów dokumentacji między lokalizacjami i członkami zespołu.
Kluczowe funkcje
Zarządzanie urządzeniami za pomocą kodów QR
Rozwiązany problem: Śledzenie urządzeń w wielu obiektach i pewność, że technicy sprawdzają właściwe urządzenia.
Platforma generuje unikalny kod QR dla każdego urządzenia. Menedżerowie drukują kody i umieszczają je na urządzeniach w obiektach klientów. Technik skanuje kod QR w aplikacji mobilnej, od razu widzi informacje o urządzeniu i może rozpocząć przegląd. Koniec z wątpliwościami, które urządzenia sprawdzić, i pewność, że żadne nie zostanie pominięte.
Natywna aplikacja mobilna


Rozwiązany problem: Technicy potrzebują szybkiej, niezawodnej aplikacji, która sprawdzi się w trudnych warunkach terenowych.
Zbudowaliśmy dedykowaną aplikację mobilną w React Native, zoptymalizowaną pod pracę w terenie. Aplikacja oferuje natywną wydajność na iOS i Androidzie oraz intuicyjny interfejs zaprojektowany z myślą o specjalistach DDD. Technicy szybko przechodzą między obiektami, sprawdzają szczegóły urządzeń i kończą przeglądy nawet przy słabym zasięgu.
Cyfrowy proces przeglądu
Rozwiązany problem: Papierowa dokumentacja jest powolna, podatna na błędy i łatwo ją zgubić lub zniszczyć w terenie.
Po zeskanowaniu kodu QR urządzenia technik wypełnia w aplikacji cyfrowy formularz przeglądu. Aplikacja działa offline, więc przeglądy można prowadzić bez dostępu do internetu, a dane synchronizują się automatycznie po odzyskaniu połączenia. Urządzenia można przypisywać do konkretnych stref w obiekcie, co ułatwia ich organizację i śledzenie.
Automatyczne generowanie raportów
Rozwiązany problem: Ręczne przygotowanie profesjonalnych raportów z logo firmy zajmowało godziny i często prowadziło do niespójności.
Po zakończeniu przeglądów menedżerowie od razu generują w panelu webowym raporty, które mogą dostosować do swoich potrzeb. Firmy dodają własne logo, zmieniają format raportów i tworzą profesjonalną dokumentację zgodną ze swoją identyfikacją wizualną. To, co kiedyś zajmowało godziny, teraz wymaga jednego kliknięcia.
Zarządzanie wieloma obiektami
Rozwiązany problem: Bez centralnego śledzenia zarządzanie urządzeniami w dziesiątkach lokalizacji klientów szybko zamienia się w chaos.
Panel webowy daje centralny wgląd we wszystkie obiekty klientów, stan urządzeń i harmonogramy przeglądów. Menedżerowie śledzą urządzenia w wielu lokalizacjach, analizują dane dla poszczególnych obiektów na interaktywnych wykresach i mają pewność, że żadna lokalizacja nie zostanie pominięta.
Architektura multi-tenant
Rozwiązany problem: Firmy DDD potrzebują własnej, bezpiecznej przestrzeni roboczej, w której nie widzą danych konkurencji.
Platforma obsługuje wiele firm DDD, z pełną izolacją danych i własnym brandingiem dla każdej z nich. Każda firma działa we własnym, bezpiecznym środowisku, a jedna platforma obsługuje całą branżę.
Zarządzanie pracownikami
Rozwiązany problem: Firmy potrzebują bezpiecznej kontroli dostępu i prostego wdrażania nowych członków zespołu.
Kontrola dostępu oparta na rolach z uprawnieniami Właściciela i Pracownika zapewnia odpowiedni poziom bezpieczeństwa. Menedżerowie zapraszają członków zespołu przez aplikację webową, a zaproszenia e-mail zawierają deep linki, które upraszczają konfigurację aplikacji mobilnej.
Proces realizacji
Najpierw design
Zanim napisaliśmy pierwszą linijkę kodu, przeprowadziliśmy kompleksowe prace projektowe UI/UX w Figmie:
- Przygotowaliśmy szczegółowe ścieżki użytkownika obejmujące cały proces przeglądu
- Zaprojektowaliśmy kompletne interfejsy dla wersji webowej i mobilnej
- Zweryfikowaliśmy doświadczenie użytkownika z interesariuszami
Harmonogram prac
Prace podzieliliśmy na skoncentrowane etapy:
- Fundamenty: Architektura multi-tenant i projekt głównej bazy danych
- Aplikacja mobilna: Skanowanie, tryb offline, formularze przeglądów
- Platforma webowa: Zarządzanie obiektami, generowanie kodów QR i panel raportowy
- Integracja i testy: Deep linking, procesy dla pracowników, analityka i przygotowanie wersji beta
Przegląd architektury
Platformę zbudowaliśmy w oparciu o architekturę monorepo z Turborepo, co pozwoliło płynnie współdzielić kod i utrzymać spójne praktyki programistyczne w aplikacji webowej i mobilnej. Dzięki temu logika biznesowa ma jedno źródło prawdy, a każda platforma zapewnia natywne doświadczenie.
Wybór stacku technologicznego
Technologie frontendowe
Aplikacja webowa: Next.js + Shadcn/ui
- Next.js: Server-side rendering zapewnia szybkie ładowanie i lepsze SEO, niezbędne w profesjonalnym produkcie SaaS
- Shadcn/ui: Gotowe, dostępne komponenty, które utrzymują spójność i skracają czas developmentu
- Zarządzanie stanem: Zustand do lekkiego, przewidywalnego zarządzania stanem
- Pobieranie danych: TanStack Query do inteligentnego cache'owania, aktualizacji w tle i optymistycznych mutacji
Aplikacja mobilna: React Native + Expo
- React Native: Natywna wydajność i współdzielona logika biznesowa, dzięki którym sprawnie obsługujemy iOS i Androida
- Expo: Usprawniony proces developmentu, aktualizacje over-the-air i prostsza publikacja w sklepach z aplikacjami
Backend i architektura API
tRPC dla type-safe API
- Wyzwanie: Zachowanie spójności API między aplikacją webową a mobilną przy zapewnieniu bezpieczeństwa typów
- Nasze rozwiązanie: tRPC zapewnia bezpieczeństwo typów end-to-end od bazy danych po UI, eliminując niezgodności API i błędy w runtime
- Rezultat: Szybszy development, mniej błędów
Baza danych: Supabase (PostgreSQL) + Drizzle ORM
- Dlaczego Supabase: Zarządzany PostgreSQL z wbudowanym uwierzytelnianiem, subskrypcjami w czasie rzeczywistym i row-level security
- Dlaczego PostgreSQL: Solidna relacyjna baza danych, idealna do złożonych relacji danych w modelu multi-tenant
- Dlaczego Drizzle ORM: Type-safe zapytania do bazy, które płynnie integrują się z naszym stackiem TypeScript
- Multi-tenancy: Row-level security zapewnia pełną izolację danych między firmami
Infrastruktura i usługi
Uwierzytelnianie: NextAuth
- Funkcje: Logowanie e-mailem i hasłem z możliwością dodania kolejnych dostawców OAuth
- Bezpieczeństwo: Tokeny JWT z bezpiecznym zarządzaniem sesją i RBAC (Role-Based Access Control)
- Integracja: Płynny proces uwierzytelniania między aplikacją webową a mobilną
Przechowywanie plików: CloudFlare R2
- Dlaczego R2: Storage kompatybilny z S3, w lepszej cenie i z globalną dystrybucją przez CDN
- Implementacja: Presigned URL-e do bezpiecznego, bezpośredniego przesyłania plików z aplikacji klienckich
- Zastosowania: Logo firm i wygenerowane raporty w PDF
Płatności: Stripe
- Integracja: Zarządzanie subskrypcjami w rozliczeniach SaaS multi-tenant
- Funkcje: Automatyczne fakturowanie, odzyskiwanie nieudanych płatności i zarządzanie cyklem życia subskrypcji
Monitoring i utrzymanie
- Sentry: Śledzenie błędów i monitoring wydajności w czasie rzeczywistym na wszystkich platformach
- Redis: Rate limiting i warstwa cache poprawiająca wydajność API
- Resend: Wysyłka e-maili transakcyjnych z zaproszeniami i powiadomieniami
Dlaczego te wybory mają znaczenie
- Bezpieczeństwo typów (tRPC + TypeScript): Ogranicza błędy, które mogłyby wpłynąć na kluczowe dane z przeglądów
- Architektura monorepo: Pozwala szybko rozwijać funkcje na wszystkich platformach
- Architektura multi-tenant: Pozwala platformie efektywnie obsługiwać całą branżę
Ta techniczna podstawa obsługuje nie tylko obecne funkcje, ale też daje solidny fundament pod dalszy rozwój i kolejne funkcjonalności.
