@golemio/pid 3.13.1 → 3.13.2-dev.1803100353

package/docs/processing/input_realtime_data/tcp_telmax_arriva_city.md

@@ -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

@@ -0,0 +1,55 @@
+# 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
+    -   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/{state_position_tracking/tcp_common.md → processing/state_position_tracking/tcp_dpp_common.md}

@@ -1,19 +1,7 @@
-# TCP common state_position
+# TCP DPP common state_position
 
 -   Data chodí na TCP-IG
-
-```xml
-<M>
-    <V turnus="17/3" line="17" evc="9168" np="ano" lat="50.05440" lng="14.41812" akt="03030001" takt="2022-08-02T21:56:22" konc="26200002" tjr="2022-08-02T21:56:00" pkt="1885317" tm="2022-08-02T21:56:22" events="O" />
-</M>
-```
-
-```xml
-<M>
-    <V turnus="134/3" line="134" evc="3738" np="ano" lat="50.03952" lng="14.42919" akt="07960001" takt="2022-06-29T17:28:13" konc="01100005" tjr="2022-06-29T17:23:00" pkt="12709236" tm="2022-06-29T17:28:22" events="O" />
-</M>
-```
-
+-   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

package/docs/{state_position_tracking/tcp_metro.md → processing/state_position_tracking/tcp_dpp_metro.md}

@@ -1,14 +1,7 @@
-# TCP metro state_position
+# TCP DPP metro state_position
 
 -   Data chodí na TCP-IG
-
-```xml
-<m linka="A" tm="2022-07-20T13:45:34Z" gvd="GD20a">
-    <vlak csp=" 3" csr=" 3" cv="279" ko="1809" odch="25" />
-    <!--...-->
-</m>
-```
-
+-   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

package/docs/processing/state_position_tracking/tcp_telmax_arriva_city.md

@@ -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

package/docs/processing/vehicle_types.md

@@ -0,0 +1,32 @@
+# Mapování MPVNet vehicle type na GTFS
+
+## Typ vozidel podle MPV
+- 0 - neznámý nebo vlak
+- 1 - metro
+- 2 - tramvaj
+- 3 - autobus MHD
+- 4 - příměstský autobus
+- 5 - noční autobus
+- 6 - noční tramvaj
+- 7 - náhradní doprava
+- 8 - lanovka
+- 9 - školní spoj
+- 10 - spoj pro lidi s hendikepem
+- 11 - smluvní spoj
+- 12 - loď
+- 13 - vlak
+- 14 - náhradní autobus za vlak
+- 15 - náhradní tramvaj
+- 16 - noční příměstský autobus
+- 17 - ostatní
+- 18 - trolejbus
+
+## Typ vozidel podle GTFS
+- 0 - tramvaj, podle MPV 2, 6, 15
+- 1 - metro, podle MPV 1
+- 2 - vlak, podle MPV 0 a 13
+- 3 - autobus, podle MPV 3, 4, 5, 7, 16 
+- 4 - loď, podle MPV 12
+- 7 - lanovka, podle MPV 8
+- 11 - trolejbus, podle MPV 18
+- 1700 - smíšený nebo neznámý, nemapujeme z MPV

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/pid",
-    "version": "3.13.1",
+    "version": "3.13.2-dev.1803100353",
     "description": "Golemio PID Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -76,7 +76,7 @@
         "@golemio/core": ">=1.16.0-rc.1551191551"
     },
     "dependencies": {
-        "@golemio/ovapi-gtfs-realtime-bindings": "1.2.3",
+        "@golemio/ovapi-gtfs-realtime-bindings": "1.2.4-dev.1288219308",
         "@turf/turf": "^6.5.0",
         "cheap-ruler": "^3.0.2",
         "csv-parser": "^3.0.0",
@@ -84,4 +84,4 @@
         "html-entities": "^2.3.3",
         "pg-copy-streams": "^5.1.1"
     }
-}
+}

package/docs/state_position_tracking/http.md

@@ -1,113 +0,0 @@
-# HTTP state_position
-
--   Batch data chodí na VP-IG (několik MB)
-
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<m disp="http://77.93.194.81:8716/api">
-    <spoj ka="2" kb="0" den="2023-03-21" lin="100115" alias="115" spoj="1061" dopr="ČSAD POLKOST"
-        doprSkut="ČSAD POLKOST" kmenl="115" t="3" tcis="A" np="true" po="39" vuzevc="1861"
-        skol="false" posl="false" sled="0" lat="50.0307" lng="14.49185" cpoz="10:00:04" azimut="337"
-        rychl="26">
-        <zast stan="B" odj="10:30" zast="56714" asw="520091" zpoz_typ_odj="2" zpoz_odj="0" />
-        <zast stan="B" odj="10:32" zast="56794" asw="11310002" zpoz_typ_odj="2" zpoz_odj="0" />
-        <zast stan="A" odj="10:34" zast="59066" asw="13410001" zpoz_typ_odj="2" zpoz_odj="0" />
-        <zast stan="A" odj="10:36" zast="67975" asw="11320001" zpoz_typ_odj="2" zpoz_odj="0" />
-        <zast stan="B" odj="10:37" zast="58953" asw="13340002" zpoz_typ_odj="2" zpoz_odj="0" />
-        <zast stan="A" odj="10:40" zast="58789" asw="1810001" zpoz_typ_odj="2" zpoz_odj="0" />
-        <zast stan="A" odj="10:41" zast="56794" asw="11310001" />
-        <zast stan="F" prij="10:43" zast="56714" asw="520002" />
-    </spoj>
-    <spoj ka="2" kb="0" den="2023-03-21" lin="100117" alias="117" spoj="1016" dopr="ABOUT ME"
-        doprSkut="ABOUT ME" kmenl="117" t="3" tcis="A" np="true" po="6" vuzevc="1950" skol="false"
-        posl="false" sled="0" lat="50.04645" lng="14.46061" cpoz="09:59:56" azimut="165" rychl="0"
-        zast="57408" asw="500006" zpoz_prij="14">
-        <zast stan="B" odj="08:55" zast="66826" asw="32360002" zpoz_typ_odj="3" zpoz_odj="35" />
-        <zast stan="B" odj="08:55" zast="67375" asw="9910002" zpoz_typ_odj="3" zpoz_odj="81" />
-        <zast stan="C" odj="08:56" zast="55206" asw="2800053" zpoz_typ_odj="3" zpoz_odj="119" />
-        <zast stan="B" odj="08:58" zast="55181" asw="620002" zpoz_typ_odj="3" zpoz_odj="113" />
-        <zast stan="H8" odj="08:59" zast="51228" asw="10060052" zpoz_typ_odj="3" zpoz_odj="121" />
-        <zast stan="A" odj="09:00" zast="67477" asw="26020001" zpoz_typ_odj="3" zpoz_odj="85" />
-        <zast stan="E" odj="09:02" zast="51227" asw="9290005" zpoz_typ_odj="3" zpoz_odj="68" />
-        <zast stan="A" odj="09:03" zast="51226" asw="9390001" zpoz_typ_odj="3" zpoz_odj="91" />
-        <zast stan="A" odj="09:05" zast="55233" asw="11580001" zpoz_typ_odj="3" zpoz_odj="81" />
-        <zast stan="D" odj="09:07" zast="43729" asw="760051" zpoz_typ_odj="3" zpoz_odj="2" />
-        <zast stan="A" odj="09:08" zast="55214" asw="170001" zpoz_typ_odj="3" zpoz_odj="31" />
-        <zast stan="A" odj="09:09" zast="55183" asw="7270001" zpoz_typ_odj="3" zpoz_odj="36" />
-        <zast stan="A" odj="09:11" zast="55257" asw="7720001" zpoz_typ_odj="3" zpoz_odj="-9" />
-        <zast stan="A" odj="09:12" zast="55220" asw="9950001" zpoz_typ_odj="3" zpoz_odj="-15" />
-        <zast stan="B" odj="09:13" zast="55188" asw="9270002" zpoz_typ_odj="3" zpoz_odj="-2" />
-        <zast stan="B" odj="09:15" zast="58807" asw="6250002" zpoz_typ_odj="3" zpoz_odj="-20" />
-        <zast stan="B" odj="09:16" zast="58781" asw="4460002" zpoz_typ_odj="3" zpoz_odj="-5" />
-        <zast stan="B" odj="09:17" zast="58863" asw="6580002" zpoz_typ_odj="3" zpoz_odj="1" />
-        <zast stan="D" odj="09:18" zast="58863" asw="6580004" zpoz_typ_odj="3" zpoz_odj="-9" />
-        <zast stan="A" odj="09:19" zast="59095" asw="3280001" zpoz_typ_odj="3" zpoz_odj="-24" />
-        <zast stan="A" odj="09:20" zast="58972" asw="600001" zpoz_typ_odj="3" zpoz_odj="-8" />
-        <zast stan="B" odj="09:21" zast="58836" asw="4940002" zpoz_typ_odj="3" zpoz_odj="-11" />
-        <zast stan="B" odj="09:22" zast="58976" asw="8570002" zpoz_typ_odj="3" zpoz_odj="22" />
-        <zast stan="D" odj="09:24" zast="58837" asw="4970004" zpoz_typ_odj="3" zpoz_odj="-4" />
-        <zast stan="A" odj="09:25" zast="58869" asw="7220001" zpoz_typ_odj="3" zpoz_odj="-3" />
-        <zast stan="B" odj="09:27" zast="47119" asw="8930002" zpoz_typ_odj="3" zpoz_odj="-28" />
-        <zast stan="H" odj="09:29" zast="27948" asw="4880008" zpoz_typ_odj="3" zpoz_odj="-56" />
-        <zast stan="A" odj="09:32" zast="57400" asw="4410001" zpoz_typ_odj="3" zpoz_odj="-38" />
-        <zast stan="B" odj="09:33" zast="57401" asw="10480002" zpoz_typ_odj="3" zpoz_odj="-7" />
-        <zast stan="B" odj="09:34" zast="59152" asw="9370002" zpoz_typ_odj="3" zpoz_odj="-11" />
-        <zast stan="B" odj="09:35" zast="59258" asw="9380002" zpoz_typ_odj="3" zpoz_odj="-6" />
-        <zast stan="B" odj="09:37" zast="58814" asw="3430002" zpoz_typ_odj="3" zpoz_odj="48" />
-        <zast stan="L" prij="09:39" zast="57408" asw="500006" zpoz_typ_prij="3" zpoz_prij="14" />
-    </spoj>
-    <!--...-->
-</m>
-```
-
--   (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
-    -   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;
-```