npm - @golemio/public-transport - Versions diffs - 0.1.0 - Mend

@golemio/public-transport 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2315) hide show

package/docs/processing/index.md ADDED Viewed

@@ -0,0 +1,18 @@
+# Dokumentace zpracování vstupních RT dat
+- **Popis vstupních dat podle poskytovatele**
+    - [HTTP MPVNet](./input_realtime_data/http_mpvnet.md)
+        - [Městské a příměstské autobusy (mimo DPP)](./input_realtime_data/http_mpvnet.md#městské-a-příměstské-autobusy-mimo-dpp)
+        - [Přívozy](./input_realtime_data/http_mpvnet.md#přívozy)
+        - [Vlaky](./input_realtime_data/http_mpvnet.md#vlaky)
+    - [TCP DPP tramvaje](./input_realtime_data/tcp_dpp_tram.md)
+    - [TCP DPP autobusy a trolejbusy](./input_realtime_data/tcp_dpp_bus.md)
+    - [TCP DPP metro](./input_realtime_data/tcp_dpp_metro.md)
+    - [TCP Telmax Arriva City](./input_realtime_data/tcp_telmax_arriva_city.md)
+- **Popis určení stavu vozidla na trase podle poskytovatele**
+    - [HTTP MPVNet](./state_position_tracking/http_mpvnet.md)
+    - [TCP DPP](./state_position_tracking/tcp_dpp_common.md)
+    - [TCP DPP metro](./state_position_tracking/tcp_dpp_metro.md)
+    - [TCP Telmax Arriva City](./state_position_tracking/tcp_telmax_arriva_city.md)
+- [**Mapování MPVNet vehicle type na GTFS**](./vehicle_types.md)
+- [**Mapování MPVNet spojů na GTFS**](./trip_matching.md)

package/docs/processing/input_realtime_data/http_mpvnet.md ADDED Viewed

@@ -0,0 +1,174 @@
+# HTTP MPVNet
+## Městské a příměstské autobusy (mimo DPP)
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<m disp="http://77.93.194.81:8716/api">
+<spoj ka="2" kb="0" den="2025-03-30" lin="100194" alias="194" spoj="4009" dopr="ABOUT ME" doprSkut="ABOUT ME" kmenl="194" t="3" tcis="A" np="true" po="2" vuzevc="1907" skol="false" posl="false" sled="2" lat="50.09078" lng="14.42738" cpoz="09:34:59" azimut="76" rychl="1" zast="63505" asw="14100002" zpoz_prij="-59">
+	<zast stan="A" odj="09:20" zast="59168" asw="29530001" zpoz_typ_odj="3" zpoz_odj="28" />
+	<zast stan="D" odj="09:23" zast="59104" asw="3610004" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="-33" zpoz_odj="9" />
+	<zast stan="I" odj="09:26" zast="57811" asw="3600009" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="-84" zpoz_odj="-44" />
+	<zast stan="A" odj="09:27" zast="59299" asw="7030081" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="-36" zpoz_odj="-3" />
+	<zast stan="B" odj="09:29" zast="63506" asw="14080002" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="-70" zpoz_odj="5" />
+	<zast stan="A" odj="09:32" zast="59300" asw="29620001" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="-94" zpoz_odj="-9" />
+	<zast stan="A" odj="09:33" zast="59108" asw="29630001" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="-18" zpoz_odj="-1" />
+	<zast stan="B" odj="09:35" zast="63505" asw="14100002" zpoz_typ_prij="3" zpoz_typ_odj="2" zpoz_prij="-59" zpoz_odj="0" />
+	<zast stan="A" odj="09:37" zast="63507" asw="14090001" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="0" zpoz_odj="0" />
+	<zast stan="B" odj="09:39" zast="59203" asw="29560002" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="0" zpoz_odj="0" />
+	<zast stan="B" odj="09:40" zast="58766" asw="320052" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="0" zpoz_odj="0" />
+	<zast stan="H" prij="09:41" zast="27863" asw="6890008" zpoz_typ_prij="2" zpoz_prij="0" />
+</spoj>
+</m>
+```
+- _spoj_ - informace o spoji a vozidlu
+	- **ka** - ??? nepoužíváme
+	- **kb** - ??? nepoužíváme
+	- **den** - datum, kdy spoj vyjel
+	- **lin** - označení linky podle CIS
+	- **alias** - číslo/označení linky podle CIS
+	- **spoj** - označení spoje podle CIS
+	- **dopr** - smluvní dopravce podle JŘ
+	- **doprSkut** - reálný dopravce vykonávající oběh
+	- **kmenl** - kmenová linka, může se lišit od **alias**
+	- **t** - typ vozidla, viz [vehicle_types.md](../vehicle_types.md)
+	- **tcis** - ??? nepoužíváme
+	- **np** - indikátor nízkopodlažnosti
+	- **po** - oběhové číslo
+	- **vuzevc** -  [Evidenční číslo vozidla](https://cs.wikipedia.org/wiki/Eviden%C4%8Dn%C3%AD_%C4%8D%C3%ADslo_vozidla)
+	- **skol** - nejspíš indikátor školního spoje ??? nepoužíváme
+	- **posl** - nejspíš indikátor poslední spoje na oběhu ??? nepoužíváme
+	- **sled** - indikátor, zda je spoj sledovaný (tracked)
+		- 0 - nesledovaný (spoj je před trasou nebo dojel nebo je zrušen)
+		- 2 - sledovaný (spoj je na trase nebo v zastávce)
+	- **lat** - zeměpisná šířka
+	- **lng** - zeměpisná délka
+	- **cpoz** - čas odeslání zprávy (nejspíš z vozidla), nesmí být více než 5 minut v budoucnu
+	- **azimut** - azimut
+	- **rychl** - rychlost vozidla
+	- **zast** - aktuální nebo poslední projetá zastávka CIS (miniuzel)
+	- **asw** - aktuální nebo poslední projetá zastávka ASW
+	- **zpoz_prij** - zpoždění na příjezdu do aktuální nebo poslední projeté zastávky
+	- **zpoz_odj** - zpoždění na odjezdu z poslední projeté zastávky. Pokud je vozidlo v zastávce, pak není vyplněno
+	- **zrus** - indikátor, zda byl spoj zrušen
+	- **zrusod** - příklad 59168/A, nejspíš od které zastávky byl spoj zrušen ???
+- _zast_ - informace o projetých i budoucích zastávkách spoje
+	- **stan** - stanoviště/nástupiště/kolej podle CIS
+	- **odj** - čas odjezdu za zastávky podle JŘ
+	- **prij** - čas příjezdu do zastávky podle JŘ
+	- **zast** - identifikátor miniuzlu (CIS), kam zastávka patří
+	- **asw** - ASW identifikátor zastávky
+	- **zpoz_typ_prij** - typ zpoždění příjezd do zastávky (2 predikce, 3 reálný stav)
+	- **zpoz_typ_odj** - typ zpoždění odjezd ze zastávky (2 predikce, 3 reálný stav)
+	- **zpoz_prij** - zpoždění příjezd do zastávky
+	- **zpoz_odj** - zpoždění příjezd do zastávky
+## Přívozy
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<m disp="http://77.93.194.81:8716/api">
+<spoj ka="2" kb="0" den="2025-03-30" lin="199693" alias="P3" spoj="4096" dopr="VITTUS GROUP" doprSkut="VITTUS GROUP" kmenl="1803" t="12" tcis="P" np="true" po="1" vuzevc="302" skol="false" posl="false" sled="0" lat="50.04807" lng="14.41222" cpoz="09:18:29" azimut="337" rychl="2">
+	<zast stan="K" odj="09:32" zast="58997" asw="1100011" zpoz_typ_odj="2" zpoz_odj="0" />
+	<zast stan="K" prij="09:34" zast="28003" asw="3370011" zpoz_typ_prij="2" zpoz_prij="0" />
+</spoj>
+</m>
+```
+## Vlaky
+### Parsování stanoviště (`stan`) u vlaků
+Atribut `stan` v elementu `<zast>` u vlaků může obsahovat složený řetězec ve formátu `část1/část2` nebo `část1 část2` (např. `5S/22S`, `-/6`, `2/3`). Jako kanonický kód nástupiště se použije **první platný segment** – první token oddělený lomítkem nebo mezerou, pokud není prázdný nebo `-`.
+Příklady výsledků po parsování:
+| Vstup (`stan`) | Výsledný `platform_code` |
+|---|---|
+| `1/3` | `1` |
+| `-/BUS` | `BUS` |
+| `2/100V` | `2` |
+| `5A/- A C` | `5A` |
+| `5S/22S` | `5S` |
+Parsování provádí `MpvStopParser.parsePlatformCode()`. Výsledný kód je uložen jako `cis_stop_platform_code` v tabulce `vehiclepositions_positions` a na výstupu se pro vlaky preferuje před GTFS `platform_code` (viz `PlatformCodeResolver`).
+### Zprávy s informací o nástupišti jako syntetická poloha
+Pokud MPVNet zpráva vlaku obsahuje informaci o nástupišti (`$.stan`) pro budoucí zastávku a vlak ještě nemá žádnou aktivní RT polohu, vytvoří se syntetická poloha ve stavu `before_track` na základě dat z této zastávky. Díky tomu lze zobrazit kód nástupiště ještě před fyzickým příjezdem vlaku na stanoviště. Kód nástupiště se parsuje stejným způsobem jako výše (`MpvStopParser.parsePlatformCode()`).
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<m disp="http://77.93.194.81:8716/api">
+<spoj ka="1" kb="0" den="2025-03-30" lin="" alias="S8" spoj="9055" dopr="ČESKÉ DRÁHY" t="0" np="true" skol="false" posl="false" sled="2" lat="49.8657227" lng="14.4618721" cpoz="09:35:19" zast="5455746" zpoz_prij="600" zpoz_odj="600">
+	<zast stan="5S/22S" odj="08:25" zast="5457076" zpoz_typ_odj="3" zpoz_odj="720" />
+	<zast stan="-/6" prij="08:29" odj="08:30" zast="5457276" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="720" zpoz_odj="780" />
+	<zast stan="-/1" odj="08:34" zast="5457287" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="720" zpoz_odj="780" />
+	<zast stan="-/2" odj="08:38" zast="5457156" zpoz_zxtyp_prij="3" zpoz_typ_odj="3" zpoz_prij="660" zpoz_odj="720" />
+	<zast stan="2/-" prij="08:42" odj="08:43" zast="5457016" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="660" zpoz_odj="660" />
+	<zast stan="-/2" prij="08:46" odj="08:47" zast="5457386" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="720" zpoz_odj="720" />
+	<zast stan="-/1" odj="08:49" zast="5455526" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="780" zpoz_odj="840" />
+	<zast stan="-/3" odj="08:53" zast="5455536" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="720" zpoz_odj="780" />
+	<zast stan="-/1" odj="08:57" zast="5455556" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="720" zpoz_odj="780" />
+	<zast stan="2/3" prij="09:01" odj="09:02" zast="5455546" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="720" zpoz_odj="720" />
+	<zast stan="-/1" odj="09:05" zast="5458316" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="660" zpoz_odj="660" />
+	<zast stan="-/2" prij="09:12" odj="09:13" zast="5455696" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="600" zpoz_odj="600" />
+	<zast stan="-/1" odj="09:16" zast="5455716" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="600" zpoz_odj="660" />
+	<zast stan="-/1" odj="09:19" zast="5455726" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="600" zpoz_odj="660" />
+	<zast stan="-/1" odj="09:24" zast="5455746" zpoz_typ_prij="3" zpoz_typ_odj="3" zpoz_prij="600" zpoz_odj="600" />
+	<zast stan="-/1" prij="09:30" odj="09:31" zast="5455736" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="09:35" odj="09:36" zast="5455756" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="09:38" odj="09:39" zast="5455776" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="09:42" odj="09:43" zast="5455766" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast odj="09:46" zast="5455796" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="09:49" odj="10:03" zast="5455786" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="10:06" odj="10:07" zast="5455806" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="10:11" odj="10:12" zast="5455816" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="10:14" odj="10:15" zast="5455096" zpoz_typ_prij="2" zpoz_typ_odj="2" zpoz_prij="720" zpoz_odj="720" />
+	<zast prij="10:19" zast="5455046" zpoz_typ_prij="2" zpoz_prij="300" />
+</spoj>
+</m>
+```

package/docs/processing/input_realtime_data/tcp_dpp_bus.md ADDED Viewed

@@ -0,0 +1,27 @@
+# TCP DPP autobusy a trolejbusy
+```xml
+<M>
+<V turnus="144/3" line="144" evc="3885" np="ano" lat="50.12460" lng="14.45489" akt="06750004" takt="2025-03-30T18:10:04" konc="06490001" tjr="2025-03-30T18:10:00" pkt="473060" tm="2025-03-30T18:10:06" events="P"/>
+</M>
+```
+- **turnus** - oběh
+- **line** - linka
+- **evc** - [Evidenční číslo vozidla](https://cs.wikipedia.org/wiki/Eviden%C4%8Dn%C3%AD_%C4%8D%C3%ADslo_vozidla)
+- **np** - indikátor nízkopodlažnosti
+- **lat** - zeměpisná šířka
+- **lng** - zeměpisná délka
+- **akt** - poslední projetá zastávka, nepoužíváme
+- **takt** - čas události (reálný čas příjezdu/odjezdu vozidla na zastávce); mapuje se na `scheduled_timestamp`
+- **konc** - poslední ASW zastávka spoje, nepoužíváme
+- **tjr** - plánovaný čas podle jízdního řádu (v jaký čas mělo vozidlo na daném bodě být); nepoužíváme pro určení pozice
+- **pkt** -  identifikátor zprávy z vozidla/číslo TCP packetu??? Nepoužíváme
+- **tm** - čas přenosu zprávy od DPP (transmission time); odpovídá aktuální zeměpisné poloze vozidla (lat/lng); mapuje se na `origin_timestamp`
+- **events** -  událost asociovaná se zprávou
+	- P - příjezd do zastávky
+	- O - odjezd ze zastávky
+	- V - spoj ukončen
+	- T - checkpoint na trase, vozidlo jen o sobě dává vědět

package/docs/processing/input_realtime_data/tcp_dpp_metro.md ADDED Viewed

@@ -0,0 +1,24 @@
+# TCP DPP metro
+```xml
+<m linka="C" tm="2025-03-03T09:07:59Z" gvd="GD29c">
+<vlak csp=" 6" csr=" 6" cv="225" ko="282901" odch="-25" />
+<vlak csp="10" csr="10" cv="229" ko="313207" odch="0" />
+<vlak csp="16" csr="16" cv="260" ko="3704" odch="15" />
+<vlak csp="18" csr="18" cv="245" ko="4709" odch="50" />
+</m>
+```
+- **linka** - označení linky, koresponduje s GTFS `route.short_name`
+- **tm** - timestamp odeslání zprávy od DPP
+- **gvd** - grafikon, nepoužíváme
+- **csp** - oběhové číslo podle JŘ, nevěříme
+- **csr** - oběhové číslo doopravdy, nevěříme
+- **cv** - číslo spoje, koresponduje s trip_number v obehy.csv, unikátní v rámci linky
+- **ko** - kolejový obvod, určení GPS souřadnic
+- **odch** - odchylka oproti `tm`, určení zpoždění (záporné číslo znamená zpoždění)

package/docs/processing/input_realtime_data/tcp_dpp_tram.md ADDED Viewed

@@ -0,0 +1,26 @@
+# TCP DPP tramvaje
+```xml
+<M>
+<V turnus="12/2" line="12" evc="8544" lat="50.10486" lng="14.53100" akt="51440002" takt="2025-03-30T18:11:52" konc="00720002" tjr="2025-03-30T18:10:00" pkt="591646" tm="2025-03-30T18:11:52" events="O"/>
+</M>
+```
+- **turnus** - oběh
+- **line** - linka
+- **evc** - [Evidenční číslo vozidla](https://cs.wikipedia.org/wiki/Eviden%C4%8Dn%C3%AD_%C4%8D%C3%ADslo_vozidla)
+- **np** - indikátor nízkopodlažnosti
+- **lat** - zeměpisná šířka
+- **lng** - zeměpisná délka
+- **akt** - poslední projetá zastávka, nepoužíváme
+- **takt** - čas události (reálný čas příjezdu/odjezdu vozidla na zastávce); mapuje se na `scheduled_timestamp`
+- **konc** - poslední ASW zastávka spoje, nepoužíváme
+- **tjr** - plánovaný čas podle jízdního řádu (v jaký čas mělo vozidlo na daném bodě být); nepoužíváme pro určení pozice
+- **pkt** -  identifikátor zprávy z vozidla/číslo TCP packetu??? Nepoužíváme
+- **tm** - čas přenosu zprávy od DPP (transmission time); odpovídá aktuální zeměpisné poloze vozidla (lat/lng); mapuje se na `origin_timestamp`
+- **events** -  událost asociovaná se zprávou
+	- P - příjezd do zastávky
+	- O - odjezd ze zastávky
+	- V - spoj ukončen
+	- T - checkpoint na trase, vozidlo jen o sobě dává vědět

package/docs/processing/input_realtime_data/tcp_telmax_arriva_city.md ADDED Viewed

@@ -0,0 +1,44 @@
+# TCP Telmax Arriva City + Arriva City Neratovice
+```xml
+<M>
+<V imei="860425047186836" rz="5SB8545" pkt="573" lat="50.0451" lng="14.44866" tm="2025-03-30T18:07:09" events="Z" rych="13" smer="49" />
+<V imei="862430061982423" rz="6SN8270" pkt="5527" lat="50.10773" lng="14.60353" tm="2025-03-30T18:07:11" events="P" line="100204" conn="4032" rych="0" smer="320" evc="9018" turnus="204716" ridic="200602" akt="55207" konc="55250" />
+<V imei="867377023798816" rz="6SU3222" pkt="2837" lat="49.95867" lng="14.8828" tm="2025-03-30T18:07:09" events="Z" rych="39" smer="350" />
+<V imei="867377023795952" rz="9U89136" pkt="1002" lat="49.86153" lng="14.58563" tm="2025-03-30T18:07:13" events="L" rych="48" smer="193" />
+<V imei="867377023798816" rz="6SU3222" pkt="2838" lat="49.95876" lng="14.88278" tm="2025-03-30T18:07:10" events="Z" rych="39" smer="351" />
+<V imei="867377023797230" rz="9U89064" pkt="939" lat="50.038" lng="14.45776" tm="2025-03-30T18:07:12" events="R" rych="11" smer="40" />
+<V imei="867377023812609" rz="6AB1843" pkt="5024" lat="50.12651" lng="14.51493" tm="2025-03-30T18:07:11" events="T" rych="0" smer="347" />
+<V imei="868711063963758" rz="6SU2942" pkt="4016" lat="50.07414" lng="14.56016" tm="2025-03-30T18:07:11" events="RZ" rych="13" smer="244" />
+<V imei="867377023797214" rz="6AJ8958" pkt="4597" lat="50.09357" lng="14.49805" tm="2025-03-30T18:07:15" events="A" rych="15" smer="294" />
+<V imei="867377023820230" rz="4AV4134" pkt="3974" lat="50.08041" lng="14.48195" tm="2025-03-30T18:07:11" events="L" rych="30" smer="78" />
+</M>
+```
+- **imei** - identifikátor palubního počítače/vozidla, u nás `external_trip_id`
+- **rz** - SPZ, nepoužíváme
+- **pkt** - identifikátor zprávy z vozidla/číslo TCP packetu??? Nepoužíváme
+- **lat** - zeměpisná šířka
+- **lng** - zeměpisná délka
+- **tm** - timestamp odeslání právy z vozidla
+- **events** - událost asociovaná se zprávou
+	- **R** - výjezd ze zastávky
+- **line** - označení linky podle CIS
+- **conn** - označení spoje podle CIS
+- **rych** - rychlost vozidla
+- **smer** - azimut
+- **evc** - [Evidenční číslo vozidla](https://cs.wikipedia.org/wiki/Eviden%C4%8Dn%C3%AD_%C4%8D%C3%ADslo_vozidla)
+- **turnus** - jiný formát než DPP???, nepoužíváme
+- **ridic** - ??? nepoužíváme
+- **akt** - aktuální zastávka , nepoužíváme
+- **konc** - poslední zastávka, nepoužíváme

package/docs/processing/state_position_tracking/http_mpvnet.md ADDED Viewed

@@ -0,0 +1,56 @@
+# HTTP MPVNet state_position
+-   Batch data chodí na VP-IG (vyšší jednotky MB během špičky)
+-   Formát vstupních dat viz [input_realtime_data/http_mpvnet.md](../input_realtime_data/http_mpvnet.md)
+-   (HTTP) Input Gateway
+    -   Raw data se uloží na blob storage
+    -   knihovnou `xml2js` se transformují na JSON
+    -   validují se vůči JSON schématu a pošlou na Rabbita do fronty `saveDataToDB`
+-   saveDataToDB
+    -   data se napasují na struktury tabulek `vehiclepositions_trips` a `vehiclepositions_positions` (stav je `unknown`, `tracking` se bere ze vstupních dat)
+    -   všechny spoje se upsertují, nové spoje a jejich pozice se pošlou do fronty `updateGTFSTripId`, existující do `updateDelay`
+-   updateGTFSTripId
+    -   duplikace vlakových spojů a pozic podle block id (určení tracking podle cis stop id)
+    -   obohacení spojů GTFS daty (včetně oběhu a kmenové linky)
+    -   upsert asociovaných pozic
+    -   **syntetická poloha z informace o nástupišti**: pokud zpráva obsahuje atribut `$.stan` pro budoucí zastávku a vlak ještě nemá aktivní RT polohu, vytvoří se syntetická pozice ve stavu `before_track` pro tuto zastávku – umožňuje zobrazit kód nástupiště před fyzickým příjezdem vlaku
+    -   spoje se pošlou do fronty `updateDelay`
+-   updateDelay
+    -   opět duplikace vlakových spojů, upsert asociovaných pozic
+    -   opětovné načtení asociovaných pozic z DB
+    -   určení trasy spoje podle GTFS shapes a stop times
+    -   processing pozic, uložení do databáze
+        -   Not tracking (`tracking` je `0` a nebo nepřišly souřadnice)
+            -   pokud je poslední pozice neznámá, nebo je známá a ve stavu `on_track` nebo `at_stop`, je aktuální stav `before_track`
+            -   pokud je poslední známá pozice s `tracking 2`
+                -   pokud je pozice duplicitní (existuje pozice se stejným `origin_timestamp`), stav je `duplicate`
+                -   jinak je stav `after_track`
+        -   Tracking (`tracking` je `2`, souřadnice jsou známy)
+            -   pokud je vozidlo 200 metrů od nejblizšího bodu (anchor points) na trase, stav je `off_track`
+            -   pokud je nejbližší bod v zastávce, nastaví se stav na `at_stop`
+            -   jinak je stav `on_track`
+        -   Zrušený spoj (příznak `canceled` u pozice)
+            -   stav je vždy `canceled`
+-   propagateDelay
+    -   podle kmenové linky a oběhu vyhledáme navazující spoje
+    -   podle GTFS trip id a registračního čísla poslední pozici ve stavu `before_track`
+    -   přepsání stavu na `before_track_delayed`
+```mermaid
+flowchart TB;
+  A[HTTP data]-->B[VP HTTP Input Gateway]--raw data-->Blob[Azure Blob Storage];
+  B--JSON xml2js-->C[AMQP saveDataToDB]--upsert-->trips[(DB trips)];
+  C--nové spoje bez GTFS dat-->D[AMQP updateGTFSTripId];
+  C--existující spoje-->E[AMQP updateDelay];
+  D--upsert-->trips;
+  D--upsert-->positions[(DB positions)];
+  D--nové spoje s GTFS daty-->E;
+  E--upsert-->trips;
+  E--upsert-->positions;
+  E--select-->trips;
+  E--select-->positions;
+  E--uložené spoje-->F[AMQP propagateDelay];
+  F--select-->trips;
+  F--select-->positions;
+  F--upsert-->positions;
+```

package/docs/processing/state_position_tracking/tcp_dpp_common.md ADDED Viewed

@@ -0,0 +1,72 @@
+# TCP DPP common state_position
+-   Data chodí na TCP-IG
+-   Formát vstupních dat viz [input_realtime_data/http_mpvnet.md](../input_realtime_data/tcp_dpp_bus.md) a [input_realtime_data/tcp_dpp_tram.md](../input_realtime_data/tcp_dpp_tram.md)
+-   Transport (TCP) Input Gateway
+    -   Raw data se uloží na blob storage (1MB buffer)
+    -   knihovnou `xml2js` transformují na JSON
+    -   pošlou na Rabbita do fronty `saveTramRunsToDB/saveBusRunsToDB`
+-   saveTramRunsToDB/saveBusRunsToDB
+    -   zprávy se uloží do DB
+    -   následně se pošlou do fronty `updateRunsGTFSTripId`
+-   updateRunsGTFSTripId
+    -   data se napasují na struktury tabulek `vehiclepositions_trips` a `vehiclepositions_positions` (stav je `unknown`)
+        -   pokud je tramvaj, je `tracking 2`
+        -   nebo pokud je autobus
+            -   pokud vozidlo odeslalo zprávu `O`, je `tracking 2`
+            -   pokud je vozidlo v první zastávce (dle `tjr` — plánovaný čas JŘ), nebo pokud vozidlo vyjelo z první zastávky (dle `takt` — čas události), je `tracking 2`
+        -   nebo je `tjr` atribut větší než příjezd do první zastávky spoje, je `tracking 2`
+        -   jinak je `tracking 0`
+    -   Rovněž se podle kmenové linky a oběhu vytvoří následující spoje (stav je `unknown`, `tracking` je vždy 0)
+    -   navíc se předchozímu spoji vytvoří nová pozice s `tracking 0`, všechny spoje se odešlou na `updateDelay`
+        -   Pokud je spoj vyhodnocen jako neveřejný (např. mazačka, náhradní autobus), vytvoří se nový spoj a pozice se stavem `not_public`, tím processing končí
+-   updateDelay
+    -   upsert asociovaných pozic
+    -   opětovné načtení asociovaných pozic z DB
+    -   určení trasy spoje podle GTFS shapes a stop times
+    -   processing pozic, uložení do databáze
+        -   Not tracking (`tracking` je `0`)
+            -   pokud je poslední pozice neznámá, nebo je známá a ve stavu `on_track` nebo `at_stop`
+                -   pokud vozidlo jede z garáže, je stav `invisible`
+                -   jinak je stav `before_track`
+            -   pokud je poslední známá pozice s `tracking 2`
+                -   pokud je pozice duplicitní (existuje pozice se stejným `origin_timestamp`), stav je `duplicate`
+                -   pokud vozidlo jede do garáže, je stav `invisible`
+                -   jinak je stav `after_track`
+            -   **zvláštní případ**: pokud má pozice `cis_last_stop_id = null`, stav se znovu nevyhodnocuje – pozice si zachovává poslední známý stav (zmrazení stavu); to zabraňuje nežádoucímu cyklování zpět do `untracked` pouze kvůli chybějící CIS zastávce
+        -   Tracking (`tracking` je `2`)
+            -   pokud je vozidlo 200 metrů od nejblizšího bodu na trase, stav je `off_track`
+            -   pokud je vozidlo v zastávce, je stav `at_stop`
+            -   pokud je vozidlo mimo zastávku a zároveň vozidlo poslalo zprávu `O` mimo poslední zastávku, je stav `on_track`
+            -   pokud je vozidlo v zastávce, nebo poslalo zprávu `V`, nebo poslalo zprávu v poslední zastávce, nebo poslalo zprávu z `tjr` atributem větší než je příjezd do poslední zastávky, je stav `after_track`
+-   propagateDelay
+    -   podle kmenové linky a oběhu vyhledáme navazující spoje
+    -   podle GTFS trip id a registračního čísla poslední pozici ve stavu `before_track` nebo `invisible`
+    -   přepsání stavu na `before_track_delayed`
+```mermaid
+flowchart TB;
+  A[TCP data]-->B[Transport TCP Input Gateway]--raw data 1MB buffer-->Blob[Azure Blob Storage];
+  B-->Qu{Datový zdroj?};
+  Qu--tram-->X1[AMQP saveTramRunsToDB]-->|oběhy| N[AMQP updateRunsGTFSTripId];
+  Qu--bus-->X2[AMQP saveBusRunsToDB]-->|oběhy| N;
+  X1--upsert-->runs[(DB runs)];
+  X2--upsert-->runs;
+  N-->Qn{Je neveřejný? Např. mazačka};
+  Qn--Ano-->X3[updateNotPublicRunTrip];
+  Qn--Ne-->X4[generateDelayMsg];
+  X3--upsert-->trips;
+  X3--upsert-->positions;
+  X4--vygenerované spoje s GTFS daty-->E[AMQP updateDelay];
+  X4--upsert-->trips;
+  X4--upsert-->positions;
+  E--upsert-->trips[(DB trips)];
+  E--upsert-->positions[(DB positions)];
+  E--select-->trips;
+  E--select-->positions;
+  E--uložené spoje-->F[AMQP propagateDelay];
+  F--select-->trips;
+  F--select-->positions;
+  F--upsert-->positions;
+```

package/docs/processing/state_position_tracking/tcp_dpp_metro.md ADDED Viewed

@@ -0,0 +1,55 @@
+# TCP DPP metro state_position
+-   Data chodí na TCP-IG
+-   Formát vstupních dat viz [input_realtime_data/tcp_dpp_metro.md](../input_realtime_data/tcp_dpp_metro.md)
+-   Transport (TCP) Input Gateway
+    -   Raw data se uloží na blob storage (1MB buffer)
+    -   knihovnou `xml2js` transformují na JSON
+    -   pošlou na Rabbita do fronty `saveMetroRunsToDB`
+-   saveMetroRunsToDB
+    -   zprávy se uloží do DB
+    -   následně se pošlou do fronty `processMetroRunMessages`,
+-   processMetroRunMessages
+    -   data se napasují na struktury tabulek `vehiclepositions_trips` a `vehiclepositions_positions` (stav je `unknown`, `tracking` je vždy 2)
+    -   Rovněž se podle kmenové linky a oběhu vytvoří následující spoje (stav je `unknown`, `tracking` je vždy 0)
+    -   navíc se předchozímu spoji vytvoří nová pozice s `tracking 0`
+    -   všechny spoje se odešlou na `updateDelay`
+-   updateDelay
+    -   upsert asociovaných pozic
+    -   opětovné načtení asociovaných pozic z DB
+    -   určení trasy spoje podle GTFS shapes a stop times
+    -   processing pozic, uložení do databáze
+        -   Not tracking (`tracking` je `0`)
+            -   pokud je poslední pozice neznámá, nebo je známá a ve stavu `on_track` nebo `at_stop`, je aktuální stav `before_track`
+            -   pokud je poslední známá pozice s `tracking 2`
+                -   pokud je pozice duplicitní (existuje pozice se stejným `origin_timestamp`), stav je `duplicate`
+                -   jinak je stav `after_track`
+        -   Tracking (`tracking` je `2`)
+            -   pokud je vozidlo 200 metrů od nejblizšího bodu na trase
+                -   pokud vozidlo poslalo zprávu z `tm` + `odch` atributy větší než je příjezd do poslední zastávky, je stav `after_track`
+                -   jinak je stav `off_track`
+            -   pokud je vozidlo podle kolejového obvodu v zastávce, je stav `at_stop`
+            -   pokud je vozidlo podle kolejového obvodu mimo zastávku, je stav `on_track`
+-   propagateDelay
+    -   podle kmenové linky a oběhu vyhledáme navazující spoje
+    -   podle GTFS trip id a registračního čísla poslední pozici ve stavu `before_track`
+    -   přepsání stavu na `before_track_delayed`
+```mermaid
+flowchart TB;
+  A[TCP data]-->B[Transport TCP Input Gateway]--raw data 1MB buffer-->Blob[Azure Blob Storage];
+  B-->X1[AMQP saveMetroRunsToDB]-->|oběhy| N[AMQP processMetroRunMessages];
+  X1--upsert-->runs[(DB runs)];
+  N--upsert-->trips;
+  N--upsert-->positions;
+  N--vygenerované spoje s GTFS daty-->E[AMQP updateDelay];
+  E--upsert-->trips[(DB trips)];
+  E--upsert-->positions[(DB positions)];
+  E--select-->trips;
+  E--select-->positions;
+  E--uložené spoje-->F[AMQP propagateDelay];
+  F--select-->trips;
+  F--select-->positions;
+  F--upsert-->positions;
+```

package/docs/processing/state_position_tracking/tcp_telmax_arriva_city.md ADDED Viewed

@@ -0,0 +1,7 @@
+# TCP Telmax Arriva City state_position
+-   Data chodí na TCP-IG
+-   Data využíváme pouze na rabínovi, na produkci bereme z MPVNetu
+-   Formát vstupních dat viz [input_realtime_data/tcp_telmax_arriva_city.md](../input_realtime_data/tcp_telmax_arriva_city.md)
+-   Transport (TCP) Input Gateway
+-   TODO doplnit