HIGI · raport dla zespołu

Gabinety, maile, NIP i weryfikacja kont — co przygotowaliśmy

Stan na 23 czerwca 2026 · gałąź robocza be/gabinet-org-login

✓ gotowe i na wersji testowej ↻ gotowe w kodzie, jeszcze nie na testowej ⏳ czeka na decyzję/konfigurację

1. Co dodajemy — w skrócie

Do tej pory HIGI miało logowanie i pojedyncze konta. Ta paczka dodaje gabinety z zespołem, maile od HIGI oraz zabezpieczenia przed zakładaniem wielu kont po to, żeby mieć usługę za darmo bez końca.

2. Gabinety — konto dla całego zespołu

Założenie gabinetu na dev

Właściciel podaje nazwę gabinetu, liczbę higienistek (miejsc) i NIP. System tworzy konto gabinetu z bezpłatnym okresem próbnym i wpuszcza właściciela do aplikacji. Dostęp obejmuje cały zespół. Adres: /zaloz-gabinet.

Zapraszanie higienistek i zarządzanie zespołem na dev

Tylko właściciel zarządza zespołem — nie da się podszyć pod cudzy gabinet (sprawdzane po stronie serwera). Adresy: /gabinet, /akceptuj-zaproszenie.

Panel super-admina: darmowe miesiące na dev

Ustawiasz, ile darmowych miesięcy dostaje gabinet — globalnie oraz indywidualnie dla konkretnego gabinetu (przedłużenie lub zakończenie). Adres: /admin/gabinety.

3. Maile od HIGI

Silnik wysyłki + przypomnienia o końcu okresu w kodzie

HIGI potrafi wysyłać maile przez usługę Resend. Codziennie rano sprawdza, komu darmowy okres kończy się za 7, 3 i 1 dzień i wysyła przypomnienie.

Panel super-admina: treść maili na dev

Edytujesz treść maili (temat, HTML, tekst) i oglądasz podgląd — bez programisty. Adres: /admin/maile.

Żeby maile realnie wychodziły, potrzebne będzie konto Resend + domena wysyłkowa (np. mail.higi.com.pl) — osobny krok, jeszcze nierobiony.

4. Zabezpieczenie przed nadużyciem darmowego okresu

Problem: ktoś mógłby zakładać konto za kontem na kolejne adresy e-mail, żeby ciągle mieć HIGI za darmo. Rozwiązanie zależy od rodzaju konta.

Gabinet → NIP na dev

Z researchu: „biała lista VAT" odpadła jako weryfikacja — gabinety stomatologiczne (usługi medyczne) są zwolnione z VAT i tam nie figurują.

Higienistka solo → numer telefonu w kodzie czeka na Clerk

5. Zmiany w bazie danych

Cztery nowe „migracje", wszystkie wyłącznie dodające (nic nie kasują):

6. Prywatność / RODO

Bo zbieramy NIP (a dla jednoosobowej działalności NIP to dana osobowa), przygotowałem szkic dokumentu prawnego: informację dla użytkownika i uzasadnienie podstawy. Wymaga przeglądu przez prawnika/IOD przed wejściem na produkcję (są w nim miejsca do uzupełnienia danymi firmy).

7. Przegląd jakości i bezpieczeństwa — co poprawiłem

Przed wystawieniem paczki do scalenia zrobiłem dokładny przegląd całego kodu (wielu niezależnych recenzentów + osobna weryfikacja każdego znaleziska). Z 36 zgłoszeń realnych było 10. Siedem naprawiłem, jedno zostawiłem świadomie.

Ważniejsze (naprawione)

1Maile mogły wyjść z wersji testowej do prawdziwych higienistek. Bezpiecznik działał odwrotnie niż powinien. Naprawione: na wersji testowej, bez jawnej listy dozwolonych adresów, nic nie wychodzi.

2Dało się obejść „jeden NIP = jeden darmowy okres" przy dwóch zgłoszeniach w tej samej chwili. Naprawione: zakładanie konta jest teraz jedną niepodzielną operacją — przy kolizji NIP konto w ogóle nie powstaje, a nadmiarowy wpis jest sprzątany.

Drobne (naprawione)

Dziura w czyszczeniu treści maila (niezamknięty kawałek kodu na końcu), przerywanie całej wysyłki po jednym błędzie, powtórzony kod, walidacja adresu e-mail, oraz przycisk „Podgląd", który po cichu zapisywał treść maila — teraz podgląd niczego nie zapisuje.

Zostawione (1, świadomie)

Administrator nadany przez panel nie jest jeszcze rozpoznawany jako super-admin w trzech miejscach. To „za mało uprawnień", nie dziura bezpieczeństwa; porządna naprawa to osobny temat (zapisany jako zadanie na potem).

Sprawdzone: typy zgadzają się we wszystkich częściach projektu, testy działania przeszły.

8. Gdzie to jest teraz

PROD
Produkcja (higi.com.pl): nietknięta. Żadna z tych zmian tam nie weszła.
DEV
Wersja testowa: działają gabinety, panele i NIP — w wersji sprzed poprawek z punktu 7 (poprawki dotyczą sytuacji brzegowych, zwykłe klikanie wygląda tak samo).
KOD
Poprawki z przeglądu + weryfikacja solo: gotowe w kodzie, jeszcze nie na dev.
PR
Cała gałąź niezatwierdzona (brak „pull requesta") — scalenie i produkcja na Twoje słowo.

9. Co czeka na decyzję / na Ciebie

  1. Wgranie poprawionej wersji na dev — żebyś klikał już na zahartowanej.
  2. Konfiguracja telefonu w Clerk — odblokowuje weryfikację higienistek solo (~5–10 min).
  3. Prawnik/IOD — zatwierdzenie dokumentu RODO przed produkcją.
  4. Formalne bramki — uruchomię /code-review i /security-review, potem „pull request" → scalenie.
  5. Produkcja — dopiero na wyraźne „promuj".

10. Dokumenty na Google Drive (zasada: repozytorium = Drive)

DokumentCo toDo zatwierdzenia
Raport zmian (ten)podsumowanie paczkiwgląd zespołu
Research NIP / weryfikacjajak weryfikować — prawno-techniczniewgląd
Klauzula RODO (NIP)szkic dokumentu prawnegoprzegląd prawnika/IOD
Runbook konfiguracji telefonu (Clerk)instrukcja krok po krokudo wykonania przez Ciebie
Dziennik decyzji (wpis D-33)zapis decyzji NIP + telefonwgląd

Pliki .md wgrane na wspólny dysk HIGI („nasze miejsce higi").