Outsource to other carrier (#4)

* Fix ishare output in ERP

* Make outsourcing possible in UI

* Record subcos and put chain in QR

* Register delegations evidence for outsourcing in AR

* Verify outsourced transport order

* Improve layout of ishare explanations

* UI and L&F improvements

* Update demo-script for outsourcing

* Add values to QR-code for demos

* Fix spelling

* Review feedback

* Only assigned trips visible to chauffeurs

* Show OTM objects in explanations

* Update demo script

* Show owner of AR rejects pickup

---------

Co-authored-by: Joost Diepenmaat <joost@zeekat.nl>

README.md

@@ -52,19 +52,21 @@ WMS:
 
 TMS 1:
 
-- `TMS1_EORI`: EORI used by TMS 1
-- `TMS1_KEY_FILE`: the file to read the TMS 1 private key from
-- `TMS1_CHAIN_FILE`: the file to read the TMS 1 certificate chain from
-- `TMS1_AR_ID`: EORI of the TMS 1 authorization register
-- `TMS1_AR_ENDPOINT`: URL to the TMS 1 authorization register
+- `TMS1_EORI`: EORI
+- `TMS1_KEY_FILE`: the file to read the private key from
+- `TMS1_CHAIN_FILE`: the file to read the certificate chain from
+- `TMS1_AR_ID`: EORI of the authorization register
+- `TMS1_AR_ENDPOINT`: URL to the authorization register
+- `TMS1_AR_TYPE`: type of authorization register (ishare or poort8)
 
 TMS 2:
 
-- `TMS2_EORI`: EORI used by TMS 2
-- `TMS2_KEY_FILE`: the file to read the TMS 2 private key from
-- `TMS2_CHAIN_FILE`: the file to read the TMS 2 certificate chain from
-- `TMS2_AR_ID`: EORI of the TMS 2 authorization register
-- `TMS2_AR_ENDPOINT`: URL to the TMS 2 authorization register
+- `TMS2_EORI`: EORI
+- `TMS2_KEY_FILE`: the file to read the private key from
+- `TMS2_CHAIN_FILE`: the file to read the certificate chain from
+- `TMS2_AR_ID`: EORI of the authorization register
+- `TMS2_AR_ENDPOINT`: URL to the authorization register
+- `TMS1_AR_TYPE`: type of authorization register (ishare or poort8)
 
 Run the web server with the following:
 

doc/architecture/20240610-delegation-chain-workarounds.svg.license

@@ -0,0 +1,6 @@
+SPDX-FileCopyrightText: 2024 Jomco B.V.
+SPDX-FileCopyrightText: 2024 Topsector Logistiek
+SPDX-FileContributor: Joost Diepenmaat <joost@jomco.nl>
+SPDX-FileContributor: Remco van 't Veer <remco@jomco.nl>
+
+SPDX-License-Identifier: AGPL-3.0-or-later

doc/demo-script.org

@@ -19,6 +19,7 @@ inloggen met één van de volgende accounts:
 
 * Overzicht
 
+#+ATTR_LATEX: :width 1.0\textwidth
 [[./demo-script/index.png]]
 
 - ERP
@@ -28,20 +29,26 @@ inloggen met één van de volgende accounts:
   elders.  Deze opdrachten worden hier toegewezen aan een vervoerder
   en doorgestuurd naar TMS en WMS (zie onder).
 
-- TMS
+- WMS
+
+  Het Warehouse Management Systeem op het DC.  Hierin worden
+  "ophaal"-opdrachten geregistreerd en de chauffeur gecontroleerd.
+
+- TMS-1
 
   Het Transport Management Systeem van de transporteur.  Hier wordt de
-  transportopdracht ingepland en een chauffeur / vrachtwagen toegewezen.
+  transportopdracht ingepland en een chauffeur / vrachtwagen
+  toegewezen of uitbesteed aan een andere vervoerder.
 
-- TMS (Chauffeur)
+- TMS-1 (Chauffeur)
 
   Schermen in het TMS speciaal bedoelt voor chauffeurs voor het laten
   zien van QR-code.
 
-- WMS
+- TMS-2 en TMS-2 (Chauffeur)
+
+  TMS schermen van de andere transporteur.
 
-  Het Warehouse Management Systeem op het DC.  Hierin worden
-  "ophaal"-opdrachten geregistreerd en de chauffeur gecontroleerd.
 
 
 \clearpage
@@ -50,96 +57,125 @@ inloggen met één van de volgende accounts:
 
 Ga naar: https://connekt-dil-demo.jomco.nl/erp/
 
-[[./demo-script/erp-index.png]]
-
-Maak een nieuwe opdracht aan met de "NIEUW" knop.
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/erp.png]]
 
-[[./demo-script/erp-new.png]]
+Maak een nieuwe opdracht aan met de "NIEUW ORDER AANMAKEN" knop.
 
-Vul hier het "Afleveradres" en de "Goederen" in, bijvoorbeeld "Nokia,
-Espoo" en "Bananen" en sla op met "BEWAREN".  Tip: kies een
-"Afleveradres" uit de suggesties om in latere schermen een volledig
-adres te zien.  Goederen kunnen vrij ingevuld worden.
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/erp_new.png]]
 
-Let op: voor "Ophaaladres" (het DC) en "Vervoerder" is maar voor
-beiden één keuze mogelijkheid.  Het gaat hier namelijk om de ook
-behandelde WMS en TMS omgevingen.
+Vul hier het "Afleveradres", de "Goederen" en de "Vervoerder" in,
+bijvoorbeeld "Nokia, Espoo", "Bananen" en "Precious Goods Transport",
+en sla op met "OPSLAAN".  Tip: kies een "Afleveradres" uit de
+suggesties om in latere schermen een volledig adres te zien.  Goederen
+kunnen vrij ingevuld worden.
 
-[[./demo-script/erp-created.png]]
+Let op: voor "Ophaaladres" (het DC) en "Vervoerder" zijn beperkte
+keuze mogelijkheiden.  Het gaat hier namelijk om de ook behandelde WMS
+en TMS omgevingen.
 
-Open de zojuist aangemaakte klantorder opnieuw met de bijbehorende
-"OPENEN" knop.
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/erp_created.png]]
 
-[[./demo-script/erp-open.png]]
+Verstuur de zojuist aangemaakte klantorder naar het DC en de
+vervoerder met de bijbehorende "VERSTUREN" knop.
 
-En druk op de "TRANSPORTOPDRACHT AANMAKEN" knop om de order door te
-zetten naar het TMS en WMS van de resp. vervoerder en DC.
-
-[[./demo-script/erp-publish.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/erp_publish.png]]
 
 Je bevind je nu op een bevestigingsscherm.  Druk "VERSTUREN" voor het
 daadwerkelijke doorzetten van de opdracht.
 
-[[./demo-script/erp-published.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/erp_published.png]]
 
 In de uitklapbare "Uitleg" is te zien dat de opdracht verstuurd is
 naar het WMS en het TMS.  Hoe dit precies gebeurd valt buiten de scope
 van deze demo.
 
-[[./demo-script/erp-published-uitleg.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/erp_published-uitleg.png]]
+
+\clearpage
+
+* TMS-1
+
+De opdracht is nu aangekomen in het TMS van "Precious Goods
+Transport".  Ga naar: https://connekt-dil-demo.jomco.nl/tms-1/
 
-Belangrijk hier is dat de vervoerder, in het netwerk bekend als
-"EU.EORI.NLPRECIOUSG". geregistreerd wordt in het /Autorisatie
-Register/ van de verlader (stappen 3 en 4) voor het ophalen van
-klantorder "124122001".
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-1.png]]
 
-[[./demo-script/erp-published-uitleg-de.png]]
+Het is nu mogelijk deze opdracht toe te wijzen aan een chauffeur en
+vrachtwagen of uit te besteden bij een andere vervoerder.
 
+Om uit te besteden (toewijzen doen we straks bij de andere vervoerder)
+druk op de "UITBESTEDEN" knop.
+
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-1_outsource.png]]
+
+Kies vervoerder "Flex Transport" en druk op "UITBESTEDEN".
+
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-1_outsourced.png]]
+
+In de uitklapbare "Uitleg" is te zien dat de opdracht verstuurd is
+naar het TMS van "Flex Transport" en dat dit geregistreerd is in het
+/Authorisatie Register/.
+
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-1_outsourced-uitleg.png]]
 
 \clearpage
 
-* TMS
+* TMS-2
 
-De opdracht is nu aangekomen in het TMS.  Ga naar:
-https://connekt-dil-demo.jomco.nl/tms/
+De opdracht is nu aangekomen in het TMS van "Flex Transport".  Ga
+naar: https://connekt-dil-demo.jomco.nl/tms-2/
 
-[[./demo-script/tms-index.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-2.png]]
 
-Open de nieuwe transportopdracht met de bijbehorende "OPENEN" knop.
+Druk op de "TOEWIJZEN" knop om een chauffeur en vrachtwagen toe te
+wijzen.
 
-[[./demo-script/tms-open.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-2_assign.png]]
 
 Voer de "Rijbewijs" en "Kenteken" velden in om een chauffeur en
 vrachtwagen toe te wijzen aan deze opdracht, bijvoorbeeld "4321" en
 "ABC12YZ" en druk op "TOEWIJZEN".
 
-[[./demo-script/tms-assigned.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-2_assigned.png]]
 
 Hier zie je de QR-code die de chauffeur straks moet laten zien bij het
-DC (zie onder bij "TMS (Chauffeur)").
+DC (zie onder bij "TMS-2 (Chauffeur)").
 
-In de uitklapbare "Uitleg" in stap 4 is te zien dat de chauffeur en de
+In de uitklapbare "Uitleg" is te zien dat de chauffeur en de
 vrachtwagen in het /Autorisatie Register/ van de vervoerder toegewezen
 zijn.
 
-[[./demo-script/tms-assigned-uitleg.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-2_assigned-uitleg.png]]
 
 
 \clearpage
 
-* TMS (Chauffeur)
+* TMS-2 (Chauffeur)
 
 De QR-code is nu ook beschikbaar voor de chauffeur.  Ga naar:
-https://connekt-dil-demo.jomco.nl/tms/chauffeur/
-
-[[./demo-script/tms-c-index.png]]
+https://connekt-dil-demo.jomco.nl/tms-2/chauffeur/
 
-Merk op dat dit scherm is geoptimaliseerd voor mobiele apparaten zoals
-tablets en smartphones.  Kies opdracht "124122001" en zie daar de op
-het DC aan te bieden QR-code.
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-2_chauffeur.png]]
 
-[[./demo-script/tms-c-open.png]]
+Druk op "TONEN" om de QR-code te zien.
 
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/tms-2_chauffeur_trip.png]]
 
 \clearpage
 
@@ -148,57 +184,42 @@ het DC aan te bieden QR-code.
 De opdracht is ook al in het WMS bekent en kan nu volledig
 geverifieerd worden.  Ga naar: https://connekt-dil-demo.jomco.nl/wms/
 
-[[./demo-script/wms-index.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/wms.png]]
 
-Merk op dat ook dit scherm is geoptimaliseerd voor mobiele apparaten
-zoals tablets en smartphones.  Kies de opdracht voor het ophalen van
-"Bananen".
+Druk op "VERIFEREN" om te controleren of de chauffeur de vracht mag
+ontvangen.
 
-[[./demo-script/wms-open.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/wms_verify.png]]
 
 Hier zijn een "SCAN QR" knop en invoer velden te vinden.  Het scannen
-van een QR-code zorgt dat de "Vervoerder EORI", "Rijbewijs" en
+van een QR-code zorgt dat de "Vervoerder EORI's", "Rijbewijs" en
 "Kenteken" velden automatisch ingevuld worden.  Het scannen van een
 QR-code is lastig in een video call het is daarom handiger om deze
 velden met de hand in te vullen:
 
-- "Vervoerder EORI": "EU.EORI.NLPRECIOUSG"
+- "Vervoerder EORI's": "EU.EORI.NLPRECIOUSG,EU.EORI.NLFLEXTRANS"
 - "Rijbewijs": "4321"
 - "Kenteken": "ABC12YZ" (let op, dit veld is op dit moment nog
   hoofdletter gevoelig!)
 
 Druk op "VERIFIEREN", er wordt nu nog extra gevraagd of het rijbewijs
 en kenteken overeenkomen met die van de chauffeur en vrachtwagen.
 
-[[./demo-script/wms-verify-good.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/wms_verified.png]]
 
 Hier is geverifieerd of de verlader de vervoerder toestaat de zending
 op te halen en of de vervoerder de chauffeur met vrachtwagen toestaat
 de zending aan te nemen.
 
-In de uitklapbare "Uitleg" is te zien dat:
-
-- Stap 1 en 2: het /Associatie Register/ gevraagd wordt naar de
-  locatie van het /Autorisatie Register/ van de verlader (bekent als
-  "EU.EORI.NLSMARTPHON")
-
-  [[./demo-script/wms-verify-good-uitleg-ar-verlader.png]]
-
-- Stap 3 en 4: het /Autorisatie Register/ van de verlader gevraagd
-  wordt of de vervoerder deze opdracht mag uitvoeren
-
-  [[./demo-script/wms-verify-good-uitleg-ar-verlader-permit.png]]
-
-- Stap 5 en 6: het /Associatie Register/ gevraagd wordt naar de
-  locatie van het /Autorisatie Register/ van de vervoerder (bekent als
-  "EU.EURI.NLPRECIOUSG")
-
-  [[./demo-script/wms-verify-good-uitleg-ar-vervoerder.png]]
-
-- Stap 7 en 8: het /Autorisatie Register/ van de vervoerder gevraagd
-  wordt of de chauffeur met vrachtwagen de zending aan mag nemen
+In de uitklapbare "Uitleg" is te zien dat de /Autorisatie Register's/
+van de verlader, uitbestedende vervoerder en uitvoerdende vervoerder
+bevraagd worden.
 
-  [[./demo-script/wms-verify-good-uitleg-ar-vervoerder-permit.png]]
+#+ATTR_LATEX: :width 1.0\textwidth
+[[./demo-script/wms_verified-uitleg.png]]
 
 * Org export configuratie                                          :noexport:
 

doc/demo-script/wms_verify.png.license

@@ -0,0 +1,5 @@
+SPDX-FileCopyrightText: 2024 Jomco B.V.
+SPDX-FileCopyrightText: 2024 Topsector Logistiek
+SPDX-FileContributor: Remco van 't Veer <remco@jomco.nl>
+
+SPDX-License-Identifier: AGPL-3.0-or-later