Bernt
7d40cf95bf
- FastAPI Identify API (port 8081) - Neo4j propertygraf (64 noder, 80 kanter) - Ingest-pipeline (Python) - Byggscript + integrationstester - Docker Compose setup
9.5 KiB
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:
- Volym — miljontals instanser i fält
- Synlighet — identifierbar från gatunivåfoto
- Efterfrågan — förvaltare och entreprenörer behöver svaret
- Datatillgång — öppna standarder och tillverkardokumentation finns
- 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:
- Identitet — vem, vad, revision, status
- Teknik — dimensioner, material, klasser (IP, belastning, korrosion), livslängd
- Historik — introducerad, utfasad, ersättningskedja
- Geografi — länder, regioner, miljötyper
- Standarder — organ, beteckning, roll (aldrig standardtext)
- AI — kännetecken, särskiljare, förväxlingar, kameravinklar, OCR/typskylt
- Problem — kända fel, alltid med källa
- Dokumentation — referenser med metadata och licensstatus
- Relationer — predikatbaserade kopplingar till andra LVX-ID
- 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:
- Standarder & terminologi. Kartlägg nationella och internationella standarder per marknad. Standarderna definierar klassens gränser, klassificeringar och officiella begrepp på varje språk.
- Marknadskarta. Dominerande tillverkare per land — historiskt och idag.
- Modellkatalog. Produktfamiljer, modeller, revisioner, produktionsperioder, artikelnummer, status.
- Visuell profil. Kännetecken, särskiljande detaljer, förväxlingsrisker, rekommenderade vinklar, typskylt/OCR.
- Livscykel & problem. Livslängd, åldrande, kända fel — endast med källa.
- Relationer. Vad den monteras på, ansluts med, matas från, ingår i, ersätts av.
- 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
- Obekräftad — extraherad, ej granskad
- Källbelagd — minst en oberoende öppen källa
- Fältverifierad — bekräftad av Zoomer-foto
- 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 dokumentlvx-objekt-schema.json— maskinläsbart schema för klass- och modellposterlvx-taxonomi-tier1.json— nio domäner + de 20 första objektklasserna med IDlvx-exempel-brunnsbetackning.json— ifylld exempelpost som mall
Grunden är inte en plan. Den är filerna ovan — implantera, kör protokollet, börja fylla.