@golemio/pid 3.17.1-dev.1919036985 → 3.17.1-dev.1925537706

package/docs/implementation_documentation.md

@@ -228,7 +228,11 @@ _:warning: Původním záměrem bylo využití OIS číselníku během zpracová
     -   validační schéma: [JISEventsJsonSchema](../src/schema-definitions/jis/datasources/JISEventsJsonSchema.ts)
     -   příklad vstupnich dat: [eventsDataSourceFixture](../test/integration-engine/jis/fixtures/eventsDataSourceFixture.ts)
 -   frekvence stahování
-    -   data jsou stažena pouze po manuálním zaslání zprávy do RabbitMQ fronty (primární způsob aktualizace dat je aktivní posílání)
+    -   cron definice:
+        -   cron.vehicle-positions.jis.refreshJISEvents
+            -   rabin `0 */1 * * * *`
+            -   prod `0 */1 * * * *`
+    -   data mohou být stažena po manuálním zaslání zprávy do RabbitMQ fronty (primární způsob aktualizace dat je aktivní posílání a cron)
 -   název rabbitmq fronty
     -   vehicle-positions.jis.fetchJISEvents
 
@@ -244,7 +248,11 @@ _:warning: Původním záměrem bylo využití OIS číselníku během zpracová
     -   validační schéma: [JISInfotextsJsonSchema](../src/schema-definitions/jis/datasources/JISInfotextsJsonSchema.ts)
     -   příklad vstupnich dat: [infotextsDataSourceFixture](../test/integration-engine/jis/fixtures/infotextsDataSourceFixture.ts)
 -   frekvence stahování
-    -   data jsou stažena pouze po manuálním zaslání zprávy do RabbitMQ fronty (primární způsob aktualizace dat je aktivní posílání)
+    -   cron definice:
+        -   cron.vehicle-positions.jis.refreshJISInfotexts
+            -   rabin `0 */1 * * * *`
+            -   prod `0 */1 * * * *`
+    -   data mohou být stažena po manuálním zaslání zprávy do RabbitMQ fronty (primární způsob aktualizace dat je aktivní posílání a cron)
 -   název rabbitmq fronty
     -   vehicle-positions.jis.fetchJISInfotexts
 
@@ -1307,6 +1315,7 @@ Worker má na starost stahování VYMI (JIS) událostí a infotextů, jejich tra
     -   `vehiclepositions_vehicle_descriptors`
 -   dodatečná transformace: Feature collection
 -   je použit `CompressionByDefaultMiddleware` a odpovědi jsou tak na output gateway komprimovány i pokud klient explicitně nepovolí komprimaci vhodnou hodnotou hlavičky `Accept-Encoding` (lze však komprimaci explicitně zakázat hodnotou `identity`)
+-   Default limit je nastaven pro vsechny role na 100 v admin panelu
 
 #### _/v2/vehiclepositions/{gtfsTripId}_
 

package/docs/jis/index.md

@@ -82,10 +82,8 @@ flowchart LR
 ## Aktivní posílání (push) dat
 
 Po uložení změn událostí a infotextů do VYMI PostgreSQL databáze dojde vždy k aktivnímu poslání (push) "aktuálních" dat z VYMI back end služby do Golemia za pomoci HTTP POST dotazu na Golemio Vehicle Positions (VP) Input Gateway (IG).
-
-Za aktuální data jsou považovány:
-- všechny události, které mají `status` `PUBLISHED`, a zároveň `updated_at` hodnotu z posledních 24 hodin nebo `active_period_end` je `NULL` nebo >= aktuální čas, neboli lidsky všechny publikované (ne-draft) události, které jsou aktivní nebo byly upraveny v posledním dnu;
-- všechny infotexty, které mají `status` `PUBLISHED`, `visibility` `PUBLIC` a zároveň `active_period_end` je `NULL` nebo >= aktuální čas, neboli lidsky všechny aktivní zapnuté publikované (ne-draft) infotexty.
+- u událostí se posílá pouze konkrétní nově vytvořená nebo upravená událost, nikoliv celý seznam aktuálních událostí.
+- všechny infotexty, které mají `status` `PUBLISHED`, `visibility` `PUBLIC` a zároveň `active_period_end` je `NULL` nebo >= aktuální čas, neboli lidsky všechny aktivní, budoucí a publikované (ne-draft) infotexty.
 
 VP Input Gateway data přijme a zašle do odpovídající RabbitMQ fronty, odkud je převezme VP Integration Engine, který data zapíše do VP PostgreSQL databáze.
 
@@ -159,7 +157,19 @@ Formát zasílaných dat je dále více popsán v implementační dokumentaci ([
 
 ## Pasivní načítání (pull) dat
 
-V případě potřeby (např. nedojde-li kvůli chybě k aktivnímu poslání dat) lze využít pasivní načtení (push) dat z VYMI REST API do Golemia. Pro spuštění načtení musí vývojář zaslat prázdnou zprávu do správné RabbitMQ fronty, kterou zkonzumuje VP Integration Engine a za pomoci HTTP GET dotazu získá data z VYMI back end služby.
+V případě potřeby (např. nedojde-li kvůli chybě k aktivnímu poslání dat) lze využít pasivní načtení (pull) dat z VYMI REST API do Golemia. Pro spuštění načtení může vývojář zaslat prázdnou zprávu do správné RabbitMQ fronty, kterou zkonzumuje VP Integration Engine a za pomoci HTTP GET dotazu získá data z VYMI back end služby.
+
+Kromě manuálního spuštění vývojářem je nyní navíc aktivní cron task, který každou minutu automaticky spouští pasivní načítání dat z VYMI do Golemia. Tento mechanismus zajišťuje vyšší odolnost proti výpadkům v aktivním posílání (push) dat.
+
+Při pasivním načítání se z VYMI vždy přenačítají pouze aktuální (aktivní) události a infotexty:
+- všechny události, které mají `status` `PUBLISHED`, a zároveň `updated_at` hodnotu z posledních 24 hodin nebo `active_period_end` je `NULL` nebo >= aktuální čas, neboli lidsky všechny publikované (ne-draft) události, které jsou aktivní nebo byly upraveny v posledním dnu;
+- všechny infotexty, které mají `status` `PUBLISHED`, `visibility` `PUBLIC` a zároveň `active_period_end` je `NULL` nebo >= aktuální čas, neboli lidsky všechny aktivní, budoucí a publikované (ne-draft) infotexty.
+
+## Chování databáze v Golemio
+
+Události – v Golemio databázi se uchovávají všechny historické i aktuální události. Staré záznamy se nepromazávají.
+
+Infotexty – v Golemio databázi se uchovávají pouze aktivní infotexty. Neaktivní se při každém přenačtení promazávají.
 
 Proces je podrobněji znázorněn na následujícím diagramu (detailnější prvky aplikační struktury jsou vynechány).
 

package/docs/openapi-output.yaml

@@ -602,12 +602,13 @@ paths:
             parameters:
                 - name: limit
                   in: query
-                  description: Limits number of retrieved items. The maximum is 10000 (default value).
+                  description: Limits number of retrieved items. The maximum is 10000.
                   required: false
                   schema:
                       type: number
                       format: int64
                       example: 10
+                      default: 100
                 - name: offset
                   in: query
                   description: Number of the first items that are skipped.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/pid",
-    "version": "3.17.1-dev.1919036985",
+    "version": "3.17.1-dev.1925537706",
     "description": "Golemio PID Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",