# OOPIS: standard di identificazione e posizionamento degli elementi di un edificio

Un identificatore permanente per ogni porta, estintore e idrante. Un’etichetta con codice QR e NFC dice che cos’è e dove si trova esattamente.

## In breve

- Tipo: Prodotto proprio di Kol.ski
- Per chi: Condomini, amministratori, costruttori, aziende di manutenzione
- Ambito: Specifica, formati dei dati, implementazione di riferimento, metodologia di mappatura
- Stato: Versione 1.0 pronta, pilota nel primo edificio in arrivo

## Sfida

Un edificio ha centinaia di elementi tecnici, e ciascuno porta un numero diverso in ogni documentazione: dal costruttore, dall’amministratore, dal manutentore, nel verbale di ispezione e nella segnalazione del residente.

> L’estintore vicino all’ascensore al terzo piano.

Una descrizione così basta a una persona, non basta a un sistema. L’indirizzo postale non esiste quando l’edificio è in costruzione, e la sostituzione di un dispositivo perde la storia del punto in cui era appeso.

## Soluzione

Ogni elemento riceve un identificatore di lunghezza fissa di 36 caratteri e un’etichetta con codice QR e tag NFC opzionale. Il codice si può leggere senza database, e costruttore, amministratore e manutentore parlano dello stesso elemento con lo stesso codice.

### Dove si trova l’edificio

Ancora di posizione basata su Plus Code, non sull’indirizzo. Funziona anche in cantiere.

### Quale parte e quale livello

Il codice indica la parte dell’edificio e il piano su cui si trova l’elemento.

### Che elemento è

Il tipo proviene da un registro aperto e versionato: porta, idrante, quadro elettrico, valvola, posto auto.

### Dove è appesa l’etichetta

La posizione dell’etichetta nel sistema di coordinate locale dell’edificio, misurata durante la mappatura, non stimata.

## Risultato

| Numero | Significato |
| --- | --- |
| 36 | caratteri dell’identificatore, nel formato noto dagli UUID |
| 5 | parti dello standard nella versione 1.0 |
| 26 | decisioni di progetto numerate e motivate |
| 0 | registri centrali necessari per funzionare |

### Cosa è pronto

- Specifica normativa con grammatica formale, checksum e procedura di validazione.
- Implementazione di riferimento: libreria, CLI e HTTP JSON API su un unico livello di logica.
- Generatore di codici QR ed etichette da stampare.
- Metodologia di mappatura: scansione LiDAR con il telefono, allineamento della scansione al modello, regole di posizionamento delle etichette.
- Pacchetto di esempio di un edificio con un tratto di corridoio.

### Prossimi passi

- Pilota nel primo edificio: inventario di una scala, stampa e montaggio delle etichette.
- Decisione sulla pubblicazione dello standard e sulla sua licenza.
- Visualizzatore di mappa e modello 3D per l’amministratore, integrazioni con i sistemi di segnalazioni e ispezioni.

OOPIS non sostituisce i sistemi BIM né CMMS: fornisce l’identificatore e la posizione a cui questi sistemi possono fare riferimento.

## Di cosa è fatto

La specifica è normativa, e i formati dei dati e l’implementazione devono esserle conformi. Una divergenza è un difetto, non un’interpretazione.

| Parte | Cosa contiene | Tecnologia |
| --- | --- | --- |
| Specifica | Grammatica dell’identificatore, checksum, sistema di coordinate, registro dei tipi, ciclo di vita dei punti, vettori di test | Markdown, ABNF, JSON |
| Formati dei dati | Manifest dell’edificio, record degli elementi, contenuto QR e NFC, pacchetto dell’edificio, API del resolver | JSON Schema, SQL, OpenAPI, NDEF |
| Implementazione di riferimento | Libreria, CLI e HTTP JSON API, generatore di etichette, test alimentati dai vettori della specifica | Python, segno, SVG, PDF |
| Metodologia e piani di implementazione | Procedura di scansione, allineamento della scansione al modello, pipeline dalle planimetrie 2D al modello 3D, piani di PoC e MVP | iPhone con LiDAR, ICP, glTF 2.0 |

## Lezioni apprese

- L’identificatore deve essere leggibile senza database. Un codice che una persona legge dall’etichetta e un sistema analizza da solo vale più di un UUID casuale con una bella interfaccia.
- Ancora con Plus Code invece dell’indirizzo. Un edificio in costruzione non ha indirizzo, e un indirizzo può cambiare per decisione amministrativa.
- I vettori di test sono il contratto tra specifica e codice. Un errore nella descrizione del checksum è emerso solo durante l’implementazione.
- Uno standard nasce da un edificio concreto. OOPIS è nato dall’esigenza di un condominio, non da un comitato.

## Hai un edificio da etichettare?

Inventario, scansione, etichette e integrazioni per condomini, amministratori e aziende. Scrivici se vuoi essere il primo edificio del pilota.

[Parliamo del tuo progetto](mailto:hi@kol.ski) · [Prenota 30 minuti](https://calendar.app.google/CJxZPq3FqabCDMS59) · [Progetti](https://kol.ski/it/progetti)