Add KiCad API v2, orderdetail export control, EDA status indicator, BOM improvements

- Add KiCad API v2 endpoints (/kicad-api/v2) with volatile field support
  for stock and storage location (shown but not saved to schematic)
- Add kicad_export flag to Orderdetail entity for per-supplier SPN control
  (backward compatible: if no flag set, all SPNs exported as before)
- Add EDA completeness indicator column in parts datatable (bolt icon)
- Add ?minimal=true query param for faster category parts loading
- Improve category descriptions (use comment instead of URL when available)
- Improve BOM importer multi-footprint support: merge entries by Part-DB
  part ID when linked, tracking footprint variants in comments
- Fix KiCost manf/manf# fields always present (not conditional on orderdetails)
- Fix duplicate getEdaInfo() call in shouldPartBeVisible
- Consolidate supplier SPN and KiCost field generation into single loop

src/Controller/KiCadApiController.php

@@ -75,7 +75,8 @@ class KiCadApiController extends AbstractController
         }
         $this->denyAccessUnlessGranted('@parts.read');
 
-        $data = $this->kiCADHelper->getCategoryParts($category);
+        $minimal = $request->query->getBoolean('minimal', false);
+        $data = $this->kiCADHelper->getCategoryParts($category, $minimal);
         return $this->createCachedJsonResponse($request, $data, 300);
     }
 

src/Controller/KiCadApiV2Controller.php

@@ -0,0 +1,104 @@
+<?php
+/*
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ *  Copyright (C) 2019 - 2023 Jan Böhmer (https://github.com/jbtronics)
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as published
+ *  by the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Affero General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Affero General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Entity\Parts\Category;
+use App\Entity\Parts\Part;
+use App\Services\EDA\KiCadHelper;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+
+/**
+ * KiCad HTTP Library API v2 controller.
+ *
+ * Differences from v1:
+ * - Volatile fields: Stock and Storage Location are marked volatile (shown in KiCad but NOT saved to schematic)
+ * - Category descriptions: Uses actual category comments instead of URLs
+ * - Response format: Arrays wrapped in objects for extensibility
+ */
+#[Route('/kicad-api/v2')]
+class KiCadApiV2Controller extends AbstractController
+{
+    public function __construct(
+        private readonly KiCadHelper $kiCADHelper,
+    ) {
+    }
+
+    #[Route('/', name: 'kicad_api_v2_root')]
+    public function root(): Response
+    {
+        $this->denyAccessUnlessGranted('HAS_ACCESS_PERMISSIONS');
+
+        return $this->json([
+            'categories' => '',
+            'parts' => '',
+        ]);
+    }
+
+    #[Route('/categories.json', name: 'kicad_api_v2_categories')]
+    public function categories(Request $request): Response
+    {
+        $this->denyAccessUnlessGranted('@categories.read');
+
+        $data = $this->kiCADHelper->getCategories();
+        return $this->createCachedJsonResponse($request, $data, 300);
+    }
+
+    #[Route('/parts/category/{category}.json', name: 'kicad_api_v2_category')]
+    public function categoryParts(Request $request, ?Category $category): Response
+    {
+        if ($category !== null) {
+            $this->denyAccessUnlessGranted('read', $category);
+        } else {
+            $this->denyAccessUnlessGranted('@categories.read');
+        }
+        $this->denyAccessUnlessGranted('@parts.read');
+
+        $minimal = $request->query->getBoolean('minimal', false);
+        $data = $this->kiCADHelper->getCategoryParts($category, $minimal);
+        return $this->createCachedJsonResponse($request, $data, 300);
+    }
+
+    #[Route('/parts/{part}.json', name: 'kicad_api_v2_part')]
+    public function partDetails(Request $request, Part $part): Response
+    {
+        $this->denyAccessUnlessGranted('read', $part);
+
+        // Use API v2 format with volatile fields
+        $data = $this->kiCADHelper->getKiCADPart($part, true);
+        return $this->createCachedJsonResponse($request, $data, 60);
+    }
+
+    private function createCachedJsonResponse(Request $request, array $data, int $maxAge): Response
+    {
+        $response = new JsonResponse($data);
+        $response->setEtag(md5(json_encode($data)));
+        $response->headers->set('Cache-Control', 'private, max-age=' . $maxAge);
+        $response->isNotModified($request);
+
+        return $response;
+    }
+}