Od pierwszegokliknięciapo klucze

Źródłem danych jest Osiedlo. Strona inwestycji pobiera z jego publicznego API ofertę (inwestycję, lokale, statusy, ceny, powierzchnie) i odsyła do niego zapytania klientów jako leady - ze źródłem, kanałem reklamowym, wskazanym lokalem i zapisaną konfiguracją wnętrza. Dostęp daje klucz API wystawiany osobno dla każdej inwestycji, tylko do odczytu oferty i przyjmowania leadów.

Compass niczego nie kopiuje: każdą stronę panelu klienta pobiera na żywo z Osiedla (lokal, etapy zakupu, dokumenty, opiekun). W drugą stronę trafiają podpisane pliki. Konto klienta w Compassie zakłada handlowiec z poziomu Osiedla, a Osiedlo może je zablokować albo zresetować hasło i 2FA.

Osobno: Osiedlo działa samodzielnie, strona także (bez CRM dane oferty są wpisane w jej treść). Compass wymaga Osiedla, bo stamtąd bierze dane. Dołączenie kolejnego systemu później to konfiguracja klucza API i tokenów, bez migracji danych.

Osiedle NOVA to nasza realizacja pokazowa. Każda strona jest budowana pod konkretną inwestycję: model 3D osiedla i treści przygotowujemy indywidualnie. Deweloper przekazuje plan zagospodarowania i rzuty, listę lokali (numery, metraże, pokoje, statusy, ceny), teksty, logo i identyfikację oraz wizualizacje lub modele, jeśli je ma.

Personalizacja obejmuje branding, treści, bryły budynków i podział na lokale w modelu oraz konfigurator wnętrz. Osiedlo obsługuje domy i mieszkania (typ lokalu, kondygnacja, numer), więc strona może dotyczyć obu - model 3D bloku to osobna praca modelarska.

To samodzielna, statyczna strona, więc może zastąpić stronę inwestycji. Osadzenie w istniejącym serwisie dewelopera wymaga ustalenia technicznego przy wdrożeniu.

Po wysłaniu formularza zapytanie staje się leadem w Osiedlu: handlowiec widzi je w zakładce Leady z historią, przypisuje opiekuna i status, a cała rozmowa zostaje na osi czasu.

API jest gotowe i przetestowane: odczyt inwestycji i lokali (statusy, ceny, powierzchnie), przyjmowanie leadów, klucze API per inwestycja, CORS i limity żądań. Pokazowa strona nova.radzio.net nie jest jeszcze z nim spięta - to kolejny krok, nie przeszkoda techniczna.

Po spięciu deweloper zarządza cenami, statusami i dostępnością w jednym miejscu, a strona pokazuje aktualne dane. Strona jest statyczna, więc odświeża je przy publikacji albo pobiera w przeglądarce - częstotliwość ustalamy przy wdrożeniu.

Mechanizm jest zbudowany zgodnie z art. 19a-19b ustawy deweloperskiej i schematem harvestera dane.gov.pl. Codziennie o 03:00 panel zapisuje plik z cenami każdej inwestycji w sprzedaży (format według wzoru ministerstwa, wersjonowany) i udostępnia manifest XML z sumą kontrolną pod stałym adresem. O 07:00 i 10:00 sprawdza przez API portalu, czy dane zostały pobrane, i pokazuje wynik dla ostatnich 14 dni.

Jednorazowo deweloper zakłada konto dostawcy danych na dane.gov.pl (profil zaufany), zgłasza adres manifestu jako codzienne źródło harvestera i wpisuje do panelu identyfikator zbioru. Dalej wszystko dzieje się samo.

Przy błędzie panel pokazuje, czego brakuje w danych albo że portal nie pobrał pliku, a plik można wygenerować i zweryfikować ręcznie. Pełnej rejestracji na portalu nie przeszliśmy jeszcze z prawdziwym deweloperem - potwierdzimy ją na pierwszym wdrożeniu.

Nabywcę, jego lokal, etapy zakupu i dokumenty prowadzi handlowiec w Osiedlu. Konto w Compassie zakłada jednym kliknięciem - Osiedlo wywołuje API Compassu i dostaje hasło jednorazowe dla klienta. Compass nie przechowuje danych zakupu, tylko konta i sesje; każdą stronę pobiera na żywo z Osiedla.

Komunikacja jest dwustronna: z Compassu do Osiedla idą podpisane pliki, z Osiedla do Compassu reset hasła i 2FA, blokada konta. Klient nie przesyła dziś własnych dokumentów - tylko podpisane wersje tych, które dostał; rozszerzenie jest możliwe.

Poza samouczkiem: zakładka Mój dom (dane lokalu, opiekun, biuro sprzedaży), bezpieczeństwo konta (2FA, kody zapasowe, zmiana hasła), pobieranie plików. Czat klienta z deweloperem jest zaprojektowany, ale wstrzymany.

podpis.gov.pl nie ma interfejsu dla firm, więc Compass prowadzi klienta krok po kroku: pobiera PDF, podpisuje go podpisem zaufanym w rządowej usłudze i przesyła podpisany plik. System rozpoznaje XAdES (plik .xml z podpisu zaufanego) i PAdES (podpisany PDF, także podpisem kwalifikowanym), odczytuje imię i nazwisko podpisującego, sprawdza typ pliku po jego zawartości i przekazuje plik do Osiedla, gdzie handlowiec go przyjmuje albo odrzuca z uwagą. PESEL nie jest nigdzie zapisywany.

Ograniczenia: Compass nie weryfikuje kryptograficznie ważności podpisu - to robi weryfikacja na gov.pl. Projekty umów i dokumenty towarzyszące można tak podpisywać; umowa deweloperska i przeniesienie własności wymagają aktu notarialnego. Opinia prawna o zakresie dokumentów jest do uzyskania.

Dziś: publiczne REST API Osiedla (oferta i leady) dla dowolnej strony lub systemu oraz API między Osiedlem a Compassem. Raport kanałów reklamowych liczy leady po parametrach UTM i wpisanym budżecie, bez łączenia z kontami Meta czy Google.

Portale ogłoszeniowe, księgowość, płatności i platformy reklamowe nie są dziś zintegrowane - każda z nich może powstać jako dodatkowe wdrożenie na tym samym API.

Aplikacje nie mają twardych limitów inwestycji, lokali, użytkowników, leadów ani dokumentów. Jeden deweloper prowadzi z jednego konta dowolnie wiele inwestycji, a klucz API wystawia osobno dla każdej. Publiczne API ma limity żądań chroniące przed nadużyciem.

Granicą jest serwer: dziś to jedna współdzielona maszyna. Większy klient dostaje osobną instancję.

Serwer VPS w OVH (Unia Europejska). Kopie zapasowe codziennie o 03:15, szyfrowane, plus dzienna kopia całego serwera po stronie OVH. Automatyczny monitoring, alerty i wycofanie nieudanej wersji.

Oba panele wymagają 2FA, hasła są hashowane algorytmem argon2, Osiedlo ma role administratora, menedżera i handlowca. Dziennik zdarzeń i historia cen są tylko do dopisywania - nie da się ich zmienić ani usunąć. Nagłówki bezpieczeństwa, CSP i testy bezpieczeństwa uruchamiane automatycznie przy każdej zmianie.

RODO: anonimizacja leada na żądanie, PESEL nigdy nie jest zapisywany. Umowa powierzenia danych i polityka prywatności są do przygotowania.

Można pokazywać i linkować: stronę pokazową nova.radzio.net oraz tryb demo Osiedla i Compassu - oba otwierają się jednym kliknięciem, na przykładowych danych, z samouczkiem krok po kroku. Są też instrukcje PDF: dla użytkownika Osiedla i dla klienta Compassu.

Logo, identyfikacji, filmów i prezentacji jeszcze nie ma. Demo działa na wspólnym serwerze zespołu, więc przy większej liczbie pokazów dostanie osobną instancję.

Żaden z systemów nie pracuje jeszcze u prawdziwego dewelopera. Mówimy to wprost: to nowe produkty, a pierwszemu klientowi proponujemy pilotaż.

Jedno źródło danych od strony przez CRM po klienta: cena, status i lead nie są nigdzie przepisywane ręcznie.

Ustawowy obowiązek jawności cen załatwiony automatycznie, z historią cen, której nie da się podrobić ani usunąć.

Klient końcowy ma własny panel: widzi, czyj teraz ruch, i podpisuje dokumenty bez wizyty w biurze - mniej telefonów do działu sprzedaży.

Do tego mały zespół bez pośredników: zmiany i poprawki idą prosto do ludzi, którzy piszą kod. Listę konkurencyjnych systemów do porównań uzupełnimy osobno.