Merge commit '04ae3b1599'

shared/examples/veglys-fv-soer/index.md

@@ -0,0 +1,71 @@
+---
+type: index
+okf_version: 0.1
+title: "Veglys fylkesveg sør — LED-utskifting og adaptiv styring"
+description: "OKF-bundle for en fylkeskommunal veglysportefølje med to kandidat-tiltak: LED-utskifting av 2 500 eldre HPS-lyspunkter, og adaptiv styring som utnytter den tillatte vedlikeholdsfaktoren. Bygget rundt et dokumentert norsk evidensgap — uten måler kan realiseringsgraden ikke ses."
+tags: [energieffektivisering, veglys, vegbelysning, M&V, IPMVP, realiseringsgrad]
+timestamp: 2026-08-09
+---
+
+# Veglys fylkesveg sør
+
+En OKF-bundle for **utskifting og styring av veglysanlegg langs fylkesveg**: én portefølje,
+to kandidat-tiltak. Den deler lærings-overflate med bygg-energi-mikro-bundelen, men står på
+egne ben: metode- og kildelaget er **materialisert inn her**, ikke lenket på tvers av
+bundler, og evidensgrunnlaget er **norsk der det teller**.
+
+> Framework-nøytral artefakt (null kode-avhengighet). Deles uendret mellom
+> implementasjonene. Se [shared/README.md](../../README.md).
+
+**Prosjektlaget er fiktivt, litteraturlaget er ekte.** Porteføljen «Fylkesveg Sør» finnes
+ikke; parameterne den er bygget av (installert effekt, brenntimer, energipris,
+realiseringsgrad) er hentet fra navngitte primærkilder og merket `[V]` der de er verifisert.
+Det er samme konvensjon som mikro-bundelen bruker — en produksjons-deployer erstatter
+prosjektlaget med en ekte kunnskapsbase og beholder litteraturlaget.
+
+## Hvorfor veglys
+
+Domenet ble valgt fordi det bærer lærings-overflaten **skarpere enn kontorbygget gjør**.
+
+I et kontorbygg er gapet mellom modellert og realisert besparelse *målbart, men sjelden
+målt*. I norsk veglys er det noe strengere: **NVE og RME dokumenterer at mange veilysanlegg
+mangler måling helt, eller avregnes på estimerte verdier.** Uten meterdata finnes det ingen
+ex-post å sammenligne ex-ante med. Realiseringsgraden er ikke ukjent fordi ingen har regnet
+på den — den er **strukturelt usynlig**.
+
+Det gjør domenet til et godt frø for lærings-sløyfa: den eneste kilden til korreksjon er
+akkumulert ekspert-erfaring, som er nøyaktig det verdict-laget bærer og validatoren ikke kan
+regne. Se [verdict-veglys-fro.md](verdict-veglys-fro.md).
+
+## Innhold (progressiv disclosure)
+
+- [veglys-fv-soer.md](veglys-fv-soer.md) — `type: project` — porteføljen, energibaselinen
+  og rammene.
+- [tiltak-led-utskifting.md](tiltak-led-utskifting.md) — `type: hypothesis` — kandidat-tiltak
+  1: LED-utskifting av 2 500 eldre HPS-lyspunkter. **Det er dette tiltaket som er projisert
+  inn i validatoren.**
+- [tiltak-adaptiv-styring.md](tiltak-adaptiv-styring.md) — `type: hypothesis` —
+  kandidat-tiltak 2: adaptiv styring som henter ut den overdimensjoneringen
+  vedlikeholdsfaktoren allerede tillater. Svakere kildebelagt enn tiltak 1, og merket slik.
+- [metode-ipmvp-a.md](metode-ipmvp-a.md) — `type: methodology` — M&V-metoden (IPMVP
+  Option A), og hvorfor de øvrige opsjonene er stengt for et umålt veglysanlegg.
+- [kilder-veglys-realisering.md](kilder-veglys-realisering.md) — `type: reference` —
+  verifisert litteratur: norske baseline- og regelverksankere, og programlitteraturen
+  realiseringsgraden er lånt fra.
+- [verdict-veglys-fro.md](verdict-veglys-fro.md) — `type: verdict` — frøsatt ekspert-dom.
+  **ExpeL-frøet loopens steg 1 henter fra.**
+
+## Hvordan den kjøres i dag
+
+`validator-input.json` er IR-projeksjonen den eksisterende deterministiske validatoren
+konsumerer uendret; `cost-baseline.json` bærer det samme tallgrunnlaget som prosjektets
+kostdata. **De to filene er bygget fra samme linje aritmetikk og bærer identisk `code`,
+`quantity` og `unit_cost`** — se [tiltak-led-utskifting.md](tiltak-led-utskifting.md),
+§«Mapping til validatoren».
+
+Bundelen ships **uten `golden.json`**. Den blokken er kryss-implementasjons-fasit produsert
+av en seedet Monte Carlo, og commons har ingen kjørbar pipeline å produsere den med. En
+fasit ingen gate leser er verre enn ingen fasit. Lærings-overflaten går ikke tapt: de
+strukturerte feltene ExpeL-folden faktisk henter (`realization_rate`,
+`expected_actual_saving_nok`) ligger i frontmatteren til
+[verdict-veglys-fro.md](verdict-veglys-fro.md), som er der loopen leser dem.