Schema danych

Każde schronisko w datasecie ma następujące pola. Pełna definicja w JSON Schema, TypeScript types: types.d.ts.

Pola obowiązkowe

• id, unikalny stable identifier (np. krotoszyn-ceglarska-11)
• nazwa, oficjalna nazwa schroniska
• wojewodztwo, slug województwa (np. wielkopolskie, lowercased bez diakrytyki)
• miasto, miasto

Pola opcjonalne

• kod_pocztowy, format XX-XXX
• adres, ulica i numer
• telefon, telefon_dodatkowy, numery telefonów
• godziny, godziny otwarcia (free-form, np. "pn-pt 10:00-15:00")
• email, www, kontakt (uwaga: niektóre WWW bez prefixa https://)
• geo, { lat, lng } WGS84 (~17% pokrycia)
• zrodla, URL źródeł danych (provenance, atrybucja oryginalnym źródłom)
• data_quality_score, float 0.0-1.0 (patrz Quality Score)
• opt_out, true jeśli schronisko zażądało RODO opt-out (rekord zachowany dla transparentności, ale oznaczony)
• notatki, wewnętrzne notatki (np. dla opt-out cases)

Stabilność ID

ID schronisk są stabilne od Phase 1. Phase 2.5+ enrichment dodaje pola, ale nigdy nie zmienia istniejących ID. Jeśli kiedyś będzie potrzebna zmiana, zostanie ogłoszona w changelog.

Znane quirks (Phase 1)

Niektóre rekordy mają occasional issues które będą naprawione w Phase 2.5:

• 3 IDs zawierają polskie diacritics lub cyrillic chars (slugifier bug)
• 7 WWW URL bez schemy https:// (np. www.example.pl)

Tooling (Zod schema, types.d.ts) traktuje te pola jako luźne stringi, handle gracefully w swojej aplikacji.