# OOPIS: standard identyfikacji i pozycjonowania elementów budynku

Jeden trwały identyfikator dla każdych drzwi, gaśnicy i hydrantu. Etykieta z kodem QR i NFC mówi, co to jest i gdzie dokładnie się znajduje.

## W skrócie

- Typ: Własny produkt Kol.ski
- Dla kogo: Wspólnoty, zarządcy, deweloperzy, firmy serwisowe
- Zakres: Specyfikacja, formaty danych, implementacja referencyjna, metodyka mapowania
- Stan: Wersja 1.0 gotowa, pilotaż w pierwszym budynku przed nami

## Wyzwanie

Budynek ma setki elementów technicznych, a każdy nosi inny numer w innej dokumentacji: u dewelopera, u administratora, u serwisanta, w protokole przeglądu i w zgłoszeniu mieszkańca.

> Gaśnica przy windzie na trzecim.

Taki opis wystarcza człowiekowi, nie wystarcza systemowi. Adres pocztowy nie istnieje, kiedy budynek jest w budowie, a wymiana urządzenia gubi historię miejsca, w którym wisiało.

## Rozwiązanie

Każdy element dostaje identyfikator o stałej długości 36 znaków i etykietę z kodem QR oraz opcjonalnym tagiem NFC. Kod da się odczytać bez bazy danych, a deweloper, zarządca i serwisant mówią o tym samym elemencie tym samym kodem.

### Gdzie stoi budynek

Kotwica miejsca oparta na Plus Code, nie na adresie. Działa też na placu budowy.

### Która część i poziom

Kod wskazuje część budynku i kondygnację, na której jest element.

### Jaki to element

Typ pochodzi z otwartego, wersjonowanego rejestru: drzwi, hydrant, rozdzielnica, zawór, miejsce postojowe.

### Gdzie wisi etykieta

Pozycja etykiety w lokalnym układzie współrzędnych budynku, zmierzona przy mapowaniu, nie zgadywana.

## Rezultat

| Liczba | Znaczenie |
| --- | --- |
| 36 | znaków identyfikatora, w układzie znanym z UUID |
| 5 | części standardu w wersji 1.0 |
| 26 | ponumerowanych decyzji projektowych z uzasadnieniem |
| 0 | centralnych rejestrów potrzebnych do działania |

### Co jest gotowe

- Specyfikacja normatywna z formalną gramatyką, sumą kontrolną i procedurą walidacji.
- Implementacja referencyjna: biblioteka, CLI i HTTP JSON API na jednej warstwie logiki.
- Generator kodów QR i etykiet do druku.
- Metodyka mapowania: skan LiDAR telefonem, dopasowanie skanu do modelu, zasady rozmieszczania etykiet.
- Przykładowy pakiet budynku z fragmentem korytarza.

### Przed nami

- Pilotaż w pierwszym budynku: inwentaryzacja jednej klatki, druk i montaż etykiet.
- Decyzja o publikacji standardu i jego licencji.
- Przeglądarka mapy i modelu 3D dla zarządcy, integracje z systemami zgłoszeń i przeglądów.

OOPIS nie zastępuje systemów BIM ani CMMS: dostarcza identyfikator i pozycję, do których te systemy mogą się odwołać.

## Z czego się składa

Specyfikacja jest normatywna, a formaty danych i implementacja muszą być z nią zgodne. Rozjazd jest defektem, nie interpretacją.

| Część | Co zawiera | Technologia |
| --- | --- | --- |
| Specyfikacja | Gramatyka identyfikatora, suma kontrolna, układ współrzędnych, rejestr typów, cykl życia punktów, wektory testowe | Markdown, ABNF, JSON |
| Formaty danych | Manifest budynku, rekordy elementów, zawartość QR i NFC, pakiet budynku, API resolvera | JSON Schema, SQL, OpenAPI, NDEF |
| Implementacja referencyjna | Biblioteka, CLI i HTTP JSON API, generator etykiet, testy zasilane wektorami ze specyfikacji | Python, segno, SVG, PDF |
| Metodyka i plany wdrożeń | Procedura skanu, dopasowanie skanu do modelu, pipeline od planów 2D do modelu 3D, plany PoC i MVP | iPhone z LiDAR, ICP, glTF 2.0 |

## Wnioski

- Identyfikator ma być czytelny bez bazy. Kod, który człowiek czyta z etykiety, a system parsuje sam, jest wart więcej niż losowy UUID z ładnym interfejsem.
- Kotwica z Plus Code zamiast adresu. Budynek w budowie nie ma adresu, a adres potrafi się zmienić decyzją urzędu.
- Wektory testowe są umową między specyfikacją a kodem. Błąd w opisie sumy kontrolnej wyszedł dopiero przy implementacji.
- Standard zaczyna się od konkretnego budynku. OOPIS wyrósł z potrzeby jednej wspólnoty mieszkaniowej, nie z komitetu.

## Masz budynek do oznaczenia?

Inwentaryzacja, skanowanie, etykiety i integracje dla wspólnot, zarządców i firm. Napisz, jeśli chcesz być pierwszym budynkiem w pilotażu.

[Porozmawiajmy o projekcie](mailto:hi@kol.ski) · [Zarezerwuj 30 minut](https://calendar.app.google/CJxZPq3FqabCDMS59) · [Projekty](https://kol.ski/pl/projekty)