fix: map live service status to export wording

tests/BusProNet/XmlLoader/TravelLoaderAvailabilityTest.php

@@ -19,9 +19,9 @@ use Symfony\Contracts\Cache\CacheInterface;
 /**
  * Tests that patchAvailabilities() carries the live service status, not just the contingent.
  *
- * When a Leistung's contingent runs out BusPro moves it to 'Anfrage' without necessarily
- * reporting frei="0", so the status is the only reliable signal. Dropping it meant every
- * availability rule read the status from the nightly XML export instead.
+ * Dropping the status meant every availability rule read it from the nightly XML export instead.
+ * The statuses here are already in export vocabulary; the parsers translate BusPro's live
+ * "buchbar" / "ausgebucht" (see AvailabilitiesParserTest).
  */
 class TravelLoaderAvailabilityTest extends TestCase
 {
@@ -45,10 +45,10 @@ class TravelLoaderAvailabilityTest extends TestCase
 
         $this->loader->patchAvailabilities(
             $travel,
-            $this->createResponse([$this->createAvailability(60, Constants::STATUS_ON_REQUEST, 3)])
+            $this->createResponse([$this->createAvailability(60, Constants::STATUS_BLOCKED, 3)])
         );
 
-        $this->assertSame(Constants::STATUS_ON_REQUEST, $service->status);
+        $this->assertSame(Constants::STATUS_BLOCKED, $service->status);
         $this->assertSame(3, $service->available);
     }
 

tests/BusProNet/XmlParser/AvailabilitiesParserTest.php

@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\BusProNet\XmlParser;
+
+use App\BusProNet\Constants;
+use App\BusProNet\XmlCrawlerFactory;
+use App\BusProNet\XmlParser\AvailabilitiesParser;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * The service lines are taken from recorded VERFUEGBARKEIT responses (travels 12855 and 12833).
+ */
+class AvailabilitiesParserTest extends TestCase
+{
+    private AvailabilitiesParser $parser;
+
+    protected function setUp(): void
+    {
+        $this->parser = new AvailabilitiesParser();
+    }
+
+    public function testMapsLiveServiceStatusOntoExportVocabulary(): void
+    {
+        $xml = '<?xml version="1.0" encoding="utf-8"?>
+<ergebnis>
+    <satz typ="VERFUEGBARKEIT"/>
+    <reise id="12855" status="frei" buchungstatusmoeglich="FOA"/>
+    <leistungen>
+        <leistung id="201200" bezeichnung="Begleitperson (gemäß Gruppenregelung)" art="SON" unterart="SON" status="buchbar" frei="3" preis="0,00" preisfaellig="Einmalig"/>
+        <leistung id="201590" bezeichnung="Begleitperson (gemäß Gruppenregelung)" art="SON" unterart="SON" status="ausgebucht" anfragemoeglich="J" frei="0" preis="0,00" preisfaellig="Einmalig"/>
+    </leistungen>
+</ergebnis>';
+
+        $services = $this->parser->parseServices(XmlCrawlerFactory::create($xml))->getServices();
+
+        $this->assertSame(Constants::STATUS_AVAILABLE, $services[201200]->status);
+        $this->assertSame(3, $services[201200]->available);
+        $this->assertSame(Constants::STATUS_BLOCKED, $services[201590]->status);
+        $this->assertSame(0, $services[201590]->available);
+    }
+
+    public function testPassesExportVocabularyAndUnknownStatusThrough(): void
+    {
+        $xml = '<?xml version="1.0" encoding="utf-8"?>
+<ergebnis>
+    <leistungen>
+        <leistung id="1" status="Anfrage" frei="2" preis="0,00"/>
+        <leistung id="2" status="unbekannt" frei="2" preis="0,00"/>
+        <leistung id="3" frei="2" preis="0,00"/>
+    </leistungen>
+</ergebnis>';
+
+        $services = $this->parser->parseServices(XmlCrawlerFactory::create($xml))->getServices();
+
+        $this->assertSame(Constants::STATUS_ON_REQUEST, $services[1]->status);
+        $this->assertSame('unbekannt', $services[2]->status);
+        $this->assertNull($services[3]->status);
+    }
+
+    public function testLeavesTravelLevelStatusUntouched(): void
+    {
+        $xml = '<?xml version="1.0" encoding="utf-8"?>
+<ergebnis>
+    <reise id="12855" status="frei" buchungstatusmoeglich="FOA"/>
+    <leistungen/>
+</ergebnis>';
+
+        $response = $this->parser->parseServices(XmlCrawlerFactory::create($xml));
+
+        $this->assertSame('frei', $response->travelStatus);
+        $this->assertSame(['F', 'O', 'A'], $response->allowedBookingStatus);
+    }
+}

tests/BusProNet/XmlParser/ExtendedAvailabilitiesParserTest.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Tests\BusProNet\XmlParser;
 
+use App\BusProNet\Constants;
 use App\BusProNet\XmlCrawlerFactory;
 use App\BusProNet\XmlParser\ExtendedAvailabilitiesParser;
 use PHPUnit\Framework\TestCase;
@@ -48,6 +49,22 @@ class ExtendedAvailabilitiesParserTest extends TestCase
         $this->assertTrue($availability->mandatory);
     }
 
+    public function testMapsLiveServiceStatusOntoExportVocabulary(): void
+    {
+        $xml = '<?xml version="1.0" encoding="utf-8"?>
+<ergebnis>
+    <leistungen>
+        <leistung id="103" status="buchbar" frei="3" preis="0,00" />
+        <leistung id="104" status="ausgebucht" anfragemoeglich="J" frei="0" preis="0,00" />
+    </leistungen>
+</ergebnis>';
+
+        $services = $this->parser->parseServices(XmlCrawlerFactory::create($xml))->getServices();
+
+        $this->assertSame(Constants::STATUS_AVAILABLE, $services[103]->status);
+        $this->assertSame(Constants::STATUS_BLOCKED, $services[104]->status);
+    }
+
     public function testIgnoresEmptyAgeAndMandatoryAttributes(): void
     {
         $xml = '<?xml version="1.0" encoding="utf-8"?>