Appearance
Formulář měřidla — mapování z EM2 a úkoly do migrace
Doplněk k zadání formuláře: odkud pole pocházejí a co se musí vyřešit při převodu dat z EM2. Zdroj: formulář EM2 GaugeCreateFormType a jeho části (GaugeEndPointType, GaugeIdentificationType, CustomerIdentificationType, ConsumptionType, ProductionType, GaugeInvoicingType, GaugeRemoteReadingsType), repozitář e-manazer @ 1ae300f8, popisky z DictionaryFixtures.php.
1. Jak to dělá EM2 (úrovně a přepínání polí)
EM2 má tři úrovně: Hlavní, Podružné a Fiktivní přefakturační. Formulář je jeden a pole se přepínají pravidly show_if / hide_if / required_if podle úrovně, druhu (média), parametrů měření a typu odběru.
- Hlavní: volí se médium. Identifikační číslo odběrného místa je povinné a jeho název se mění podle média. Zobrazí se typ odběru a navazující tarifní pole, primární zdroj, hromadný nákup a „Data ve výstupech“ (uvádět / neuvádět).
- Podružné i fiktivní: povinné nadřazené měřidlo. Médium a jednotka fakturace se převezmou z nadřazeného a pole médium se skryje. Identifikační číslo, číslo OM, typ odběru, sazba, jistič, TDD a primární zdroj se nezobrazí. Místo „Data ve výstupech“ je volba zahrnout / odečíst. U výroby se volí „Měřidlo“ (typ výroby: FVE, akumulace baterie, ohřev vody, nabíjení elektromobilu, jiné).
- Fiktivní navíc skrývá typ/model a umístění.
- Po uložení se úroveň ani nadřazené měřidlo v běžném formuláři změnit nedají (EM2 má pro změnu úrovně zvláštní formulář a roli).
2. Rozsah EM2 a co s ním v EM3
Legenda sloupce EM3: převzít · upravit · přesunout (patří jinam) · vypustit.
2.1 Zařazení OM (GaugeEndPointType)
| Pole EM2 | Kdy se zobrazí / povinné v EM2 | EM3 |
|---|---|---|
| Objekt | vždy, po uložení mění jen role | převzít — výběr ze stromu |
| Úroveň měřidla | vždy ★, po uložení zamčené | upravit — „Druh měřidla“: Hlavní · Podružné · Virtuální |
| Nadřazené měřidlo | podružné a fiktivní ★ | převzít — jen podružné |
| Druh měřidla (médium) | hlavní ★; u ostatních z nadřazeného | převzít — „Médium“ |
| Primární zdroj energie + „Zdroj energie“ (text u „jiné“) | hlavní, kromě teploměru a KVP | převzít obojí |
| Parametry měření (spotřeba / výroba / spotřeba + výroba) | hlavní ★ | upravit — seznam Měřené parametry (zadání) |
| Účel užití | spotřeba elektřiny, plynu, tepla a paliva ★, verzovaný | upravit — pole měřidla Účel užití (usageType), s historií; EM2 ho měl u parametru |
| Spadá do hromadného nákupu | hlavní, elektřina a plyn | převzít — sekce Fakturace |
| Sdílení elektřiny — spotřební / výrobní EAN | hlavní elektřina, podle parametrů | převzít |
| Centrální dodávka | hlavní, mimo elektřinu a plyn | převzít — sekce Fakturace |
| Měřidlo (typ výroby) | podružné s výrobou ★ | převzít — sloupec u parametru Výroba |
| Data ve výstupech | hlavní: uvádět/neuvádět; ostatní: zahrnout/odečíst | upravit — „Započtení do celkové spotřeby“ (zadání) |
| ID měřidla | po uložení, jen ke čtení | převzít |
2.2 Identifikace měřiče (GaugeIdentificationType)
| Pole EM2 | Kdy / povinné | EM3 |
|---|---|---|
| Název | vždy ★ | převzít |
| EAN – spotřeba | hlavní elektřina ★, 18 znaků, unikátní | převzít |
| EAN – výroba | hlavní elektřina s výrobou | převzít — „EAN — dodávka / výroba“, vždy nepovinné (23. 9.) |
| EIC kód | hlavní plyn ★, 16 znaků | převzít |
| Identifikační číslo | hlavní voda a teplo ★ | převzít |
| VIN kód / výrobní číslo | hlavní PHM ★ | převzít |
| Evidenční číslo | hlavní palivo, teploměr, KVP ★ | převzít |
| Číslo odběrného místa | jen hlavní, mimo PHM, teploměr a KVP | převzít — samostatné pole vedle EAN/EIC |
| Číslo měřidla | mimo PHM, teploměr, KVP | převzít — „Výrobní číslo měřidla“, s historií |
| Typ/model | mimo fiktivní | převzít |
| Umístění měřiče | mimo PHM a fiktivní | převzít |
| Typ odběru | hlavní elektřina a plyn ★ | převzít (viz zadání, bod 4) |
| Počet fází + jistič | hlavní elektřina maloodběr ★, verzované | převzít |
| Sazba | hlavní elektřina maloodběr ★, číselník rates (25 kódů, booleany VT / NT / ST), verzovaná v gauge_rate | převzít a povýšit — platformní číselník distributionRate s tariffScheme a správou v adminu; historie gaugeDistributionRateHistory 1:1 z gauge_rate (M7) |
| Typový diagram (TDD) elektřina | po uložení, jen ke čtení | převzít jen ke čtení |
| Typ měření (A/B/C, u plynu A/B/C/Cm/S) | hlavní maloodběr | převzít |
| Rezervovaný příkon, Rezervovaná kapacita | hlavní (v EM2 podmínka „maloodběr“) | převzít — podmínku ověřit: rezervovaná kapacita patří spíš k velkoodběru |
| Denní rezervovaná kapacita (m³) | hlavní plyn | převzít |
| Třída TDD plynu | hlavní plyn; ★ při hromadném nákupu | převzít |
| Roční spotřeba | hlavní plyn s TDD DOM1–4 ★ | převzít |
| Distribuční sazba plynu | hlavní plyn, nabídka podle TDD | převzít |
| Využití odběrného místa | hlavní plyn, nabídka podle TDD | převzít |
| Spalné teplo objemové | hlavní plyn, verzované | přesunout — karta Výhřevnost (Calorific Value Management) |
| Nízký tarif, Špičkový tarif | velkoodběr VN a VVN (forceLowTariff, forceSpecialTariff) | převzít — jen u VN / VVN, přesunuto do Zařazení; u maloodběru zapnuté hodnoty zahodit s reportem (M7) |
| Komentář | vždy | převzít |
| Odkaz na portál | vždy | převzít — „Odkaz na portál distributora“ |
| Fotografie | vždy, jeden obrázek | převzít |
2.3 Identifikace odběratele (CustomerIdentificationType)
| Pole EM2 | EM3 |
|---|---|
| IČO odběratele (načtení z ARES), předvyplněné vlastníkem objektu | upravit — výběr organizace z registru (ARES), předvyplněný vlastníkem objektu |
| Název odběratele | upravit — z organizace |
| Kontaktní e-mail, Číslo účtu | přesunout — údaje organizace, na měřidle jen ke čtení |
2.4 Ruční odečty — spotřeba / výroba (ConsumptionType, ProductionType)
Každý parametr měl v EM2 vlastní skupinu polí. V EM3 je to řádek v tabulce Měřené parametry.
| Pole EM2 | Kdy / povinné | EM3 |
|---|---|---|
| Frekvence odečtů (roční, měsíční, týdenní, denní; „žádné“ při primárním dálkovém odečtu) | ★ | převzít — sloupec |
| Jednotka | ★, verzovaná | převzít — sloupec, s historií |
| Objemový koeficient / Koeficient ohřevu vody (u vody) | výchozí 1, verzovaný | převzít — sloupec „Koeficient“, s historií (volumeCoefficient) |
| Kontrola frekvence primárních odečtů | přepínač | převzít — přepínač pod tabulkou |
2.5 Automatizované odečty (GaugeRemoteReadingsType)
| Pole EM2 | EM3 |
|---|---|
| K dispozici, Nastavit jako primární | upravit — „Primární způsob odečtu“ = priorita zdrojů (výchozí podle klienta) |
| Datum zprovoznění, typ zapojení, optočlen/vysílač, způsob zasílání, SIM, výstup, počet impulzů, identifikace dálkového měření, napájení, výměna baterie | přesunout — Provoz → API konektory (koncový bod dálkového odečtu) |
2.6 Fakturace (GaugeInvoicingType)
| Pole EM2 | Kdy / povinné | EM3 |
|---|---|---|
| Jednotka fakturace | hlavní a podružné se spotřebou ★; u podružného z nadřazeného | převzít |
| Frekvence fakturace spotřeby | vždy | převzít |
| Frekvence záloh | mimo samotnou výrobu | převzít |
| Aktuální dodavatel, Platnost smlouvy do | mimo samotnou výrobu | přesunout — ze smlouvy, na měřidle jen ke čtení |
| Distributor elektřiny | elektřina | převzít — sekce Elektrické parametry |
| Jednotkové smluvní ceny, paušální poplatek za OM | podle média | přesunout — Contract Management |
| Rozsah plateb (vodné, stočné, srážky) | voda | převzít |
| Frekvence fakturace příjmů, Aktuální odběratel (výroby) | hlavní s výrobou | převzít — „Odběratel dodávky“ |
3. Otázky a úkoly do migrace
Body, které se musí vyřešit při převodu dat z EM2, ne při stavbě formuláře.
| # | Co | Proč |
|---|---|---|
| M1 | Export OM s vyplněnou rezervovanou kapacitou a příkonem — před změnou podmínek zobrazení | Feature id26 obrací zobrazení z maloodběru na velkoodběr. Dokud nevíme, u kterých OM jsou hodnoty vyplněné, hrozí, že se stanou neviditelnými a při další editaci se ztratí. Vyžádáno přímo v zadání id26. |
| M2 | Fiktivní přefakturační měřidlo z EM2 — virtuální s ručním zadáním, nebo podružné s volbou „odečíst“? | Rozhoduje o tom, jak se tato měřidla převedou a jak se budou chovat ve vzorci objektu. |
| M3 | Hodnoty účelu užití — plná sada číselníku usageType (R4) | Migrační CLI dnes mapuje jen 1 → heating, 2 → hotWater, 3 → other a vše ostatní odmítá. Nově: 1 heating · 2 hotWater · 5 other · 6 lighting · 7 baseLoad; 3 / 4 / 8 nejsou účely, ale režim alokace (M8). Mapování purpose 3 na export opravit (kód 3 je dodávka / přetoky). |
| M4 | Přenos 1:1 na kanál, žádné slučování. | |
| M5 | Měřidla bez účelu užití (EM2 kód 0, 5 236 kanálů na stagingu) | Rozhodnuto (D01): bez alokace = Neurčeno; výpočet je zobrazí jako neurčenou část, nic se nedoplňuje. Report pro klienty k doplnění. |
| M6 | Jednotka a koeficient měřidla → gaugeSourceSetting | Dnešní hodnota se převede do ruční sady; historie koeficientů se rozdělí podle zdroje. |
| M7 | Distribuční sazba a tarifní dimenze odečtů — rates jako seed migrace v platform backendu (read-only v1, ID deterministická z rates.id) | rates → seed distributionRate (high&low → dual, jinak single; ID zachovat); gauge_rate → gaugeDistributionRateHistory 1:1. Odečty: segment 2 (VT) u měřidla, které mělo v readAt jednotarifní sazbu nebo žádnou, se převede na tariff = total; segment 2 u dvoutarifní sazby → high, segment 3 → low. Tabulku Migration from legacy segments v Confluence Data Model („segment 2 → high“ bez podmínky) upřesnit. Report: elektroměry maloodběr bez sazby (doplnit sazbu), měřidla s forceLowTariff / forceSpecialTariff mimo VN / VVN (hodnota se zahazuje). |
| M8 | Alokace účelu užití — gauge_consumption_usage + gauge_consumption_usage_combi → gaugeUsageAllocation / gaugeUsageAllocationItem | Kódy 1, 2, 5, 6, 7 → single; 4 → estimated s měsíčními podíly z combi (implicitní zbytek EM2 → explicitní podíl heating, aby měsíc dával 100 %); 3 / 8 → measured s podružným kanálem jako zdrojem a druhým účelem jako dopočtem; 0 → bez záznamu. validFrom = datum migrace. Report: kanály, jejichž podíly v EM2 nedávají 100 %, a měřené režimy bez platného podružného zdroje. |