Bernt
7d40cf95bf
- FastAPI Identify API (port 8081) - Neo4j propertygraf (64 noder, 80 kanter) - Ingest-pipeline (Python) - Byggscript + integrationstester - Docker Compose setup
203 lines
9.5 KiB
Markdown
203 lines
9.5 KiB
Markdown
# 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.
|