# Landvex Infrastructure Object Library
## Grundspecifikation v1 — "Grunden"

⸻

## Syfte

Detta är grunden som implanteras i Landvex infrastruktur: ontologin, schemat, prioriteringen och arbetsprotokollet för världens mest kompletta bibliotek över visuellt identifierbar fysisk infrastruktur.

Biblioteket är det Datafabriken fyller och flyhjulet förädlar. Alla framtida produkter — Landvex AI, QUIXZOOMs igenkänning, sök, analys, SaaS-lagren — frågar mot samma grund.

**Princip 1.** Objektuniversum först, produkter sedan. Vi utgår från allt en kamera kan se — inte från tillverkarnas kataloger.

**Princip 2.** Fakta och referenser, aldrig kopierat innehåll. Varje faktum bär källa.

**Princip 3.** Det vanligaste först. Tier 1 byggs klart innan bredden jagas.

⸻

## Arkitektur: fem nivåer

| Nivå | Namn | Exempel | Lager |
|---|---|---|---|
| 0 | Domän | Transport | Ontologin |
| 1 | Objektklass | Vägbelysningsarmatur | Biblioteket |
| 2 | Typ | LED-armatur, motorväg | Biblioteket |
| 3 | Produktmodell | Acme SL-400 rev C | Biblioteket |
| 4 | Individ | Armaturen på Storgatan 12 | QUIXZOOM/kund |

**Landvex-ID:**

* Objektklass: `LVX-{DOMÄN}-{NNNN}` → `LVX-TRP-0102`
* Produktmodell: `LVX-P-{NNNNNNN}` → `LVX-P-0000481`
* Individ: `LVX-I-{...}` (fältlagret, utanför denna spec)

ID:n är permanenta. Namn får ändras — ID aldrig.

⸻

## Objektuniversum: nio domäner

| Kod | Domän | Omfattar bl.a. |
|---|---|---|
| TRP | Transport/väg | vägar, körfält, markeringar, räcken, kantsten, refuger, broar, tunnlar, signaler, skyltar, portaler, belysning, reflexstolpar, hållplatser |
| ELN | Elnät | transformatorer, ställverk, kabelskåp, elstolpar, kraftledningar, laddstationer, mätarskåp |
| VAT | Vatten & avlopp | brunnar, betäckningar, galler, ventiler, pumpstationer, hydranter, inspektionspunkter |
| TEL | Telekom | fiberskåp, kopparskåp, master, 5G, antenner, radiolänkar |
| BYG | Byggnad | fasader, tak, entréer, portar, fönster, brandskydd, ventilation, nödutgångar, skyltar |
| PRK | Park & offentlig miljö | träd, bänkar, lekplatser, papperskorgar, pollare, cykelställ, fontäner |
| JVG | Järnväg | signaler, kontaktledning, slipers, växlar, bommar, plattformar |
| HMN | Hamn | kajer, pollare, fendrar, kranar, landström |
| FLG | Flygplats | banbelysning, skyltar, stängsel, navigationshjälpmedel |

Geografisk räckvidd v1: **USA, EU, Storbritannien, Kanada, Australien.**

Ontologin är global från dag ett — nya marknader är data, inte omdesign.

⸻

## Tier 1 — det vanligaste byggs först

Urvalskriterier:

1. **Volym** — miljontals instanser i fält
2. **Synlighet** — identifierbar från gatunivåfoto
3. **Efterfrågan** — förvaltare och entreprenörer behöver svaret
4. **Datatillgång** — öppna standarder och tillverkardokumentation finns
5. **Flyhjul** — syns i material Zoomers redan samlar

### De 20 första objektklasserna

| LVX-ID | Klass | Nyckelstandarder (exempel) |
|---|---|---|
| LVX-TRP-0101 | Belysningsstolpe | EN 40 (EU), AASHTO LTS (US) |
| LVX-TRP-0102 | Vägbelysningsarmatur | EN 60598, EN 13201 (EU), UL 1598 (US) |
| LVX-TRP-0103 | Vägmärke | MUTCD (US), TSRGD (UK), nationella kataloger (EU), AS 1742 (AU) |
| LVX-TRP-0104 | Trafiksignal, signalhuvud | EN 12368 (EU), ITE-spec. (US) |
| LVX-TRP-0105 | Trafiksignalskåp/styrapparat | NEMA TS-serien (US) |
| LVX-TRP-0106 | Vägmarkering | EN 1436 (EU), MUTCD (US) |
| LVX-TRP-0107 | Vägräcke | EN 1317 (EU), MASH (US) |
| LVX-TRP-0108 | Hållplatsväderskydd | tillverkar-/kommunprogram |
| LVX-VAT-0101 | Brunnsbetäckning | EN 124 (EU/UK), kommunala lastkrav (US) |
| LVX-VAT-0102 | Dagvattengaller | EN 124 |
| LVX-VAT-0103 | Brandpost/hydrant | AWWA C502/C503 (US), nationella typer (EU) |
| LVX-ELN-0101 | Kabelskåp, lågspänning | nätbolagsnormer per land |
| LVX-ELN-0102 | Elstolpe | ANSI O5.1 (trä, US), nationella normer (EU) |
| LVX-ELN-0103 | Nätstation/transformator | IEC/IEEE-serier — kartläggs i steg 1 |
| LVX-ELN-0104 | Laddstation | IEC 61851, kontaktstandarder (CCS, J1772) |
| LVX-TEL-0101 | Telekomskåp | operatörsspecifika program |
| LVX-TEL-0102 | Mobilmast/antennplats | nationella regelverk |
| LVX-PRK-0101 | Pollare | säkerhetspollare: PAS 68 / IWA 14 |
| LVX-PRK-0102 | Papperskorg | — |
| LVX-PRK-0103 | Cykelställ | — |

**Tier 2 (nästa våg):** kantsten, reflexstolpar, vägportaler, broräcken, bullerskydd, mätarskåp, ventilbetäckningar, parkbänkar, järnvägens basobjekt.

**Tier 3:** hamn- och flygplatsdomänerna — hög specialisering, begränsad access, byggs mot kunduppdrag.

⸻

## Universellt objektschema

Varje post — klass eller produktmodell — följer samma tio block:

1. **Identitet** — vem, vad, revision, status
2. **Teknik** — dimensioner, material, klasser (IP, belastning, korrosion), livslängd
3. **Historik** — introducerad, utfasad, ersättningskedja
4. **Geografi** — länder, regioner, miljötyper
5. **Standarder** — organ, beteckning, roll (aldrig standardtext)
6. **AI** — kännetecken, särskiljare, förväxlingar, kameravinklar, OCR/typskylt
7. **Problem** — kända fel, alltid med källa
8. **Dokumentation** — referenser med metadata och licensstatus
9. **Relationer** — predikatbaserade kopplingar till andra LVX-ID
10. **Proveniens** — källor, konfidens, verifieringsnivå

Maskinformatet definieras i `lvx-objekt-schema.json`. I grafen bryts posterna ner till enskilda fakta med källa, konfidens och bitemporal giltighet — enligt Genome-strategin.

**OCR först.** En stor andel el-, tele- och belysningsobjekt bär typskylt med tillverkare, modell och serienummer. Typskyltens position och fältstruktur dokumenteras per klass — det är den billigaste vägen till säker identifiering.

⸻

## Käll- och rättighetspolicy

**Tillåtet — sammanställ fakta och spara referenser från:**

* Standardiseringsorgan: beteckning, titel, tillämpningsområde — aldrig innehåll ur köpta standarder
* Myndigheter: föreskrifter, typgodkännanden, regelverk (amerikanska federala dokument är ofta public domain)
* Tillverkares publika datablad, kataloger och manualer: extrahera fakta, länka källan
* Patent: fria att referera och analysera
* Offentliga upphandlingar: produkter, platser, tidpunkter
* Egna fältbilder: fullt ägda

**Ej tillåtet:**

* Kopiera skyddade databaser eller kringgå avtalsvillkor
* Skörda bakom inloggning eller mot uttryckligt förbud
* Återge standardtexter, manualtexter eller bilder vi saknar rätt till

**Särskilda noter:**

* OpenStreetMap (ODbL) kräver attribution och delningsvillkor — hålls i separat spår tills licensstrategin är beslutad
* "Kända problem" publiceras endast med belagd källa: återkallelse, servicebulletin eller verifierad fältobservation

Regeln i en mening: **vi bygger kunskap om innehållet — inte kopior av innehållet.**

⸻

## Forskningsprotokoll per objektklass

Varje Tier 1-klass blir ett forskningsuppdrag i sju steg. Detta är agenternas arbetsorder:

1. **Standarder & terminologi.** Kartlägg nationella och internationella standarder per marknad. Standarderna definierar klassens gränser, klassificeringar och officiella begrepp på varje språk.
2. **Marknadskarta.** Dominerande tillverkare per land — historiskt och idag.
3. **Modellkatalog.** Produktfamiljer, modeller, revisioner, produktionsperioder, artikelnummer, status.
4. **Visuell profil.** Kännetecken, särskiljande detaljer, förväxlingsrisker, rekommenderade vinklar, typskylt/OCR.
5. **Livscykel & problem.** Livslängd, åldrande, kända fel — endast med källa.
6. **Relationer.** Vad den monteras på, ansluts med, matas från, ingår i, ersätts av.
7. **Verifiering.** Konfidenssättning, källgranskning; fältverifieringsbehov flaggas till Zoomer-kön.

Output per uppdrag: en komplett klasspost enligt schemat + en lista produktmodellposter — alla källbelagda.

⸻

## Relationsvokabulär v1

`monteras_pa` · `star_pa` · `ansluts_med` · `matas_fran` · `ingar_i` · `del_av` · `ersatter` · `ersatts_av` · `kompatibel_med` · `forvaxlas_med` · `tillverkas_av` · `foljer_standard` · `variant_av`

Nya predikat kräver ontologibeslut. Vildvuxna relationer förstör grafen.

⸻

## Verifieringsstegen

1. **Obekräftad** — extraherad, ej granskad
2. **Källbelagd** — minst en oberoende öppen källa
3. **Fältverifierad** — bekräftad av Zoomer-foto
4. **Tillverkarbekräftad** — bekräftad via tillverkarportalen

AI:n exponerar alltid nivån. Kunder ser aldrig obekräftat som sanning.

⸻

## Byggordning: grunden på 90 dagar

**Vecka 1–2.** Ontologin fryses: nio domäner, Tier 1-listan, ID-serier, relationsvokabulär. Schema v1 i drift.

**Vecka 3–6.** Forskningsprotokollet körs på alla 20 Tier 1-klasser → 20 kompletta klassposter, källbelagda.

**Vecka 7–12.** Produktmodellskiktet för de fem mest efterfrågade klasserna — förslag: armaturer, brunnsbetäckningar, kabelskåp, vägmärken, hydranter → de första tusen produktmodellerna med LVX-P-ID. Parallellt: Zoomer-bounties på Tier 1 för fältverifiering och visionsträning.

Därefter växer biblioteket enligt Genome-strategins fabrik: efterfrågestyrt, automatiserat, verifierat.

⸻

## Leveranser i detta paket

* `iol-grundspecifikation.md` — detta dokument
* `lvx-objekt-schema.json` — maskinläsbart schema för klass- och modellposter
* `lvx-taxonomi-tier1.json` — nio domäner + de 20 första objektklasserna med ID
* `lvx-exempel-brunnsbetackning.json` — ifylld exempelpost som mall

Grunden är inte en plan. Den är filerna ovan — implantera, kör protokollet, börja fylla.