Add price columns to project BOM table and build price summary (#1345)

* Add unit price and extended price columns to project BOM table

Adds two optional columns to the project BOM datatable (hidden by
default, toggleable via column visibility):

- **Price**: unit price for the BOM entry in the base currency,
  looked up via PricedetailHelper. For parts whose BOM quantity falls
  below the minimum order amount the minimum order amount is used for
  the price tier lookup so that a price is always returned.
- **Extended Price**: unit price multiplied by the BOM quantity.

Prices are rendered via MoneyFormatter (locale-aware, with currency
symbol). Both columns round up to 2 decimal places to avoid displaying
0.00 for very small prices.

* Add translation key for project.bom.ext_price

Adds the English translation "Extended Price" for the new BOM extended
price column. Other languages are marked needs-translation and will be
picked up by Crowdin.

* Add build price summary to project info tab

Displays the total BOM price for N builds on the project info page,
using the existing price-tier logic from PricedetailHelper. The user
can adjust the number of builds via a small form; the unit price is
also shown when N > 1.

New backend:
- ProjectBuildHelper gains calculateTotalBuildPrice(),
  calculateUnitBuildPrice(), roundedTotalBuildPrice(), and
  roundedUnitBuildPrice() — bulk-order quantities are factored in so
  that price tiers apply correctly across N builds.
- ProjectController::info() now reads ?n= and passes number_of_builds
  to the template.

Template (_info.html.twig):
- Adds price badge (hidden when no pricing data is available).
- Adds number-of-builds form that reloads the info page.

* Add tests for build price calculation in ProjectBuildHelper

Covers calculateTotalBuildPrice(), calculateUnitBuildPrice(),
roundedTotalBuildPrice(), and the private getBomEntryUnitPrice()
helper. Scenarios tested: empty project, no pricing data, non-part BOM
entries with manual prices, part entries with pricedetails, mixed
entries, rounding-up of sub-cent prices, and minimum order amount
floor for price tier lookup.

* Deduplicate BOM entry price logic into ProjectBuildHelper

The private getBomEntryUnitPrice() in ProjectBomEntriesDataTable was
identical to the one in ProjectBuildHelper. Replaced it with a new
public getEntryUnitPrice() on ProjectBuildHelper (returns BigDecimal,
never null) and delegate to it from the DataTable.

This eliminates the duplicate code and brings the DataTable lines under
the existing ProjectBuildHelper test coverage. Added three tests for
getEntryUnitPrice() covering the no-pricing, non-part, and part cases.

* Added type hint to service

---------

Co-authored-by: Jan Böhmer <mail@jan-boehmer.de>

src/Controller/ProjectController.php

@@ -69,10 +69,13 @@ class ProjectController extends AbstractController
             return $table->getResponse();
         }
 
+        $number_of_builds = max(1, $request->query->getInt('n', 1));
+
         return $this->render('projects/info/info.html.twig', [
             'buildHelper' => $buildHelper,
             'datatable' => $table,
             'project' => $project,
+            'number_of_builds' => $number_of_builds,
         ]);
     }
 

src/DataTables/ProjectBomEntriesDataTable.php

@@ -29,12 +29,15 @@ use App\DataTables\Column\LocaleDateTimeColumn;
 use App\DataTables\Column\MarkdownColumn;
 use App\DataTables\Helpers\PartDataTableHelper;
 use App\Doctrine\Helpers\FieldHelper;
-use App\Entity\Parts\Part;
 use App\Entity\Parts\ManufacturingStatus;
+use App\Entity\Parts\Part;
 use App\Entity\ProjectSystem\ProjectBOMEntry;
 use App\Services\ElementTypeNameGenerator;
 use App\Services\EntityURLGenerator;
 use App\Services\Formatters\AmountFormatter;
+use App\Services\Formatters\MoneyFormatter;
+use App\Services\ProjectSystem\ProjectBuildHelper;
+use Brick\Math\RoundingMode;
 use Doctrine\ORM\AbstractQuery;
 use Doctrine\ORM\Query;
 use Doctrine\ORM\QueryBuilder;
@@ -50,7 +53,9 @@ class ProjectBomEntriesDataTable implements DataTableTypeInterface
         protected EntityURLGenerator $entityURLGenerator,
         protected TranslatorInterface $translator,
         protected AmountFormatter $amountFormatter,
-        protected PartDataTableHelper $partDataTableHelper
+        protected PartDataTableHelper $partDataTableHelper,
+        protected ProjectBuildHelper $projectBuildHelper,
+        protected MoneyFormatter $moneyFormatter,
     ) {
     }
 
@@ -202,6 +207,27 @@ class ProjectBomEntriesDataTable implements DataTableTypeInterface
                     return '';
                 }
             ])
+            ->add('price', TextColumn::class, [
+                'label' => 'project.bom.price',
+                'visible' => false,
+                'render' => function ($value, ProjectBOMEntry $context) {
+                    $price = $this->projectBuildHelper->getEntryUnitPrice($context);
+                    return $this->moneyFormatter->format($price->toScale(2, RoundingMode::UP)->toFloat(), null, 2, true);
+                },
+            ])
+            ->add('ext_price', TextColumn::class, [
+                'label' => 'project.bom.ext_price',
+                'visible' => false,
+                'render' => function ($value, ProjectBOMEntry $context) {
+                    $price = $this->projectBuildHelper->getEntryUnitPrice($context);
+                    return $this->moneyFormatter->format(
+                        $price->multipliedBy($context->getQuantity())->toScale(2, RoundingMode::UP)->toFloat(),
+                        null,
+                        2,
+                        true
+                    );
+                },
+            ])
 
             ->add('addedDate', LocaleDateTimeColumn::class, [
                 'label' => $this->translator->trans('part.table.addedDate'),

src/Services/ProjectSystem/ProjectBuildHelper.php

@@ -25,16 +25,22 @@ namespace App\Services\ProjectSystem;
 use App\Entity\Parts\Part;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\ProjectSystem\ProjectBOMEntry;
+use App\Entity\PriceInformations\Currency;
 use App\Helpers\Projects\ProjectBuildRequest;
 use App\Services\Parts\PartLotWithdrawAddHelper;
+use App\Services\Parts\PricedetailHelper;
+use Brick\Math\BigDecimal;
+use Brick\Math\RoundingMode;
 
 /**
  * @see \App\Tests\Services\ProjectSystem\ProjectBuildHelperTest
  */
 final readonly class ProjectBuildHelper
 {
-    public function __construct(private PartLotWithdrawAddHelper $withdraw_add_helper)
-    {
+    public function __construct(
+        private PartLotWithdrawAddHelper $withdraw_add_helper,
+        private PricedetailHelper $pricedetailHelper,
+    ) {
     }
 
     /**
@@ -168,4 +174,81 @@ final readonly class ProjectBuildHelper
             $this->withdraw_add_helper->add($buildRequest->getBuildsPartLot(), $buildRequest->getNumberOfBuilds(), $message);
         }
     }
+
+    /**
+     * Calculates the total price to build the given project N times, taking bulk pricing into account.
+     * Returns null if no BOM entry has any pricing information.
+     */
+    public function calculateTotalBuildPrice(Project $project, int $number_of_builds = 1, ?Currency $currency = null): ?BigDecimal
+    {
+        $total = BigDecimal::zero();
+        $has_price = false;
+
+        foreach ($project->getBomEntries() as $entry) {
+            $unit_price = $this->getBomEntryUnitPrice($entry, $number_of_builds, $currency);
+            if ($unit_price === null) {
+                continue;
+            }
+            $has_price = true;
+            $total = $total->plus($unit_price->multipliedBy($entry->getQuantity())->multipliedBy($number_of_builds));
+        }
+
+        return $has_price ? $total : null;
+    }
+
+    /**
+     * Calculates the price to build one unit of the given project when ordering for N builds in total.
+     * Returns null if no BOM entry has any pricing information.
+     */
+    public function calculateUnitBuildPrice(Project $project, int $number_of_builds = 1, ?Currency $currency = null): ?BigDecimal
+    {
+        $total = $this->calculateTotalBuildPrice($project, $number_of_builds, $currency);
+        if ($total === null) {
+            return null;
+        }
+        return $total->dividedBy($number_of_builds, 10, RoundingMode::HALF_UP);
+    }
+
+    /**
+     * Returns the total build price rounded up to 2 decimal places, ready for display.
+     */
+    public function roundedTotalBuildPrice(Project $project, int $number_of_builds = 1, ?Currency $currency = null): ?BigDecimal
+    {
+        return $this->calculateTotalBuildPrice($project, $number_of_builds, $currency)
+            ?->toScale(2, RoundingMode::UP);
+    }
+
+    /**
+     * Returns the unit build price rounded up to 2 decimal places, ready for display.
+     */
+    public function roundedUnitBuildPrice(Project $project, int $number_of_builds = 1, ?Currency $currency = null): ?BigDecimal
+    {
+        return $this->calculateUnitBuildPrice($project, $number_of_builds, $currency)
+            ?->toScale(2, RoundingMode::UP);
+    }
+
+    /**
+     * Returns the effective unit price for a single piece of the given BOM entry,
+     * taking bulk pricing and minimum order amounts into account for N builds.
+     * Returns BigDecimal::zero() when no pricing data is available.
+     */
+    public function getEntryUnitPrice(ProjectBOMEntry $entry, int $number_of_builds = 1, ?Currency $currency = null): BigDecimal
+    {
+        return $this->getBomEntryUnitPrice($entry, $number_of_builds, $currency) ?? BigDecimal::zero();
+    }
+
+    /**
+     * Returns the effective unit price for a single piece of the given BOM entry,
+     * taking bulk pricing into account for N builds.
+     */
+    private function getBomEntryUnitPrice(ProjectBOMEntry $entry, int $number_of_builds, ?Currency $currency): ?BigDecimal
+    {
+        if ($entry->getPart() instanceof Part) {
+            $total_qty = $entry->getQuantity() * $number_of_builds;
+            $min_order = $this->pricedetailHelper->getMinOrderAmount($entry->getPart());
+            $effective_qty = ($min_order !== null) ? max($total_qty, $min_order) : $total_qty;
+            return $this->pricedetailHelper->calculateAvgPrice($entry->getPart(), $effective_qty, $currency);
+        }
+        return $entry->getPrice();
+    }
 }