landvex: IOL v3 + Identify API + Neo4j-graf + byggpipeline

- FastAPI Identify API (port 8081) - Neo4j propertygraf (64 noder, 80 kanter) - Ingest-pipeline (Python) - Byggscript + integrationstester - Docker Compose setup
2026-07-05 05:55:48 +00:00
parent 8dcca96185
commit 7d40cf95bf
61 changed files with 22330 additions and 0 deletions
@@ -0,0 +1,55 @@
+# Landvex IOL — Leveransrapport Tier 1
+## Forskningsvåg 1: 20 klassposter, 2026-07-04
+
+⸻
+
+## Vad som levererats
+
+Forskningsprotokollet (steg 1–7) har körts på samtliga 20 Tier 1-klasser. Resultat: 20 kompletta klassposter enligt schemat, fördelade på fyra filer:
+
+* `lvx-klassposter-trp.json` — 8 poster (belysning, vägmärken, signaler, markering, räcken, hållplats)
+* `lvx-klassposter-vat.json` — 3 poster (betäckning, galler, brandpost)
+* `lvx-klassposter-eln.json` — 4 poster (kabelskåp, elstolpe, nätstation, laddstation)
+* `lvx-klassposter-tel-prk.json` — 5 poster (telekomskåp, mast, pollare, papperskorg, cykelställ)
+
+Varje post innehåller teknik, geografi, standarder med roll per marknad, AI-block (kännetecken, särskiljare, förväxlingsrisker, kameravinklar, OCR), problem, relationer och proveniens med käll-URL:er.
+
+⸻
+
+## Källäge: 14 källbelagda, 6 obekräftade
+
+| Nivå | Antal | Klasser |
+|---|---|---|
+| **Källbelagd** (webbkälla verifierad denna våg) | 14 | belysningsstolpe, armatur, vägmärke, signalhuvud, signalskåp, vägmarkering, vägräcke, brunnsbetäckning, dagvattengaller, brandpost, elstolpe, nätstation, laddstation, mobilmast |
+| **Obekräftad** (kunskapsbaserad, väntar källa) | 6 | hållplatsväderskydd, kabelskåp, telekomskåp, pollare, papperskorg, cykelställ |
+
+De sex obekräftade är klasser med svag öppen standardisering — de identifieras via operatörs- och kommunprogram snarare än standarder. De källbeläggs i våg 2 via program- och tillverkardokumentation.
+
+⸻
+
+## Nyckelfynd med källa (urval)
+
+* **Vägmärken US:** MUTCD 11:e utgåvan med Revision 1 (dec 2025) är gällande; delstatsadoption krävdes senast 18 jan 2026. Regelverksskiften på klassnivå = daterbara generationsskiften i fält.
+* **Armaturer:** ANSI C136.15-etiketten anger lamptyp och wattal utvändigt — snabbaste US-identifieringen. Zhaga Book 18 vs NEMA-sockel skiljer EU/US-installationer.
+* **Källbelagt klassproblem:** lila gatubelysning orsakad av fosfor-delaminering i CSP-LED tillverkade ca 2017–2019 — perfekt exempel på "känt problem" AI:n kan flagga från foto.
+* **Elstolpar:** EPA:s penta-utfasning (2022; lager t.o.m. feb 2027) gör impregneringsmedlet till en daterbar egenskap; birthmark-märkningen på stolpen är OCR-guld.
+* **Laddstationer:** SAE J3400/NACS ersätter gradvis CCS1 i Nordamerika — kontaktnivån får en egen ersättningskedja i grafen.
+* **Betäckningar:** klapper, sättning och stöld nu källbelagda som klassproblem (inte längre platshållare).
+
+⸻
+
+## Policyefterlevnad
+
+* Alla fakta bär källa i `proveniens.kallor`; endast referenser och metadata har sparats — inget standardinnehåll.
+* Problem utan källa är markerade **PLATSHÅLLARE — får ej publiceras**. De blir researchjobb i våg 2, inte publika påståenden.
+* Tillverkarlistor är märkta `exempel_tillverkare` (kunskapsbaserade exempel, ej marknadsandelsdata) tills marknadskartan i modellvågen belägger dem.
+
+⸻
+
+## Nästa våg (förslag)
+
+1. **Källbelägg de 6 obekräftade** via operatörs-/kommunprogram och tillverkardokumentation.
+2. **Produktmodellskiktet (LVX-P)** för topp 5: armaturer, brunnsbetäckningar, kabelskåp, vägmärken, brandposter — modellfamiljer, revisioner, produktionsperioder.
+3. **Zoomer-bounties från OCR-fälten:** typskyltar på armaturer, birthmarks på elstolpar, gjutmärken på betäckningar, NEMA/Zhaga-socklar, hydrantmärkning, site-ID på master. Varje kategori tränar visionsmodellen och fältverifierar posterna.
+
+Säg vilken våg vi kör — jag kan börja direkt.
@@ -0,0 +1,63 @@
+# Landvex IOL — Leveransrapport våg 2
+## Full källbeläggning + produktmodellskiktet startat, 2026-07-04
+
+⸻
+
+## Vad som levererats
+
+**Spår 1 — de sex sista klasserna källbelagda.** `lvx-klassposter-vag2-uppdaterade.json` innehåller uppdaterade poster för hållplatsväderskydd, kabelskåp, telekomskåp, pollare, papperskorg och cykelställ. De ersätter versionerna i våg 1-filerna.
+
+**Resultat: 20 av 20 Tier 1-klasser är nu källbelagda.**
+
+**Spår 2 — produktmodellskiktet (LVX-P) startat.** `lvx-produktmodeller-vag2.json` innehåller de första 17 modellposterna, alla källbelagda:
+
+| Klass | Modeller |
+|---|---|
+| Armaturer | GE Evolve ERMC → ERS → ERL (hela kedjan), AEL Autobahn (7 varianter), Schréder Ampera → Ampera EVO, Philips Luma gen2 |
+| Vägmärkesfolier | 3M Diamond Grade DG3 serie 4000, 3M HIP 3930 |
+| Betäckningar | PAM PAMREX, Neenah R-1640/1642-serien |
+| Kabelskåp | ABB Kabeldon CDC-serien |
+| Brandposter | Mueller Super Centurion, M&H 929, AVK Series 27, American-Darling B-84-B, Waterous Pacer |
+
+⸻
+
+## Grafen börjar leva: första ersättningskedjorna
+
+* **GE Evolve:** ERMC (2009) → ERS Scalable (2012, nu utgången) → ERL-serien (aktiv). Tillverkarbekräftad kedja — exakt den historik-dimension visionen kräver.
+* **Schréder:** Ampera → Ampera EVO.
+* **Laddkontakter (från våg 1):** CHAdeMO → CCS1 → SAE J3400.
+
+När QUIXZOOM ser en ERS i fält kan Landvex nu svara: utgången, ersatt av ERL — och vem som säljer ersättaren.
+
+⸻
+
+## Identifieringsguld ur våg 2
+
+* **Philips Luma gen2 bär Service tag** — en QR-kod som gör varje armaturindivid unikt identifierbar med dokumentation. Klass → modell → individ i en skanning.
+* **American-Darling B-84-B levereras med 2D-streckkod** för GIS-inläsning av tillverkningsdata — hydranterna digitaliserar sig själva.
+* **PAMREX** känns igen på gångjärnslocket (130°-öppning) och namnet gjutet i godset.
+* **UK-telekom:** nästan all Openreach-gatuutrustning är grön; PCP-skåp vs FTTC-skåp vs G.fast-podd är läsbara typer.
+* **Sheffield-bygeln** är de facto-standard för cykelparkering — och tapper-plattan nertill avslöjar tillgänglighetsanpassade program.
+
+⸻
+
+## Status för biblioteket
+
+| Skikt | Antal | Källäge |
+|---|---|---|
+| Domäner | 9 | — |
+| Objektklasser Tier 1 | 20 | 20/20 källbelagda |
+| Produktmodeller (LVX-P) | 17 | 17/17 källbelagda |
+| Problem-poster med källa | 10+ | resten flaggade PLATSHÅLLARE |
+
+Detta är kärnan i det API-kunder sedan betalar för: klass → modell → status → ersättare, med källa på varje led.
+
+⸻
+
+## Nästa våg (förslag)
+
+1. **Bredda modellkatalogen** per klass: fler tillverkare per marknad (Ulefos/EJ-modeller, Valtir-räckessystem, Kempower/Alpitronic-laddare, Econolite-skåpfamiljer) — samma protokoll, samma format.
+2. **Zoomer-bounties från OCR-fälten:** typskyltar, Service tag-QR, birthmarks, gjutmärken, hydrantgjutningar, site-ID — varje foto fältverifierar en post och tränar visionsmodellen.
+3. **Tier 2-klasser:** kantsten, betäckningsram, nedstigningsbrunn, skyltstolpe, signalstolpe, fundament, mätarskåp.
+
+Säg vilken så kör jag.
@@ -0,0 +1,49 @@
+# Landvex IOL — Leveransrapport våg 3
+## Tier 2 + bountyprogram + modellkatalog, 2026-07-04
+
+⸻
+
+## Vad som levererats
+
+**1. Tier 2-taxonomin** (`lvx-taxonomi-tier2.json`) — 17 nya klasser med permanenta ID:n, plus **relationskartan** som mappar alla platshållartexter i Tier 1-posterna till riktiga ID:n. Grafen kan nu städas maskinellt: "Betäckningsram (Tier 2 — LVX-ID tilldelas)" → `LVX-VAT-0201`, och så vidare. Räckesterminal fick egen klass (`LVX-TRP-0210`) — terminalerna är egna produktfamiljer med egna krocktest.
+
+**2. Zoomer-bountyprogrammet** (`lvx-zoomer-bountyprogram.md` + `lvx-zoomer-bounties-vag1.json`) — flyhjulet aktiverat. 16 konkreta bounties härledda ur klassposternas OCR-fält, med poängmodell, femstegsverifiering, hårda säkerhetsregler och integritetsskydd. SaaS-kopplingen är inbyggd: när en API-kund får "obekräftad" som svar skapas automatiskt en bounty — betalande efterfrågan styr fältarbetet.
+
+**3. Nio nya produktmodeller** (`lvx-produktmodeller-vag3.json`) — biblioteket är nu uppe i **26 modeller**, alla källbelagda:
+
+| Klass | Nytt i våg 3 |
+|---|---|
+| Betäckningar | Ulefos (grundat 1657 — fältexempel med gjutkod verifierat), EJ ERGO/ERGO XL |
+| Vägräcken | MGS 31-tum (generiskt, MASH TL-3 — skarv mellan stolpar är signaturen) |
+| Räckesterminaler | Valtir SoftStop (MASH TL-3, ny klass LVX-TRP-0210) |
+| Signalskåp | Econolite Blue Series (NEMA TS 2) |
+| Laddstationer | Kempower Satellite (distribuerad arkitektur), Alpitronic Hypercharger HYC-serien, Tesla Supercharger V3 → V4 |
+
+⸻
+
+## Grafen växer: nya kedjor och signaturer
+
+* **Tesla V3 → V4:** ny tillverkarbekräftad generationskedja. V4 känns igen på kortläsare + display och dekalen 1000 V/615 A; "true V4" på det separata 1,2 MW-kabinettet.
+* **Arkitektur som klassificerare:** smal stolpe + separat kraftenhet = distribuerat system (Kempower, HYC1000, Tesla true V4); bred monolit = all-in-one (HYC400). AI:n kan läsa laddplatsens topologi, inte bara stolpen.
+* **MGS-signaturen:** balkskarv mitt emellan stolparna + 31-tumshöjd skiljer moderna räcken från äldre — synligt från trottoaren, inget OCR behövs.
+
+⸻
+
+## Status för biblioteket
+
+| Skikt | Antal |
+|---|---|
+| Domäner | 9 |
+| Objektklasser | 37 (20 Tier 1 källbelagda + 17 Tier 2) |
+| Produktmodeller (LVX-P) | 26, alla källbelagda |
+| Aktiva bounties | 16 (täcker 12 Tier 1-klasser) |
+
+⸻
+
+## Nästa våg (förslag)
+
+1. **Datastädning:** kör relationskartan över alla poster, koppla ihop grafen.
+2. **Tier 2-forskningsprotokoll:** kör de sju stegen på de 17 nya klasserna.
+3. **Kunddemo/pilot-API:** klass → modell → status → ersättare med källa på varje led — paketet finns nu för att visa första betalande kunden.
+
+Säg vilken så kör jag.
@@ -0,0 +1,51 @@
+# Landvex IOL — Leveransrapport våg 4
+## Grafen ihopkopplad + pilot-API-paketet, 2026-07-04
+
+⸻
+
+## Vad som levererats
+
+**1. Datastädningen — körd på riktigt.** Konsolideringsscriptet (Python, i containern) läste samtliga vågars filer, arbetade in våg 2-uppdateringarna, mappade om relationerna enligt Tier 2-relationskartan och validerade varje post mot schemat.
+
+Resultat:
+
+| Mätpunkt | Utfall |
+|---|---|
+| Klassposter konsoliderade | 20 (6 våg 2-versioner inarbetade) |
+| Produktmodeller | 26 |
+| Relationer ommappade till Tier 2-ID | 14 |
+| Grafkanter totalt | 115 |
+| — upplösta LVX→LVX-kanter | 61 |
+| — standardkanter (foljer_standard) | 46 |
+| Olösta textnoder kvar | 7 |
+| **Valideringsfel** | **0** |
+
+De 7 kvarvarande textnoderna är äkta framtidsklasser: nättopologierna (access-, distributions-, mellanspänningsnät), vägbana/beläggning, teknikbod, vattenledningsnät samt fleet-referensen "CCS1-utrustade stationer". De ligger listade i graffilen och blir Tier 2/3-beslut.
+
+**Filer:** `lvx-klassposter-master-v1.json` (ersätter de fem tidigare klasspostfilerna som arbetskopia) och `lvx-graf-kanter-v1.json` (hela grafen som kantlista).
+
+**Ontologibeslut v1.1:** predikatet `tillhor_klass` (produktmodell → objektklass) infört för grafexporten.
+
+**2. Pilot-API-paketet** (`lvx-pilot-api-spec.md`) — produkten ovanpå biblioteket. Sex endpoints, svarskontrakt där verifieringsnivå, konfidens och källor är obligatoriska, PLATSHÅLLARE-filtrering inbyggd i serialiseringen (juridiken sitter i kontraktet), feedback-endpoint som skapar bounties, och SaaS-paketeringen Pilot / Pro / Enterprise med prisprinciper.
+
+**3. Golden demo-svar** (`lvx-api-demosvar.json`) — tre säljcase på riktiga poster:
+
+* **Case 1:** ERS-armatur identifierad → *utgången, ersatt av ERL* — ersättningskedjan är svaret
+* **Case 2:** hydrant åldersbestämd till 1998 direkt ur gjutgodset — OCR-guldet i praktiken
+* **Case 3:** okänd modell → ärlig klasskandidat + automatiskt skapad bounty — flyhjulet synligt för kunden
+
+⸻
+
+## Vad detta betyder
+
+Biblioteket är inte längre bara filer — det är en validerad graf med noll fel och ett säljbart kontrakt ovanpå. Pilotdemon kan hållas med materialet som ligger i outputs-mappen: spec + tre cases + grafen som bevis.
+
+⸻
+
+## Nästa våg (förslag)
+
+1. **Tier 2-forskningsprotokollet** — kör de sju stegen på de 17 nya klasserna (störst datalyft).
+2. **Pilotpitch-deck** — paketera våg 1–4 till presentation för första designpartnern.
+3. **Tillverkarportalen v0** — spec för hur tillverkare verifierar sina egna modellposter (fjärde verifieringsnivån).
+
+Säg vilken så kör jag.
@@ -0,0 +1,53 @@
+# Landvex IOL — Leveransrapport våg 5
+## Tier 2-forskningsprotokollet, 2026-07-04
+
+⸻
+
+## Vad som levererats
+
+**Alla 17 Tier 2-klasser har nu fullständiga poster** enligt forskningsprotokollet — 6 nya webbverifierade standardspår plus återanvändning av tidigare vågors källor.
+
+| Fil | Innehåll |
+|---|---|
+| `lvx-klassposter-tier2-trp.json` | 10 poster: skyltstolpe, signalstolpe/mastarm, fundament, styrnod, vägportal, kantsten, reflexstolpe, broräcke, bullerskydd, räckesterminal |
+| `lvx-klassposter-tier2-ovriga.json` | 7 poster: betäckningsram, nedstigningsbrunn, dagvattenbrunn, ventilbetäckning, mätarskåp, kabelbrunn, parkbänk |
+| `lvx-klassposter-master-v2.json` | Hela biblioteket konsoliderat — 37 klasser |
+| `lvx-graf-kanter-v2.json` | Grafen v2 |
+
+**Nya källbelagda standardspår (denna våg):**
+
+* **EN 12767** (+A1:2024) — passiv säkerhet för stolpar och fundament, klasserna HE/LE/NE → skyltstolpe, fundament
+* **EN 1340 / EN 1343** — betong- respektive naturstenskantsten (UK-väghållarkrav MCHW verifierat) → kantsten
+* **EN 12899-3** — reflexstolpar och retroreflektorer, inkl. påkörningskrav och klasser som WL1/D1–D3 → reflexstolpe
+* **EN 14388 + EN 1793/1794** — bullerskyddens produktstandard, akustik (DLR/DLα) och mekanik → bullerskydd
+* **ASTM C478 / AASHTO M199** — prefabbrunnsdelar (ringar, konor, justerringar) → nedstigningsbrunn; EN 1917 markerad "kartläggs"
+* **ANSI/SCTE 77 + NEC 314.30** — kabelbrunnars tier-lastklassning (Tier 5/8/15/22 = designlast × 1000 lb, provlast +50 %) → kabelbrunn
+
+⸻
+
+## Bibliotekets tillstånd efter konsolidering v2
+
+| Mätpunkt | v1 (våg 4) | **v2 (nu)** |
+|---|---|---|
+| Objektklasser | 20 | **37** |
+| — källbelagda | 20 | **31** |
+| — obekräftade | 0 | 6 |
+| Produktmodeller | 26 | 26 |
+| Grafkanter | 115 | **167** |
+| — LVX-upplösta | 61 | **79** |
+| — standardkanter | 46 | **74** |
+| Valideringsfel | 0 | **0** |
+
+De 6 obekräftade (signalstolpe, fundament, vägportal, dagvattenbrunn, ventilbetäckning, parkbänk) är ärligt markerade och blir nästa researchmål — flera väntar på AASHTO LTS- och EN 1917-källor.
+
+**Olösta textnoder: 13.** Tier 2-relationerna pekade ut nya framtidsklasser (avstängningsventil, brokantbalk, dagvattennät m.fl.) — grafen talar nu själv om vad Tier 3 bör innehålla. Två varianter av "Vägbana/beläggning" ska slås ihop i nästa städning.
+
+⸻
+
+## Nästa våg (förslag)
+
+1. **Pilotpitch-deck** — våg 1–5 paketerat som presentation för första designpartnern.
+2. **Källbelägg de 6 obekräftade** + EN 1917 (litet, fokuserat researchpass).
+3. **Tillverkarportalen v0** — spec för tillverkarbekräftad-nivån.
+
+Säg vilken så kör jag.
@@ -0,0 +1,53 @@
+# Landvex IOL — Leveransrapport våg 7
+## Ingest-automationen byggd och körd, 2026-07-04
+
+⸻
+
+## Vad som levererats
+
+**Datafabriken finns nu som körbar kod.** Kedjan Källor → Skördare → Källpaket → Extraktor → **Ingest** → Master/Graf/Bounties är byggd, dokumenterad och demonstrerad på en riktig batch.
+
+| Fil | Roll |
+|---|---|
+| `ingest.py` | Pipelinens deterministiska kärna: entitetsupplösning, merge-policy, ID-mintning, validering, grafexport, bounty-generator |
+| `lvx-ingest-spec.md` | Arkitektur, driftköer, kostnadsmått, miljönot |
+| `lvx-extraktionsprompt.md` | LLM-kontraktet för extraktionssteget |
+| `lvx-id-register.json` | ID-serier — pipelinen mintar, skriver tillbaka, återanvänder aldrig |
+| `intag/kallpaket-vag7.json` + `intag/kandidatposter-vag7.json` | Demobatchen: skördarens referat och extraktorns patchar |
+
+**Merge-policyn i korthet:** källor unionas på URL, standarder ersätts på normaliserad beteckning ("kartläggs" → skarp utgåva), tomma fält fylls men ifyllda skrivs aldrig över (konflikt ⇒ granskningskö), nivålyft endast uppåt och källbelagd kräver källor.
+
+⸻
+
+## Demokörningen — verkliga siffror
+
+3 nya skördepass (AASHTO LTS, EN 1917, ASTM C913) + 1 korsreferens utan ny skörd:
+
+| Mätpunkt | Utfall |
+|---|---|
+| Uppdaterade poster | 5 |
+| Nya poster (ID mintat) | 1 — **LVX-P-0000027 EJ SELFLEVEL** (register → 28) |
+| Nivålyft obekräftad → källbelagd | **4** (signalstolpe, fundament, vägportal, dagvattenbrunn) |
+| Nya källor / standardposter | 9 / 9 (varav EN 1917 "kartläggs" ersatt av EN 1917:2002) |
+| Konflikter / valideringsfel | **0 / 0** |
+| Auto-genererade bounty-förslag | 17 (`lvx-bounty-kandidater-vag7.json`) |
+
+**Biblioteket efter v3:** 37 klasser — **35 källbelagda**, 2 obekräftade (ventilbetäckning, parkbänk) · 27 modeller · 176 grafkanter (80 LVX-upplösta, 82 standardkanter).
+
+Notera korsreferens-lyftet: fundamentklassen blev källbelagd med en redan skördad källa — noll ny skördkostnad. Det är exakt den sortens gratis-lyft produktionspipelinen ska hitta själv, och det syns direkt i kärnmåttet kostnad per verifierat faktum.
+
+⸻
+
+## Driftmodellen (SaaS-kopplingen)
+
+Tre köer matar skördaren: schemalagd omkontroll, **kunddriven** (svaga API-svar och feedback skapar riktade skördejobb + bounties) och fältkön (godkända Zoomer-foton lyfter till fältverifierad). Betald efterfrågan styr var fabriken gräver — intäkten bär datakostnaden.
+
+⸻
+
+## Nästa våg (förslag)
+
+1. **Fältflödet:** individposter (LVX-I) + foto-ingest-steget som sätter *fältverifierad* — sista pusselbiten i trappan.
+2. **Skörda med automationen:** kör 2–3 nya batchar (t.ex. BYG-domänen eller fler modeller) genom exakt samma pipeline.
+3. **Tillverkarportalen v0:** flödet som sätter *tillverkarbekräftad*.
+
+Säg vilken så kör jag.