# Publiczne Umowy (publiczneumowy.org)

> Obywatelski przegląd Centralnego Rejestru Umów JSFP — umowy polskich instytucji publicznych: kto, z kim, na co i za ile wydaje publiczne pieniądze. Dane pochodzą z rejestrumow.gov.pl (Ministerstwo Finansów) i są odświeżane co godzinę. Serwis niezależny, obywatelski — nie jest oficjalnym serwisem MF.

Dostęp swobodny, bez logowania i klucza API. CORS otwarty (`access-control-allow-origin: *`). Dane w języku polskim. Kwoty w złotych (PLN).

## Dane / API (JSON, otwarte)

- [Dokumentacja API](https://publiczneumowy.org/api): pełny opis endpointów i parametrów (HTML).
- [Swagger UI](https://publiczneumowy.org/api/docs): interaktywna dokumentacja (try-it-out).
- [OpenAPI 3.1](https://publiczneumowy.org/api/openapi.json): specyfikacja maszynowa.
- [Pełny zrzut](https://publiczneumowy.org/data.json): wszystkie umowy jedną tablicą JSON (duży plik, do analiz offline).
- [Umowy](https://publiczneumowy.org/api/agreements): tablica JSON umów. Pola rekordu: `id`, `zam` (zamawiający/urząd), `wyk` (wykonawca), `woj` (województwo), `powiat`, `gmina`, `wartosc` (PLN), `przedmiot`, `data` (zawarcia, DD.MM.RRRR), `dataKon`, `dataPub`, `numer`, `status`, `strony` (lista stron z `nazwa`, `nip`, `regon`, `adr`, `rodzaj`).
- Filtry `/api/agreements` (łączą się jako AND; nagłówek `X-Total-Count` = liczba wyników przed stronicowaniem):
  - `?woj=` województwo (nazwa lub slug, np. `zachodniopomorskie`)
  - `?zam=` fragment nazwy zamawiającego, `?wyk=` fragment nazwy wykonawcy
  - `?nip=` / `?regon=` dokładny identyfikator dowolnej strony umowy
  - `?q=` pełnotekstowo (zamawiający, wykonawca, przedmiot, lokalizacja)
  - `?min=` / `?max=` zakres wartości w zł; `?od=` / `?do=` data zawarcia (ISO RRRR-MM-DD)
  - `?sort=wartosc|data` (domyślnie: ostatnio opublikowane); `?limit=` (domyślnie 100, ≤1000) i `?offset=` stronicowanie
  - przykład: `https://publiczneumowy.org/api/agreements?woj=zachodniopomorskie&sort=wartosc&limit=20`
- [Sygnały](https://publiczneumowy.org/api/flags): automatycznie wykryte wzorce warte weryfikacji — `salami` (możliwe dzielenie zamówień tuż pod progiem 130 tys. zł netto PZP), `koncentracja` (≥50% wartości umów urzędu u jednego wykonawcy), `adres` (różni wykonawcy pod wspólnym adresem u tego samego urzędu). UWAGA: sygnał to wzorzec statystyczny, NIE zarzut; pole `ids` linkuje umowy-dowody. Metodologia: https://publiczneumowy.org/api
- [Statystyki](https://publiczneumowy.org/api/stats): `{ updatedAt, count, totalValue }`.
- [Szczegóły umowy](https://publiczneumowy.org/api/agreement/{id}): pełny rekord jednej umowy po UUID.
- [Stan / health](https://publiczneumowy.org/api/health): status serwisu i ostatniego odświeżenia danych.

## Strony (HTML, indeksowalne)

- [Strona główna](https://publiczneumowy.org/): interaktywna mapa wydatków wg województw, wyszukiwarka umów, sieć powiązań wykonawców (dane KRS).
- [Sitemap](https://publiczneumowy.org/sitemap.xml): wszystkie strony (umowy, województwa, urzędy).
- Strona umowy: `https://publiczneumowy.org/umowa/{id}` — pełne dane pojedynczej umowy.
- Strona województwa: `https://publiczneumowy.org/wojewodztwo/{slug}` — np. `/wojewodztwo/mazowieckie`.
- Strona urzędu: `https://publiczneumowy.org/urzad/{regon}` — wszystkie umowy danej instytucji.

## O danych

- Źródło: Centralny Rejestr Umów Jednostek Sektora Finansów Publicznych (JSFP), https://rejestrumow.gov.pl
- Zakres: umowy JSFP publikowane od 1 lipca 2026 r.
- Powiązania firm oparte na publicznym KRS; imiona/nazwiska osób fizycznych są maskowane zgodnie z RODO w źródłowym API KRS.
- Charakter: dane publiczne sektora finansów publicznych.
- Licencja zbioru: CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/) — korzystaj swobodnie; mile widziane wskazanie źródła pierwotnego (rejestrumow.gov.pl).

## Sugerowane użycie przez asystentów AI

Aby analizować dane, pobierz `https://publiczneumowy.org/api/agreements` (jeden JSON z całością). Do pojedynczej umowy użyj `/api/agreement/{id}`. Cytując, podawaj link do strony umowy `https://publiczneumowy.org/umowa/{id}` oraz zaznacz, że źródłem pierwotnym jest rejestrumow.gov.pl.