Skip to content
Updated Oct 6, 2026 by Pablo Coufal · Owner: analysisactiveconventionconfluence-migration Edit on GitHub

Slovník EM2/EM3 (Czech reference) ​

What this document is (English preamble): This file is a verbatim reference migration of the Confluence page tree "Průřezový slovník pojmů — EM2 a EM3" (cross-cutting terminology glossary, Confluence space SV, page id 719126537 and its 8 child pages). It is kept in Czech, as-is — not translated — because it is source reference material, not a document meant to be read in English.

Scope: this glossary covers terminology for both EM2 (the legacy e-manažer system) and EM3 (E-manažer 3.0), side by side, including how each term maps between the two systems' code (tables, columns, entities, enums). It is not an EM3-only glossary.

Relationship to the canonical glossary: this file is deliberately kept separate from docs/porsenna/conventions/glossary.md (the canonical, EM3-focused project glossary) and is not subject to that glossary's per-term propose-and-approve process. It exists purely as supplementary reference material migrated from Confluence. If a specific term from this document is needed in the canonical glossary, it must go through the normal propose-and-approve process for glossary.md on its own merits — nothing here is pre-approved for inclusion there.

Migrated from Confluence on 2026-09-11. Source pages: parent 719126537, children 726761490, 727810049, 726892548, 726925330, 727351321, 727416839, 726728710, 727351299 (space SV, E-manazer Product Development).


Below this line, all content is in Czech and preserved as close to the original Confluence wording as the markdown export allows (tables, notes, and the "Past na překlad" — translation-trap — entries included).


Tenhle slovník sjednocuje názvosloví EM2 a EM3 na jednom místě. Pro každý pojem uvádí český termín, anglický protějšek, název v kódu EM2 i v kódu EM3 vedle sebe, stručný význam a poznámku k mapování. Jednotlivé stavební kameny jsou na podstránkách; tahle stránka nese pravidla zápisu, past na překlad a zdroje.

ÚčelSpolečný jazyk pro business zadání, Feature Docy, Jira tickety a komunikaci se stakeholdery. Zdroj pravdy pro překlad CZ ↔ EN a pro mapování názvů mezi EM2 a EM3.
RozsahEM2 (stávající e-manažer) i EM3 (E-manažer 3.0). Vytěžen celý strom prostoru E-manažer 3.0 včetně migračních map.
Stav dokumentuK PROJITÍ — kde stránky EM3 český ekvivalent neuvádějí a nedá se spolehlivě odvodit, je český sloupec prázdný a platí anglický název.
Aktualizováno9/10/2026

Jak slovník číst ​

Každá tabulka na podstránkách má šest sloupců:

  • Český pojem — jak se o věci mluví v zadání a se stakeholderem. Prázdné pole znamená, že český termín zatím neexistuje a používá se anglický; není to chyba, ale místo k doplnění.
  • English — anglický termín pro mezinárodní dokumentaci a názvy ticketů.
  • EM2 v kódu — název tabulky, sloupce nebo třídy ve stávajícím systému.
  • EM3 v kódu — název entity, atributu nebo hodnoty číselníku v novém systému.
  • Význam — jedna až dvě věty, co pojem znamená v byznysu, ne v databázi.
  • Mapování a poznámky — co se mezi systémy mění, kde je regres, co blokuje.

Pravidla zápisu ​

Jeden pojem má v každém systému jeden kanonický tvar. Druhý tvar se neopakuje, protože se odvodí mechanicky.

EM3Doménový tvar entita.atribut v camelCase, tak jak ho uvádějí entity stránky — například gauge.circuitBreaker. Tentýž sloupec je v databázi circuit_breaker; převod je mechanický a v tabulkách se neuvádí.
EM2Tvar tabulka.sloupec, protože s EM2 se pracuje hlavně přes databázi. Název třídy se uvádí jen tam, kde pojem není sloupec, ale chování — DistributionRateOptimazer, VatHelper.
Hodnoty číselníkůPřesně tak, jak je definuje příslušná stránka Static Enums — reportOnly, remote_manual_invoice, KWH. Varianty velkými písmeny z Data Modelu (REPORT_ONLY, CAMPUS) kanonické nejsou.
Třídy, soubory, databázové objektyDrží si vlastní tvar a jsou popsané slovem — degree-days.rules.ts, pohled best_available, tabulka gauge_phaze_and_breaker.

Značky v obou kódových sloupcích:

—V tomto systému neexistuje.
?Existuje, ale přesný název se v podkladech nepodařilo dohledat.
(návrh)V EM3 zatím jen navržené, neimplementované. Entity, které jsou zatím jen v Data Modelu, uvádíme ve stejném tvaru jako ostatní a původní zápis zmiňujeme v poznámce.

Slovník názvy zaznamenává, nevymýšlí. Pravidla, jak se mají věci v EM3 jmenovat, patří na samostatnou stránku s konvencemi; slovník se jimi jen řídí.

Past na překlad ​

Nejdůležitější část celého slovníku. Každý řádek už jednou způsobil nedorozumění v zadání nebo v kódu.

PojemVýznam AVýznam BJak to rozlišit
outputModeEM2 a stránka Ingestion Management: formát odečtu, kumulativní proti přírůstkovému.EM3 Static Enums: režim zahrnutí měřidla do bilance budovy.Formát odečtu se v EM3 jmenuje gauge.readingMode a reading.format. Stránku Ingestion Management je potřeba opravit.
primarySourceEM2 i Static Enums EM3: palivo nebo zdroj energie.Návrh tolerancí EM3-57 a EM3-223: totéž pole se čte jako způsob odečtu, ruční proti dálkovému.Sémantický posun, který mění význam existujícího nastavení. Řeší OR-4 Epicu 3.5 — nutné rozhodnout před migrací.
Typ měřidlaEM2 gauges.type: elektroměr, plynoměr, vodoměr, kalorimetr — odpovídá médiu v EM3.EM3 gauge.kind:standard, subGauge, virtual — strukturální typ, ne médium.„Typ měřidla" z EM2 zadání se téměř vždy překládá jako medium. Číselné hodnoty se navíc neshodují a migrace používá překladovou mapu.
Rodič a potomek u měřidlaEM2 parent_gauge_id: hlavní měřidlo a jeho podružné.EM3 gauge.physicalMeterId: kanály jednoho fyzického přístroje, symetricky, žádný není hlavní.Obojí vypadá jako strom, ale znamená to něco jiného. EM3 si obě věci drží zvlášť.
PřetokEnergetika: přetok do sítě, tedy export a dodaná energie.Kontroly: přetok limitu, tedy překročení hodinového limitu spotřeby.V angličtině dvě různá slova: Export / Feed-in proti Limit overflow.
CO₂Modul Emise: vypuštěné emise v tunách.KVP: koncentrace v ppm z čidla vnitřního prostředí.Jednotka je spolehlivý rozlišovač: t proti ppm.
SegmentEM2 Segment: jeden plochý číselník kombinující veličinu, směr i tarif.Chart Engine EM3: kombinace typu, směru, tarifu, zdroje a formátu.Hodnoty se nepřekrývají jedna ku jedné — při migraci mapovat, ne přejmenovat. Stejný číselník sdílely odečty i položky faktur.
Výpočtová spotřeba proti spotřebě virtuálního měřidlaVýpočtová spotřeba (buildingCalculatedConsumption): hodnota z energetického auditu.Spotřeba virtuálního měřidla (reading.source = calculated): dopočet vzorcem z jiných měřidel.Anglicky obojí zní jako calculated consumption. Starší označení „systémově vypočtená spotřeba" se už nepoužívá (EM3-321).
Referenční spotřebaVýchozí spotřeba, tedy baseline z referenčního roku.Výpočtová spotřeba z auditu, nebo klouzavý průměr.Vždy doplnit, o kterou jde. Volbu pro EM3 řeší OR-1 Epicu 3.3, na kterém závisí i OR-4 Epicu 3.7.
Dodavatel proti distributoroviDodavatel (contractSupplier): obchodník, se kterým je uzavřená smlouva.Distributor (client.electricityDistributorId): provozovatel fyzické sítě.EM2 názvosloví je nedůsledné: GasSupplier a gas_supplier_id jsou ve skutečnosti distributor. Migrace to opravuje, sjednocení je úkol Epicu 8.2.
AgregátorDatový agregátor: rušená EM2 aplikace pro příjem a normalizaci dat.Agregátor flexibility: subjekt slučující kapacitu více objektů pro podpůrné služby.Zcela nesouvisející pojmy, které se v češtině jmenují stejně.
AktivacePodpůrné služby: okno, kdy provozovatel soustavy vyvolá dodávku nebo odběr.Běžný provoz: zapnutí modulu, aktivace uživatele.Aktivace podpůrné služby zkresluje bilanci objektu a musí se označit značkou intervalu.
Vytápěná plochaEM2 building_heated_area (entita BuildingHeatedArea): v UI „Celková energeticky vztažná plocha"; plocha, ke které se vztahují měrné ukazatele.EM3 buildingParameter.areaEnergyReference: totéž — EVP.Stejná hodnota; „heated" je jen název tabulky. Nehledat v EM3 samostatnou „vytápěnou plochu".
Meteostanice objektubuilding.climateStationId — pole s climate.weatherStation, clientWeatherStation — entita s weather.Cizí klíč míří na weatherStation, přestože se jmenuje climate…. Při hledání zkusit obě slova.
Výroba FVEGauge Management:export a reportOnly.outputMode + direction:include a import.Rozpor v návrhu, na jednom objektu rozdíl 1 800 kWh. Nahlášeno k opravě.
VOVeřejné osvětlení, nejčastější význam.Velkoodběr.Rozlišuje kontext; v zadání raději rozepsat.
VýchozíVýchozí spotřeba je baseline, hodnota referenčního roku.Výchozí hodnota je default, přednastavená volba.V angličtině Baseline proti Default — nikdy nepřekládat „výchozí spotřeba" jako Default consumption.
Výhřevnost proti spalnému tepluVýhřevnost (net calorific value) — koeficient převodu paliva na energii používaný v EM2 i EM3.Spalné teplo (gross calorific value) — jiná, vyšší hodnota, uváděná u přepočtu plynu.Datový model je zmiňuje vedle sebe; pro výpočet je potřeba vědět, která hodnota je v poli uložená.

Co ještě chybí a je potřeba doplnit ​

  • Prázdné buňky v českém sloupci označují pojmy, pro které tým zatím český termín nemá — především produkty podpůrných služeb, yr.no, webhook a RFC 7807. U technických standardů je anglický název v pořádku; u ostatních stojí za to termín dohodnout.
  • Otazníky v kódových sloupcích jsou místa, kde pole prokazatelně existuje, ale přesný název není v podkladech — zejména třída PENB a evidenční čísla odběrných míst mimo elektřinu a plyn.
  • Verzovaná nastavení měřidla (gauge_rate, gauge_unit_price, gauge_invoice_unit, gauge_phaze_and_breaker, gauge_price_supply_point) mají EM2 protějšky v GaugeSettings, ale konkrétní sloupce migrační mapa neuvádí.
  • Číselník účelů měřidla GaugePurpose není finální — na stránce jsou zatím tři ukázkové hodnoty.
  • Účel užití ConsumptionUsageType má být otevřený editovatelný číselník o zhruba deseti položkách; dnes je to pevný CHECK, EM3-287.
  • Zkratka ÚČEH má v obou systémech pole (building_properties.uceh → building.uceh), ale celé znění zkratky není nikde rozepsané.
  • Rezervovaný příkon a typ odběru se do EM3 nemigrují a odkládají se mimo v1 — bez nich nejde dokončit Feature 124 pro vysoké napětí.
  • Sazby DPH nemají v EM3 žádný ticket ani entitu.
  • Konvence pojmenování v EM3 nejsou nikde sepsané. Dokumentace si mezi sebou odporuje: Data Model píše entity velkým počátečním písmenem a hodnoty číselníků velkými písmeny, entity a enum stránky malými. Slovník se drží entity stránek. Samostatná stránka s konvencemi zatím neexistuje.

Zdroje ​

Migrační mapy a kontrolní body — hlavní zdroj sloupců „EM2 v kódu" a „EM3 v kódu"

Datový model a číselníky

Feature stránky domén

Business analýzy epiců Initiative 3

Kód — e-manazer @ master 7c817488, e-manazer-api, emanazer-data-aggregator; EM3 @ origin/main 93c8bbcd.


Slovník · Průřezové pojmy a zkratky ​

Průřezové technické pojmy ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznam
TenantTenant— (jedna databáze pro všechny klienty)tenantId, schéma na klientaDatová izolace klienta. Hypertabulky nemají RLS a hlídá je aplikace. Vazba klient a tenant je jedna ku jedné.
Primární klíčPrimary keyceločíselné auto-incrementUUID v7, původní číslo v legacyIdEM3 přechází na identifikátory s vestavěnou časovou složkou; původní číslo zůstává dohledatelné.
HypertabulkaHypertable—— (TimescaleDB)Časově dělená tabulka pro velké objemy měřených dat; v EM3 tak jsou uložené odečty.
Append-only, platnost odAppend-only, Valid fromvalid_from jen u části tabulekvalidFrom systematickyZáznamy se nepřepisují; oprava je nový řádek s pozdější platností. Verze se vybírá k datu události, ne k dnešku.
Měkké smazání, zneplatněníSoft delete, VoidingDisabledTrait (disabledAt, disabledBy, disabledReason)deletedAt, isVoided, archivedAtZáznam se označí jako smazaný nebo neplatný, ale zůstává v databázi. EM3 má pro životní cyklus tři různá slovníčky podle typu entity.
Auditní kvartetoAudit quartetnepovinné, často prázdnécreatedAt, createdBy, updatedAt, updatedBy (povinné)Konvence projektu. Chybějící legacy hodnoty se při migraci doplňují jako system:migration.
Chybová obálka APIAPI error envelope—errorCode, errorMessage, status, requestId, detailsJednotná struktura chybové odpovědi. U odpovědi 403 se nově vrací i chybějící kód oprávnění.
Autorizační řetězecGuard chainrole na uživateliJwtAuthGuard, TenantContextGuard, PermissionGuard, ClientModuleGuard, ClientExpirationReadGuardPořadí kontrol při zpracování požadavku: autentizace, kontext klienta, oprávnění, zapnutý modul, platnost licence.
Soubor a dokumentFile, DocumentFile, FileComponentfile, documentPříloha vázaná na jiný záznam proti spravovanému dokumentu s vlastní kategorií a životním cyklem. V Data Modelu psané jako File a Document.
Záznam zálohyBackup record—backupRecord (návrh)Metadata bodových záloh jednotlivých klientů, umožňující obnovit jednoho klienta bez dopadu na ostatní.
UI popisek a nápovědaUI label, Field hintDictionaryFixtures, klíče field.help.*uiLabel, uiLabel.translationKey, UiLabelComponent, UiLabelType, LocalePřizpůsobitelné texty rozhraní. Z 81 EM2 klíčů nápovědy je 36 vyplněných a nemapují se jedna ku jedné na klíče EM3.
ČíselníkEnum, Code listPHP konstanty a číselné hodnotyStatic Enums nebo otevřené editovatelné tabulkyStatický se mění nasazením, otevřený spravuje superadmin za běhu.
Počítat za běhu, uložená řadaRead-time, Stored seriespřevážně přepočtové úlohy— (rozhodnutí per případ)Opakované rozhodnutí napříč epicy. Dosavadní precedens (EM3-259) je počítat za běhu.
Otevřené rozhodnutí, featureOpen decision, Feature——OR-n je číslované rozhodnutí v business zadání, které musí potvrdit stakeholder. Feature je číslovaná položka v seznamu Features List.
EM2, EM3Legacy e-manažer, E-manažer 3.0——Stávající systém a jeho nástupce.

Zkratky ​

ZkratkaČeskyEnglish
EMEnergetický managementEnergy management
EnMSSystém energetického managementuEnergy management system
EnPIUkazatel energetické náročnostiEnergy performance indicator
SEUVýznamný spotřebič energieSignificant energy use
OMOdběrné místoMetering point
DODálkové odečtyRemote readings
VOVeřejné osvětlení, podle kontextu též velkoodběrPublic lighting, Large consumer
RVORozvaděč veřejného osvětleníPublic lighting distribution board
VT, NTVysoký tarif, nízký tarifHigh tariff, Low tariff
NN, VN, VVNNízké, vysoké a velmi vysoké napětíLow, High and Extra-high voltage
EANIdentifikátor odběrného místa elektřinyElectricity metering point ID
EICIdentifikátor odběrného místa plynuGas metering point ID
IČOIdentifikační číslo osobyCompany registration number
ODSOptimalizace distribučních sazebDistribution tariff optimisation
TDDTypový diagram dodávkyTariff distribution diagram
ERÚEnergetický regulační úřadEnergy Regulatory Office
OTEOperátor trhuMarket operator
ČEPSProvozovatel přenosové soustavyTransmission system operator
POZEPodpora obnovitelných zdrojů energieRenewable energy support levy
PpSPodpůrné službyAncillary services
FCR, aFRR, mFRR, RRTypy podpůrných služeb podle rychlosti reakceAncillary service products
ČHMÚČeský hydrometeorologický ústavCzech Hydrometeorological Institute
FVEFotovoltaická elektrárnaPhotovoltaic plant
KVPKvalita vnitřního prostředíIndoor environment quality
PHMPohonné hmotyVehicle fuel
TUV, TVTeplá užitková voda, teplá vodaDomestic hot water
CZTCentrální zásobování teplemDistrict heating
PENBPrůkaz energetické náročnosti budovyEnergy performance certificate
EPCEnergetické služby se zárukouEnergy performance contracting
OPŽPOperační program Životní prostředíEnvironmental operational programme
ÚČEHKód klasifikace budov; celé znění není v podkladech uvedenéBuilding classification code
ISDOCČeský XML formát fakturyCzech e-invoice XML format
OBISSystém kódů měřených veličinObject Identification System
DLMS/COSEMStandard komunikace chytrých měřidelDevice Language Message Specification
M-Bus, ModbusKomunikační protokoly měřidel tepla a vodyMeter communication protocols
ARESRegistr ekonomických subjektůBusiness registry
MGMěřený kanál fyzického měřidlaMetered gauge
D21DenostupněDegree days
S0A, S0BKombinované datasety EM2 pro nejlepší dostupnou hodnotuLegacy combined datasets
OF, FFOdečtový formulář, fakturační formulářReading form, Invoice form
T_refReferenční vnitřní teplotaReference indoor temperature

Slovník · Predikce, emise, EnMS a výstupy ​

Predikce a úspory ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
Predikce spotřebyConsumption predictionPredictionHelper::getPrediction, PredictionDataCollector, clients.show_predictionclient.showPrediction, jinak —Odhad budoucí spotřeby: pro každý den průměr téhož kalendářního dne za poslední jeden až tři roky, násobený korekčním součinitelem.Nastavení se migruje, samotný výpočet v EM3 neexistuje a žádná entita pro uložené predikce zatím není. EM2 predikci nikam neukládá.
Korekční součinitelCorrelation coefficientprepareCorrelationCoefficient, proměnná prediction_days_cc (default 90)—Poměr průměrné denní spotřeby za posledních N dní k témuž období o rok dříve.Když v okně chybí byť jediný den, EM2 ho tiše nastaví na 1 — OR-5 Epicu 3.6.
Ostatní vlivy v predikciOther elements in predictionclients.include_other_elements_in_predictionclient.includeOtherElementsInPredictionNastavení slibující zahrnutí cen energií a počasí do predikce.Migruje se beze změny, ale v EM2 ho žádný výpočet nečte. Epic 8.1 navíc obě varianty z v1 vylučuje.
Predikce výdajůCost predictionDataSeriesPoint::DATA_PREDICTION_COSTS, UnitPriceHelper::getUnitPriceBySegments—Predikovaná spotřeba násobená jednotkovou cenou.V EM2 jen v grafu, ne v tabulce Přehledy.
OpatřeníMeasure, Savings measureEntity\Event\Action ($approved, $realized)measure (EM3-152)Nápravné nebo úsporné opatření s plánovaným a skutečným datem realizace.V EM2 čistá evidence — predikce opatření ignoruje (OR-7 Epicu 3.6). V Data Modelu psané jako Measure.
Předpokládaná úsporaExpected savingAction::$energySaved, $waterSaved, $CO2Saved, $costSaved (vše text)—Ručně zadaný odhad úspory energie, vody, CO₂ nebo peněz za rok.EM2 je tiskne bez desetinných míst, takže 0,4 t CO₂ se zobrazí jako 0 t.
Dosažená úsporaAchieved saving——Skutečně realizovaná úspora proti zvolené základně.V EM2 se nepočítá nikde — jádro Epicu 3.6. Základnu řeší OR-3.
Efektivita výroby FVEPV production efficiencySEGMENT_PRODUCTION (4), SolarEdgeDataAggregator—Vyrobená energie minus přetoky, minus nasdílená energie.EM2 sbírá data, ale žádné vyhodnocení nedělá. Výroba navíc chybí v seznamu kumulativních segmentů, takže se ani nepredikuje.
Degradace zdrojeSource degradation——Postupný pokles výkonu fotovoltaiky v čase.Feature 350, v2.
Předpověď počasíWeather forecastMeteoConnector (jen skutečnost)met-forecast-api.ts, met-forecast.entity.tsPředpokládaný vývoj teploty, srážek a slunečního svitu.EM2 předpověď nemá vůbec. EM3 volá MET Norway přímo z prohlížeče a zpracovává jen teplotu a srážky — sluneční svit chybí. Ukládání = EM3-208, v2.
PV GISPV GIS——Externí zdroj dat o slunečním svitu pro předpověď výroby.Epic 2.4, v2.
Dešťová vodaRainwaterunitPriceRainfall, Dataset::PAYMENT_RANGE_*—Odhad využití, nákladů a úspory z vlastního zdroje.V EM2 jen fakturační složka. Feature 352, v2 spolu s pasportem.

Emise ​

Emise v EM2 neexistují. Grep napříč všemi třemi repozitáři nenašel žádnou entitu, migraci, obrazovku ani výpočet. Zadání z roku 2024 (EM-532, EM-533) je hotové do úrovně obrazovek a akceptačních kritérií, ale nikdy se neimplementovalo. Sloupec „EM2 v kódu" je proto v celé kapitole prázdný.

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamPoznámky
EmiseEmissions——Množství CO₂, výhledově i CO, NOₓ a TZL, odpovídající spotřebě. Spotřeba v MWh × emisní faktor v t CO₂/MWh.Paliva se nejdřív přes výhřevnost převedou na energii.
Emisní faktorEmission factor—clientEmissionFactorMnožství emisí na jednotku energie. Funkce primárního zdroje, typu měřidla, typu emise a data spotřeby.Přednost měřidlo, klient, systém. Klíčuje se přes medium stejně jako výhřevnost a tolerance. EM3-58 dosud blokované, ačkoli jeho blokátor je hotový.
Úspora emisíEmission saving——Emise referenčního období minus emise hodnoceného období.Kterou sadou faktorů se počítá reference, řeší OR-5 Epicu 3.7 — nejdůležitější rozhodnutí epicu.
Modul Emise, Emise+Emissions module, Emissions+—emissionFactorsZákladní evidence faktorů a výpočet (Features 109 až 112, Epic 3.7); nadstavba se Scope 1 až 3 je Feature 166, Epic 8.6.Přepínač modulu v EM3 už existuje, obsah za ním ne. Popis Epicu 8.6 stále uvádí modul Emise jako svou náplň — opravit před rozpadem na tickety.
ESG reportESG report—esgReport (návrh)Výkaz emisí a CO₂ za objekt nebo portfolio.Plánovaná entita, mimo první vydání. V Data Modelu psaná jako ESGReport.
Koncentrace CO₂CO₂ concentrationSEGMENT_CO2 (9), GaugePurpose::PURPOSE_CO2 (7)reading.type = co2, gauge.medium = kvpÚdaj z čidla vnitřního prostředí v ppm.S emisemi nesouvisí — viz Past na překlad.

EnMS, ukazatele a reporting ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
Systém energetického managementuEnergy management systemBuildingEnergyManagement, building_properties.client_energy_managementclientEnms, building.isPartOfEnmsZkratka EnMS. Konfigurace řízení energií podle ISO 50001: certifikace, politika, metoda určení významných spotřebičů.EM2 měl jen příznaky na objektu; konfigurace na úrovni klienta je nová.
Ukazatel energetické náročnostiEnergy performance indicator—clientEnpiZkratka EnPI. Systémové ukazatele se počítají za běhu, vlastní si klient definuje včetně vztažné veličiny.Nové v EM3.
Významný spotřebič energieSignificant energy use—clientEnms.seuMethod, SeuMethodZkratka SEU. Metody topN, percentageThreshold, coverageTarget.Nové v EM3.
Cíl EnMSEnMS target—clientEnmsTarget, EnmsTargetStatusStanovený cíl snížení spotřeby nebo emisí a jeho stav.Nové v EM3.
NeshodaNon-conformity—— (návrh)Závažné zjištění vyžadující řešení, typicky v kontextu ISO 50001.Vzniká z upozornění po marném uplynutí termínu, nebo se založí přímo.
Pravidlo notifikaceNotification rulesendNotifications v jednotlivých službáchnotificationRuleKonfigurovatelný spouštěč e-mailových upozornění — konec smlouvy, překročení prahu, chyba synchronizace.EM2 mělo pravidla zadrátovaná; EM3 z nich dělá konfiguraci. V Data Modelu psané jako NotificationRule.
Deník aktivitActivity log— (ukládal se jen aktuální stav)activityLogNeměnný záznam každé uživatelské akce, u editace i stará a nová hodnota.Nad rámec EM2. Řeší většinu dotazů na helpdesk.
Šablona reportuReport template—reportTemplate, reportBlockSestavitelný výstup složený z bloků.Nové v EM3. Šablonu vidí celý klient, upravit ji smí jen její autor.
Vlastní oznámeníCustom announcement—— (návrh)Hromadná zpráva vybraným rolím, například o plánované odstávce.Nové v EM3.

Grafy a výstupy ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
Časová řadaTimelineTimelineDataSerializer—Základní pohled — hodnota v čase.
Spotřeba dle užitíConsumption by usageConsumptionUsageSerializer—Pohled rozpadající spotřebu na účely užití.Jediný pohled EM2, kde se zobrazuje výpočtová spotřeba.
PorovnáníComparisonComparisonDataSerializer—Meziroční pohled.
Typ grafuChart typeHighcharts, pevné typychartTypeZpůsob zobrazení už nakonfigurovaného obsahu. Nově přibývá heatmapa a bublinový graf.Nová koncepce v EM3 — obsah a způsob zobrazení jsou oddělené kroky, přepnutí typu konfiguraci nezahodí.
Datová řadaData seriesDataSeriesPoint— (součást uloženého grafu)Jedna zobrazovaná řada v grafu; viditelnost se přepíná bez nového dotazu.
Filtr grafu a uložený filtrChart filter, Saved filterReportFilter, SavedFilterManager, ReportsController::outputGraphs()—Kombinace sektoru, objektu, média, měřidla, periody a zdroje dat, uložitelná pod názvem.V EM3 se rozšiřuje na uložený graf, který drží i typ a viditelnost řad.
Vrstva grafuOverlayprocessDefaultConsumption, setCalculatedConsumptionchart-series.entity.ts (baseline, calculatedConsumption)Doplňková řada nad hlavními daty — výchozí spotřeba, výpočtová spotřeba, akce, predikce.Kontrakt v EM3 už existuje, data pod ním jsou zatím jen fixture (EM3-275).
Grafový engineChart engineReportsController, Highcharts— (EM3-277)Dotazovací vrstva, která grafům dodává řady.EM3-277 BLOCKED, čeká na agregační vrstvu EM3-276. Hlavní blokátor Epicu 3.3.
Nástěnka a dlaždiceDashboard, Tile—dashboardLayout, dashboardBlockUspořádatelná úvodní obrazovka. Každý uživatel má právě jedno rozvržení, dlaždice se přichytávají na mřížku.Nové v EM3. Libovolný panel lze připnout jako dlaždici, není to pevný seznam widgetů.
Blok reportuReport block—reportBlockJeden prvek uvnitř šablony reportu — graf, tabulka nebo text — s pořadím.Nové v EM3. Vlastní registr typů, oddělený od dlaždic. Export a plánované rozesílání jsou odložené.
PřehledyOverviewsOverviewDataCollector, generatePrediction—Tabulkové sekce EM2 — Predikce, Optimalizace sazeb a další.V predikci chybí korunové sloupce; jsou jen v grafu.

Integrace a externí systémy ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
ARESBusiness registry lookup—— (integrace)Veřejný registr ekonomických subjektů. Vyhledá firmu podle názvu nebo IČO a doplní název, IČO a právní formu.Nová integrace v EM3. Podporuje i fyzické osoby bez IČO.
—yr.no, MET Norway—met-forecast-api.tsPoskytovatel předpovědi počasí, ze kterého čerpá meteogram.Volá se přímo z prohlížeče a nic se neukládá.
RevisioRevisioinvoices.revisio_record_id— (noční synchronizace)Externí účetní a fakturační systém jednoho konkrétního klienta.Jednosměrné zrcadlení do EM3, v UI neviditelné. Pole na faktuře se nemigruje.
Datový agregátorData Aggregatoremanazer-data-aggregator, DataControlDispatcher, EgdDataAggregator, SolarEdgeDataAggregator—Samostatná aplikace EM2, která normalizovala vstupní data a udržovala kombinované datasety.V EM3 se ruší; funkci přebírá backend a průběžné agregáty.
Klíč APIAPI key—apiKey (návrh)Přístupový klíč třetí strany omezený na definovanou množinu měřidel, jen pro čtení.Nové v EM3. V Data Modelu psaný jako APIKey.
Asynchronní zpracováníAsynchronous processing, JobWaitingJobsCommandjobIdDlouhá operace vrátí ihned identifikátor úlohy a stav se dotazuje zvlášť.EM2 mělo frontu úloh; EM3 ji vystavuje i navenek přes rozhraní.
—Webhook, RFC 7807 Problem Details, Cursor-based pagination—— (API standardy)Standardy pro integrace třetích stran: oznámení o dokončení, formát chybové odpovědi, stránkování velkých objemů dat.Nové v EM3. Formát chyby pro třetí strany se liší od interní chybové obálky.

Podpůrné služby (PpS) ​

Zvažovaný příplatkový modul mimo základní rozsah EM3 — v EM2 ani v EM3 zatím nic z toho neexistuje. Slovník je tu proto, aby se pojmy nezaměňovaly s běžnou dodávkou energie: agregátor a aktivace znamenají v této doméně něco úplně jiného než jinde v aplikaci.

Český pojemEnglishVýznamPoznámky
Podpůrné službyAncillary servicesZkratka PpS. Kontrahované kapacity, které výrobci, velcí odběratelé nebo agregátoři poskytují provozovateli přenosové soustavy k udržení rovnováhy sítě.
ČEPS—Český provozovatel přenosové soustavy, který podpůrné služby kontrahuje a aktivuje.Nezaměňovat s distributorem, který provozuje distribuční síť.
Agregátor flexibilityAggregatorSubjekt slučující flexibilitu z více objektů a klientů a nabízející ji souhrnně jako podpůrnou službu.Klienti se do podpůrných služeb zapojují typicky přes agregátora.
—FCR, aFRR, mFRR, RRProdukty podle rychlosti reakce: sekundy, do 30 sekund, do 12,5 minuty, do 30 minut.aFRR a mFRR jsou nejpravděpodobnější vstupní bod pro klienty.
AktivaceActivationČasové okno, kdy provozovatel soustavy vyvolá dodávku nebo odběr výkonu.Zkresluje energetickou bilanci objektu, pokud se nezaznamená značkou intervalu a nevyloučí.
Smlouva o podpůrných službáchPpS contractPoskytovatel, typ služby, kontrahovaný výkon a platnost.Jiná struktura než smlouva o dodávce energie.
Platba za dostupnost, platba za energiiCapacity payment, Energy paymentOdměna za držení kapacity, respektive za energii skutečně dodanou během aktivace.

Slovník · Klima, reference a kontroly ​

Klima a normalizace ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
MeteostaniceWeather stationh_m_stationsweatherStationZdroj klimatických dat. Katalog je dvouúrovňový: globální stanice a stanice klienta.Vlastnictví se odvozuje z h_m_stations.editable: neupravitelná → globální, upravitelná → patří klientovi.
Kód stanice ČHMÚStation codeh_m_stations.code— (připojeno do weatherStation.name)Označení stanice u Českého hydrometeorologického ústavu.Samostatné pole bylo zrušeno; kód se připojuje do názvu, například „Praha-Ruzyně (P1PRUZ01)".
Identifikátor stanice WIGOSWIGOS station identifier—weatherStation.wsiMezinárodní identifikátor stanice pro párování s automatickým feedem.Nové v EM3. Kód ČHMÚ se na něj nemapuje — doplní ho superadmin ručně.
Poloha staniceStation positionh_m_stations.lat, lng, altitudeweatherStation.lat, weatherStation.lng, weatherStation.altitudeZeměpisné souřadnice a nadmořská výška.Beze změny.
Výchozí meteostanice klientaDefault weather stationclients.default_meteostation_idclient.defaultWeatherStationIdStanice použitá všude, kde objekt nemá vlastní.V EM2 jediný zdroj pro celý výpočet normalizace — objektová stanice do něj nevstupuje. V EM3 je to EM3-56, BLOCKED.
Doplňková stanice klientaClient weather stationclient_meteostationclientWeatherStationDalší stanice přiřazené klientovi nad rámec výchozí.U výchozí stanice se duplicitní řádek nevytváří. Pozor: vazba objektu na stanici se jmenuje climate…, tahle weather….
Klimatická dataClimate datah_m_short_term_data, HMShortTermDataclimateDataSkutečně naměřené hodnoty stanice za období — topné dny a průměrná teplota.Rok a měsíc se skládají do data prvního dne měsíce. EM2 zná jen měsíční data; granularita i verzování jsou nové.
Granularita klimatických datClimate data granularity—climateData.granularity, ClimateDataGranularityMěsíční, denní, hodinová.Všem migrovaným záznamům se nastaví měsíční.
Zdroj klimatických datClimate data sourceh_m_stations.main_thermometerclimateData.source, ClimateDataSourceAutomatický přenos, nebo ruční zadání.Odvozuje se: stanice s nastaveným teploměrem → remote, jinak manual (včetně všech globálních stanic ČHMÚ).
Klimatický normálClimate normalh_m_long_term_dataclimateNormalDlouhodobý průměr stanice, dvanáct měsíčních řádků.Beze změny hodnot; topné dny se převádějí na desetinné číslo.
Topný denHeating dayh_m_short_term_data.heating_days, HEATING_DAY_MAXIMUM_TEMPERATURE = 13.0climateData.heatingDaysDen, jehož průměrná venkovní teplota klesne pod 13 °C; sezóna září až prosinec a leden až květen, dvoudenní hystereze.Metodicky shodné. Pravidla v EM3 jsou v souboru climate-derivation.rules.ts. Denní příznak lze v EM2 ručně přepsat.
Průměrná denní teplotaAverage daily temperatureh_m_short_term_data.avg_tempclimateData.avgTempVážený průměr měření podle vzorce (T07 + T14 + 2 × T21) / 4.Zaokrouhlení na dvě desetinná místa. Měsíční agregace jen z úplného měsíce.
DenostupněDegree daysdaydegree_normal, daydegree_actualfunkce computeDegreeDays v degree-days.rules.tsTopné dny × (referenční vnitřní teplota − průměrná venkovní teplota). V tabulkách se objevují pod označením D21.Vzorec je shodný.
Normalizační poměrNormalisation ratioHMShortTermDataRepository::getNormalRatiosfunkce computeNormalisationRatioDenostupně normálu dělené denostupni skutečnosti.EM2 obaluje výsledek funkcí abs(), čímž maskuje nefyzikální vstupy; EM3 místo toho vrací prázdnou hodnotu.
Normovaná spotřebaNormalised consumptionklíč řady norm, ReportDataCollector::processNormalConsumptionslužba normalised-consumption-average.service.tsSpotřeba přepočtená na dlouhodobě normální klima, aby byly roky srovnatelné.EM2 násobí poměrem jen podíl vytápění; dočasný adaptér EM3 normalizuje celé médium teplo — OR-1 Epicu 3.2.
Klimatická korekceClimate correction—— (počítáno za běhu)Sama úprava spotřeby o vliv počasí.V EM3 se neukládá — rozhodnutí u EM3-259.
MeteogramMeteogram—— (widget nad yr.no)Devítidenní grafická předpověď — teplota, srážky, vítr, tlak, oblačnost.Nové v EM3, čerpá přímo z yr.no a nic se neukládá.
Konfigurace stanice pro dálkový přenosStation remote connectiondata_loggerweatherStation.remoteConnectionIdNapojení stanice na automatický přenos dat.Migrace odložena, dokud nevznikne správa vzdálených připojení.

Referenční hodnoty a srovnání ​

Tři pojmy se pravidelně pletou dohromady. Výchozí spotřeba je stav na začátku EnMS včetně neefektivit. Výpočtová spotřeba je hodnota z auditu — jaká by spotřeba měla být. Referenční spotřeba není entita, ale kontextový pojem. Čtvrtý podobně znějící pojem, spotřeba virtuálního měřidla, s nimi nesouvisí vůbec.

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
Výchozí spotřebaEnergy baselinebuilding_energy_managemet.{medium}_consum_norm, dále *ConsumInv, *CostsInv, *CostsNormbuildingEnergyBaseline.value, buildingEnergyBaseline.medium, buildingEnergyBaseline.referenceYear, buildingEnergyBaseline.sourceSpotřeba energetického hospodářství na začátku zavedení EnMS. Roční, ruční, jedna hodnota na objekt a médium.EM2 drží čtyři hodnoty na médium, EM3 zatím jednu — OR-4 Epicu 3.3, potvrdit před migrací. Referenční rok se nastaví na rok migrace. Celková energie se nemigruje, isTotalEnergy byl zrušen.
Výpočtová spotřebaCalculated consumptioncalculated_consumption + calculated_consumption_monthsbuildingCalculatedConsumption, CalculatedConsumptionSourcePředpokládaná spotřeba podle energetického auditu, po účelech užití.Roční záznam i měsíční rozpad se převádějí na obecné období. EM3 rozlišuje zdroj auditor a userSnapshot; v EM2 lze verze editovat i mazat.
Referenční spotřebaReference consumptionSettings::SHOW_REFERENCE_CONSUMPTION (zakomentované)—Kontextový pojem bez vlastní entity. Jakákoli spotřeba použitá jako základna srovnání.V EM2 funkce fakticky neexistuje, protože nastavení je zakomentované. Volbu pro EM3 řeší OR-1 Epicu 3.3.
Topný profilHeating profileCalculatedConsumptionMonths::$ratios—Pevný rozpad roční hodnoty do dvanácti měsíců.EM2 používá 19/16/14/9/2/0/0/0/1/8/14/17 % stejně pro každý účel užití; návrh pro EM3 je použít ho jen u vytápění (OR-6 Epicu 3.3).
Meziroční porovnáníYear-over-year comparisonComparisonDataSerializer::getDataSeriesmode = yearOverYearKaždý rok je vlastní řada, na ose x je měsíc.EM2 vynechá každý bod menší nebo rovný nule, takže v létě vzniká díra místo nuly.
Klouzavý průměrRolling average——Průměr několika minulých období jako referenční hodnota; navrhované okno tři roky.Nové, OR-2 Epicu 3.3.
Medián, republikový mediánMedian, Republic medianclients.median, republic_medianclient.median, client.republicMedianSrovnávací hodnota spotřeby pro klienta a pro celou databázi.Migruje se beze změny, ale v grafech ani reportech se nepoužívá — jsou to jen texty v administraci. Skutečný výpočet je v2 (OR-8 Epicu 3.3).
BenchmarkBenchmark——Porovnání proti referenční hodnotě nebo proti jiným objektům.Epic 3.3.

Kontroly, tolerance a anomálie ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
Klientská toleranceClient tolerancegauge_tolerance_types (client_id, gauge_type, primary_source, tolerance_min, tolerance_max), ToleranceHelperclientTolerance.clientId, clientTolerance.medium, clientTolerance.primarySource, clientTolerance.toleranceMin, clientTolerance.toleranceMaxPovolené pásmo odchylky spotřeby. Výchozí ±20 %, tvrdý limit ±25 %, hranice inkluzivní.Klíčování se mění z GaugeType na medium, protože starý enum se ruší. Řádky mají jen 3 klienti. EM3-57 je BLOCKED.
Tolerance na měřidleGauge anomaly tolerance—gauge.anomalyToleranceMin, gauge.anomalyToleranceMaxVýjimka z klientského pásma pro konkrétní měřidlo. Hodnoty jsou v procentech, jednotka není v názvu.Nové v EM3, migrací se neplní. Ukládá se, ale nikde se nevyhodnocuje.
Očekávaná spotřebaExpected consumptionDailyStatusManager::getPreviousConsumption, isConsumptionOutOfTolerancefunkce classify (EM3-223), základna se předává parametremHodnota, proti které se nový odečet poměřuje.EM2 bere stejné kalendářní okno až tří předchozích let a počítá vážený průměr. V EM3 výpočet základny zatím neexistuje — OR-1 Epicu 3.5.
AnomálieAnomalymessage.consumption_alertanomalyAlert (návrh)Hodnota mimo tolerované pásmo, vázaná na měřidlo a období.Samostatná entita je v EM3 plánovaná, mimo první vydání. V Data Modelu psaná jako AnomalyAlert.
Řádová odchylkaOrder-of-magnitude deviation——Hodnota řádově vyšší, než dává smysl — typicky překlep o nulu.V EM2 neexistuje nikde. Návrh: měkký příznak s prahem desetinásobku, OR-7 Epicu 3.5.
StagnaceStagnation—— (kontrola, práh podle média)Stejná hodnota se opakuje napříč několika po sobě jdoucími intervaly.Princip přejatý z EM2, v EM3 formalizovaný. U dálkových zařízení se totéž hlásí jako zamrzlá hodnota.
Limit spotřeby, kontrolní režimConsumption limitConsumptionLimit, ConsumptionLimitItem, GaugeControlTask, GaugeControlManager— (EM3-128)Absolutní hodinový limit u dálkových odečtů, 24 hodin × pracovní den a víkend.V EM3 chybí; uvažuje se jako placený doplněk. OR-8 Epicu 3.5 doporučuje převzít jedna ku jedné.
Přetok limituLimit overflowGaugeLimitOverflow—Překročení limitu spotřeby; založí akci a rozešle notifikaci, sama se uzavře po poklesu.Nezaměňovat s přetokem do sítě — viz Past na překlad.
Prodleva kontroly a frekvence notifikacíControl delay, Notification frequencyclients.gauge_limit_control_delay, gauge_limit_notification_frequencyclient.gaugeLimitNotificationDelayHours, client.gaugeLimitNotificationFrequencyHoursJak dlouho se po doručení dat čeká a jak často se opakuje upozornění.Defaulty 2 a 4 hodiny. V EM2 se klientské nastavení kvůli chybě v operátoru ?: nikdy nepoužije a okno kontroly je natvrdo 38 hodin. Oprava = OR-9 Epicu 3.5; u některých klientů bude znamenat méně e-mailů než dnes.
Značka intervaluInterval tag—intervalTagČasový úsek na objektu nebo měřidle označený vysvětlením neobvyklých dat: nehoda, porucha, údržba, výstavba, odstávka, uvádění do provozu, aktivace podpůrné služby.Nové v EM3. Interval lze vyloučit z reportů. V Data Modelu psané jako IntervalTag.
Značka odečtu, značka spotřebyReading tag, Consumption tag—readingTag, consumptionTagOznačení konkrétní hodnoty jako chybné; taková hodnota se z výpočtu spotřeby vyloučí.Nové v EM3. Značka spotřeby se používá tam, kde pod hodnotou žádný odečet není.
Příznak chybného odečtuInvalid reading flag—viz značky výšeOznačení hodnoty jako vadné a její vyloučení z výpočtů.Dokumentace EM2 tvrdí, že to systém umí; v kódu to není — EM-515 nerealizované (OR-10 Epicu 3.5).
Zápis s obejitím kontrolyWrite-override—samostatný endpoint a oprávněníZápis odečtu, který by kontrola monotónnosti odmítla.Nové v EM3, není to plošná výjimka pro administrátory.
UpozorněníNoticeEntity\Event\ActionnoticeInformační záznam vzniklý automaticky nebo ručně. Stavy nový, zobrazený, vyřešený; po marném termínu se mění na neshodu.Odpovídá workflow Akcí v EM2. V Data Modelu psané jako Notice.
Akce a její spouštěčAction, Action triggerAutoEventGenerator, eventGenerator::processConsumptionOutOfToleranceactionTrigger (EM3-152, EM3-154)Záznam události nebo opatření a konfigurace jeho automatického vzniku.EM2 měl logiku zadrátovanou v kódu; EM3 z ní dělá konfiguraci. Doména akcí v EM3 zatím chybí.
Kontrola zadání odečtuReading submission checkGaugeReadingsControlHelper, gr_days_tolerance_* (5, 3, 15 dní)—Hlídání, že odečet dorazil včas a že dálkový odečet funguje.Patří spíš do Epicu 6.3.
Zamrzlá hodnota, slabá baterieFrozen value, Low battery—— (upozornění)Zařízení posílá stále stejnou hodnotu, nebo hlásí docházející baterii.Nové v EM3.

Slovník · Spotřeba, náklady a sazby ​

Spotřeba ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
SpotřebaConsumptionDailyStatusManager, gauge_daily_output— (tabulka zatím neexistuje)Množství energie nebo vody odebrané za období.EM2 záporný rozdíl tiše zahodí. V EM3 samotný výpočet zatím chybí — na main je jen dočasný adaptér pro objekt, měsíc, médium teplo a delta odečty.
Efektivní spotřebaEffective consumptiondatasety S0A, S0Bpohled best_availableSpotřeba vybraná pro každý interval podle priority zdrojů. Pro jedno období může být složená z více zdrojů.V EM2 implicitní „nejlepší dostupná" hodnota; v EM3 poprvé pojmenovaná.
Spotřeba virtuálního měřidlaCalculated consumption of a virtual gauge—reading.source = calculatedSpotřeba dopočtená vzorcem z efektivních spotřeb více fyzických měřidel.Sjednocený název podle EM3-321. Nezaměňovat s výpočtovou spotřebou z auditu.
Objemová, energetická spotřeba, výkonVolume, Energy consumption, Powersegment (11, 14 pro výkon)reading.type = volume, energy, powerSpotřeba v m³, v kWh po přepočtu, a rychlost spotřeby v kW.Výkon se ukládá jen tam, kde je potřeba pro grafy, špičky nebo navazující výpočty.
Druh hodnotyKind—consumption.kind (návrh)Rozlišuje, zda uložená hodnota je spotřeba, nebo náklad.Nová dimenze vedle typu, směru, tarifu a zdroje.
VýrobaProductionSEGMENT_PRODUCTION (4)gauge.direction = exportEnergie vyrobená v objektu — fotovoltaika, kogenerace.
Převod jednotekUnit conversionGaugeUnitManager, UnitsUnitPřepočet mezi m³, kWh, MWh, GJ, t a l.EM3-273 hotovo. EM2 u neznámé dvojice jednotek použije koeficient 1 bez varování a u plynoměru default 10,55 kWh/m³.
Účel užitíUsage typeConsumptionUsage, GaugeConsumptionUsage, calculated_consumption.usage_typeConsumptionUsageType, buildingCalculatedConsumption.usageTypeVytápění, ohřev teplé vody, ostatní, výroba, výhledově osvětlení a větrání.Hodnota hot water se mění na hotWater. V EM3 dnes pevný CHECK, převod na otevřený číselník je EM3-287.
Rozúčtování reálné spotřebyConsumption allocation—allocationPercentage (návrh)Procentní rozdělení skutečné spotřeby mezi účely užití, po měsících.Nové v EM3.
Měrná spotřebaSpecific consumptionSpecificConsumptionDataSerializer—Spotřeba na jednotku plochy, typicky kWh/m².EM2 ji má, ale bez normované varianty; v EM3 zatím nepočítá nic.
Odečty k půlnociMidnight reading conventionclients.calculate_consumption_from_midnight—Zda se odečet vztahuje k půlnoci, nebo k poledni s půlením krajních dnů.Koncept se v EM3 ruší a nastavení se nemigruje, ale migrace historické spotřeby musí zohlednit, jakou hodnotu měl který klient. OR-6 Epicu 3.1.
Perioda, granularitaPeriod, GranularityPeriod::MONTH, YEAR_KEYbuildingCalculatedConsumption.periodStart, periodEndRok, měsíc, den, hodina, 15 minut.EM3 nahrazuje pevné periody obecným intervalem.
Agregační vrstvaContinuous aggregatesData Aggregator, přepočtové úlohy— (EM3-276)Automaticky udržované předpočítané souhrny nad hypertabulkou odečtů.Nahrazuje přepočtové úlohy a datasety z EM2. EM3-276 je BLOCKED a blokuje grafy i benchmarking.
Retenční dobaData retention—— (politika, ne pole)Jak dlouho se drží surová patnáctiminutová data; agregáty zůstávají trvale.Datový model počítá s dvěma roky pro surová data; Epic 3.1 navrhuje k rozhodnutí deset let pro spotřebu (OR-8).

Náklady, sazby a optimalizace ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
Náklad, výdajCostGaugeInvoiceFormType, InvoiceDataCollector—Peněžní vyjádření spotřeby; zaokrouhluje se na dvě desetinná místa.EM2 dopočtenou částku nezaokrouhluje a drží ji jako float. Pro EM3 otevřené, zda náklad ukládat, nebo počítat za běhu — OR-3 Epicu 3.1.
Jednotková cenaUnit priceUnitPriceHelper, GaugeUnitPricecontractItem.price, gauge_unit_priceCena za jednotku energie.Verzovaná cena na měřidle se převádí na položku smlouvy.
Distribuční sazbaDistribution tariffRate, Rate::description, odsDescriptiongauge.distributorTariff (volný text), contractItemTypeSazba distributora, například C02d nebo D01d. Určuje ceny distribuce a fixní platby.Regres: EM2 má číselník s příznaky vysokého, nízkého a speciálního tarifu, EM3 má na měřidle jen volný text. Bez číselníku nejde určit „stejnou skupinu" ani zobrazit legislativní poznámky — OR-5 Epicu 3.4.
Skupina sazebRate groupRate::$combineGroups, RateRepository::getRatesFromSameGroup—Sazby se stejnou kombinací tarifních pásem, které lze mezi sebou porovnávat.V EM3 chybí spolu s číselníkem sazeb.
Optimalizace distribučních sazebDistribution tariff optimisationDistributionRateOptimazer, OverviewDataCollector sekce ods—Návrh nejlevnější sazby pro odběrné místo na základě ročního odběru. Zkratka ODS.V EM2 hotová funkce i záložka; v EM3 zatím nic.
Cenové rozhodnutí ERÚERÚ price decisionPriceDecision, Service, TariffPrice, CircuitBreaker, CircuitBreakerPrice, PriceDecisionManager—Roční ceník regulovaných složek vydávaný Energetickým regulačním úřadem.EM2 importuje z XLSX šablony. V EM3 neexistuje — žádná migrace, žádný import (OR-3 Epicu 3.4).
DistributorDistributor, DSODistributor, GasSupplier, clients.el_dictributor_id, gas_supplier_id, consumption_single_electricity_supplierclient.electricityDistributorId, client.gasDistributorId, client.singleElectricityDistributor, client.singleGasDistributorProvozovatel distribuční soustavy, tedy fyzické sítě.Migrace opravuje překlepdictributor a přejmenovává „dodavatele plynu" na distributora, protože to distributor vždycky byl. V EM3 musí být platformní číselník, ne organizace klienta — EM3-167.
Systémové služby, POZE, poplatek operátora trhuSystem services, Renewable support levy, Market operator feesystem_service_fix, support_nn_by_consumption, support_nn_by_cb, ote_distributor—Regulované složky ceny elektřiny. Podpora obnovitelných zdrojů se účtuje buď podle jističe, nebo podle spotřeby — platí se nižší z obou.Existují jen uvnitř optimalizace sazeb v EM2. Rozpad nákladů na složky je celý ve v2 (Features 339, 340, 353).
Platba za jističCircuit-breaker chargeCircuitBreakerPrice—Měsíční fixní platba odvozená od velikosti jističe.
Vodné, stočné, srážkovnéWater supply, Sewage, Stormwater chargeContractItemTypecontractItemTypeSložky fakturace vodoměru: dodávka pitné vody, odvod odpadní vody, odvod srážkové vody.Srážkovné je často paušální, nezávislé na naměřené spotřebě.
Spalné teploGross calorific value——Koeficient pro přepočet objemu plynu na energii.Odlišit od výhřevnosti — podobný, ale ne totožný pojem. Viz Past na překlad.
Koeficient budovyBuilding coefficient—buildingCoefficientNásobící nebo aditivní korekce na úrovni objektu, aplikovaná až po koeficientu měřidla.Od rozhodnutí u EM3-259 se klimatická korekce počítá za běhu, takže hlavní důvod pro tuhle entitu odpadl.
Typový diagram dodávkyTariff distribution diagramGaugeProperties.tddEl, tddgauge.tddGroupZkratka TDD. Skupina typového průběhu odběru tam, kde není průběhové měření.Dvě EM2 pole se slučují do jednoho.
Spot, fixSpot price, Fixed price——Dva režimy nákupu komodity.Feature 295, v2.
Úspora ze sazbyTariff savingDistributionRateOptimazer::_calculate—Rozdíl mezi aktuální a nejlevnější dostupnou sazbou, nikdy záporný.EM2 řadí sazby komparátorem, který vrací pravdivostní hodnotu místo tří stavů — u blízkých částek není pořadí zaručené.

Slovník · Odečet, faktura a smlouva ​

Odečet a sběr dat ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
OdečetReadinggauge_reading + gauge_reading_valuereadingNaměřená hodnota měřidla v konkrétním čase.Zásadní změna tvaru dat: EM2 měl hlavičku s několika hodnotami, EM3 má jeden plochý řádek na kombinaci typ, směr, tarif, zdroj a formát. Odečet s vysokým i nízkým tarifem tedy vytvoří dva záznamy.
Čas odečtuRead timestampgauge_reading.read_at (jen datum)reading.readAt (datum a čas s pásmem)Okamžik, ke kterému hodnota platí.EM2 implicitně půlnoc. Migrace historických dat bez času použije jako odhad poledne.
Vazba na měřidloGauge referencegauge_reading.gauge_id (cizí klíč)reading.gaugeId (volná reference)Ke kterému měřidlu odečet patří.V EM3 bez databázového cizího klíče — měřidlo žije v jiné doméně, hranice se řeší fasádou.
Typ hodnotyReading typeodvozeno ze segmentreading.type, ReadingTypeEnergie, výkon, objem, teplota, vlhkost, CO₂.Nová samostatná dimenze.
Tarifní pásmoTariffodvozeno ze segment (1, 11 → celkem; 2 → vysoký; 3 → nízký)reading.tariff, ReadingTariffCelkem, vysoký, nízký, speciální, nebo neurčeno.Nová samostatná dimenze.
Vysoký tarif, nízký tarifHigh tariff, Low tariffsegment 2 a 3reading.tariff = high, lowDvě tarifní pásma elektřiny. Zkratky VT a NT.
Speciální tarifSpecial tariffSPECIAL_TARIFFreading.tariff = specialTřetí, samostatně účtované pásmo.
Zdroj odečtuReading source— (odvozováno z kontextu)reading.source, ReadingSourceRuční, dálkový, z faktury, dopočtený.Nová samostatná dimenze. Dopočtený zdroj nevstupuje do priority zdrojů.
Formát hodnotyReading format—reading.format (cumulative, delta)Odečet nese absolutní stav počítadla, nebo přímo spotřebu za období.V EM3 poprvé explicitní.
Stav životního cykluLifecycle stategauge_reading.state (0, 1, 2)reading.lifecycleState, LifecycleStatePrvní odečet nového měřiče, běžný odečet, poslední odečet před výměnou.Funkční parita, jen pojmenované hodnoty. Stav final smí vzniknout jen v rámci výměny měřidla a zrušit ho lze jedině admin akcí clear-final.
Jednotka odečtuReading unit— (dotahovala se z měřidla)reading.unitJednotka uložená přímo na odečtu.Nové v EM3 — chrání historii při výměně měřidla.
MonotónnostMonotonicity—— (kontrola, Reading Management FR2)Kumulativní řada nesmí klesnout pod předchozí ani přerůst následující hodnotu.Obejít lze jen zvláštním oprávněním a endpointem, ne plošnou admin výjimkou.
SegmentSegmentSegment (14 hodnot: 1 spotřeba, 2 VT, 3 NT, 4 výroba, 5 přetok, 9 CO₂, 11 výkon spotřeby, 14 výkon výroby)—Pojem EM2 — jeden plochý číselník kombinující veličinu, směr i tarif.V EM3 zaniká a rozpadá se na pět samostatných dimenzí odvozených ze standardu DLMS/COSEM. Při migraci mapovat, ne přejmenovat. Stejný číselník sdílely odečty i položky faktur.
Deník aktivit odečtuReading activity log— (ukládal se jen aktuální stav)vazba reading → activityLogHistorie zásahů do odečtu včetně staré a nové hodnoty.Nad rámec parity s EM2.
Denní data měřidlaDaily outputgauge_daily_output, datasety S0A a S0Bagregační vrstva, pohled best_availablePojem EM2 — denní agregace, ze které čerpají grafy, predikce i optimalizace sazeb.Přímý architektonický ekvivalent. EM3-276 je BLOCKED.
Import datData importdata_import, DataImportItem (polymorfní vazba)dataImport, invoice.importId, reading.importIdJeden běh dávkového nahrání faktur, odečtů, měřidel nebo jejich úprav.Polymorfní join tabulka se ruší; vzniklé záznamy odkazují na import přímo. Chybějící auditní údaje se doplňují hodnotou system:migration.
Zdrojový formát importuImport source type—dataImport.sourceType, DataImportSourceTypeHromadný soubor, nebo automatický příjem ISDOC.Nové v EM3, odvozuje se z přípony souboru.
Zdroj vzdáleného připojení, konektorRemote source, Connectoraggregator_remote_sourcesremoteSourceKonektor na externí systém dodávající odečty nebo faktury.Vazba na klienta je mnoho ku mnoha — jeden zdroj slouží více klientům.
Koncový bod, datový kanálRemote end pointaggregator_remote_endpointsremoteEndPointJeden datový kanál zdroje, spárovaný s měřidlem, nebo s meteostanicí — nikdy s obojím.Zápis EndPoint se odchyluje od běžného endpoint.
PárováníPairingmodul AUTO_PAIR_GAUGE_READINGS— (funkce nad koncovými body)Přiřazení nespárovaného koncového bodu ke konkrétnímu měřidlu.Ve verzi 1 jen po jednom; hromadné párování odložené do v2. Opětovné spárování vyžaduje potvrzení.
Stav konektoruConnector health statusRemoteEndPointRecord, EgdDataAggregator::STATUSES_VALIDremoteSource.outageThresholdHours, hodnoty operational, warning, errorDopočítaný stav z času posledního úspěšného požadavku a nastaveného prahu.Nové v EM3, pro superadmina i souhrnně napříč klienty.
OBIS kódOBIS codeiecCode (na měřidle)remoteEndPoint.iecCodeStandardizovaný identifikátor měřené veličiny ve tvaru A-B:C.D.E*F.Přesouvá se z měřidla do domény dálkových odečtů.
Kontrolní den odečtuReading cycle dayclients.gauge_month_control_day_setting, gauge_month_control_day, gauge_week_control_dayclient.gaugeMonthControlDaySetting, client.gaugeMonthControlDay, client.gaugeWeekControlDayDen v měsíci nebo týdnu, ke kterému se vztahuje pravidelný cyklus odečtů.Beze změny. Hodnoty firstDay, lastDay, customDay (1 až 28).
Připomínka odečtuReading reminderclients.gauge_reading_reminder, gr_days_tolerance_*client.gaugeReadingReminderKdy systém upozorní, že odečet chybí.Automatické vypnutí měřidla po X dnech (gauge_disabled_after) se do EM3 nepřenáší (rozhodnuto 26. 6. 2026).
SamoodečetSelf-reading——Odečet, který si k danému datu zadá sám odběratel, typicky k půlnoci posledního dne v měsíci.Samostatná feature mimo Reading Management.
Koncentrátor, bránaConcentrator, Gateway——Zařízení mezi měřidlem a rozhraním, které sbírá data z více měřidel.Pojem z popisu integrací, ne pole v datech.

Faktura a smlouva ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
FakturaInvoiceinvoicesinvoiceDoklad za energii nebo službu zadaný k měřidlu, pokrývající fakturační období.Peníze se z float mění na numeric(12,2).
Číslo fakturyInvoice numberinvoices.invoice_numberinvoice.invoiceNumberOznačení dokladu od dodavatele.Beze změny.
Fakturační obdobíBilling periodinvoices.date_from, date_toinvoice.dateFrom, invoice.dateToInterval, který faktura pokrývá.Beze změny.
Cena s DPH, bez DPHPrice, Price without VATinvoices.price, price_without_vatinvoice.price, invoice.priceWithoutVatFakturovaná částka v obou podobách.Sazba DPH se v EM2 neukládá, dopočítává se za běhu. Název price implicitně znamená „s DPH" — položka faktury pro totéž používá cost….
DobropisCredit noteinvoices.credit_noteinvoice.creditNoteOpravný doklad se zápornou hodnotou.Beze změny. V EM2 výjimka z pravidla „záporné hodnoty se zahazují".
Položka fakturyInvoice valueinvoice_valueinvoiceValueRozpad faktury podle dvojice druh a tarif.Nahrazuje jediný souhrnný údaj.
Druh položkyInvoice value kindinvoice_value.segmentinvoiceValue.kind, invoiceValue.tariff, InvoiceValueKindSpotřeba (u exportu dodávka či přetok), výkon, cena s DPH, cena bez DPH.Plochý číselník se rozpadá na dvě ortogonální dimenze. Segment 4 (výroba) padá do stejného kbelíku jako 1 (spotřeba), směr se odvozuje z měřidla; segment 5 se stává výkonem.
Jednotka položkyInvoice value unitinvoice_value.unit (hodnota 99 = Kč)invoiceValue.unit, UnitJednotka fakturované hodnoty.Číslování 1 až 10 zůstává, koruna se z 99 přečíslovává na 11.
Rozpad faktury do dnůInvoice allocationInvoiceDataCollector—Rozpuštění fakturované spotřeby na jednotlivé dny období.EM2 váží skutečným průběhem jen při pokrytí alespoň 95 % dní, jinak rovnoměrně; faktura doplňuje spotřebu jen tam, kde chybí odečty.
Mezera, přesah obdobíGap, Overlap——Nespojitost navazujících fakturačních období.Kontrola navržena v Invoice Management, Feature 102.
Napojení na RevisioRevisio linkinvoices.revisio_record_id—Odkaz na doklad v externím účetním systému jednoho klienta.Nemigruje se jako sloupec faktury; řeší se samostatnou integrací.
SmlouvaContractContract + gauges_contract, souběžně GaugeUnitPrice a GaugeProperties.suppliercontractSmlouva o dodávce pokrývající jedno nebo více měřidel.EM2 má dvě paralelní cesty k ceně a EM3 je sjednocuje. Kde běží obojí (915 měřidel), vyhrává novější model. Z 856 smluv jich 780 pokrývá právě jedno měřidlo.
DodavatelSupplierSuppliercontractSupplierObchodník, se kterým je uzavřená smlouva. Nezaměňovat s distributorem, který provozuje síť.Migruje se jen název. Příznaky médií, počet použití a slučování se zahazují. Dodavatel není organizace s právní subjektivitou.
Položka smlouvyContract itemContractItem, GaugeUnitPricecontractItemJedna oceněná položka — například vysoký tarif sazby C02d nebo vodné.Historizovaná cena mimo hromadný nákup (43 měřidel) se převádí na dvojici položka a sazba.
Typ položky, sazba, povolená kombinaceContract item type, rate, allowed combinationContractItemType, ContractItemRate, ContractItemAllowedTypeRatecontractItemType, contractItemRate, contractItemAllowedTypeRateGlobální číselník oceňovatelných položek (sazby C01d až D57d, vodné, stočné), jednotka ceny a pravidlo, které dvojice dávají smysl.Přebírá se téměř beze změny — dobře normalizovaný model.
Sdružený nákupBulk purchasegauges_contractcontract.purchaseType, ContractPurchaseTypeSmlouva na skupinu odběrných míst stejného média.V EM3 explicitní příznak; jedno měřidlo je běžný zvláštní případ.
Způsob dodávkyDelivery methodContract.delivery_method i ContractItemType.delivery_methodcontractItemType.deliveryMethodJednosložková nebo dvousložková cena.Pole na smlouvě se ruší jako duplicita — byl to jen přepínač viditelnosti, vyplněný u 114 z 856 smluv.
Médium smlouvyContract mediumGaugeProperties.consumption_typecontract.medium, ContractMediumMédium a u elektřiny a plynu i kategorie odběratele: maloodběr, velkoodběr.Rozhodnuto 12. 8. 2026: vlastnost celé smlouvy. V jedné smlouvě nelze kombinovat malo- a velkoodběr. Teplo je nově plnohodnotná hodnota (F127).
Zamykání fakturačních políField lockingGaugeInvoicingTypestejné chováníPo napojení měřidla na platnou smlouvu se pole dodavatel a cena na měřidle stanou jen pro čtení.Potvrzeno jedna ku jedné. Netýká se karty Faktury.
Palivo a pohonné hmoty ve smlouváchFuel and vehicle fuel in contractsvyloučeno v GaugeInvoicingTypevyloučenoTato média se do smluvního modelu nezahrnují.Architektonické rozhodnutí, EM3 ho přebírá.

Slovník · Měřidlo a odběrné místo ​

Měřidlo a odběrné místo ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
MěřidloGaugegauges, GaugeProperties, GaugeSettingsgaugeMěřicí bod, který dodává data o spotřebě. Nese konfiguraci, ne samotné odečty.EM3 slučuje hlavní tabulku s vlastnostmi; verzovaná nastavení zůstávají v samostatných tabulkách.
Odběrné místoMetering point, Supply pointgauges.eangauge.supplyPointIdMísto odběru evidované u distributora. Zkratka OM.Přejmenováno na obecný název, protože stejné pole nese i EIC a evidenční čísla u ostatních médií.
EAN, EICEAN, EICgauges.eangauge.supplyPointIdUnikátní identifikátor odběrného místa elektřiny (EAN) a plynu (EIC).Návrh sdíleného EAN (isSharedEan) byl zamítnut — za 15 let provozu se situace nevyskytla.
Evidenční čísloRegistration number?gauge.supplyPointIdIdentifikátor přidělený dodavatelem u tepla, vody a ostatních médií.Obdoba EAN a EIC mimo elektřinu a plyn.
Druh měřidlaGauge kindgauges.level (LEVEL_MAIN, LEVEL_SECONDARY, LEVEL_FICTIVE)gauge.kind, GaugeKindFyzické zařízení, podružné měřidlo, nebo virtuální bez zařízení.1 → standard; 2 s vyplněným rodičem → subGauge; 3 → virtual.
Podružné měřidlo, podměřidloSub-gaugegauges.parent_gauge_id + level = 2gauge.parentGaugeId, gauge.kind = subGaugeFyzický měřič dílčího okruhu pod nadřazeným měřidlem.Pozor: v EM3 znamená vztah rodič-potomek něco jiného než seskupení kanálů jednoho fyzického měřiče.
Virtuální měřidloVirtual gaugegauges.level = LEVEL_FICTIVEgauge.kind = virtual, gauge.virtualSubtype, GaugeVirtualSubtypeMěřidlo bez zařízení; hodnota vzniká vzorcem (computed), ručním zadáním (manualInput) nebo jako bilance objektu (buildingTotal).EM2 všechny tři případy sléval do jedné úrovně. Podtyp se po migraci přiřazuje ručně; buildingTotal v EM2 neexistuje.
Systémově spravované měřidloSystem-managed gauge—gauge.isSystemManagedVzorec virtuálního měřidla generuje a udržuje systém, ne uživatel.Nové v EM3; u migrovaných měřidel vždy nepravda.
Bilance budovyBuilding total— (počítáno za běhu v ReportDataCollector)gauge.virtualSubtype = buildingTotalSoučtový vzorec objektu: součet přítoků minus součet odtoků.V EM2 se nikdy neukládala. V EM3 je to trvalý, auditovatelný vzorec — každá změna režimu zahrnutí vyžaduje potvrzení uživatelem.
Fyzický měřičPhysical meter—gauge.physicalMeterId, physicalMeterJedno zařízení s více měřenými kanály — čtyřkvadrantový elektroměr měří import i export.Nové v EM3 (EM3-303). Migrace u obousměrných měřidel vytvoří dva záznamy sdílející nový identifikátor; žádný kanál není hlavní. V dokumentaci se jeden kanál označuje zkratkou MG.
MédiumMediumgauges.type, GaugeType::TYPE_*gauge.medium, GaugeMediumCo měřidlem protéká: elektřina, plyn, voda, teplo, palivo, pohonné hmoty, kvalita vnitřního prostředí, jiné čidlo.Číselné hodnoty se neshodují — migrace používá překladovou mapu. EM2 měl dvě různé hodnoty pro vodu. Enum GaugeType se v EM3 ruší úplně.
Primární zdrojPrimary sourcegauges.primary_source, GaugeType::SOURCE_*gauge.primarySource, PrimarySourcePalivo nebo zdroj energie — zemní plyn, štěpka, hnědé uhlí, elektřina, celkem 28 hodnot.Přímá kopie čísel 1 až 28, tedy i bez rozpadu biomasy u elektroměru. Pozor na sémantický posun — viz Past na překlad.
Směr tokuDirectionodvozeno ze segmentgauge.direction, reading.direction, GaugeDirectionDo objektu ze sítě, z objektu do sítě nebo výroba, případně bez směru u čidel.Segmenty 1, 2, 3, 11 → import; 4, 5, 14 → export; kvalita vnitřního prostředí → prázdné.
Režim zahrnutí do bilanceOutput modegauges.dataInResults (ON, OFF, TAKE_OFF)gauge.outputMode, GaugeOutputModeZahrnout, odečíst, vyloučit, nebo pouze reportovat.Migrační pravidlo: standardní s importem → include, standardní s exportem → reportOnly, podružné → exclude. Hodnota OFF se zachovává jako záměrné nastavení. reportOnly nemá v EM2 předlohu.
Účel měřidlaGauge purposegauge_purpose (vazba 1:N)gauge.purpose → gaugePurposeOption, GaugePurposeSlovní varianta („Odběr ze sítě", „Výroba FVE"), která přednastaví směr toku a režim zahrnutí.Z vazby jeden na mnoho se stává jeden na jedna s odkazem do nového číselníku. Číselník není finální. Pozor: cizí klíč se jmenuje purpose, ne purposeId jako ostatní.
Režim odečtuReading modeoutputMode (EM2 význam)gauge.readingMode, GaugeReadingMode, reading.formatKumulativní stav počítadla, nebo spotřeba za období.Kolize názvů — EM2 tomuhle říká outputMode, což v EM3 znamená úplně jinou věc. Viz Past na překlad.
Priorita zdrojůSource prioritygauges.remote_as_primary (ano/ne)gauge.sourcePriority, client.defaultSourcePriority, GaugeSourcePriorityPořadí důvěryhodnosti při konfliktu zdrojů.Ne → manual_remote_invoice, ano → remote_manual_invoice. EM3 má šest permutací a nově i výchozí hodnotu na klientovi. Dočasný adaptér řadí jinak než nastavení — OR-1 Epicu 3.1.
Sériové číslo a jeho historieSerial number, Gauge serial historygauges.serial_number, GaugeProperties.meterNumbergauge.serialNumber, gaugeSerialHistoryVýrobní číslo měřiče a záznam jeho výměn.EM2 historii nemá. Migrace založí jediný záznam s platností od vzniku měřidla; starší výměny nelze zrekonstruovat.
VýrobceManufacturergauges.manufacturergauge.manufacturerVýrobce měřicího zařízení, volný text.Beze změny.
JednotkaUnitgauges.unit, Unitsgauge.unit, reading.unit, UnitFyzikální jednotka měřené veličiny.Prázdná hodnota se doplňuje na kWh. V EM3 se jednotka navíc denormalizuje na odečet, aby výměna měřidla nepřepsala historii.
Koeficient měřidlaGauge coefficientgauge_volume_ratiovolumeCoefficientVerzovaný převodní koeficient aplikovaný před zápisem spotřeby — typicky m³ plynu na kWh.Migruje se celá historie; kde chybí platnost od, doplní se datum migrace. EM3 přidává isVoided.
Objemový koeficientVolume coefficientgauge_volume_ratio, gauge_remote_volume_ratiovolumeCoefficientPojem EM2 pro přepočet objemu na energii.EM2 ho bere z prvního účelu měřidla pro všechny segmenty, včetně výroby — OR-12 Epicu 3.1.
VýhřevnostCalorific valuedefault_heating_power_types, HeatingPower, GaugeHeatingPowerdefaultCalorificValue, calorificValueKoeficient převádějící palivo na energii. Přednost: měřidlo, klient, systém.EM2 tři úrovně bez platnosti od a do; individuální úroveň jen u plynoměru. Klíčování se mění z GaugeType na medium. V EM3 je to EM3-58, dosud blokované.
JističCircuit breakerGaugeSettings (verzované)gauge.circuitBreakerJmenovitá hodnota hlavního jističe; základ fixních plateb u nízkého napětí.Verzovaná nastavení v EM3 nese tabulka gauge_phaze_and_breaker — s překlepem převzatým z EM2.
Počet fázíPhase countGaugeSettings (verzované)gauge.phaseCountVstup do výpočtu podpory obnovitelných zdrojů podle jističe.Migrace patří do Reading Management epicu, ne do mapy měřidla.
Rezervovaná kapacitaReserved capacityGaugeProperties.reserved_capacity (text)gauge.reservedCapacitySjednané maximum odběru u velkoodběru.Text se převádí na desetinné číslo v MW; jednotka není v názvu. Na testovacích datech jsou jen 4 záznamy.
Rezervovaný příkonReserved powerGaugeProperties.reserved_power—Obdobný sjednaný parametr; vstup pro optimalizaci u vysokého napětí.Nemigruje se, odloženo mimo v1. Bez něj nejde dokončit Feature 124 pro vysoké napětí (OR-9 Epicu 3.4).
Typ odběruConsumption typeGaugeProperties.consumption_type— (na měřidle), contract.medium (na smlouvě)Maloodběr proti velkoodběru; u elektřiny nízké napětí proti vysokému.Na měřidle se nemigruje. Rozhodnuto 12. 8. 2026: je to vlastnost celé smlouvy, ne položky ani měřidla.
Distribuční sazbaDistribution tariffRate, GaugeSettingsgauge.distributorTariff (volný text), gauge_rateSazba distributora, například C02d nebo D01d.Regres: EM2 má číselník s příznaky tarifů, EM3 na měřidle jen volný text — OR-5 Epicu 3.4.
Typový diagram dodávkyTariff distribution diagramGaugeProperties.tddEl, tddgauge.tddGroupZkratka TDD. Skupina typového průběhu odběru tam, kde není průběhové měření.Dvě EM2 pole (elektřina a plyn) se slučují do jednoho.
Fakturační frekvenceBilling frequencyGaugeProperties.invoicePeriodgauge.billingFrequency, GaugeBillingFrequencyMěsíčně, čtvrtletně, ročně, jinak.Přesné legacy hodnoty jsou zatím k doplnění.
Sdružený nákup na měřidlePart of bulk purchaseGaugeProperties.involvedInPurchasegauge.isPartOfBulkPurchaseMěřidlo je zahrnuté do hromadného nákupu energie.Přejmenováno.
Sdílení elektřinyElectricity sharingGaugeProperties.electricitySharingConsumption, electricitySharingProductiongauge.electricitySharingConsumption, gauge.electricitySharingProductionSpotřební nebo výrobní EAN zapojený do sdílení; vylučuje nabídku sazeb C01d a D01d.Beze změny, jen u elektřiny.
Vlastník měřicího zařízeníMeter ownership—gauge.meterOwnership, GaugeMeterOwnershipOdběratel, distributor, třetí strana.Nové v EM3.
Výměna měřidlaMeter replacement—reading.lifecycleState (initial, final), gaugeSerialHistoryKonec jednoho fyzického měřiče a start dalšího.EM3-296 rozpracováno. EM2 při změně jednotky jen přeznačí, nepřepočítá.
Archivace měřidlaGauge archivegauges.disabled_at, disabled_reason, GaugeDisableReasongauge.archivedAt, gauge.archiveReason, gauge.isArchived, GaugeArchiveReasonProdej či demolice, převod do jiné správy, vyřazení mimo hranice EnMS, přeřazení, sloučení, změna média, změna užívání, jiný důvod.Přímé mapování hodnot 1 až 8, stejná logika jako u objektu.
Typ zapojeníConnection typeconnectionType (na měřidle)remoteEndPoint.connectionTypePřímé, optočlen, vysílač, jiné.Přesouvá se z měřidla na koncový bod dálkového odečtu.
Fotovoltaická elektrárnaPhotovoltaic plant——Zkratka FVE.
Přetok do sítěExport, Feed-inSEGMENT_ENERGY_DELIVERY (5)gauge.direction = exportEnergie dodaná z objektu do distribuční sítě.Nezaměňovat s přetokem limitu — viz Past na překlad.
Kvalita vnitřního prostředíIndoor environment qualitygauges.type = KVPgauge.medium = kvpTeplota, vlhkost a koncentrace CO₂ z čidel. Zkratka KVP.Nemá směr toku ani tarif.
Pohonné hmotyVehicle fuelgauges.type = PHMgauge.medium = phmPaliva pro vozidla. Zkratka PHM.V EM3 samostatné médium, odlišené od stacionárního paliva fuel.

Nesrovnalost k opravě: u výroby FVE uvádí stránka Gauge Management kombinaci export a reportOnly, zatímco stránka outputMode + direction uvádí include a import. Na jednom objektu je to rozdíl 1 800 kWh. Nahlášeno autorovi stránek.

Verzovaná nastavení měřidla ​

Tyhle tabulky drží hodnoty, které se v čase mění. V EM2 byly součástí GaugeSettings, konkrétní sloupce migrační mapa neuvádí — patří do Billing a Reading Management epiců.

Co neseEM3 v kódu
Distribuční sazbagauge_rate
Jednotková cena médiagauge_unit_price
Fakturační jednotkagauge_invoice_unit
Fáze a jističgauge_phaze_and_breaker
Instalovaný topný výkongauge_heating_power
Cena podle odběrného místagauge_price_supply_point

Slovník · Objekt a jeho parametry ​

Objekt a jeho parametry ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
AktivumAsset—— (doménová kategorie)Zastřešující pojem pro objekt, měřidlo a meteostanici.Nový pojem v EM3, není to tabulka.
ObjektBuilding, Building nodebuildings, building_propertiesbuildingUzel, jehož spotřebu sledujeme. Může to být budova, soustava veřejného osvětlení nebo jiné zařízení.EM3 slučuje dvě EM2 tabulky a přidává strom přes building.parentId.
AreálCampusgrounds, building_properties.areal (volný text)building.levelType = campusSkupina budov na jednom místě, například školní areál.EM2 areál byl zvlášť tabulka i volný text; oboje nahrazuje uzel ve stromu. Volný text se ruší.
Typ objektuBuilding typebuildings.type (1, 2, 3)building.type, BuildingTypeBěžná budova, soustava veřejného osvětlení, jiné.1 → building, 2 → publicLighting, 3 → other.
Úroveň uzluBuilding level type—building.levelType, BuildingLevelTypeRole uzlu ve stromu: portfolio (jedno na klienta, vzniká automaticky), region (automaticky podle PSČ), campus, building, floor a unit (rezervováno pro pasport).Nové v EM3, strukturu nevynucuje.
SektorSectorbuildings.sector_idbuilding.sectorIdOdvětvové zařazení objektu; filtr grafů a přehledů.Beze změny.
Vlastník, správce, pověřený správceOwner, Manager, Delegated managerbuildings.ico, owner, manager_ico, manager, delegated_manager_ico, delegated_managerbuilding.ownerIco, building.ownerName, building.managerIco, building.managerName, building.delegatedManagerIco, building.delegatedManagerTři role subjektů u objektu, dohledávané podle IČO v registru ARES.Jen přejmenování; buildings.ico je IČO vlastníka, což z názvu nebylo poznat. Nesourodost v EM3: vlastník a správce mají ...Name, pověřený správce ne.
AdresaAddressbuildings.street, house_number, reference_number, zip, citybuilding.street, building.houseNumber, building.referenceNumber, building.zip, building.cityPoštovní adresa objektu.PSČ se převádí z čísla na pětimístný text s vedoucími nulami. Město se nově dá dohledat podle PSČ.
Souřadnice objektuCoordinatesbuildings.map_lat, map_lng, map_lat_custom, map_lng_custom, mapy_cz_url, show_on_mapbuilding.lat, building.lng, building.latCustom, building.lngCustom, building.mapyComUrl, building.showOnMapGeokódovaná nebo ručně přepsaná pozice objektu. Vlastní souřadnice mají přednost.Uložený odkaz na mapu se ruší a nahrazuje ho pole dopočítané za běhu.
Rok výstavbyYear builtbuildings.built_yearbuilding.yearBuiltRok dokončení stavby.Přejmenováno.
Památková ochranaHeritage protectionbuilding_properties.protectedbuilding.isHeritagePříznak omezující možná opatření.Přejmenováno; prázdná hodnota se čte jako nepravda.
Klasifikace ÚČEHBuilding classification codebuilding_properties.ucehbuilding.ucehKód klasifikace budovy.Beze změny. V grafovém enginu zatím není dostupný jako filtr.
Součást energetického managementuPart of EnMSbuilding_properties.client_energy_management, client_working_energy_managementbuilding.isPartOfEnms, building.isOperationPartOfEnmsZda objekt a jeho provoz spadají do energetického managementu klienta.Prázdná hodnota se čte jako pravda.
Energetický profil objektuBuilding energy profilebuilding_properties (část polí)buildingEnergyProfileSkupina technických údajů o objektu: počet podlaží, faktor tvaru, instalovaný výkon, provozní doba, dotační programy, certifikace.Nová samostatná entita v EM3; v EM2 to byly sloupce jedné široké tabulky.
Počet podlažíFloor countbuilding_properties.floor_countbuildingEnergyProfile.floorCountPočet nadzemních podlaží.Beze změny.
Faktor tvaru budovyEnvelope-to-volume factorbuilding_properties.factor_avbuildingEnergyProfile.factorAvPoměr plochy obvodového pláště k obestavěnému objemu, značí se A/V.Beze změny, nepřepočítává se.
Instalovaný výkonInstalled powerbuilding_properties.rated_power_source (volný text)buildingEnergyProfile.installedPowerRaw, buildingEnergyProfile.installedPowerKw, buildingEnergyProfile.installedPowerUnitVýkon zdroje v objektu.Migrace se pokusí text rozparsovat na číslo a jednotku, původní text zůstává.
Provozní dobaOperating timebuilding_properties.operating_time (volný text)buildingEnergyProfile.operatingTimeNezávazný popis provozní doby objektu.Beze změny.
Provozní rozvrhBuilding schedule—buildingScheduleTýdenní mřížka 672 patnáctiminutových slotů. Autoritativní vstup pro detekci anomálií.Nové v EM3 a mimo rozsah migrace — volný text z EM2 zůstává vedle něj jako popisek.
Zapojení do EPCEPC enrolmentbuilding_properties.in_epc, in_epc_sincebuildingEnergyProfile.epcEnrolled, buildingEnergyProfile.epcFromProjekt energetických služeb se zárukou.Přejmenováno, datum se zkracuje na den.
Zapojení do OPŽPOPZP enrolmentbuilding_properties.in_opzp, in_opzp_sincebuildingEnergyProfile.opzpEnrolled, buildingEnergyProfile.opzpFromDotační program Životní prostředí.Přejmenováno.
Certifikace ISOISO certificationbuilding_properties.by_iso, by_iso_sincebuildingEnergyProfile.isoCertified, buildingEnergyProfile.isoFromZda je objekt pokrytý certifikací podle ISO 50001.Přejmenováno.
Parametry objektuBuilding parameterbuilding_heated_area, building_usable_area, building_built_up_area, building_users_quantity, building_templerature, building_public_light_pointsbuildingParameterVerzovaný snímek fyzických parametrů objektu.EM3 slučuje šest EM2 tabulek do jedné verzované entity s validFrom.
Energeticky vztažná plochaEnergy reference areabuilding_heated_area.areabuildingParameter.areaEnergyReferencePlocha, ke které se vztahují měrné ukazatele.V EM2 UI „Celková energeticky vztažná plocha", jen tabulka se jmenuje building_heated_area. Celé číslo se převádí na desetinné.
Užitná plochaUsable areabuilding_usable_area.areabuildingParameter.areaUsableCelková užitná plocha objektu (m²).Převod na desetinné číslo.
Obestavěný prostorEnclosed volumebuilding_built_up_area.areabuildingParameter.volumeEnclosedObestavěný prostor objektu (m³).Pozor: tabulka se jmenuje „built-up area“, ale EM2 v ní eviduje obestavěný prostor v m³, ne zastavěnou plochu. Zastavěná plocha se v EM3 neeviduje.
Počet uživatelů objektuUser countbuilding_users_quantity.quantitybuildingParameter.userCountKolik lidí objekt užívá; jmenovatel měrných ukazatelů.Beze změny.
Referenční vnitřní teplotaReference indoor temperaturebuilding_templerature.temperaturebuildingParameter.temperatureReferenceVnitřní teplota, ke které se počítají denostupně. Značí se T_ref.Beze změny hodnoty. Pozor: EM2 tabulka má překlep v názvu a joinuje se bez filtru platnosti, takže verzování se fakticky ignoruje. EM3 verzuje správně.
Světelné bodyLight pointsbuilding_public_light_points.points, building_public_light_points_fve.points, building_properties.rvo_countbuildingParameter.lightPoints, buildingParameter.lightPointsPv, buildingEnergyProfile.rvoCountPočet světelných bodů soustavy veřejného osvětlení, kolik z nich má fotovoltaiku a kolik je napájecích míst.Beze změny, jen pro typ objektu veřejné osvětlení.
Meteostanice objektuBuilding climate station—building.climateStationIdStanice, ze které objekt bere klimatická data.EM2 používá výhradně výchozí stanici klienta, objektová do výpočtu nevstupuje. Pozor: pole se jmenuje climate…, ale míří na entitu weatherStation.
Archivace objektuBuilding archivebuildings.disabled_at, disabled_reasonbuilding.archivedAt, building.archiveReason, building.isArchived, BuildingArchiveReasonVyřazení objektu z evidence s uvedeným důvodem; data zůstávají.Přejmenováno. Příznak isArchived je nový — EM2 ho odvozoval z vyplněného data.
Pasport objektuBuilding passport——Podrobná evidenční karta objektu.Epic 1.2, odloženo do v2. Úrovně floor a unit jsou pro něj připravené.
Průkaz energetické náročnosti budovyEnergy performance certificate??Zkratka PENB. Třída z průkazu se používá jako filtr grafů.Filtr je popsaný ve feature Chart Types, konkrétní pole zatím nikde pojmenované.

Slovník · Klient, organizace a přístup ​

Klient, organizace a přístup ​

Český pojemEnglishEM2 v kóduEM3 v kóduVýznamMapování a poznámky
KlientClient, Tenantclientsclient, tenantIdNejvyšší organizační jednotka systému. Nese identitu organizace, systémová nastavení, licenci a zapnuté moduly.EM3 přidává datovou izolaci tenantem; vazba klient a tenant je jedna ku jedné.
Typ klientaClient typeclients.typeclient.type, ClientTypeKategorie klienta, například svazek obcí; ovlivňuje, která pole se zobrazují.Hodnota municipality_group přejmenována na municipalityGroup.
Skupina klientůClient groupclients.client_group_idclient.clientGroupIdOrganizační štítek seskupující klienty, bez vlastní konfigurace.Beze změny.
KrajRegionclients.region_idclient.regionIdGeografické zařazení klienta pro reporting.Beze změny.
Organizace, subjektOrganisation—organisationPrávnická nebo fyzická osoba v registru klienta. Vystupuje jako vlastník či správce objektu nebo jako odběratel u měřidla.Samostatná vrstva až v EM3; v EM2 rozptýlené v polích objektu a měřidla.
Fyzická osoba, právnická osobaNatural person, Legal entity—organisation.type, organisation.legalFormRozlišení typu subjektu v registru. U fyzické osoby se IČO nevyžaduje a zadává se volným textem.Právní forma se přebírá z registru ARES.
OdběratelSubscriberGaugeProperties.customerICO, customerName, customerEmailgauge.subscriberId → organisationOrganizace, která je na odběrném místě smluvním odběratelem.Z volných textových polí na měřidle se stává odkaz na organizaci; migrace deduplikuje podle IČO.
Osoba, kontaktPerson—person (návrh)Pojmenovaný kontakt — vlastník, správce, technik, odečtář — přiřaditelný k objektu nebo měřidlu.Zatím jen v datovém modelu, kde je uvedená jako Person.
UživatelUserusersuserOsoba s přístupem do aplikace.
Odpovědná osobaResponsible personusers_buildings + role ROLE_WORKER, Building::getResponsibleUser()responsiblePersonAssignmentPřiřazení osoby k objektu v konkrétní roli — EnMS, fakturace, technika, regulatorika.EM2 vybíral první nalezenou osobu bez řazení, tedy nedeterministicky. Migrace založí záznam pro každého přiřazeného pracovníka. Rozhodnuto 13. 8. 2026: jen úroveň objektu, ne per médium.
Role uživateleUser roleROLE_WORKER, ROLE_CAN_EDIT_H_M_SHORT_TERM_HEATING_DAYS a dalšíadmin, manager, technician, accountant, workerRole řídí oprávnění a směrování notifikací.Hlavní manažer klienta: clients.main_manager_id → client.mainManagerId.
SuperadminSuperadmin, Porsenna system admin—— (role, bez vlastní entity)Role nad úrovní administrátora klienta. Vidí data napříč všemi klienty, spravuje globální číselníky a UI popisky.Nové v EM3.
Oprávnění napříč klientyCross-tenant read permission—userTenantAccess (návrh)Právo číst data více klientů najednou, například pro helpdesk nebo krajského manažera.Nové v EM3, modelováno jako vlastnost uživatele.
Adresář osobPerson directory—personDirectorySdílená tabulka mimo schémata klientů, která mapuje jméno, telefon a e-mail na klienta.Nové v EM3, jen pro čtení, plněné triggerem z organizací.
Notifikační maticeNotification matrixusers.email_reporting, email_reminder, incident_email_reporting, sms_reportingclientNotificationMatrix, user.emailReporting, user.emailReminder, user.incidentEmailReporting, user.smsNotificationsEnabledKonfigurace, které role dostávají který typ notifikace a jakou formou. Při vzniku klienta se předvyplní sedm typů krát pět rolí.EM2 měl booleovské příznaky na uživateli; ty se migrují jedna ku jedné a matice je nová vrstva nad nimi. Pozor: 53 % uživatelů má report vypnutý — migrace to musí zachovat. SMS v EM3 v1 nemá UI ani implementaci.
Forma doručeníDelivery form—NotificationDeliveryFormOkamžitě, nebo denní souhrn. Platí pro celý typ notifikace napříč rolemi.Nové v EM3.
ModulClient moduleclient_permissions (IMPORT_GAUGE_READINGS, AUTO_PAIR_GAUGE_READINGS, IMPORT_INVOICES, MODULE_SETTLEMENT, QR_PRINT, CHAT)clientModule, MODULE_KEYS (remoteReadings, invoiceImport, settlement, qrPrint, emissionFactors)Zapínatelná část funkcionality klienta.Import odečtů a automatické párování se slučují do remoteReadings. Modul CHAT se nemigruje. emissionFactors je nový — přepínač existuje, obsah za ním ne.
Typ licenceLicence typeclients.licence_type (1, 2, 3)client.licenceType, LicenceTypeNa dobu neurčitou, časově omezená, nebo s automatickým prodloužením.Číselné hodnoty se převádějí na indefinitePeriod, timeLimit, autoExtension.
Úroveň licenceLicence levelclients.licence_level (0, 1, 2)client.licenceLevel, LicenceLevelDemo, základní, rozšířená.Převádí se na demo, basic, extended. Platnost: licence_valid_to → client.licenceValidTo, u 75 klientů prázdná.
Zobrazovat náklady bez DPHDisplay costs without VATclients.display_expenses_without_vatclient.displayExpensesWithoutVatKlientské nastavení, v jaké podobě se ukazují náklady.Beze změny.
Výchozí lhůta akceDefault action deadlineclients.event_deadline_defaultclient.defaultActionDeadlineDaysZa kolik dní má být akce standardně vyřešená.Přejmenováno.
Energetický managementEnergy management——Obor, kterého se celá aplikace týká. Zkratka EM.
Český pojemEnglishVýznam
SekceSectionTlačítko na hlavní liště — Objekty, Akce, Grafy, Vstupy, Přehledy.
ZáložkaTabPodstránka v rámci sekce — například Klimadata a Výhřevnosti ve Vstupech, Predikce v Přehledech.
Odečtový formulářReading formStránka, kde se zadávají odečty. Zkratka OF.
Fakturační formulářInvoice formStránka, kde se zadávají faktury. Zkratka FF.
Detail (objektu, měřidla, akce…)Detail pageStránka po kliknutí na tlačítko Detail u záznamu.