HIGI — raport stanu prac

Audyt z twardych źródeł: co jest na GitHubie, co tylko na dev, a co niezbudowane.

Stan na 2026-06-25 · źródła: GitHub (PR-y i gałęzie), worktree lokalne, wdrożenia Cloudflare. Tylko dev.higi.com.pl — produkcja nietknięta.

Najważniejsze w jednym akapicie. Część prac jest porządnie na GitHubie i w gałęzi głównej (main) — logowanie/admin, edytor ankiety (wersja makietowa), zapis treści dla higienistki solo, fundament treści, menu, środowisko dev. Ale duży blok pracy — gabinety, zaproszenia, panel maili, NIP, oraz dzisiejsza warstwa globalna — jest TYLKO wdrożony na dev i NIE jest wypchnięty na GitHub (zero commitów, zero PR, zero przeglądu). Do tego silnik, który generuje plan pacjenta, wciąż czyta plik Excel, więc żadna edycja w edytorze nie zmienia jeszcze planu pacjenta.

Uczciwie: wcześniej mówiłem „wdrożone na dev" w sposób, który brzmiał jak „zrobione". „Wdrożone na dev" znaczy: działa i można klikać. NIE znaczy: zapisane na GitHubie, przejrzane, bezpieczne. Ten raport rozdziela te dwie rzeczy.

NA GITHUB zmergowane do main (trwałe, przejrzane) TYLKO DEV działa na dev, ale niezacommitowane / poza GitHub NIEZBUDOWANE jeszcze nie istnieje

1. Co JEST na GitHubie (zmergowane do main)

Wszystkie PR-y poniżej są scalone (MERGED) — to trwały, przejrzany stan kodu.

PRCoData
#57Dokumentacja: onboarding gabinetu = automat + darmowe miesiące22.06
#56Zapis treści edytora na serwer — higienistka solo (backend)22.06
#55Edytor ankiety (wersja makietowa) + pełna ankieta Joanny (38 pytań)21.06
#54Wzmocnienie bezpieczeństwa nagłówków + bramka testów21.06
#53Logowanie: admin = pełny dostęp (serwerowo) + token Clerka21.06
#50Wspólne menu na stronach legacy (dev-only)21.06
#51, #52Dokumentacja: przegląd architektury + 7 decyzji + spec backendu szablonów18–21.06
#45, #46Wspólne menu/nawigacja aplikacji (role-aware) + pozycja „Edytor ankiety"14.06
#47, #48, #49Dokumentacja: model wersji szablonu, mapa ekranów, status prawny firma/osoba14.06
#44Środowisko deweloperskie serwera (dev.higi.com.pl/api/*)14.06
#42, #43Fundament „pipeline treści" + publiczne API treści (publikacja/rollback)12.06

Pełna historia: github.com/numerika-ai/higi → gałąź main.

2. ⚠️ Co jest TYLKO na dev — NIE na GitHubie (dług do spłaty)

To jest najważniejsze ostrzeżenie tego raportu

Poniższe prace działają na dev, ale istnieją wyłącznie jako niezacommitowane pliki w katalogach roboczych w /tmp. 0 commitów ponad main, gałęzie NIE wypchnięte na GitHub, brak PR, brak przeglądu kodu i bezpieczeństwa. Jeśli te katalogi zostaną sprzątnięte — praca przepada.

ObszarCo konkretnieStan
Gabinety / organizacjeZakładanie konta gabinetu, role właściciel/pracownik, dziedziczenie dostępuTYLKO DEV
ZaproszeniaZapraszanie higienistek e-mailem, ekran akceptacji, panel gabinetuTYLKO DEV
Darmowe miesiącePanel super-admina (globalny + per-gabinet)TYLKO DEV
System mailiSilnik wysyłki (tryb próbny) + panel edycji treści /admin/maileTYLKO DEV
NIP (anty-nadużycia)NIP gabinetu jako kotwica „jeden darmowy okres"TYLKO DEV
Migracje bazy0005–0008 (konfiguracja, maile, NIP, kotwica) — wgrane na bazę dev, pliki niezacommitowaneTYLKO DEV
Warstwa globalna edytoraSuper-admin (Asia) edytuje treść domyślną dla wszystkich — zbudowane dziśTYLKO DEV

Gałąź be/gabinet-org-login: 25 zmienionych + 20 nowych plików, niezacommitowane. Gałąź be/templates-global-layer: 8 plików, niezacommitowane.

3. Co jeszcze NIE jest zbudowane

CoDlaczego ważneStan
Silnik pacjenta czyta treść z serwera Dziś silnik składa plan z pliku Excel. Dopóki tego nie ma, żadna edycja w edytorze (globalna, gabinetu ani solo) NIE zmienia planu, który widzi pacjent. To brakujące ogniwo, które „ożywia" cały edytor. Odkryto rozjazd: model edytora jest uboższy niż silnik (brak pól ręcznych, statusów) — wymaga wzbogacenia + testu zgodności, nie zwykłego wpięcia. NIEZBUDOWANE
Kopia treści dla gabinetu + edycja higienistki pod gabinetem + przełącznik edycjiDalsze warstwy edytora (po warstwie globalnej)NIEZBUDOWANE
Weryfikacja telefonu higienistki solo (SMS)Kod gotowy na dev, uśpiony — czeka na konfigurację ClerkCZEKA NA KONFIG
Maile naprawdę wychodzą (Resend)Teraz tryb próbny — potrzebny klucz Resend + DNSCZEKA NA KONFIG
Codzienny automat przypominajek (cron)Cloudflare wymaga subdomeny workers.dev — nie rejestruje sięCZEKA NA DECYZJĘ

4. Otwarte PR-y na GitHubie

PRCoStan
#58Dokumentacja: mikrosajty + funkcja analityki + rezydencja danych + obowiązkowy checklist aktualizacji w CLAUDE.mdOTWARTY (czeka na merge)

To jedyny otwarty PR. Reszta gałęzi z punktu 2 nie ma nawet PR — bo nie jest wypchnięta.

5. Co dokładnie żyje teraz na dev

WarstwaWdrożenie
Serwer (Worker)higi-api-dev, wersja d9fe66b4 — 2026-06-25 22:43
Strona (Pages)higi-devdev.higi.com.pl, wdrożenie 109e326e — 22:52
Produkcjahigi.com.plnietknięta (inny, starszy build; zmiany tylko na „promuj")

Uwaga: dev serwuje pakiet łączony (gabinety + maile + NIP + warstwa globalna) — wszystko z punktu 2. To dlatego nie można było wgrać samej warstwy globalnej bez tamtych — i dlatego dług z punktu 2 jest pilny.

6. Ryzyko i rekomendacja

Ryzyko

Rekomendowana kolejność

  1. Spłacić dług: zacommitować i wypchnąć na GitHub gałęzie z punktu 2 → /code-review + /security-review → PR. Najpierw to, co wisi w /tmp, żeby nie zginęło.
  2. Etap silnika: wzbogacić model edytora + test zgodności (plan z serwera == plan z Excela) + bezpieczny tryb podglądu na dev (fallback do Excela). Dopiero zielony test przełącza domyślny silnik.
  3. Konfiguracje (Clerk telefon, Resend, cron) — równolegle, zależne od Bartosza.
  4. Produkcja — dopiero po przeglądach i na wyraźne „promuj".