~/ instalatorpv-pro $ cat user-guide

InstalatorPV.Pro

profesjonalne narzędzie dla instalatorów fotowoltaiki


// o aplikacji

InstalatorPV Pro to kompleksowe narzędzie dla instalatorów fotowoltaiki. Kalkulatory zgodne z normami IEC, generator protokołów wg PN-EN 62446-1, zarządzanie projektami i klientami. Działa offline, synchronizuje dane z chmurą.

Platforma
Android
Android 11.0+ (API 30)
Tryb offline
Pełny
Kalkulatory i protokoły bez internetu
Trial
7 dni
Pełny dostęp bez opłat
Subskrypcja
9,99 PLN/tydz.
Google Play Billing

// pierwsze kroki

01 Logowanie i rejestracja
Trzy sposoby logowania:
  • Email + hasło — pełny dostęp z synchronizacją chmurową
  • Konto Google — szybkie logowanie przez Google SSO
  • Tryb demo — "Pomiń logowanie" — dane tylko lokalnie, brak synchronizacji
Po zalogowaniu aktywowany jest 7-dniowy bezpłatny okres próbny z pełnym dostępem do wszystkich funkcji.
Bezpieczeństwo biometryczne:

Jeśli urządzenie obsługuje biometrię (odcisk palca, Face ID), przy kolejnym uruchomieniu aplikacja zaproponuje szybkie odblokowanie biometryczne zamiast ponownego logowania.

02 Pulpit (Dashboard)
Ekran startowy pokazuje podsumowanie aktywności:
  • Aktywne projekty — liczba projektów w toku
  • Protokoły w tym miesiącu — ile protokołów wygenerowałeś
  • Kalendarz — dni z zaplanowanymi instalacjami wyróżnione kolorem
  • Szybkie akcje — przyciski "Nowy projekt" i "Nowy protokół"

Kliknij dzień w kalendarzu, aby zobaczyć zaplanowane wydarzenia.

03 Nawigacja w aplikacji
Dolna belka nawigacji (5 zakładek):
ZakładkaFunkcja
PulpitDashboard, statystyki, kalendarz
KalkulatoryPVGIS, elektryczny, zgodność
ProtokołyNowy protokół, archiwum
ProjektyZarządzanie klientami i projektami
WięcejKalendarz, dokumenty, historia zmian, ustawienia

// kalkulatory

Kalkulator PVGIS ENERGIA
Obliczanie uzysku energii na podstawie bazy PVGIS (JRC, Komisja Europejska).

Parametry wejściowe:

ParametrZakresOpis
LokalizacjaGPS / adresPołożenie instalacji
Moc szczytowa0.1 – 20 kWpMoc zainstalowana PV
Kąt nachylenia0 – 90°Nachylenie modułów
Azymut-180 – 180°Konwencja PVGIS: 0° = południe
Straty systemowe0 – 100%Typowo 14%
Typ modułówc-Si / CIS / CdTeTechnologia ogniw
Cena energiiPLN/kWhDo obliczenia oszczędności
Koszt instalacjiPLN (opcja)Do obliczenia PBP

Wyniki:

  • Roczny uzysk [kWh/rok]
  • Produktywność [kWh/kWp/rok]
  • Roczne oszczędności [PLN]
  • Okres zwrotu [lata]
  • Wykres produkcji miesięcznej
Typowe uzyski w Polsce: Warszawa ~1050, Kraków ~1030, Gdańsk ~1000 kWh/kWp/rok.
Azymut: Podaj wartość w konwencji PVGIS: 0° = południe, -90° = wschód, 90° = zachód. Nie jest to konwencja kompasowa.

Wyniki można zapisać do projektu lub udostępnić jako tekst.

Kalkulator elektryczny DC/AC
Dobór kabli, zabezpieczeń i konfiguracja stringów wg IEC 60364-7-712.

Strona DC — konfiguracja stringów:

  • Liczba modułów w stringu i liczba stringów
  • Voc, współczynnik temperaturowy Voc [%/°C], Isc, Imp modułu
  • Max. napięcie DC falownika [V], max. prąd MPPT [A]
  • Min. temperatura otoczenia [°C]

Sprawdzenie: Voc stringu w najniższej temperaturze vs. max. napięcie falownika.

Dobór kabli DC:

  • Długość kabla (jednokierunkowa) [m]
  • Spadek napięcia ≤ 1% (norma)
  • Rezystywność miedzi (20°C): ρ = 0.0175 Ω·mm²/m

Strona AC:

  • Moc AC falownika [W], długość kabla AC [m]
  • Opcja: 3-fazowy (400V)
  • Dobór przekroju kabla AC i spadku napięcia

Rekomendacje zabezpieczeń:

StronaZabezpieczenie
DCBezpiecznik stringowy, rozłącznik DC, SPD DC
ACMCB (nadprądowy), RCD, SPD AC
Wynik: ZGODNY / NIEZGODNY z oznaczeniem wg jakich kryteriów.
Sprawdzanie zgodności MÓJ PRĄD 6.0
Weryfikacja wymogów programu Mój Prąd 6.0.

Wymagania sprawdzane:

WymaganieWarunek
Moc PV≤ 20 kWp
Pojemność BESS≥ 2 kWh i ≥ 1.5 × moc PV
Koszt BESS≤ 6 000 PLN/kWh
Net-billingAktywne rozliczenie

Dane wejściowe:

  • Moc szczytowa PV [kWp]
  • Pojemność magazynu energii [kWh]
  • Całkowity koszt magazynu [PLN]
  • Czy net-billing jest aktywny

Maksymalne dotacje w programie:

KomponentKwota
Instalacja PVdo 6 000 PLN
Magazyn energiido 16 000 PLN
HEMS/EMSdo 3 000 PLN
Ładowarka EVdo 5 000 PLN
Pompa ciepła CWUdo 4 400 PLN
Pompa ciepła CO+CWUdo 28 500 PLN

Wynik: ZGODNY lub NIEZGODNY z listą spełnionych i niespełnionych wymagań.


// protokoły odbioru

📄 Kreator protokołu (5 kroków) PN-EN 62446-1
Generator protokołu odbioru instalacji PV zgodnie z PN-EN 62446-1.
1
Dane ogólne — dane inwestora (imię, adres, telefon), dane wykonawcy (imię, nr SEP), adres instalacji, data montażu
2
Specyfikacja systemu — model i moc modułów PV, numery seryjne, falownik (model, S/N, moc), magazyn energii (opcja)
3
Pomiary elektryczne — napięcie Voc i prąd Isc stringu, wynik testu RCD (zaliczony / niezaliczony)
4
Lista kontrolna — 8 punktów do odhaczenia: montaż mechaniczny, trasa kabli DC, podłączenia AC, konfiguracja falownika, uziemienie, zabezpieczenia DC/AC, licznik
5
Zdjęcia i podpisy — dokumentacja fotograficzna (aparat / galeria), podpis cyfrowy instalatora i inwestora
PDF generowany jest lokalnie w < 3 sekundy. Plik pozostaje na urządzeniu — nie jest wysyłany do chmury.
🗃 Archiwum protokołów
  • Lista wszystkich protokołów posortowana od najnowszego
  • Podgląd: inwestor, adres, data, status (Wersja robocza / Ukończony)
  • Otwórz i udostępnij PDF
  • Usuń protokół (przytrzymaj)
  • Synchronizacja z chmurą (dla zalogowanych użytkowników)

// zarządzanie projektami

💼 Projekty (mini CRM) PRO
Zarządzanie projektami od zapytania klienta do zamknięcia.

Statusy projektu:

StatusOpis
ZapytanieNowy kontakt od klienta
OfertaPrzygotowanie oferty
MontażW trakcie instalacji
OdbiórProtokół i uruchomienie
DokumentacjaKompletowanie dokumentów
ZamkniętyProjekt zakończony

Dane projektu:

  • Dane klienta: imię, telefon, email
  • Status projektu z menu rozwijnego
  • Termin instalacji (kalendarz + czas)
  • Notatki tekstowe
  • Powiązanie z obliczeniami PVGIS
Projekty z ustawionym terminem instalacji pojawiają się automatycznie w kalendarzu na dashboardzie.
📅 Kalendarz instalacji
  • Widok miesięczny z wyróżnionymi dniami instalacji
  • Kliknij dzień aby zobaczyć zaplanowane projekty
  • Dostępny z dashboardu i z zakładki "Więcej"
📋 Dokumenty i historia zmian
Dokumenty:
  • Organizacja wg typu: Protokoły, Zdjęcia, Faktury, Inne
  • Filtrowanie chipami
  • Otwieranie plików systemowym podglądem
Historia zmian (audit log):
  • Chronologiczny rejestr wszystkich modyfikacji
  • Śledzenie zmian w projektach, protokołach, obliczeniach
  • Synchronizacja z Firestore dla zalogowanych

// ustawienia i konto

Ustawienia
Profil firmy:
  • Nazwa firmy, NIP, numer certyfikatu SEP
  • Dane wykorzystywane w generowanych protokołach
Motyw aplikacji:
  • Systemowy (domyślny — podąża za ustawieniami urządzenia)
  • Jasny
  • Ciemny
Eksport danych (RODO):
  • Eksport danych klientów do pliku CSV
  • Zgodne z wymogami GDPR/RODO
Zarządzanie kontem:
  • Wylogowanie
  • Usunięcie konta — trwałe usunięcie wszystkich danych (Firebase + lokalne)
Usunięcie konta jest nieodwracalne. Wszystkie dane w chmurze i na urządzeniu zostaną usunięte.
🔒 Synchronizacja i dane
Tryb offline-first:

Wszystkie dane zapisywane są lokalnie w zaszyfrowanej bazie (Room + SQLCipher). Dla zalogowanych użytkowników dane synchronizują się automatycznie z chmurą Firebase.

TrybLokalnieChmura
Email / Google
Anonimowy
Protokoły PDF przechowywane są wyłącznie na urządzeniu — nie są wysyłane do chmury.
Subskrypcja i trial
Model dostępu:
  • Trial 7 dni — aktywowany automatycznie po pierwszym zalogowaniu. Pełny dostęp do wszystkich funkcji.
  • Subskrypcja 9,99 PLN/tydzień — po zakończeniu triala. Rozliczana przez Google Play.
Co obejmuje pełny dostęp:
  • Nieograniczone projekty i protokoły
  • Generowanie PDF
  • Wszystkie kalkulatory
  • Synchronizacja z chmurą
  • Tryb offline
Przywracanie zakupu:

Przy reinstalacji aplikacja automatycznie sprawdza aktywne subskrypcje w Google Play i przywraca dostęp.

Zarządzanie subskrypcją:

Anulowanie, zmiana metody płatności — przez Google Play Store > Subskrypcje.


// typowe scenariusze użycia

A Nowy projekt od zapytania do odbioru
1
Pulpit > Nowy projekt > wpisz dane klienta, ustaw status "Zapytanie"
2
Kalkulatory > PVGIS > oblicz uzysk, zapisz do projektu
3
Kalkulatory > Elektryczny > dobierz kable i zabezpieczenia
4
Kalkulatory > Zgodność > sprawdź wymagania Mój Prąd 6.0
5
Zmień status projektu na "Montaż", ustaw termin instalacji
6
Na miejscu: Protokoły > Nowy protokół > 5 kroków > podpisy > PDF
7
Zamknij projekt — status "Zamknięty"
B Szybki protokół w terenie
1
Otwórz aplikację (działa offline)
2
Protokoły > Nowy protokół
3
Wypełnij 5 kroków, zrób zdjęcia, zbierz podpisy
4
PDF wygenerowany — udostępnij emailem bezpośrednio z telefonu
Cały proces zajmuje kilka minut. PDF generowany jest na urządzeniu bez połączenia z internetem.

// FAQ

Czy aplikacja działa offline?
Tak. Wszystkie kalkulatory, protokoły i projekty działają w pełni offline. Dane zapisywane są w zaszyfrowanej lokalnej bazie danych. Synchronizacja z chmurą następuje automatycznie po połączeniu z internetem (dla zalogowanych użytkowników).
Czy mogę używać bez konta?
Tak — tryb demo ("Pomiń logowanie") pozwala korzystać z kalkulatorów i przeglądać interfejs. Aby zapisywać projekty, generować protokoły PDF i synchronizować dane, wymagane jest konto (email lub Google).
Co się stanie po zakończeniu triala?
Po 7 dniach triala aplikacja wyświetli ekran subskrypcji. Dotychczasowe dane nie zostaną usunięte. Aby kontynuować korzystanie z pełnych funkcji, wymagana jest subskrypcja 9,99 PLN/tydzień. Zarządzanie subskrypcją odbywa się przez Google Play Store.
Jak usunąć swoje dane (RODO)?
Eksport danych: Więcej > Ustawienia > Eksport danych (RODO) > plik CSV z danymi klientów.

Usunięcie konta: Więcej > Ustawienia > Usuń konto. Wszystkie dane w chmurze i na urządzeniu zostaną trwale usunięte. Operacja jest nieodwracalna.
Skąd pochodzą dane PVGIS?
Dane o nasłonecznieniu i uzysku energii pobierane są z bazy PVGIS (Photovoltaic Geographical Information System) prowadzonej przez Joint Research Centre Komisji Europejskiej. Baza zawiera dane satelitarne i meteorologiczne z wieloletnich pomiarów.
Na jakich normach oparte są obliczenia?
  • IEC 60364-7-712 — instalacje PV, dobór kabli i zabezpieczeń
  • PN-EN 62446-1 — protokół odbioru instalacji PV
  • PN-EN 62305 — ochrona odgromowa (SPD)
  • Mój Prąd 6.0 — regulamin programu dotacyjnego NFOŚiGW
Jak skontaktować się z supportem?
Email: support@echosignal-dev.com

Zgłaszanie błędów i sugestii: github.com/echo-signal

// linki

wersja: 1.0 · Android