acquisitore: calibrazione manuale con mm/px impostato a mano (Refs #95)

POST /camera/calibrazioni/manuale salva una voce senza mappa (metodo manuale);
anteprima/calibrata senza mappa risponde il frame grezzo (X-Raddrizzato: no);
scheda «Calibrazione manuale» nella tab Calibrazione.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scripts/camera_service.py

@@ -29,6 +29,10 @@ Calibrazione a scacchiera (#83, logica in scripts/calibrazione.py).
          calibrated_at, attiva_su}], attiva: nome|null}  (dalla piu' recente)
   POST   /camera/calibrazioni json {calcolo_id, nome, sovrascrivi=false} -> 201
          metadati. 404 calcolo scaduto, 400 nome non valido, 409 nome gia' usato
+  POST   /camera/calibrazioni/manuale json {source, nome, mm_per_px, sovrascrivi=false}
+         -> 201 metadati (#95: mm/px impostato a mano, metodo "manuale", nessuna
+         mappa; non la attiva). 400 mm/px fuori 0.00001..100 o nome non valido,
+         409 nome gia' usato; la risoluzione e' quella del frame tenuto o di un grab
   DELETE /camera/calibrazioni?nome=X -> 204 (toglie anche la mappa e la scollega
          da ogni sorgente) | 404
   PUT    /camera/calibrazione-attiva json {source, nome}: legge un frame dalla
@@ -84,6 +88,7 @@ from __future__ import annotations
 
 import argparse
 import logging
+import math  # #95: mm/px finito nella calibrazione manuale
 import os
 import re  # #92: nome sicuro per le immagini caricate
 import sys
@@ -440,6 +445,35 @@ def create_app(folder: Path | str | None = None,
         except calibrazione.NomeGiaUsato as e:
             raise HTTPException(409, str(e))
 
+    @app.post("/camera/calibrazioni/manuale", status_code=201)
+    def calibrazioni_manuale(corpo: dict = Body(default=None)):
+        """#95: calibrazione con mm/px impostato a mano (nessuna scacchiera, nessuna mappa); NON la attiva."""
+        corpo = corpo if isinstance(corpo, dict) else {}
+        sorgente = _sorgente(corpo.get("source"))
+        mm_px = corpo.get("mm_per_px")
+        if (isinstance(mm_px, bool) or not isinstance(mm_px, (int, float))
+                or not math.isfinite(mm_px) or not 0.00001 <= mm_px <= 100):
+            raise HTTPException(400, "mm/px deve essere un numero positivo")
+        sovrascrivi = corpo.get("sovrascrivi", False)
+        if not isinstance(sovrascrivi, bool):
+            raise HTTPException(400, "«sovrascrivi» deve essere true o false")
+        try:
+            nome = calibrazione.pulisci_nome(corpo.get("nome"))
+        except calibrazione.NomeNonValido as e:
+            raise HTTPException(400, str(e))
+        with lock:
+            frame = grezzi.get(sorgente)
+        if frame is None:  # nessun frame tenuto: un grab come /camera/grab (404/503/504)
+            frame = _grab(sorgente, 5000)
+        alt, larg = frame.shape[:2]  # serve al controllo W×H di PUT /camera/calibrazione-attiva
+        dati = {"px_per_mm": 1.0 / mm_px, "mm_per_px": float(mm_px), "metodo": "manuale",
+                "image_width": larg, "image_height": alt, "origine": sorgente,
+                "calibrated_at": calibrazione.ora_iso(), "rms_px": None, "square_mm": None}
+        try:
+            return archivio.salva_nome(nome, dati, None, sovrascrivi)
+        except calibrazione.NomeGiaUsato as e:
+            raise HTTPException(409, str(e))
+
     @app.delete("/camera/calibrazioni", status_code=204)
     def calibrazioni_elimina(nome: str = ""):
         if not archivio.elimina_nome(nome):
@@ -563,7 +597,7 @@ def create_app(folder: Path | str | None = None,
 
     @app.post("/camera/anteprima/calibrata")
     def camera_anteprima_calibrata(corpo: dict = Body(default=None)):
-        """#92: l'ultimo frame grezzo dell'anteprima, raddrizzato; NON legge un frame nuovo."""
+        """#92: l'ultimo frame grezzo dell'anteprima, raddrizzato; NON legge un frame nuovo. #95: senza mappa esce grezzo (X-Raddrizzato: no)."""
         corpo = corpo if isinstance(corpo, dict) else {}
         nome = _sorgente(corpo.get("source"))
         lato = corpo.get("lato_max", 1280)
@@ -577,14 +611,22 @@ def create_app(folder: Path | str | None = None,
         if attiva is None:
             raise HTTPException(409, "nessuna calibrazione attiva su questa sorgente")
         mappa = archivio.leggi_mappa(nome)
-        if mappa is None:  # planare: ha solo scala, nessuna mappa da applicare
-            raise HTTPException(409, f"la calibrazione «{attiva}» non ha una mappa di correzione (planare)")
-        corretto = calibrazione.raddrizza(frame, mappa)
-        if corretto is None:  # risoluzione diversa da quella calibrata
-            ch, cw = mappa.shape[:2]
+        if mappa is None:  # #95: senza mappa (manuale o planare) solo scala: frame grezzo, nessuna correzione
+            dati = archivio.leggi(nome) or {}
+            cw, ch = dati.get("image_width"), dati.get("image_height")
             alt, larg = frame.shape[:2]
-            raise HTTPException(409, f"la calibrazione «{attiva}» è per immagini {cw}×{ch}, "
-                                     f"il frame è {larg}×{alt}")
+            if isinstance(cw, int) and isinstance(ch, int) and (cw, ch) != (larg, alt):
+                raise HTTPException(409, f"la calibrazione «{attiva}» è per immagini {cw}×{ch}, "
+                                         f"il frame è {larg}×{alt}")
+            corretto, raddrizzato = frame, "no"
+        else:
+            corretto = calibrazione.raddrizza(frame, mappa)
+            if corretto is None:  # risoluzione diversa da quella calibrata
+                ch, cw = mappa.shape[:2]
+                alt, larg = frame.shape[:2]
+                raise HTTPException(409, f"la calibrazione «{attiva}» è per immagini {cw}×{ch}, "
+                                         f"il frame è {larg}×{alt}")
+            raddrizzato = "si"
         alt, larg = corretto.shape[:2]
         if corretto.dtype != np.uint8:  # il JPEG vuole 8 bit
             corretto = _grigio8(corretto)
@@ -596,7 +638,7 @@ def create_app(folder: Path | str | None = None,
         if not ok:
             raise HTTPException(500, "codifica JPEG fallita")
         return Response(buf.tobytes(), media_type="image/jpeg", headers={
-            "X-Raddrizzato": "si", "X-Larghezza": str(larg), "X-Altezza": str(alt),
+            "X-Raddrizzato": raddrizzato, "X-Larghezza": str(larg), "X-Altezza": str(alt),
             "X-Calibrazione": urllib.parse.quote(attiva, safe="")})
 
     @app.get("/camera/parametri")