Podgląd aplikacji pest-raport

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

Generowanie kodów QR w PestRaport

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

Ekran główny aplikacji mobilnej PestRaportSzczegóły pułapki w aplikacji mobilnej PestRaport

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

Diagramy ścieżek użytkownika w PestRaport

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

Generowanie raportów w PestRaport

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

Szczegóły obiektu w PestRaport

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

Diagramy ścieżek użytkownika w PestRaport Plik projektowy PestRaport w Figmie

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:

  1. Fundamenty: Architektura multi-tenant i projekt głównej bazy danych
  2. Aplikacja mobilna: Skanowanie, tryb offline, formularze przeglądów
  3. Platforma webowa: Zarządzanie obiektami, generowanie kodów QR i panel raportowy
  4. 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.

Masz projekt na myśli? Porozmawiajmy.

Opowiedz nam o swoim wyzwaniu. Wrócimy z propozycją rozwiązania, planem i wyceną.

Upsphere - Oprogramowanie na zamówienie