Case study

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.

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

  • 36znaków identyfikatora, w układzie znanym z UUID
  • 5części standardu w wersji 1.0
  • 26ponumerowanych decyzji projektowych z uzasadnieniem
  • 0centralnych 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ą.

  1. Specyfikacja

    Gramatyka identyfikatora, suma kontrolna, układ współrzędnych, rejestr typów, cykl życia punktów, wektory testowe

    • Markdown
    • ABNF
    • JSON
  2. Formaty danych

    Manifest budynku, rekordy elementów, zawartość QR i NFC, pakiet budynku, API resolvera

    • JSON Schema
    • SQL
    • OpenAPI
    • NDEF
  3. Implementacja referencyjna

    Biblioteka, CLI i HTTP JSON API, generator etykiet, testy zasilane wektorami ze specyfikacji

    • Python
    • segno
    • SVG
    • PDF
  4. 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

  1. 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.
  2. Kotwica z Plus Code zamiast adresu. Budynek w budowie nie ma adresu, a adres potrafi się zmienić decyzją urzędu.
  3. Wektory testowe są umową między specyfikacją a kodem. Błąd w opisie sumy kontrolnej wyszedł dopiero przy implementacji.
  4. 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.

Pierwsza rozmowa jest bezpłatna: 30 minut online, bez przygotowań i bez zobowiązań.

Napisz do nas

Wiadomość szyfrujemy w Twojej przeglądarce — po drodze nikt poza nami jej nie odczyta. Jeśli chcesz, możesz dodatkowo zaszyfrować treść naszym kluczem PGP i wkleić wynik.

Wpisz co najmniej dwa znaki.
Sprawdź adres e-mail.
Sprawdź numer telefonu.

Podaj e-mail, telefon albo oba.

Podaj e-mail lub telefon.
Nie wpisuj danych wrażliwych (np. o zdrowiu), haseł ani cudzych danych.
Napisz od 10 do 5000 znaków.
Bez tej zgody nie możemy przyjąć wiadomości.