@golemio/pid 4.0.3 → 4.0.4-dev.2004342551

package/docs/assets/V4transferboards.drawio

@@ -0,0 +1,191 @@
+<mxfile host="Electron" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/28.0.6 Chrome/138.0.7204.100 Electron/37.2.3 Safari/537.36" version="28.0.6">
+  <diagram id="C5RBs43oDa-KdzZeNtuy" name="Page-1">
+    <mxGraphModel dx="1528" dy="503" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+      <root>
+        <mxCell id="WIyWlLk6GJQsqaUBKTNV-0" />
+        <mxCell id="WIyWlLk6GJQsqaUBKTNV-1" parent="WIyWlLk6GJQsqaUBKTNV-0" />
+        <mxCell id="TFaf3FyTcIUIAYAIC652-1" value="Redis channel vpPublicCache" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-280" y="80" width="260" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-28" value="" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-2" target="TFaf3FyTcIUIAYAIC652-6">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="-150" y="420" />
+              <mxPoint x="170" y="420" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-2" value="VPSubscriber" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-230" y="310" width="150" height="50" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-4" value="Redis vpPublicCache:* (aktivní, budoucí a zrušené spoje)" style="shape=cylinder3;boundedLbl=1;backgroundOutline=1;size=10;strokeWidth=2;whiteSpace=wrap;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-120" y="770" width="310" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-5" value="Redis gtfsPublicDepartureCache:*" style="shape=cylinder3;boundedLbl=1;backgroundOutline=1;size=10;strokeWidth=2;whiteSpace=wrap;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="590" y="770" width="220" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-33" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-6" target="TFaf3FyTcIUIAYAIC652-4">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-6" value="OG PublicVehiclePositionsRepository" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="60" y="530" width="230" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-55" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-7" target="TFaf3FyTcIUIAYAIC652-46">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-7" value="GET /v4/pid/transferboards" style="whiteSpace=wrap;strokeWidth=2;fontStyle=1" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="250" y="80" width="260" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-50" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;startArrow=classic;startFill=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-8" target="TFaf3FyTcIUIAYAIC652-40">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-51" value="RT informace o zastavce" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="TFaf3FyTcIUIAYAIC652-50">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="5" y="1" as="offset" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-61" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.75;entryY=0;entryDx=0;entryDy=0;curved=1;startArrow=classic;startFill=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-8" target="TFaf3FyTcIUIAYAIC652-6">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-71" value="RT informace o spoji" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="TFaf3FyTcIUIAYAIC652-61">
+          <mxGeometry y="10" relative="1" as="geometry">
+            <mxPoint x="2" y="15" as="offset" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-8" value="Obohacení o RT informace" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="390" y="420" width="190" height="50" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-9" value="Přihlášení k odběru" style="curved=1;startArrow=none;endArrow=block;exitX=0.64;exitY=-0.01;entryX=0.64;entryY=1;rounded=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-2" target="TFaf3FyTcIUIAYAIC652-1">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="-50" y="220" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-10" value="ID/název nové datové sady" style="curved=1;startArrow=none;endArrow=block;exitX=0.36;exitY=1;entryX=0.36;entryY=-0.01;rounded=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-1" target="TFaf3FyTcIUIAYAIC652-2">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="-240" y="220" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-19" value="Redis channel jisCache" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-570" y="80" width="260" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-29" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-20" target="TFaf3FyTcIUIAYAIC652-27">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="-440" y="470" />
+              <mxPoint x="-90" y="470" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-20" value="VPSubscriber" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-520" y="310" width="150" height="50" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-21" value="Přihlášení k odběru" style="curved=1;startArrow=none;endArrow=block;exitX=0.64;exitY=-0.01;entryX=0.64;entryY=1;rounded=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-20" target="TFaf3FyTcIUIAYAIC652-19">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="-340" y="220" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-22" value="ID/název nové datové sady" style="curved=1;startArrow=none;endArrow=block;exitX=0.36;exitY=1;entryX=0.36;entryY=-0.01;rounded=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-19" target="TFaf3FyTcIUIAYAIC652-20">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="-530" y="220" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-23" value="Redis channel gtfsStopsCache" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="859" y="80" width="260" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-32" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-24" target="TFaf3FyTcIUIAYAIC652-31">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-24" value="VPSubscriber" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="909" y="310" width="150" height="50" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-25" value="Přihlášení k odběru" style="curved=1;startArrow=none;endArrow=block;exitX=0.64;exitY=-0.01;entryX=0.64;entryY=1;rounded=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-24" target="TFaf3FyTcIUIAYAIC652-23">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="1089" y="220" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-26" value="ID/název nové datové sady" style="curved=1;startArrow=none;endArrow=block;exitX=0.36;exitY=1;entryX=0.36;entryY=-0.01;rounded=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-23" target="TFaf3FyTcIUIAYAIC652-24">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="899" y="220" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-37" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-27" target="TFaf3FyTcIUIAYAIC652-34">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-27" value="OG JISInfotextsRedisRepository" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-190" y="530" width="210" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-36" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-31" target="TFaf3FyTcIUIAYAIC652-35">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-31" value="OG GtfsStopsRedisRepository" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="880" y="500" width="210" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-34" value="Redis jisCache:* (aktivní infotexty)" style="shape=cylinder3;boundedLbl=1;backgroundOutline=1;size=10;strokeWidth=2;whiteSpace=wrap;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="-390" y="770" width="240" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-35" value="Redis gtfsStopsCache:*" style="shape=cylinder3;boundedLbl=1;backgroundOutline=1;size=10;strokeWidth=2;whiteSpace=wrap;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="865" y="770" width="240" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-38" value="Redis vpPublicStopTimeCache:* (pro dolneni RT dat o stop_name a platform_code)" style="shape=cylinder3;boundedLbl=1;backgroundOutline=1;size=10;strokeWidth=2;whiteSpace=wrap;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="260" y="770" width="310" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-42" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-40" target="TFaf3FyTcIUIAYAIC652-38">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-40" value="OG PublicStopTimeRepository" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="370" y="590" width="230" height="80" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-53" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;curved=1;startArrow=classic;startFill=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-46" target="TFaf3FyTcIUIAYAIC652-31">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="810" y="230" />
+              <mxPoint x="810" y="540" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-58" value="" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-46" target="TFaf3FyTcIUIAYAIC652-57">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-63" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-46" target="TFaf3FyTcIUIAYAIC652-62">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-46" value="Ziskat vsechny zastavky v danem uzlu" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="240" y="200" width="290" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-59" value="" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-57" target="TFaf3FyTcIUIAYAIC652-8">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-70" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;endArrow=classic;endFill=1;startArrow=classic;startFill=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-57" target="TFaf3FyTcIUIAYAIC652-65">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-57" value="Ziskat vsechny odjezdy pro zastavky v uzlu" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="340" y="310" width="290" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-64" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;startArrow=classic;startFill=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-62" target="TFaf3FyTcIUIAYAIC652-27">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-62" value="Ziskat aktivni infotexty pro zastavky v uzlu" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="20" y="310" width="290" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-69" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;curved=1;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TFaf3FyTcIUIAYAIC652-65" target="TFaf3FyTcIUIAYAIC652-5">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="TFaf3FyTcIUIAYAIC652-65" value="OG PublicGtfsDepartureRepository" style="whiteSpace=wrap;strokeWidth=2;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+          <mxGeometry x="600" y="450" width="200" height="50" as="geometry" />
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

package/docs/asyncapi.yaml

@@ -48,6 +48,39 @@ channels:
         messages:
             empty:
                 $ref: "#/components/messages/JISInfotexts"
+    jis.refreshJISInfotextsCache:
+        address: vehicle-positions.jis.refreshJISInfotextsCache
+        description: Refresh JIS infotexts cache in Redis (Valkey)
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            empty:
+                $ref: "#/components/messages/emptyMessage"
+    ropidgtfs.refreshPublicGtfsDepartureCache:
+        address: vehicle-positions.ropidgtfs.refreshPublicGtfsDepartureCache
+        description: Refresh PublicGtfsDepartureCache
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            empty:
+                $ref: "#/components/messages/emptyMessage"
+    ropidgtfs.refreshGtfsStopsCache:
+        address: vehicle-positions.ropidgtfs.refreshGtfsStopsCache
+        description: Refresh GtfsStopsCache
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            empty:
+                $ref: "#/components/messages/emptyMessage"
     updateGTFSTripId:
         address: vehicle-positions.vehiclepositions.updateGTFSTripId
         description: some description
@@ -294,6 +327,18 @@ operations:
         action: "send"
         channel:
             $ref: "#/channels/jis.refreshJISInfotexts"
+    jis.refreshJISInfotextsCache:
+        action: "send"
+        channel:
+            $ref: "#/channels/jis.refreshJISInfotextsCache"
+    ropidgtfs.refreshPublicGtfsDepartureCache:
+        action: "send"
+        channel:
+            $ref: "#/channels/ropidgtfs.refreshPublicGtfsDepartureCache"
+    ropidgtfs.refreshGtfsStopsCache:
+        action: "send"
+        channel:
+            $ref: "#/channels/ropidgtfs.refreshGtfsStopsCache"
     updateGTFSTripId:
         action: "send"
         channel:

package/docs/cache/types/redis.md

@@ -62,7 +62,7 @@ flowchart TD;
   -  Pomocný timestamp se načte pomocí `GET` a vrátí se jako hodnota hlavičky `Last-Modified` převedená na ISO string. Pokud timestamp neexistuje, hodnota hlavičky bude unix timestamp 0 jako ISO string. Využívá se především pro monitoring a alerting
 - Feedy se generují nejméně 3x za minutu (rabín 2x) pomocí queue-message
   -  Používají redis-mutex na zamykání, aby neběželo více shodných tasků v jeden okamžik
-  -  Pokud generování stíhá běžet rychleji, task se snaží do ±7 vteřin svého běhu spustit nové generování souborů (opět přes queue-message). 
+  -  Pokud generování stíhá běžet rychleji, task se snaží do ±7 vteřin svého běhu spustit nové generování souborů (opět přes queue-message).
 
 ### Flowchart
 
@@ -152,6 +152,7 @@ flowchart TD;
   - `cis_stop_platform_code` - nástupiště/kolej podle CIS u vlakových zastávek, jinde null
   - `platform_code` - označení zastávky podle GTFS
   - `stop_id` - GTFS id zastávky
+  - `stop_name` - název zastávky
 - TTL 1 hodina a 5 minut
 - Automatické promazání dat po úspěšném načtení GTFS jíždních řádů
 - Cca jednou za 5 vteřin se přenačtou stop times pro všechny aktivní spoje. Generování může běžet pouze jednou, po dokončení tasku se spustí znovu (max čekání 4.8 vteřin)
@@ -313,4 +314,82 @@ flowchart TD;
     rt_info["Obohacení o RT informace"];
     get_departures--"Alespoň jedno vozidlo připadá nějakému spoji (aktivní, budoucí i zrušené) na odjezdu"-->rt_info;
     rt_info--"RT informace o spoji"-->redis_repository<-->redis_public_cache;
-```
+```
+
+## Cache pro API přestupních tabulí (transfer boards)
+
+*(přestupní tabule využívají také cache pro Public API, která je již popsána výše)*
+
+### gtfsStopsCache:*
+
+- Jednotlivé komponenty cache jsou členěny do sad s `$setId`
+    - `$setId` je id vygenerované datové sady (4 náhodné bajty reprezentované hexadecimálně)
+    - Nová sada je vytvořena při každém přenačtení cache
+    - Id `$setId` nejnovější datové sady se propaguje přes PubSub channel `gtfsStopsCache` a je také uloženo v cache jako hodnota položky `gtfsStopsCache:activeSetName`
+- Komponenty:
+  - `gtfsStopsCache:$setId:aswNodeToGtfsStops` - Hash mapa, mapující daný ASW node na seznam pod něj spadajících zastávek (GTFS ids zastávek, odděleny čárkami)
+  - `gtfsStopsCache:$setId:cisToAswNode` - Hash mapa, mapující dané CIS id zastávky na příslušný ASW node
+- TTL žádné (mimo přenačtení cache, kdy je namísto okamžitého promazání původnímu setu nastaveno TTL 1 minuta)
+- Cache je celá přenačtena vždy po přenačtení jízdních řádů (tedy 1-2x denně při stavu k červenci 2025)
+
+### jisCache:*
+
+- Jednotlivé komponenty cache jsou členěny do sad s `$setId`
+    - `$setId` je id vygenerované datové sady (4 náhodné bajty reprezentované hexadecimálně)
+    - Nová sada je vytvořena při každém přenačtení cache
+    - Id `$setId` nejnovější datové sady se propaguje přes PubSub channel `jisCache` a je také uloženo v cache jako hodnota položky `jisCache:activeSetName`
+- Komponenty:
+  - `jisCache:$setId:infotexts` - Hash mapa, mapující dané id infotextu na informace o onom infotextu (JSON jako string)
+  - `jisCache:$setId:stops-infotexts` - Hash mapa, mapující dané GTFS id zástavky na seznam infotextů s ní asociovaných (ids infotextů, odděleny čárkami)
+- TTL žádné (mimo přenačtení cache, kdy je namísto okamžitého promazání původnímu setu nastaveno TTL 1 minuta)
+- Cache je celá přenačtena při každé aktualizaci infotextů (tento proces je více popsán v [Dokumentaci propisu VYMI (JIS) dat do datové platformy](../../jis/index.md))
+
+### Flowchart (refresh gtfsStopsCache:*)
+
+```mermaid
+flowchart LR
+    finish_up_gtfs("`Dokončení zpracování GTFS JŘ`");
+
+    psql_ropidgtfs_cis_stops[("`PSQL ropidgtfs_cis_stops`")];
+    psql_ropidgtfs_stops[("`PSQL ropidgtfs_stops`")];
+
+    redis_gtfsStopsCache[("`Redis gtfsStopsCache:\*`")];
+
+    amqp_refreshGtfsStopsCache["`AMQP refreshGtfsStopsCache`"];
+
+    task_RefreshGtfsStopsCacheTask["`RefreshGtfsStopsCacheTask`"];
+
+    finish_up_gtfs --> amqp_refreshGtfsStopsCache;
+    amqp_refreshGtfsStopsCache --> task_RefreshGtfsStopsCacheTask;
+    task_RefreshGtfsStopsCacheTask <-- "`ASW ids a CIS ids zastávek`" --> psql_ropidgtfs_cis_stops;
+    task_RefreshGtfsStopsCacheTask <-- "`ASW nodes a GTFS ids zastávek`" --> psql_ropidgtfs_stops;
+    task_RefreshGtfsStopsCacheTask -- "`HSET gtfsStopsCache:$setId:aswNodeToGtfsStops a gtfsStopsCache:$setId:cisToAswNode, EXPIRE staré sady`" --> redis_gtfsStopsCache;
+```
+
+### Flowchart (refresh jisCache:*)
+
+```mermaid
+flowchart LR
+    refresh_infotexts("`Aktualizace infotextů`");
+
+    psql_jis_infotexts[("`PSQL jis_infotexts`")];
+    psql_jis_infotexts_ropidgtfs_stops[("`PSQL jis_infotexts_ropidgtfs_stops`")];
+
+    redis_jisCache[("`Redis jisCache:\*`")];
+
+    amqp_refreshJISInfotextsCache["`AMQP refreshJISInfotextsCache`"];
+
+    task_RefreshJISInfotextsCacheTask["`RefreshJISInfotextsCacheTask`"];
+
+    refresh_infotexts --> amqp_refreshJISInfotextsCache;
+    amqp_refreshJISInfotextsCache --> task_RefreshJISInfotextsCacheTask;
+    task_RefreshJISInfotextsCacheTask <-- "`Data infotextů`" --> psql_jis_infotexts;
+    task_RefreshJISInfotextsCacheTask <-- "`GTFS ids zastávek a ids infotextů`" --> psql_jis_infotexts_ropidgtfs_stops;
+    task_RefreshJISInfotextsCacheTask -- "`HSET jisCache:$setId:infotexts a jisCache:$setId:stops-infotexts, EXPIRE staré sady`" --> redis_jisCache;
+```
+
+### Flowchart (v4 transferboards API)
+
+![flowchart.svg](../../assets/V4Transferboards.svg)
+
+link na .drawio [soubor](../../assets/V4Transferboards.drawio)

package/docs/jis/index.md

@@ -123,9 +123,11 @@ flowchart TB
         subgraph "Golemio VP Integration Engine"
             golemio_refresh_events_task["`RefreshJISEventsTask`"];
             golemio_refresh_infotexts_task["`RefreshJISInfotextsTask`"];
+            golemio_refresh_infotexts_cache_task["`RefreshJISInfotextsCacheTask`"];
         end
 
         vp_pg[("`VP PostgreSQL`")];
+        vp_redis[("`VP Redis (Valkey)`")];
     end
 
     vymi_events_controller_create --> vymi_get_events;
@@ -134,8 +136,8 @@ flowchart TB
     vymi_infotexts_controller_create --> vymi_get_infotexts;
     vymi_infotexts_controller_update --> vymi_get_infotexts;
 
-    vymi_get_events -- "`SELECT aktuálních událostí z tabulek vehicle-positions.pid.jis_events a vehicle-positions.pid.jis_events_ropidgtfs_routes`" --> vymi_pg;
-    vymi_get_infotexts -- "`SELECT aktuálních infotextů z tabulek vehicle-positions.pid.jis_infotexts a vehicle-positions.pid.jis_infotexts_ropidgtfs_stops`" --> vymi_pg;
+    vymi_get_events <-- "`SELECT aktuálních událostí z tabulek vehicle-positions.pid.jis_events a vehicle-positions.pid.jis_events_ropidgtfs_routes`" --> vymi_pg;
+    vymi_get_infotexts <-- "`SELECT aktuálních infotextů z tabulek vehicle-positions.pid.jis_infotexts a vehicle-positions.pid.jis_infotexts_ropidgtfs_stops`" --> vymi_pg;
 
     vymi_get_events --> golemio_api_post_events;
     vymi_get_infotexts --> golemio_api_post_infotexts;
@@ -151,9 +153,12 @@ flowchart TB
 
     golemio_refresh_events_task -- "`UPSERT do tabulek vehicle-positions.pid.jis_events a vehicle-positions.pid.jis_events_ropidgtfs_routes`" --> vp_pg;
     golemio_refresh_infotexts_task -- "`UPSERT do tabulek vehicle-positions.pid.jis_infotexts a vehicle-positions.pid.jis_infotexts_ropidgtfs_stops`" --> vp_pg;
+    golemio_refresh_infotexts_task --> golemio_refresh_infotexts_cache_task;
+
+    golemio_refresh_infotexts_cache_task -- "`Aktualizace cache jisCache:infotexts:* a jisCache:stop-infotexts:*`" --> vp_redis;
 ```
 
-Formát zasílaných dat je dále více popsán v implementační dokumentaci ([události](../implementation_documentation.md#jis-events-1), [infotexty](../implementation_documentation.md#jis-infotexts-1)), stejně tak jako odkazy na [Input Gateway OpenAPI](../implementation_documentation.md#input-api) a popis [uložení dat](../implementation_documentation.md#uložení-dat) včetně databázového schema a popisu retence.
+Formát zasílaných dat je dále více popsán v implementační dokumentaci ([události](../implementation_documentation.md#jis-events-1), [infotexty](../implementation_documentation.md#jis-infotexts-1)), stejně tak jako odkazy na [Input Gateway OpenAPI](../implementation_documentation.md#input-api) a popis [uložení dat](../implementation_documentation.md#uložení-dat) včetně databázového schema a popisu retence. Data infotextů jsou dále cachovány - tento proces je popsán v dokumentaci [Redis cache](../cache/types/redis.md#cache-pro-api-přestupních-tabulí-transfer-boards).
 
 ## Pasivní načítání (pull) dat
 
@@ -202,6 +207,7 @@ flowchart TB
             golemio_fetch_infotexts_task["`FetchJISInfotextsTask`"];
             golemio_refresh_events_task["`RefreshJISEventsTask`"];
             golemio_refresh_infotexts_task["`RefreshJISInfotextsTask`"];
+            golemio_refresh_infotexts_cache_task["`RefreshJISInfotextsCacheTask`"];
 
             %% invisible unicode char ‎ due to https://github.com/orgs/community/discussions/106690
             golemio_api_get_events["`HTTPS GET s API klíčem na https‎://api-vymi.golemio.cz/v1/exports/events/custom-format`"];
@@ -209,10 +215,11 @@ flowchart TB
         end
 
         vp_pg[("`VP PostgreSQL`")];
+        vp_redis[("`VP Redis (Valkey)`")];
     end
 
-    vymi_get_events -- "`SELECT aktuálních událostí z tabulek vehicle-positions.pid.jis_events a vehicle-positions.pid.jis_events_ropidgtfs_routes`" --> vymi_pg;
-    vymi_get_infotexts -- "`SELECT aktuálních infotextů z tabulek vehicle-positions.pid.jis_infotexts a vehicle-positions.pid.jis_infotexts_ropidgtfs_stops`" --> vymi_pg;
+    vymi_get_events <-- "`SELECT aktuálních událostí z tabulek vehicle-positions.pid.jis_events a vehicle-positions.pid.jis_events_ropidgtfs_routes`" --> vymi_pg;
+    vymi_get_infotexts <-- "`SELECT aktuálních infotextů z tabulek vehicle-positions.pid.jis_infotexts a vehicle-positions.pid.jis_infotexts_ropidgtfs_stops`" --> vymi_pg;
 
     golemio_rabbit_fetch_events --> golemio_fetch_events_task;
     golemio_rabbit_fetch_infotexts --> golemio_fetch_infotexts_task;
@@ -233,6 +240,9 @@ flowchart TB
 
     golemio_refresh_events_task -- "`UPSERT do tabulek vehicle-positions.pid.jis_events a vehicle-positions.pid.jis_events_ropidgtfs_routes`" --> vp_pg;
     golemio_refresh_infotexts_task -- "`UPSERT do tabulek vehicle-positions.pid.jis_infotexts a vehicle-positions.pid.jis_infotexts_ropidgtfs_stops`" --> vp_pg;
+    golemio_refresh_infotexts_task --> golemio_refresh_infotexts_cache_task;
+
+    golemio_refresh_infotexts_cache_task -- "`Aktualizace cache jisCache:infotexts:* a jisCache:stop-infotexts:*`" --> vp_redis;
 ```
 
 Zdroj a formát dat pro aktivní stahování jsou dále více popsány v implementační dokumentaci ([události](../implementation_documentation.md#jis-events), [infotexty](../implementation_documentation.md#jis-infotexts)), stejně tak jako [worker a tasky](../implementation_documentation.md#jisworker) a popis [uložení dat](../implementation_documentation.md#uložení-dat) včetně databázového schema a popisu retence.

package/docs/openapi-input.yaml

@@ -453,6 +453,12 @@ components:
             type: array
             items:
                 type: object
+                required:
+                    - routeName
+                    - note
+                    - apiVersion
+                    - route
+                    - query
                 properties:
                     routeName:
                         type: string
@@ -469,6 +475,9 @@ components:
                     query:
                         type: string
                         example: "?minutesAfter=300&limit=8&mode=departures&cisIds=40110"
+                    isTesting:
+                        type: boolean
+                        example: true
         JISEvents:
             title: JIS events
             type: array
@@ -831,14 +840,16 @@ components:
                         "note": "Tablo Zahradní město z centra (APEX)",
                         "apiVersion": 2,
                         "route": "/pid/departureboards",
-                        "query": "?minutesAfter=40&limit=6&mode=departures&filter=routeHeadingOnceNoGapFill&order=real&aswIds=2781_2&aswIds=2781_52&skip=atStop&airCondition=true"
+                        "query": "?minutesAfter=40&limit=6&mode=departures&filter=routeHeadingOnceNoGapFill&order=real&aswIds=2781_2&aswIds=2781_52&skip=atStop&airCondition=true",
+                        "isTesting": true
                     },
                     {
                         "routeName": "apex-zahradnimesto-6048-kopie",
                         "note": "Tablo Zahradní město z centra (APEX)",
                         "apiVersion": 2,
                         "route": "/pid/departureboards",
-                        "query": "?minutesAfter=40&limit=6&mode=departures&filter=routeHeadingOnceNoGapFill&order=real&aswIds=2781_2&aswIds=2781_52&skip=atStop&airCondition=true"
+                        "query": "?minutesAfter=40&limit=6&mode=departures&filter=routeHeadingOnceNoGapFill&order=real&aswIds=2781_2&aswIds=2781_52&skip=atStop&airCondition=true",
+                        "isTesting": false
                     }
                 ]
         JISEventsExample: