Rejestr prawny UK
Companies House
Zwraca nazwę prawną, numer spółki, status prawny i dowód rejestrowy dla podmiotów z Wielkiej Brytanii.
03 / Produkt cyfrowy / PLATFORMA COMPANY INTELLIGENCE
Platforma company intelligence zaprojektowana i zbudowana wokół oficjalnych rejestrów i źródeł VAT, jawnych dowodów, integracji API oraz niezawodnych workflow Flask i TypeScript.

01 / WPROWADZENIE
SENTINEL łączy oficjalne rejestry firm i źródła weryfikacji VAT w jeden przejrzysty proces wspierający procurement i ocenę dostawców. To działający produkt cyfrowy, a nie wyłącznie koncept marketingowy: zapytania trafiają do właściwych providerów, dane są normalizowane do wspólnego modelu dowodowego, a wyniki pozostają dostępne jako rekordy do ponownej analizy.
02 / WYZWANIE
Weryfikacja firmy jest rozproszona. Tożsamość prawna, status rejestracyjny, VAT, oficjalne adresy i dostępność źródeł pochodzą z różnych systemów. Produkt musiał jasno pokazać rolę każdego źródła, połączyć odpowiedzi bez zacierania ich znaczenia i oddzielić techniczną niedostępność providera od negatywnego wniosku o firmie.
03 / SYSTEM & ROUTING
Jedno zapytanie może uruchomić różne ścieżki weryfikacji. SENTINEL odczytuje jurysdykcję, identyfikator firmy i numer VAT, a następnie odpytuje wyłącznie oficjalne usługi właściwe dla podanych danych.
04 / ŹRÓDŁA DANYCH
Interfejs rozdziela dane rejestrowe, walidację VAT UE i weryfikację VAT UK. Każdy provider odpowiada na inne pytanie i zachowuje informację o środowisku oraz kontekście źródła.
Rejestr prawny UK
Zwraca nazwę prawną, numer spółki, status prawny i dowód rejestrowy dla podmiotów z Wielkiej Brytanii.
Walidacja VAT UE
Weryfikuje obsługiwane numery VAT UE i zwraca dane firmy, jeżeli usługa udostępnia je w odpowiedzi.
Weryfikacja VAT UK
Sprawdza rejestrację VAT UK, nazwę firmy i adres VAT. Obecna integracja korzysta z danych testowych HMRC Sandbox, a nie produkcyjnej weryfikacji VAT.
05 / DOŚWIADCZENIE WERYFIKACJI
Workspace został zaprojektowany wokół dowodów, a nie jednego nieprzejrzystego score. Wprowadzenie danych, routing źródeł, uzasadnienie wyniku, historia i generowanie raportu tworzą jeden ciągły workflow.

06 / CROSS-SOURCE INTELLIGENCE
Odpowiedzi providerów są normalizowane bez udawania, że każde źródło weryfikuje ten sam fakt. Status prawny pozostaje oddzielony od statusu VAT, nazwy są porównywane konserwatywnie, a rozbieżności trafiają do review zamiast znikać pod ogólnym wynikiem.
Właściwe oficjalne źródło potwierdza podmiot.
Odpowiednia usługa VAT potwierdza rejestrację.
Potwierdzono tylko część wymaganych dowodów.
Źródła lub dane tożsamości wymagają analizy człowieka.
Negatywna odpowiedź biznesowa źródła, nie błąd techniczny.
Źródło nie odpowiedziało; system nie wyciąga wniosku o firmie.
07 / SOURCE TRANSPARENCY & PDF
Każdy wniosek pozostaje połączony ze źródłem. UI zachowuje nazwę providera, jego rolę, czas sprawdzenia, zwrócone dane, środowisko i oficjalny URL, dzięki czemu wynik można zweryfikować zamiast przyjmować go jak black box.
Brandowany PDF zamienia zapisany wynik w przenośny snapshot dowodowy. Rozdziela providerów, zachowuje timestampy i linki źródłowe, wyjaśnia podstawę decyzji oraz oznacza odpowiedzi HMRC Sandbox jako dane testowe, a nie produkcyjną weryfikację.

08 / UX & SEMANTIC STATES
System wizualny rezerwuje zieleń dla potwierdzonych dowodów, zgaszoną czerwień dla negatywnych wyników biznesowych, bursztyn dla review oraz osobny stan techniczny dla niedostępnych providerów. Not applicable pozostaje neutralne. Dzięki temu błąd techniczny nie staje się ryzykiem firmy.
09 / ARCHITEKTURA TECHNICZNA
Produkt łączy application factory Flask, adaptery providerów, deterministyczną logikę decyzji, normalizację danych, zapisaną historię i generowanie PDF w pamięci z interfejsem strict TypeScript budowanym przez Vite.
Companies House, VIES i HMRC działają jako niezależne adaptery za wspólnym kontraktem weryfikacji.
Uruchamiane są wyłącznie źródła właściwe dla podanych danych firmy i VAT.
Normalizacja wspiera porównanie, ale samo podobieństwo fuzzy nigdy nie tworzy statusu verified.
Błędy sieci i providerów tworzą kontrolowane stany techniczne zamiast fałszywie negatywnych wyników.
Sekrety pozostają w ENV, HMRC korzysta z OAuth 2.0, a wartości poufne są redagowane w logach.
Gunicorn, wersjonowane assety Vite i konfiguracja zgodna z Render obsługują publiczną aplikację.
10 / REZULTAT I DALSZY KIERUNEK
SENTINEL pokazuje pełne product thinking obejmujące UX/UI, backend Flask, TypeScript, oficjalne integracje API, logikę decyzji, transparentność źródeł i raportowanie — jako responsywna aplikacja produkcyjna bez zawyżania rzeczywistego zakresu danych.
Przyszły kierunek rozwoju zakłada company registry intelligence dla Stanów Zjednoczonych, z wykorzystaniem oficjalnych rejestrów biznesowych poszczególnych stanów tam, gdzie będzie to technicznie i prawnie możliwe. To roadmapa, a nie obecnie aktywna funkcja.
11 / Następny projekt
Kinowe doświadczenie produktowe łączące 3D w czasie rzeczywistym, kontrolowany motion i lekki commerce layer.