HP-1751 Create configurations for billing types

src/product/AggregateInterface.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+interface AggregateInterface
+{
+    public function isMax(): bool;
+}

src/product/AggregateNotFoundException.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+use hiqdev\php\billing\Exception\RuntimeException;
+
+class AggregateNotFoundException extends RuntimeException
+{
+}

src/product/BillingRegistry.php

@@ -0,0 +1,134 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+use hiqdev\php\billing\product\invoice\RepresentationInterface;
+use hiqdev\php\billing\product\quantity\QuantityFormatterNotFoundException;
+use hiqdev\php\billing\product\quantity\FractionQuantityData;
+use hiqdev\php\billing\product\behavior\BehaviorInterface;
+use hiqdev\php\billing\product\behavior\BehaviorNotFoundException;
+use hiqdev\php\billing\type\Type;
+use hiqdev\php\billing\type\TypeInterface;
+
+class BillingRegistry implements BillingRegistryInterface
+{
+    /** @var TariffTypeDefinition[] */
+    private array $tariffTypes = [];
+    private bool $locked = false;
+
+    public function addTariffType(TariffTypeDefinition $tariffType): void
+    {
+        if ($this->locked) {
+            throw new \RuntimeException("BillingRegistry is locked and cannot be modified.");
+        }
+
+        $this->tariffTypes[] = $tariffType;
+    }
+
+    public function lock(): void
+    {
+        $this->locked = true;
+    }
+
+    public function priceTypes(): \Generator
+    {
+        foreach ($this->tariffTypes as $tariffType) {
+            foreach ($tariffType->withPrices() as $priceTypeDefinition) {
+                yield $priceTypeDefinition;
+            }
+        }
+    }
+
+    /**
+     * @param string $representationClass
+     * @return RepresentationInterface[]
+     */
+    public function getRepresentationsByType(string $representationClass): array
+    {
+        $representations = [];
+        foreach ($this->priceTypes() as $priceTypeDefinition) {
+            foreach ($priceTypeDefinition->documentRepresentation() as $representation) {
+                if ($representation instanceof $representationClass) {
+                    $representations[] = $representation;
+                }
+            }
+        }
+
+        return $representations;
+    }
+
+    public function createQuantityFormatter(
+        string $type,
+        FractionQuantityData $data,
+    ): array {
+        $type = $this->convertStringTypeToType($type);
+
+        foreach ($this->priceTypes() as $priceTypeDefinition) {
+            if ($priceTypeDefinition->hasType($type)) {
+                return $priceTypeDefinition->createQuantityFormatter($data);
+            }
+        }
+
+        throw new QuantityFormatterNotFoundException('Quantity formatter not found');
+    }
+
+    private function convertStringTypeToType(string $type): TypeInterface
+    {
+        return Type::anyId($type);
+    }
+
+    /**
+     * @param string $type - full type like 'overuse,lb_capacity_unit'
+     * @param string $behaviorClassWrapper
+     * @return BehaviorInterface
+     * @throws BehaviorNotFoundException
+     */
+    public function getBehavior(string $type, string $behaviorClassWrapper): BehaviorInterface
+    {
+        $type = $this->convertStringTypeToType($type);
+
+        foreach ($this->priceTypes() as $priceTypeDefinition) {
+            if ($priceTypeDefinition->hasType($type)) {
+                foreach ($priceTypeDefinition->withBehaviors() as $behavior) {
+                    if ($behavior instanceof $behaviorClassWrapper) {
+                        return $behavior;
+                    }
+                }
+            }
+        }
+
+        throw new BehaviorNotFoundException('Behaviour was not found');
+    }
+
+    public function getBehaviors(string $behaviorClassWrapper): \Generator
+    {
+        foreach ($this->tariffTypes as $tariffType) {
+            foreach ($tariffType->withBehaviors() as $behavior) {
+                if ($behavior instanceof $behaviorClassWrapper) {
+                    yield $behavior;
+                }
+            }
+        }
+
+        foreach ($this->priceTypes() as $priceTypeDefinition) {
+            foreach ($priceTypeDefinition->withBehaviors() as $behavior) {
+                if ($behavior instanceof $behaviorClassWrapper) {
+                    yield $behavior;
+                }
+            }
+        }
+    }
+
+    public function getAggregate(string $type): AggregateInterface
+    {
+        $type = $this->convertStringTypeToType($type);
+
+        foreach ($this->priceTypes() as $priceTypeDefinition) {
+            if ($priceTypeDefinition->hasType($type)) {
+                return $priceTypeDefinition->getAggregate();
+            }
+        }
+
+        throw new AggregateNotFoundException('Aggregate was not found');
+    }
+}

src/product/BillingRegistryInterface.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+use hiqdev\php\billing\product\price\PriceTypeDefinition;
+
+interface BillingRegistryInterface
+{
+    /**
+     * @return PriceTypeDefinition[]
+     */
+    public function priceTypes(): \Generator;
+}

src/product/DocumentRepresentationInterface.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+interface DocumentRepresentationInterface
+{
+
+}

src/product/Domain/Model/TariffTypeInterface.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product\Domain\Model;
+
+interface TariffTypeInterface
+{
+
+}

src/product/Domain/Model/Unit/FractionUnitInterface.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product\Domain\Model\Unit;
+
+interface FractionUnitInterface
+{
+
+}

src/product/Domain/Model/Unit/UnitInterface.php

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product\Domain\Model\Unit;
+
+use \hiqdev\php\units\UnitInterface as BaseUnitInterface;
+
+interface UnitInterface
+{
+    public function createExternalUnit(): BaseUnitInterface;
+
+    public function fractionUnit(): FractionUnitInterface;
+}

src/product/GTypeInterface.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+interface GTypeInterface
+{
+    public function name(): string;
+
+    public function equals(GTypeInterface $otherGType): bool;
+}

src/product/InvoiceDescriptionsBuilder.php

@@ -0,0 +1,23 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+class InvoiceDescriptionsBuilder
+{
+    private BillingRegistry $registry;
+
+    public function __construct(BillingRegistry $registry)
+    {
+        $this->registry = $registry;
+    }
+
+    public function build(): array
+    {
+        $descriptions = [];
+        foreach ($this->registry->priceTypes() as $priceType) {
+            $descriptions[] = $priceType->representInvoice();
+        }
+
+        return $descriptions;
+    }
+}

src/product/ParentNodeDefinitionInterface.php

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+use hiqdev\php\billing\product\behavior\BehaviorCollectionInterface;
+
+interface ParentNodeDefinitionInterface
+{
+    public function withBehaviors(): BehaviorCollectionInterface;
+
+    public function hasBehavior(string $behaviorClassName): bool;
+}

src/product/ProductInterface.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+interface ProductInterface
+{
+    public function toProductName(): string;
+
+    public function label(): string;
+}

src/product/TariffTypeDefinition.php

@@ -0,0 +1,68 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+use hiqdev\php\billing\product\behavior\BehaviorTariffTypeCollection;
+use hiqdev\php\billing\product\Domain\Model\TariffTypeInterface;
+use hiqdev\php\billing\product\price\PriceTypeDefinitionCollection;
+use hiqdev\php\billing\product\price\PriceTypeDefinitionFactory;
+
+class TariffTypeDefinition implements TariffTypeDefinitionInterface
+{
+    private ProductInterface $product;
+
+    private PriceTypeDefinitionCollection $prices;
+
+    private BehaviorTariffTypeCollection $behaviorCollection;
+
+    public function __construct(private readonly TariffTypeInterface $tariffType)
+    {
+        $this->prices = new PriceTypeDefinitionCollection($this, new PriceTypeDefinitionFactory());
+        $this->behaviorCollection = new BehaviorTariffTypeCollection($this, $tariffType);
+    }
+
+    public function tariffType(): TariffTypeInterface
+    {
+        return $this->tariffType;
+    }
+
+    public function ofProduct(ProductInterface $product): TariffTypeDefinitionInterface
+    {
+        $this->product = $product;
+
+        return $this;
+    }
+
+    public function setPricesSuggester(string $suggesterClass): TariffTypeDefinitionInterface
+    {
+        // Validate or store the suggester class
+        return $this;
+    }
+
+    public function withPrices(): PriceTypeDefinitionCollection
+    {
+        return $this->prices;
+    }
+
+    public function withBehaviors(): BehaviorTariffTypeCollection
+    {
+        return $this->behaviorCollection;
+    }
+
+    public function hasBehavior(string $behaviorClassName): bool
+    {
+        foreach ($this->behaviorCollection as $behavior) {
+            if ($behavior instanceof $behaviorClassName) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    public function end(): TariffTypeDefinitionInterface
+    {
+        // Validate the TariffType and lock its state
+        return $this;
+    }
+}

src/product/TariffTypeDefinitionFactory.php

@@ -0,0 +1,11 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+class TariffTypeDefinitionFactory
+{
+    public static function create(TariffTypeInterface $tariffType): TariffTypeDefinition
+    {
+        return new TariffTypeDefinition($tariffType);
+    }
+}

src/product/TariffTypeDefinitionInterface.php

@@ -0,0 +1,26 @@
+<?php declare(strict_types=1);
+
+namespace hiqdev\php\billing\product;
+
+use hiqdev\php\billing\product\Domain\Model\TariffTypeInterface;
+use hiqdev\php\billing\product\price\PriceTypeDefinitionCollectionInterface;
+
+/**
+ * @template T of PriceTypeDefinitionCollectionInterface
+ */
+interface TariffTypeDefinitionInterface extends ParentNodeDefinitionInterface
+{
+    public function tariffType(): TariffTypeInterface;
+
+    public function ofProduct(ProductInterface $product): self;
+
+    public function setPricesSuggester(string $suggesterClass): self;
+
+    /**
+     * @return PriceTypeDefinitionCollectionInterface
+     * @psalm-return T
+     */
+    public function withPrices(): PriceTypeDefinitionCollectionInterface;
+
+    public function end(): static;
+}