@golemio/pid 6.4.0 → 6.4.1-dev.3054859807

package/dist/schema-definitions/jis/datasources/interfaces/IMapaPidDelayShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMapaPidDelayShape.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/datasources/interfaces/IMapaPidDelayShape.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/jis/datasources/interfaces/index.d.ts

@@ -7,3 +7,4 @@ export * from "./IJISInfotext.js";
 export * from "./IJISInfotextStop.js";
 export * from "./IJISInfotextPreset.js";
 export * from "./IJISTranslationText.js";
+export * from "./IMapaPidDelayShape.js";

package/dist/schema-definitions/jis/datasources/interfaces/index.js

@@ -7,4 +7,5 @@ export * from "./IJISInfotext.js";
 export * from "./IJISInfotextStop.js";
 export * from "./IJISInfotextPreset.js";
 export * from "./IJISTranslationText.js";
+export * from "./IMapaPidDelayShape.js";
 //# sourceMappingURL=index.js.map

package/dist/schema-definitions/jis/datasources/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/datasources/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/datasources/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}

package/dist/schema-definitions/jis/models/JISDelayedSegmentsModel.d.ts

@@ -0,0 +1,24 @@
+import { type JSONSchemaType } from "@golemio/core/dist/shared/ajv.js";
+import type { CreationOptional, InferAttributes, InferCreationAttributes, ModelAttributes } from "@golemio/core/dist/shared/sequelize.js";
+import SequelizeCore from "@golemio/core/dist/shared/sequelize.js";
+declare const Model: typeof SequelizeCore.Model;
+import { type IJISDelayedSegment, type IJISDelayedSegmentInfoPanelStop, type IJISDelayedSegmentRoute, type IJISDelayedSegmentStop } from "./interfaces/index.js";
+export declare class JISDelayedSegmentsModel extends Model<InferAttributes<JISDelayedSegmentsModel>, InferCreationAttributes<JISDelayedSegmentsModel>> implements IJISDelayedSegment {
+    static tableName: string;
+    id: string;
+    external_from_stop_id: string;
+    external_to_stop_id: string;
+    from_stop_id: string;
+    from_stop_name: string;
+    to_stop_id: string;
+    to_stop_name: string;
+    expected_delay_seconds: number;
+    stops: IJISDelayedSegmentStop[];
+    routes: IJISDelayedSegmentRoute[];
+    info_panel_stops: IJISDelayedSegmentInfoPanelStop[];
+    created_at: CreationOptional<Date>;
+    updated_at: CreationOptional<Date>;
+    static attributeModel: ModelAttributes<JISDelayedSegmentsModel>;
+    static jsonSchema: JSONSchemaType<IJISDelayedSegment[]>;
+}
+export {};

package/dist/schema-definitions/jis/models/JISDelayedSegmentsModel.js

@@ -0,0 +1,138 @@
+import SequelizeCore from "@golemio/core/dist/shared/sequelize.js";
+const { DataTypes, Model } = SequelizeCore;
+const stopJsonSchema = {
+    type: "object",
+    properties: {
+        id: { type: "string" },
+        name: { type: "string" },
+    },
+    additionalProperties: false,
+    required: ["id", "name"],
+};
+export class JISDelayedSegmentsModel extends Model {
+}
+JISDelayedSegmentsModel.tableName = "jis_delayed_segments";
+JISDelayedSegmentsModel.attributeModel = {
+    id: {
+        primaryKey: true,
+        type: DataTypes.TEXT,
+        allowNull: false,
+    },
+    external_from_stop_id: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+    },
+    external_to_stop_id: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+    },
+    from_stop_id: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+    },
+    from_stop_name: {
+        type: DataTypes.TEXT,
+        allowNull: false,
+    },
+    to_stop_id: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+    },
+    to_stop_name: {
+        type: DataTypes.TEXT,
+        allowNull: false,
+    },
+    expected_delay_seconds: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+    },
+    stops: {
+        type: DataTypes.JSONB,
+        allowNull: false,
+    },
+    routes: {
+        type: DataTypes.JSONB,
+        allowNull: false,
+    },
+    info_panel_stops: {
+        type: DataTypes.JSONB,
+        allowNull: false,
+    },
+    created_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+    },
+    updated_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+    },
+};
+JISDelayedSegmentsModel.jsonSchema = {
+    type: "array",
+    items: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            external_from_stop_id: { type: "string" },
+            external_to_stop_id: { type: "string" },
+            from_stop_id: { type: "string" },
+            from_stop_name: { type: "string" },
+            to_stop_id: { type: "string" },
+            to_stop_name: { type: "string" },
+            expected_delay_seconds: { type: "integer" },
+            stops: { type: "array", items: stopJsonSchema },
+            routes: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        short_name: { type: "string" },
+                        type: { type: "integer" },
+                    },
+                    additionalProperties: false,
+                    required: ["id", "short_name", "type"],
+                },
+            },
+            info_panel_stops: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        stop: stopJsonSchema,
+                        preset_route_names: { type: "array", items: { type: "string" } },
+                        routes: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    id: { type: "string" },
+                                    distance_stops: { type: "integer" },
+                                },
+                                additionalProperties: false,
+                                required: ["id", "distance_stops"],
+                            },
+                        },
+                    },
+                    additionalProperties: false,
+                    required: ["stop", "preset_route_names", "routes"],
+                },
+            },
+        },
+        additionalProperties: false,
+        required: [
+            "id",
+            "external_from_stop_id",
+            "external_to_stop_id",
+            "from_stop_id",
+            "from_stop_name",
+            "to_stop_id",
+            "to_stop_name",
+            "expected_delay_seconds",
+            "stops",
+            "routes",
+            "info_panel_stops",
+        ],
+    },
+};
+//# sourceMappingURL=JISDelayedSegmentsModel.js.map

package/dist/schema-definitions/jis/models/JISDelayedSegmentsModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JISDelayedSegmentsModel.js","sourceRoot":"","sources":["../../../../src/schema-definitions/jis/models/JISDelayedSegmentsModel.ts"],"names":[],"mappings":"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"}

package/dist/schema-definitions/jis/models/interfaces/IJISDelayedSegment.d.ts

@@ -0,0 +1,44 @@
+export interface IJISDelayedSegmentStop {
+    id: string;
+    name: string;
+}
+export interface IJISDelayedSegmentRoute {
+    id: string;
+    short_name: string;
+    type: number;
+}
+/**
+ * Route passing an info panel stop, with the signed distance of the stop from the segment
+ * (negative before the segment, 0 inside, positive after it, in stops along the route)
+ */
+export interface IJISDelayedSegmentInfoPanelRoute {
+    id: string;
+    distance_stops: number;
+}
+export interface IJISDelayedSegmentInfoPanelStop {
+    stop: IJISDelayedSegmentStop;
+    preset_route_names: string[];
+    routes: IJISDelayedSegmentInfoPanelRoute[];
+}
+/**
+ * Stops, routes and info panels of a delayed segment derived from GTFS
+ */
+export interface IJISDelayedSegmentEnrichment extends Pick<IJISDelayedSegment, "stops" | "routes" | "info_panel_stops"> {
+    /** Whether both endpoints exist in GTFS; endpoints without stops then mean that no trip runs the whole segment */
+    has_endpoint_stops: boolean;
+    from_stop: IJISDelayedSegmentStop | null;
+    to_stop: IJISDelayedSegmentStop | null;
+}
+export interface IJISDelayedSegment {
+    id: string;
+    external_from_stop_id: string;
+    external_to_stop_id: string;
+    from_stop_id: string;
+    from_stop_name: string;
+    to_stop_id: string;
+    to_stop_name: string;
+    expected_delay_seconds: number;
+    stops: IJISDelayedSegmentStop[];
+    routes: IJISDelayedSegmentRoute[];
+    info_panel_stops: IJISDelayedSegmentInfoPanelStop[];
+}

package/dist/schema-definitions/jis/models/interfaces/IJISDelayedSegment.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IJISDelayedSegment.js.map

package/dist/schema-definitions/jis/models/interfaces/IJISDelayedSegment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJISDelayedSegment.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/models/interfaces/IJISDelayedSegment.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/jis/models/interfaces/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./IJISDelayedSegment.js";
 export * from "./IJISEvent.js";
 export * from "./IJISEventTranslationText.js";
 export * from "./IJISEventsRopidGTFSRoutes.js";

package/dist/schema-definitions/jis/models/interfaces/index.js

@@ -1,3 +1,4 @@
+export * from "./IJISDelayedSegment.js";
 export * from "./IJISEvent.js";
 export * from "./IJISEventTranslationText.js";
 export * from "./IJISEventsRopidGTFSRoutes.js";

package/dist/schema-definitions/jis/models/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/models/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/jis/models/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/docs/asyncapi.yaml

@@ -84,6 +84,17 @@ channels:
         messages:
             data:
                 $ref: "#/components/messages/JISEvents"
+    jis.refreshDelayedSegments:
+        address: vehicle-positions.jis.refreshDelayedSegments
+        description: Fetch delayed segments from Mapa PID, enrich them with GTFS data and refresh them in database
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            empty:
+                $ref: "#/components/messages/emptyMessage"
     ropidgtfs.refreshPublicGtfsDepartureCache:
         address: vehicle-positions.ropidgtfs.refreshPublicGtfsDepartureCache
         description: Refresh PublicGtfsDepartureCache
@@ -382,6 +393,10 @@ operations:
         action: "send"
         channel:
             $ref: "#/channels/jis.updateEventWebhook"
+    jis.refreshDelayedSegments:
+        action: "send"
+        channel:
+            $ref: "#/channels/jis.refreshDelayedSegments"
     ropidgtfs.refreshPublicGtfsDepartureCache:
         action: "send"
         channel:

package/docs/implementation_documentation.md

@@ -241,6 +241,26 @@ _:warning: Původním záměrem bylo využití OIS číselníku během zpracová
 -   název rabbitmq fronty
     -   vehicle-positions.jis.fetchJISInfotexts
 
+#### _Mapa PID – zpožděné úseky_
+
+-   zdroj dat
+    -   url: module.pid.jis.delayedSegments.url
+    -   interní endpoint webové [Mapy PID](https://mapa.pid.cz/), POST požadavek bez vozidel a tvarů úseků (prázdné `bounds`, `show_delay_sections: false`); zpožděné úseky vrací vždy pro celou síť
+-   formát dat
+    -   protokol: http
+    -   datový typ: json
+    -   validační schéma: [MapaPidDelayShapesJsonSchema](../src/schema-definitions/jis/datasources/MapaPidDelayShapesJsonSchema.ts)
+    -   příklad vstupních dat: [JISDelayedSegmentsDataSourceFactory.unit.test.ts](../test/integration-engine/jis/datasources/JISDelayedSegmentsDataSourceFactory.unit.test.ts)
+-   frekvence stahování
+    -   cron definice:
+        -   cron.vehicle-positions.jis.refreshDelayedSegments
+            -   rabin `0 */5 * * * *`
+            -   prod `0 */5 * * * *`
+-   název rabbitmq fronty
+    -   vehicle-positions.jis.refreshDelayedSegments
+-   omezení
+    -   odpověď neobsahuje čas výpočtu úseků; pokud Mapa PID přestane úseky přepočítávat, vrací poslední známý stav (až 24 hodin) a ten se u nás dál jeví jako aktuální
+
 ### _Ropid staticka data_
 
 -   zdroj dat
@@ -1313,6 +1333,30 @@ Worker má na starost stahování VYMI (JIS) událostí a infotextů, jejich tra
 -   data modely
     -   žádné
 
+#### _task: RefreshDelayedSegmentsTask_
+
+Záměr, architekturu a algoritmus podrobně popisuje [jis/delayed-segments.md](./jis/delayed-segments.md).
+
+-   vstupní rabbitmq fronta
+    -   název: vehicle-positions.jis.refreshDelayedSegments
+    -   TTL: 4 minuty
+    -   parametry: žádné
+-   závislé fronty (do kterých jsou odesílány zprávy z metody workeru)
+    -   žádné
+-   datové zdroje
+    -   Mapa PID (zpožděné úseky)
+    -   `ropidgtfs_precomputed_departures`, `ropidgtfs_trips`, `ropidgtfs_stops`, `ropid_departures_presets`, `ropid_departures_presets_ropidgtfs_stops`
+-   transformace
+    -   úseky se zpožděním pod `module.pid.jis.delayedSegments.minDelaySeconds` (výchozí 300 s) se zahazují
+    -   krajní zastávky se převádí na ASW id (`uzel/sloupek`), z nichž se skládá id úseku; úseky bez ASW id (např. železniční body `T…`) se zahazují
+    -   úseky se obohatí o GTFS data, všechny jedním dotazem ([JISDelayedSegmentEnrichmentQuery](../src/integration-engine/jis/repositories/helpers/JISDelayedSegmentEnrichmentQuery.ts)); uvažují se pouze odjezdy v okně ± `module.pid.jis.delayedSegments.routeTimeWindowMinutes` (výchozí 120 min) od stažení a pravidelné spoje (`exceptional = 0`):
+        -   zastávky úseku – zastávky mezi krajními zastávkami na spojích projíždějících celý úsek, sloučené podle ASW id (reprezentované abecedně prvním stop id ze všech variant v GTFS, aby se neměnilo mezi běhy), seřazené podél úseku
+        -   dotčené linky – linky se spojem, který projede alespoň jeden mezizastávkový úsek ve směru úseku
+        -   zastávky s panely – zastávky s presetem odjezdové tabule (párované podle ASW id) do vzdálenosti `module.pid.jis.delayedSegments.maxInfoPanelDistanceStops` (výchozí 5) zastávek od úseku podél dotčených spojů; pro každou linku se uvádí vzdálenost se znaménkem (záporná před úsekem, 0 v úseku, kladná za úsekem), nejbližší k úseku; vzdálenost se počítá jako rozdíl `stop_sequence`, což předpokládá souvislé číslování zastávek spoje (platí pro všechny spoje PID); mezera v číslování by vzdálenost zvětšila o svou délku
+    -   zahazují se úseky, jejichž krajní zastávky nejsou v GTFS, úseky, které v časovém okně celé neprojíždí žádný spoj (Mapa PID slučuje navazující úseky různých linek), a úseky bez dotčených linek; počty vyřazených úseků podle důvodu se logují při každém běhu
+-   data modely
+    -   Model `jis_delayed_segments` – při každém úspěšném stažení se nahradí celý obsah; `created_at` je začátek aktuální nepřerušené detekce úseku (úsek chybějící v úspěšném stažení se smaže a při dalším výskytu začíná znovu), `updated_at` čas poslední; při chybě stažení zůstávají data beze změny
+
 ## Uložení dat
 
 -   typ databáze
@@ -1344,6 +1388,7 @@ Worker má na starost stahování VYMI (JIS) událostí a infotextů, jejich tra
     -   popis vozidel se nepromazává – přetrvávají do přepsání novými daty (fixní TTL bylo odstraněno)
     -   preset logy si uchováváme 8 hodin
     -   JIS události si uchováváme neomezeně; JIS infotexty jen dokud jsou v posledním přijatém seznamu z VYMI (chybějící se při každém přenačtení mažou)
+    -   zpožděné úseky jen dokud jsou v posledním úspěšně staženém seznamu z Mapy PID
 
 ## Input API
 
@@ -1622,3 +1667,14 @@ Worker má na starost stahování VYMI (JIS) událostí a infotextů, jejich tra
 -   zdrojové tabulky: `jis_events`, `jis_events_ropidgtfs_routes`
 -   formát odpovědi: viz schéma `EventCustomFormat` v [openapi-output.yaml](./openapi-output.yaml)
 -   trasy v `informed_entity.routes` jsou snapshot-first (`jis_events_ropidgtfs_routes.route_details`), s GTFS fallbackem (`ropidgtfs_routes`) jen pro starší řádky bez snímku; podrobněji viz [jis/index.md](./jis/index.md#informed_entityroutesroute_details-snímek-gtfs-atributů-trasy)
+
+#### _/v1/jis/delayed-segments_
+
+-   interní endpoint pro VYMI, vrací aktuální zpožděné úseky obohacené o GTFS data (viz [RefreshDelayedSegmentsTask](#task-refreshdelayedsegmentstask) a [jis/delayed-segments.md](./jis/delayed-segments.md#kontrakt-api))
+-   úseky v čase rostou a zmenšují se, `id` (odvozené od krajních zastávek) proto není stabilní identifikace úseku; úseky se mají párovat podle zastávek
+-   při chybě stažení se úseky nemažou a jejich `last_detected_at` se přestane posouvat, aktuálnost je proto třeba posuzovat podle něj; zaseknutý výpočet na straně Mapy PID tím rozpoznat nelze (viz omezení zdroje)
+-   parametry (volitelné, jen zužují uložená data):
+    -   `minDelaySeconds` – minimální `expected_delay_seconds` úseku
+    -   `minDistanceStops`, `maxDistanceStops` – rozsah `distance_stops` linek zastávek s panely včetně; zastávky bez linky v rozsahu se vynechají
+-   zdrojové tabulky: `jis_delayed_segments`
+-   formát odpovědi: viz schéma `JISDelayedSegment` v [openapi-output.yaml](./openapi-output.yaml)

package/docs/index.md

@@ -28,6 +28,7 @@ PID Polohy je soubor služeb datové platformy [Golemio](https://golemio.cz/) na
   - [Upřesňující popis architektury platformy Golemio]
 - Podrobná dokumentace:
   - [Dokumentace propisu VYMI dat do datové platformy Golemio]
+    - [Zpožděné úseky – podklad pro automatické infotexty](./jis/delayed-segments.md)
   - [Dokumentace zpracování RT dat](./processing/index.md)
     - [Vstupní data HTTP MPVnet (autobusy mimo DPP, přívozy, vlaky)](./processing/input_realtime_data/http_mpvnet.md)
     - [Vstupní data TCP DPP tramvaje](./processing/input_realtime_data/tcp_dpp_tram.md)