Instrukcja użytkowania FixControl

Instrukcja dla nowych użytkowników — jak skonfigurować firmę w panelu administratora i jak codziennie pracować z usterkami w aplikacji (Windows / Android).

Spis treści

1. Wprowadzenie
2. Rejestracja firmy i logowanie
3. Panel administratora — pierwsze kroki
4. Projekty — jak dodać
5. Obiekty — jak dodać
6. Lokalizacje i rzuty (plany pięter)
7. Typy usterek
8. Wykonawcy i konta wykonawców
9. Role i uprawnienia
10. Użytkownicy (subkonta) i dostęp do obiektów
11. Dodawanie usterki w aplikacji
12. Statusy usterek
13. Praca na planie (rzucie)
14. Eksport i raporty (XLSX / PDF)
15. Moje konto

1. Wprowadzenie

1.1 Co to jest FixControl

FixControl to oprogramowanie dla budownictwa do rejestrowania i kontroli usterek na budowie. Usterki oznacza się na planach (rzutach) obiektów, przypisuje do wykonawców i śledzi ich status — od zgłoszenia, przez naprawę, do potwierdzonego zamknięcia. W praktyce to cyfrowa punch lista połączona z rysunkiem: przydaje się przy bieżącej kontroli jakości robót, odbiorach częściowych i końcowych oraz przeglądach gwarancyjnych.

1.2 Struktura danych — od firmy do usterki

Dane w systemie są zorganizowane hierarchicznie:

Firma
 └─ Projekt (opcjonalnie — grupuje obiekty, np. "Projekt Słoneczny")
     └─ Obiekt (np. "B15")
         └─ Lokalizacja / rzut (np. "0p", "1p", "dach", "M12")
             └─ Usterka

• Firma — Twoja organizacja. Wszystkie dane (obiekty, usterki, użytkownicy) są widoczne tylko dla osób z Twojej firmy.
• Projekt — opcjonalny poziom grupujący obiekty. Jeśli budujesz tylko jeden obiekt lub nie potrzebujesz grupowania, możesz go całkowicie pominąć.
• Obiekt — np. konkretny blok/obiekt na budowie.
• Lokalizacja (rzut) — plan piętra, mieszkania lub innego obszaru, na którym zaznacza się usterki. Każda lokalizacja może mieć wgrany plan (PDF/PNG).
• Usterka — pojedynczy wpis: opis, typ, status, wykonawca, opcjonalne zdjęcie i pozycja na planie.

1.3 Dwa miejsca pracy: aplikacja i panel webowy

• Aplikacja (Windows / Android) — codzienna praca na budowie: dodawanie usterek, oznaczanie ich na planach, zmiana statusów, robienie zdjęć, eksport raportów.
• Panel webowy (https://fixcontrol.pl/app/panel) — konfiguracja firmy: projekty, obiekty, lokalizacje/rzuty, wykonawcy, użytkownicy, role i uprawnienia, dane do faktury.

Większość czynności opisanych w punktach 4–10 wykonuje się w panelu webowym, jako administrator. Punkty 11–12 dotyczą codziennej pracy w aplikacji.

2. Rejestracja firmy i logowanie

2.1 Rejestracja nowej firmy (panel webowy)

1. Wejdź na https://fixcontrol.pl/app/register.
2. Wypełnij pola:
3. Nazwa firmy
4. E-mail i Powtórz e-mail (muszą być identyczne)
5. Twoja nazwa (np. „Jan Kowalski") — to będzie login administratora
6. Hasło i Powtórz hasło
7. Zaznacz oba checkboxy: akceptację Regulaminu serwisu i zapoznanie się z Polityką prywatności.
8. Kliknij „Zarejestruj firmę".

Po rejestracji konto firmy startuje z okresem próbnym — informacja o liczbie dni i pakietów próbnych jest widoczna na stronie rejestracji i cennika.

2.2 Logowanie do panelu webowego

1. Wejdź na https://fixcontrol.pl/app/login.
2. Wpisz E-mail i Hasło, kliknij „Zaloguj się".
3. Administrator trafia na /app/panel, pozostali użytkownicy — na /app/konto.

Link „Nie pamiętasz hasła?" prowadzi do resetu hasła. Link „Nowa firma?" prowadzi do rejestracji.

2.3 Logowanie w aplikacji (Windows / Android)

1. Otwórz aplikację FixControl.
2. W polu „Email lub login" wpisz:
3. swój e-mail (administrator / subkonto), albo
4. login — w przypadku kont wykonawców (patrz punkt 8), które nie mają adresu e-mail jako loginu.
5. Wpisz Hasło i kliknij „Zaloguj się".

Adres serwera jest wbudowany w aplikację — nie trzeba go konfigurować.

3. Panel administratora — pierwsze kroki

Po zalogowaniu jako administrator panel (/app/panel) ma menu boczne z zakładkami:

Większość formularzy zapisuje się automatycznie — po wpisaniu wartości i naciśnięciu Enter / kliknięciu poza pole (np. zmiana nazwy, dropdown roli, checkboxy obiektów). Tam, gdzie to dotyczy, krótki komunikat potwierdzenia pojawia się obok pola na 3 sekundy — strona się nie przeładowuje.

Jeśli zalogujesz się jako subkonto (nie administrator), zobaczysz tylko zakładkę Moje konto (/app/konto) — patrz punkt 15.

Limity planu: jeśli pojawi się komunikat o przekroczeniu limitu (np. liczby rzutów, usterek, kont wykonawców czy subkont), dodawanie nowych danych danego typu jest zablokowane do momentu zwiększenia planu (zakładka „Subskrypcje" → „Cennik / zmień plan").

3.1 Zakładka „Subskrypcje"

Zakładka „Subskrypcje" pokazuje aktualny status abonamentu firmy i zużycie limitów planu:

• Status abonamentu — w zależności od tego, co jest aktywne, widoczna jest jedna lub kilka sekcji: pakiet próbny (z datą ważności), pakiet bonusowy, oraz aktywna subskrypcja (Stripe lub P24) z liczbą wykupionych pakietów. Dla subskrypcji odnawianej automatycznie (Stripe) widoczna jest też data następnego odnowienia.
• „Zarządzaj subskrypcją" — link do panelu Stripe (zmiana karty, anulowanie).
• „Cennik / zmień plan" — link do cennika, gdzie można wykupić lub zmienić pakiet.
• „Wykorzystanie limitów planu" — pasek postępu dla każdego limitu (rzuty, usterki, subkonta, konta wykonawców, konta administratorów): aktualna liczba / limit. Pasek zmienia kolor na żółty przy zbliżaniu się do limitu (≥90%) i na czerwony po jego przekroczeniu.

4. Projekty — jak dodać

Projekt to opcjonalny poziom grupujący obiekty (np. gdy budujesz kilka obiektów w ramach jednej inwestycji). Jeśli go nie potrzebujesz — pomiń ten punkt, obiekty bez projektu działają normalnie.

1. W panelu przejdź do zakładki „Obiekty i przypisanie projektów".
2. W sekcji „Projekty" kliknij „Dodaj".
3. Wypełnij:
4. Nazwa skrócona — wymagana, krótka nazwa używana w listach i nazwach plików raportów
5. Nazwa pełna — opcjonalna, pełna nazwa inwestycji (np. „Projekt Słoneczne Wzgórze")
6. Zapisz formularz.

Nowo dodany projekt pojawi się na liście jako etykieta z ikoną ✏ — kliknięcie jej otwiera formularz zmiany nazwy (te same dwa pola, przycisk „Zapisz").

5. Obiekty — jak dodać

1. W panelu przejdź do zakładki „Obiekty i przypisanie projektów".
2. W sekcji „Obiekty" kliknij „Dodaj".
3. Wypełnij:
4. Obiekt — nazwa obiektu (np. „B15")
5. Projekt — opcjonalny dropdown; wybierz projekt albo zostaw „— bez projektu —"
6. Kliknij „Dodaj".

Nowy obiekt pojawia się w tabeli obiektów:

• Projekt — dropdown przypisania projektu, zapisuje się automatycznie po zmianie.
• „Archiwum" — przenosi obiekt do archiwum (obiekt przestaje być widoczny w bieżącej pracy, ale dane nie są usuwane; archiwalne obiekty są wyszarzone, oznaczone „arch."). Przycisk „Przywróć" w archiwum cofa tę operację.
• „Usuń" — trwale usuwa obiekt razem z jego lokalizacjami, usterkami, historią usterek i uprawnieniami do tego obiektu. Jeśli obiekt ma jakiekolwiek usterki, panel ostrzeże o tym przed usunięciem — operacji nie można cofnąć.

Po dodaniu obiektu przejdź do punktu 6, aby dodać lokalizacje (piętra/mieszkania) i wgrać dla nich plany.

6. Lokalizacje i rzuty (plany pięter)

Lokalizacja to pojedyncze piętro, mieszkanie albo inny obszar obiektu, na którego planie („rzucie") oznacza się usterki.

6.1 Dodawanie lokalizacji w panelu

1. W panelu przejdź do zakładki „Rysunki / lokalizacje".
2. Kliknij „Dodaj" — pojawi się formularz dodawania wierszy.
3. Dla każdej lokalizacji wypełnij wiersz:
4. Projekt (jeśli firma ma projekty) — filtruje listę obiektów do wyboru
5. Obiekt — wybierz z listy
6. Nazwa — krótka nazwa/slug, np. 0p, 1p, dach, m12
7. Rodzaj rzutu — patrz punkt 6.2
8. Numer kondygnacji — widoczny tylko gdy rodzaj = „Kondygnacja"
9. Rzut (opcjonalnie) — można od razu upuścić lub wybrać plik PDF/PNG z planem
10. Kliknij „+ Dodaj wiersz", aby dodać kolejną lokalizację w tym samym formularzu (przyda się przy konfigurowaniu wielu pięter na raz).
11. Na końcu kliknij „Dodaj wszystkie".

6.2 Rodzaj rzutu i poziom kondygnacji

Każda lokalizacja ma przypisany rodzaj rzutu, który decyduje o sposobie sortowania na listach, w raportach PDF i na rzucie:

Dla rodzaju „Kondygnacja" pole „Numer kondygnacji" (poziom) akceptuje: - liczby całkowite: -1, 0, 1, 2, … - połówki pięter: 1,5 lub 1.5 - słowo „parter" — odpowiada poziomowi 0 - słowo „dach" — zawsze sortowany jako ostatni, niezależnie od numeracji pięter

Kondygnacje są sortowane wszędzie (na liście, na rzucie, w PDF) rosnąco wg poziomu, a „dach" zawsze na końcu. Mieszkania i „Pozostałe" sortowane są alfabetycznie po nazwie.

Rodzaj i poziom można zmienić w każdej chwili w tabeli lokalizacji (kolumna „Rodzaj rzutu") — zmiana zapisuje się automatycznie po wybraniu z listy / opuszczeniu pola.

6.3 Wgrywanie / zmiana planu (rzutu) w panelu

Jeśli lokalizacja nie ma jeszcze wgranego planu (kolumna „Rzut" pokazuje „Brak"):

1. Kliknij „↑ Wgraj / Zmień" przy danej lokalizacji.
2. Wybierz plik PDF lub PNG z planem piętra/mieszkania.

Plan zostaje przekonwertowany automatycznie (PDF → PNG, maks. 2048 px). Po wgraniu kolumna „Rzut" pokazuje „Wgrany". Aby zastąpić istniejący plan nowym, użyj tego samego przycisku ponownie. Przycisk „✕" usuwa wgrany plan z lokalizacji (z potwierdzeniem).

6.4 Dodawanie / edycja lokalizacji i planów z aplikacji

Plan można dodać/zamienić bezpośrednio z aplikacji, bez wchodzenia do panelu web — jedno okno „Dodaj/edytuj lokalizację" pozwala zarządzać całą hierarchią Projekt → Obiekt → Lokalizacja oraz plikami rzutów, w formie tabeli z edycją na miejscu.

Jak otworzyć okno:

• Kliknij ikonę ☰ (Menu) w lewym górnym rogu ekranu Dashboard lub Rzut, a następnie wybierz „Dodaj/edytuj lokalizację".
• Jeśli aktualna lokalizacja nie ma jeszcze wgranego planu, ekran rzutu pokazuje komunikat „Brak wgranego rzutu" z przyciskiem „Dodaj/edytuj lokalizację", który otwiera to samo okno od razu przewinięte do właściwego wiersza.

Widok tabeli ma kolumny Projekt / Obiekt / Lokalizacja / Typ / Plik, jeden wiersz na lokalizację (obiekty bez lokalizacji i projekty bez obiektów pokazują wiersz-placeholder z przyciskiem dodania kolejnego poziomu hierarchii).

Dodawanie nowych pozycji — przyciski „+ Dodaj" nad nagłówkami kolumn:

• nad Projekt (tylko administrator) — mini-okno z nazwą nowego projektu;
• nad Obiekt (tylko administrator) — mini-okno z wyborem projektu (opcjonalnie) i nazwą nowego obiektu;
• nad Lokalizacja (dowolna rola), albo bezpośrednio przy wybranym obiekcie w wierszu-placeholderze — pełne okno „Nowa lokalizacja": wybór Projektu/Obiektu, nazwa, rodzaj rzutu (patrz punkt 6.2), poziom (dla kondygnacji) oraz opcjonalnie od razu plik PDF lub PNG z planem.

Edycja istniejących wpisów — zapis jest automatyczny, bez osobnego przycisku „Zapisz":

• Zmiana nazwy — kliknij nazwę w komórce Projektu/Obiektu (tylko administrator) lub Lokalizacji (dowolna rola), wpisz nową wartość i zatwierdź Enterem albo kliknięciem gdzie indziej.
• Zmiana typu/poziomu — kliknij komórkę w kolumnie Typ, wybierz rodzaj rzutu i (dla kondygnacji) poziom, kliknij „Zapisz".
• Plik rzutu — kliknij komórkę w kolumnie Plik:
• gdy lokalizacja nie ma jeszcze planu („Dodaj") — od razu otwiera się wybór pliku;
• gdy plan już jest („Edytuj") — pojawia się menu „Zamień plik" albo „Usuń plik rzutu" (usunięcie wymaga potwierdzenia).

Plan zostaje przekonwertowany automatycznie (PDF → PNG, maks. 2048 px). Błędy (np. zajęta nazwa, brak uprawnień) pokazują się na czerwono pod edytowanym polem albo jako baner w górnej części okna. Okno zamyka się przyciskiem ✕ — wszystkie zmiany wprowadzone w trakcie są już zapisane.

7. Typy usterek

Typy usterek to lista kategorii do wyboru w formularzu usterki (np. „Realizacja", „Odbiorowa"). Każda firma ma własną listę.

1. W panelu przejdź do zakładki „Typy usterek".
2. Aby dodać nowy typ: kliknij „Dodaj", wpisz nazwę, zatwierdź.
3. Aby zmienić nazwę istniejącego typu: kliknij ✏ przy typie, zmień tekst, kliknij „Zapisz".
4. Aby usunąć typ: kliknij „×" przy typie (z potwierdzeniem).

Musi pozostać co najmniej jeden typ usterki — ostatniego typu nie można usunąć.

Nowe firmy startują z domyślnymi typami „Realizacja" i „Odbiorowa". Lista typów jest automatycznie pobierana przez aplikację przy starcie i widoczna w formularzu usterki.

8. Wykonawcy i konta wykonawców

8.1 Co to jest „wykonawca"

Wykonawca to firma, podwykonawca albo brygada odpowiedzialna za naprawę usterek (np. „Elektryk Kowalski", „Firma XYZ — hydraulika"). Każda usterka może mieć przypisanego wykonawcę — ułatwia to filtrowanie usterek i generowanie raportów per wykonawca.

8.2 Dodawanie wykonawcy w panelu

1. W panelu przejdź do zakładki „Wykonawcy".
2. Kliknij „Dodaj".
3. Wypełnij:
4. Nazwa — wymagana
5. E-mail — opcjonalny (patrz niżej, do czego służy)
6. Kliknij „Dodaj".

Nazwę i e-mail można edytować bezpośrednio w tabeli (zapis automatyczny po opuszczeniu pola). Przycisk „Usuń" usuwa wykonawcę — jeśli ma przypisane usterki, panel pokaże ostrzeżenie ile usterek zostanie odpiętych (usterki nie są usuwane, tylko traci się przypisanie do wykonawcy).

8.3 Konto użytkownika-wykonawcy („naprawiający")

Jeśli wykonawca ma podany e-mail, system może dla niego utworzyć konto logowania do aplikacji z rolą „naprawiający" — żeby mógł sam zmieniać status swoich usterek (np. oznaczać „Wykonano") bez dostępu do pełnego panelu.

Jak utworzyć konto wykonawcy:

1. W tabeli „Wykonawcy" w panelu, jeśli dany wykonawca nie ma jeszcze konta, w kolumnie „Login" widoczny jest przycisk „Dodaj konto".
2. Kliknij go — konto zostaje utworzone automatycznie:
3. Login = nazwa-firmy-wykonawca-nazwa (wygenerowany automatycznie, bez podkreślników)
4. Hasło tymczasowe generowane automatycznie
5. Wykonawca otrzymuje e-mail powitalny z loginem, hasłem tymczasowym, linkiem do pobrania aplikacji i informacją o konieczności zmiany hasła
6. Login można później zmienić bezpośrednio w tabeli (pole edytowalne, zapis automatyczny).

Bez podanego e-maila przycisk „Dodaj konto" nie zadziała — e-mail jest potrzebny tylko do wysłania danych logowania, nie jest używany do logowania (logowanie odbywa się przez login, nie przez e-mail).

Co widzi konto wykonawcy po zalogowaniu:

• Domyślna rola „naprawiający" ma uprawnienia: widok usterek, zmiana statusu na „Wykonano" i „Do poprawy" (patrz punkt 9 — szczegóły uprawnień).
• Nie widzi panelu administratora — tylko /app/konto (zmiana hasła, ewentualnie zmiana nazw przypisanych lokalizacji/wykonawców, jeśli ma do nich dostęp).
• Widoczność obiektów zależy od przypisanych uprawnień (patrz punkt 10) — domyślnie nowe konto wykonawcy nie ma przypisanych obiektów i należy to skonfigurować ręcznie w tabeli użytkowników.

8.4 Dodawanie wykonawcy „w locie" z aplikacji

Podczas dodawania/edycji usterki w aplikacji, jeśli potrzebnego wykonawcy nie ma na liście:

1. W formularzu usterki, przy polu „Wykonawca", kliknij „+".
2. Wpisz nazwę nowego wykonawcy i opcjonalnie „Email wykonawcy (opcjonalny)".
3. Kliknij „Dodaj" — wykonawca zostaje utworzony natychmiast (i konto „naprawiającego", jeśli podano e-mail — patrz wyżej) i automatycznie wybrany w formularzu.

Jeśli wpisana nazwa jest bardzo podobna do istniejącego wykonawcy, aplikacja pokaże ostrzeżenie o możliwym duplikacie i poprosi o potwierdzenie.

9. Role i uprawnienia

9.1 Wbudowane role

Każda firma ma domyślnie trzy role (oprócz roli admin, która ma zawsze wszystkie uprawnienia i nie wymaga konfiguracji):

9.2 Co oznaczają poszczególne uprawnienia

Szczegółowy przepływ statusów i przycisków — patrz punkt 12.

9.3 Tworzenie własnej roli

1. W panelu przejdź do zakładki „Użytkownicy firmy".
2. W sekcji „Role i uprawnienia" kliknij „Dodaj".
3. Wpisz nazwę roli i zaznacz checkboxy odpowiednich uprawnień (Widok, Dodawanie, Naprawa, Cofnięcie naprawy, Zakończ).
4. Kliknij „Dodaj".

Nowa rola pojawi się jako kolejny wiersz w tabeli ról i będzie dostępna do wyboru przy dodawaniu/edycji użytkowników.

9.4 Zmiana uprawnień roli

W tabeli ról każda kombinacja rola/uprawnienie to checkbox — zaznaczenie lub odznaczenie zapisuje zmianę automatycznie.

• Rola „admin" nie ma wiersza w tej tabeli — jest chroniona i ma wszystkie uprawnienia zawsze.
• Rolę można usunąć przyciskiem „Usuń" (z potwierdzeniem), o ile nie jest aktualnie przypisana do żadnego użytkownika.

10. Użytkownicy (subkonta) i dostęp do obiektów

10.1 Dodawanie nowego użytkownika

1. W panelu przejdź do zakładki „Użytkownicy firmy".
2. Kliknij „+ Dodaj użytkownika" — otworzy się okno.
3. Wypełnij:
4. Adres e-mail — będzie loginem do panelu i aplikacji
5. Imię i nazwisko
6. Hasło tymczasowe i Powtórz hasło (min. 6 znaków)
7. Rola — wybierz z listy ról firmy albo „Administrator"
8. W sekcji „Obiekty (subkonto)" zaznacz obiekty, do których użytkownik ma mieć dostęp. Obiekty są pogrupowane wg projektu — przycisk „cały projekt" zaznacza jednym kliknięciem wszystkie obiekty danego projektu.
9. Kliknij „Dodaj i wyślij e-mail".

Użytkownik otrzyma e-mail z danymi do logowania i prośbą o zmianę hasła.

Dostęp do obiektów nie dotyczy roli „Administrator" — admin widzi wszystkie obiekty firmy. Dla pozostałych ról: brak zaznaczonych obiektów = brak dostępu do żadnych usterek/rzutów.

10.2 Zmiana roli i dostępu istniejącego użytkownika

W tabeli „Użytkownicy firmy":

• Rola — dropdown przy każdym nieadministratorze; zmiana zapisuje się automatycznie. Admin nie może zmienić roli innego admina ani swojej własnej.
• Obiekty (subkonto) — checkboxy obiektów (z grupowaniem wg projektu i przyciskiem „cały projekt"); zmiana zapisuje się automatycznie chwilę po ostatnim kliknięciu.
• Status — wskazuje, czy konto jest aktywne.
• „Dezaktywuj" / „Aktywuj" — blokuje/odblokowuje logowanie bez usuwania konta.
• „Usuń" — trwale usuwa konto (z potwierdzeniem).

10.3 Prośba o dostęp (dla subkonta)

Jeśli zalogowany użytkownik (subkonto) nie ma dostępu do wszystkich potrzebnych obiektów, może sam poprosić o dostęp:

1. Wejdź na /app/konto.
2. W sekcji „Dostęp do obiektów" zobaczysz listę obiektów, do których już masz dostęp (zielone etykiety).
3. Jeśli są obiekty bez dostępu, pojawi się sekcja „Poproś o dostęp" z listą checkboxów — zaznacz potrzebne obiekty.
4. Kliknij „Wyślij prośbę".

Na adresy e-mail wszystkich aktywnych administratorów firmy (którzy mają ustawiony e-mail) zostanie wysłana wiadomość z prośbą. Brak powiadomienia w aplikacji — administrator musi samodzielnie nadać dostęp w panelu (punkt 10.2).

11. Dodawanie usterki w aplikacji

11.1 Z ekranu głównego (Dashboard)

1. Na ekranie głównym kliknij przycisk „Dodaj" (prawy dolny róg, ikona „+").
2. Wybierz Lokalizację — pole to działa niezależnie od Projektu/Obiektu (nie trzeba najpierw wybrać obiektu, żeby wybrać lokalizację); po wyborze Projekt/Obiekt uzupełniają się automatycznie w formularzu.
3. (opcjonalnie) Kliknij „Zaznacz na rysunku", aby od razu wskazać dokładne miejsce usterki na planie wybranej lokalizacji — otworzy się podgląd planu, na którym klikasz właściwy punkt i zatwierdzasz „Zapisz". Bez tego kroku usterka trafia do panelu „Bez lokalizacji" na ekranie rzutu i można ją później przeciągnąć na plan ręcznie (patrz punkt 13).
4. Wypełnij pozostałe pola formularza (patrz punkt 11.3).
5. Kliknij „Zapisz".

Jeśli potrzebnej lokalizacji jeszcze nie ma na liście, po wybraniu Obiektu pojawia się rozwijany blok „Nowa lokalizacja" — pozwala od razu utworzyć nową lokalizację (nazwa, rodzaj rzutu, opcjonalnie poziom kondygnacji i plik PDF/PNG z planem) bez wychodzenia z formularza usterki. Nowa lokalizacja od razu jest dostępna do wyboru w tym samym formularzu. Ten blok jest dostępny tylko przy dodawaniu nowej usterki (nie przy edycji istniejącej).

11.2 Z planu (rzutu)

1. Przejdź na ekran „Rzut" dla wybranej lokalizacji.
2. Kliknij w miejsce na planie, gdzie znajduje się usterka — otworzy się formularz nowej usterki z już ustawioną pozycją na planie.
3. Wypełnij formularz i zapisz — usterka pojawi się na planie jako punkt.

Alternatywnie (Windows): można przeciągnąć zdjęcie usterki z Eksploratora plików prosto na plan — formularz otworzy się automatycznie z dołączonym zdjęciem i pozycją w miejscu upuszczenia.

Usterki bez przypisanej pozycji na planie są widoczne w panelu bocznym „Bez lokalizacji" — można je później przeciągnąć na właściwe miejsce na planie.

11.3 Pola formularza usterki

* pola wymagane.

Ważne: jeśli usterka jest już umieszczona na planie (ma pozycję x/y), pole „Opis" jest zablokowane do edycji — można je ustawić tylko przy tworzeniu usterki albo przed umieszczeniem jej na planie. Pozostałe pola (typ, status, wykonawca, zdjęcie, pozycja na planie) można edytować zawsze — pozycję zmienia się przyciskiem „Zmień pozycję na rysunku" pod polem Lokalizacja, bez konieczności przechodzenia na ekran rzutu.

11.4 Dodawanie zdjęcia

W formularzu usterki są dwa niezależne sloty na zdjęcie, obok siebie — np. jedno zdjęcie ogólne i jedno zbliżenie, albo zdjęcie „przed" i „po" naprawie. Każdy slot obsługuje się osobno:

• „Zrób zdjęcie" — otwiera aparat urządzenia.
• „Dodaj z galerii" — wybór istniejącego pliku.
• Jeśli dany slot ma już zdjęcie, przyciski zmieniają się na „Zmień zdjęcie".

Każde zdjęcie jest automatycznie kompresowane przed wysłaniem.

Podgląd zdjęcia — kliknięcie na dowolne wgrane zdjęcie otwiera je w powiększonym oknie podglądu (zamykane przyciskiem ✕ w rogu albo kliknięciem w tło poza zdjęciem).

11.5 Kopiowanie usterki

Gdy kilka usterek na tym samym miejscu/piętrze różni się tylko wykonawcą (np. ta sama usterka zgłoszona do kilku branż), zamiast wypełniać formularz od nowa można skopiować istniejącą pozycję:

1. Otwórz do edycji usterkę, którą chcesz skopiować.
2. W nagłówku okna kliknij ikonę kopiowania (obok ikony historii).
3. Otworzy się formularz nowej usterki z automatycznie wypełnionymi polami: opis, typ, termin, lokalizacja, pozycja na planie oraz zdjęcia (oba sloty, jeśli były ustawione).
4. Pole „Wykonawca" pozostaje puste — trzeba je uzupełnić ręcznie, a status nowej pozycji zawsze zaczyna się od „Otwarte", niezależnie od statusu oryginału.
5. Uzupełnij/zmień, co potrzeba, i kliknij „Zapisz" — nowa usterka pojawi się jako osobny, niezależny wpis (oryginał pozostaje bez zmian).

12. Statusy usterek

12.1 Lista statusów

Kolory na rzucie: Otwarte = pomarańczowy, Wykonane = niebieski, Zakończone = zielony.

12.2 Przepływ zmiany statusu (przyciski)

            [Wykonano]                [Potwierdź wykonanie]
  Otwarte  ───────────▶  Wykonane  ───────────────────────▶  Zakończone
     ▲                       │                                    │
     │      [Do poprawy]     │                                    │
     └───────────────────────┘                                    │
     ▲                                  [Cofnij do otwarte]        │
     └───────────────────────────────────────────────────────────┘

• „Wykonano" (niebieski przycisk) — widoczny dla usterek Otwarte; zmienia status na Wykonane.
• „Do poprawy" (pomarańczowy) — widoczny dla usterek Wykonane; zmienia status z powrotem na Otwarte (np. gdy naprawa była niewystarczająca).
• „Potwierdź wykonanie" (zielony) — widoczny dla usterek Otwarte i Wykonane; zmienia status na Zakończone (np. gdy odbiorca od razu potwierdza, że usterki nie ma/jest naprawiona).
• „Cofnij do otwarte" — widoczny dla usterek Zakończone; przywraca status Otwarte (np. gdy usterka pojawiła się ponownie).

Przyciski statusów są dostępne na ekranie głównym (karta usterki), na rzucie (panel szczegółów) i w formularzu edycji usterki — działają identycznie w każdym miejscu.

12.3 Uprawnienia wymagane do zmiany statusu

Każdy przycisk wymaga odpowiedniego uprawnienia roli użytkownika (patrz punkt 9.2):

Jeśli użytkownik nie ma odpowiedniego uprawnienia, dany przycisk nie jest dostępny.

13. Praca na planie (rzucie)

Ekran „Rzut" pokazuje plan piętra/mieszkania z zaznaczonymi usterkami jako kolorowe punkty (kolor wg statusu — patrz punkt 12.1).

• Filtry (pasek pod górnym menu): Projekt (jeśli firma ma projekty) → Obiekt → Lokalizacja → Wykonawca → Typ → Status. Wybór innej lokalizacji przełącza widok na jej plan.
• Panel „Bez lokalizacji" (prawa strona) — usterki bez ustalonej pozycji na planie; można je przeciągnąć na plan, aby je umieścić. Na desktopie panel można pokazać/ukryć przyciskiem na prawej krawędzi ekranu.
• Kliknięcie na punkt otwiera panel szczegółów usterki — opis, status, wykonawca, zdjęcie, przyciski zmiany statusu, przycisk „Usuń z rzutu" (usterka wraca do panelu „Bez lokalizacji", bez usuwania jej z systemu) oraz przycisk „Historia" (pełna historia zmian usterki).
• Przesuwanie punktu — przytrzymaj i przeciągnij punkt na nowe miejsce. Ostatnie przesunięcie można cofnąć klawiszami Ctrl+Z.
• Upuszczenie zdjęcia z Eksploratora (Windows) na plan — otwiera formularz nowej usterki z dołączonym zdjęciem.

14. Eksport i raporty (XLSX / PDF)

Ekran „Eksport" (dostępny z górnego menu) umożliwia:

• Eksport XLSX — plik z listą usterek (z filtrami), do analiz, zestawień i raportowania poza systemem.
• Generowanie PDF — raport z planami pięter z zaznaczonymi usterkami, tabelami i zdjęciami (np. punch lista dla konkretnego wykonawcy albo zestawienie do kontroli budowy dla inwestora).

Przed generowaniem PDF można skonfigurować:

• Filtry — Projekt, Obiekt, Lokalizacja, Wykonawca, Typ, Status (domyślnie tylko „Otwarte").
• „Osobne pliki raportów" — wg jakiego wymiaru (np. wykonawca) generować osobne pliki PDF.
• „Grupowanie pozycji w obrębie każdego pliku" — wg jakich wymiarów grupować sekcje wewnątrz każdego pliku (domyślnie: obiekt → lokalizacja).

Po wygenerowaniu raportów lista „Wygenerowane raporty" pozwala otworzyć plik, otworzyć folder z plikiem albo przygotować e-mail z raportem jako załącznikiem (z domyślnie wypełnionymi adresami e-mail wykonawców z danego raportu).

15. Moje konto

Strona /app/konto jest dostępna dla wszystkich zalogowanych użytkowników (admin i subkonta) i zawiera:

• Moje konto — login, e-mail, rola (tylko podgląd).
• Zmień hasło — pola „Aktualne hasło", „Nowe hasło", „Powtórz nowe hasło" (min. 6 znaków).
• Dostęp do obiektów (nie-administratorzy) — lista obiektów z dostępem + możliwość „Poproś o dostęp" do pozostałych.
• Wykonawcy — zmiana nazwy (jeśli użytkownik ma dostęp do jakichś wykonawców) — możliwość poprawienia nazwy wykonawcy bez wchodzenia do panelu admina.
• Rysunki / lokalizacje — zmiana nazwy (jeśli użytkownik ma dostęp do obiektów) — zmiana nazwy lokalizacji oraz jej rodzaju rzutu/poziomu (patrz punkt 6.2).

Administrator widzi te same opcje konta dodatkowo w panelu (/app/panel → „Moje konto").