melhorias calibration

Author: dinizime

CLAUDE.md

@@ -23,7 +23,7 @@ npm run dev            # Dev server with auto-restart (--watch)
 npm run migrate        # Import JSON metadata + JPG images into SQLite
 npm run generate-pmtiles  # Generate PMTiles for map markers
 npm run verify         # Validate database integrity
-npm run estimate-slope-roll  # Estimate mesh_rotation_z from elevation data
+npm run estimate-slope-roll  # (Deprecated) Estimate mesh_rotation_z from elevation data
 npm test               # Run tests (node:test built-in)
 npm run lint           # ESLint (--max-warnings 0)
 npm run lint:fix       # ESLint auto-fix
@@ -52,7 +52,7 @@ src/
 scripts/
 ├── migrate.js             # JSON+JPG → SQLite migration (7-phase)
 ├── generate-pmtiles.js    # PMTiles generation for mapping
-├── estimate-slope-roll.js # Estimate mesh_rotation_z from elevation between consecutive photos
+├── estimate-slope-roll.js # (Deprecated) Estimate mesh_rotation_z from elevation
 └── verify.js              # Data validation
 
 public/calibration/        # Calibration web interface
@@ -241,7 +241,7 @@ const imgDb = getProjectDb('alegrete.db');  // Cached per filename
 |-----------|--------|-------|---------|-------------|
 | Heading (Y) | `mesh_rotation_y` | 0–360 | 180 | Yaw correction applied to panorama sphere |
 | Pitch (X) | `mesh_rotation_x` | −30–30 | 0 | Pitch tilt correction |
-| Roll (Z) | `mesh_rotation_z` | −30–30 | 0 | Roll tilt correction (auto-estimated from slope) |
+| Roll (Z) | `mesh_rotation_z` | −30–30 | 0 | Roll tilt correction |
 | Camera height | `camera_height` | 0.1–20 | 2.5 | Height above ground in meters |
 | Distance scale | `distance_scale` | 0.1–5.0 | 1.0 | Multiplier for target distances |
 | Marker scale | `marker_scale` | 0.1–5.0 | 1.0 | Multiplier for navigation marker visual size |
@@ -254,14 +254,21 @@ const imgDb = getProjectDb('alegrete.db');  // Cached per filename
 ### Three.js Rotation Order
 The panorama sphere uses Euler order `ZXY` — matrix `Rz·Rx·Ry` — meaning Y (heading) is applied first to pixels, then X (pitch), then Z (roll) in the corrected frame. Both `viewer.js` (calibration) and `street_view_viewer.js` (ebgeo_web) must use the same order.
 
-### Elevation Delta in Projection
-When both camera and target have `ele` data, the elevation difference `ΔE = target.ele - camera.ele` offsets the target marker vertically: `y = -cameraHeight + ΔE`. This affects marker Y position, flatten ratio, and slant distance for marker sizing. Clamped to ±2m (`MAX_ELEVATION_DELTA`) to protect against GPS noise. When either `ele` is null, `ΔE = 0` (flat ground fallback).
+### Height Model (Flat Ground)
+All markers are projected using a **flat ground model** — GPS elevation (`ele`) is stored but **not used** for projection. The `ele` column is retained in the database and API responses for informational purposes only.
 
-### Slope Roll Estimation
-`scripts/estimate-slope-roll.js` estimates `mesh_rotation_z` (roll) from elevation data between a photo and its `next` target: `θ = atan2(ΔE, distance)`. Slopes beyond `--max-angle` (default 15°, recommended 10°) are **discarded** as GPS noise (set to 0), not clamped. Supports `--dry-run`, `--clear`, `--project <slug>`, `--max-angle <N>`.
+- **GPS targets**: projected onto ground plane at `y = -cameraHeight` (all targets at same level)
+- **Override targets**: projected onto `y = -cameraHeight + overrideHeight` (manual height control)
+- **`override_height`**: relative to camera ground level (0 = ground, positive = above ground)
+- **`camera_height`**: distance from ground to camera lens (default 2.5m)
+
+Both `projector.calculateFlattenRatio()` and `projector.calculateMarkerSize()` accept a `heightOffset` parameter (default 0) used only by override targets via `overrideHeight`.
 
 ### Target Override Projection
-Override markers use a **ground-plane model**: bearing + ground distance + height are projected onto `y = -cameraHeight + overrideHeight` plane, NOT spherical coordinates. Both `navigator.js` (calibration) and `navigation/navigator.js` (ebgeo_web) use `projectFromOverride()` for this. Override markers do **not** use GPS elevation delta — the height is manually controlled via a slider in the calibration UI. When `override_height` is NULL/0, the marker sits on the ground plane exactly where the user clicked.
+Override markers use a **ground-plane model**: bearing + ground distance + height are projected onto `y = -cameraHeight + overrideHeight` plane, NOT spherical coordinates. Both `navigator.js` (calibration) and `navigation/navigator.js` (ebgeo_web) use `projectFromOverride()` for this. When `override_height` is NULL/0, the marker sits on the ground plane exactly where the user clicked.
+
+### Slope Roll Estimation (Deprecated)
+`scripts/estimate-slope-roll.js` previously estimated `mesh_rotation_z` from elevation data. This is deprecated — elevation data is no longer used for projection. The standalone script remains available with a deprecation warning; its `--clear` mode can reset `mesh_rotation_z` to 0.
 
 ## Calibration UI Architecture
 
@@ -318,12 +325,12 @@ app.js (orchestrator)
 
 Migration (`scripts/migrate.js`) processes source data in 7 phases:
 1. Read JSON metadata files from `METADATA/*.json`
-2. Read JPG images from `IMG/*.jpg`
-3. Assign photos to nearest project center by distance
-4. Generate navigation graph (50m radius, 15-degree angular separation)
-5. Convert images to WebP (full + preview sizes)
-6. Write to SQLite databases (index.db + per-project DBs)
-7. Verify data integrity
+2. Assign photos to nearest project center by distance
+3. Compute sequence numbers per project
+4. Generate deterministic UUIDs
+5. Adaptive spatial analysis — navigation graph (sector-based, per-project adaptive radius)
+6. Populate metadata + targets in index.db
+7. Process images into per-project databases (JPG → WebP conversion)
 
 ## Deployment
 

public/calibration/index.html

@@ -449,6 +449,34 @@
             font-size: 11px;
         }
 
+        .cal-panel__btn--icon {
+            background: transparent;
+            border: 1px solid #45475a;
+            color: #a6adc8;
+            padding: 1px 6px;
+            font-size: 11px;
+            font-family: monospace;
+            border-radius: 4px;
+            cursor: pointer;
+            vertical-align: middle;
+            margin-left: 6px;
+        }
+
+        .cal-panel__btn--icon:hover {
+            background: #45475a;
+            color: #cdd6f4;
+        }
+
+        .cal-panel__btn--danger {
+            color: #f38ba8;
+            border-color: #f38ba8;
+        }
+
+        .cal-panel__btn--danger:hover {
+            background: #f38ba8;
+            color: #1e1e2e;
+        }
+
         .cal-panel__btn--ghost {
             background: transparent;
             border: 1px solid #45475a;
@@ -801,6 +829,16 @@
             flex: 1;
         }
 
+        .cal-dialog__actions .cal-panel__btn--destructive {
+            background: #f38ba8;
+            color: #1e1e2e;
+            font-weight: 600;
+        }
+
+        .cal-dialog__actions .cal-panel__btn--destructive:hover {
+            background: #eba0ac;
+        }
+
         /* ================================================================
            REVIEW WORKFLOW — Navigation bar
            ================================================================ */

public/calibration/js/api.js

@@ -336,6 +336,22 @@ export async function createTarget(sourceId, targetId) {
     return response.json();
 }
 
+/**
+ * Soft-deletes a photo (removes from navigation, keeps data for recovery).
+ * @param {string} photoId - Photo UUID
+ * @returns {Promise<Object>} Server response with deletedPhotoId, projectSlug, newPhotoCount
+ */
+export async function deletePhoto(photoId) {
+    const response = await fetch(`${BASE}/photos/${photoId}`, {
+        method: 'DELETE',
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`Failed to delete photo ${photoId} (HTTP ${response.status}): ${text}`);
+    }
+    return response.json();
+}
+
 /**
  * Deletes a manually-created target connection.
  * @param {string} sourceId - Source photo UUID

public/calibration/js/app.js

@@ -10,6 +10,7 @@ import {
     saveTargetOverride, clearTargetOverride,
     setPhotoReviewed, fetchProjectPhotos,
     saveTargetVisibility, fetchNearbyPhotos, createTarget, deleteTargetConnection,
+    deletePhoto,
 } from './api.js';
 import {
     state, isDirty, loadPhoto, discardChanges, markSaved, onChange,
@@ -297,6 +298,7 @@ function initializeSubsystems() {
         onDeleteTarget: handleDeleteTarget,
         onNearbyPreviewToggle: handleNearbyPreviewToggle,
         onNearbySelect: handleNearbySelect,
+        onDeletePhoto: handleDeletePhoto,
     });
 
     // Initialize preview viewer (shows target photo when selected)
@@ -310,14 +312,19 @@ function initializeSubsystems() {
         },
     });
 
-    // Sync minimap target selection and preview viewer with state
+    // Sync minimap target selection and preview viewer with state.
+    // Track last fetched target to avoid re-fetching on every notify (e.g. slider changes).
+    let lastPreviewTargetId = null;
+
     onChange((s) => {
         setSelectedTarget(s.selectedTargetId);
 
-        // Show/hide preview viewer based on selected target
-        if (s.selectedTargetId && s.currentMetadata?.targets) {
+        // Show/hide preview viewer only when the selected target changes
+        if (s.selectedTargetId && s.selectedTargetId !== lastPreviewTargetId && s.currentMetadata?.targets) {
             const target = s.currentMetadata.targets.find(t => t.id === s.selectedTargetId);
             if (target) {
+                lastPreviewTargetId = s.selectedTargetId;
+
                 // Clear nearby preview when selecting a real target
                 clearNearbyPreview();
                 showAddButton(false);
@@ -340,6 +347,7 @@ function initializeSubsystems() {
                 });
             }
         } else if (!s.selectedTargetId) {
+            lastPreviewTargetId = null;
             // Only hide preview if no nearby preview is active
             const { previewingId } = getNearbyPreviewState();
             if (!previewingId) {
@@ -380,6 +388,7 @@ function onSetFromClick(groundOverride) {
     showToast(`Override definido: bearing=${bearingDeg.toFixed(1)}°, dist=${distance.toFixed(1)}m`, 'success');
 }
 
+
 // ============================================================================
 // NAVIGATION
 // ============================================================================
@@ -638,6 +647,81 @@ async function handleDeleteTarget(targetId) {
     }
 }
 
+// ============================================================================
+// DELETE PHOTO (soft-delete)
+// ============================================================================
+
+async function handleDeletePhoto() {
+    const photoId = state.currentPhotoId;
+    const displayName = state.currentMetadata?.camera?.display_name || photoId?.slice(0, 8);
+
+    const confirmed = await showDeletePhotoDialog(displayName);
+    if (!confirmed) return;
+
+    try {
+        const result = await deletePhoto(photoId);
+        showToast(`Foto ${displayName} excluida`, 'success');
+
+        // Refresh project photo list
+        const slug = state.currentProjectSlug || result.projectSlug;
+        if (slug) {
+            await loadProjectContext(slug);
+        }
+
+        // Navigate to previous (or next if at start, or back to projects)
+        const prevId = getPrevPhotoId();
+        const nextId = getNextPhotoId();
+        if (prevId) {
+            startCalibration(prevId);
+        } else if (nextId) {
+            startCalibration(nextId);
+        } else {
+            // No photos left — go back to project selector
+            showProjectSelector();
+        }
+    } catch (err) {
+        console.error('Failed to delete photo:', err);
+        showToast(`Erro ao excluir foto: ${err.message}`, 'error');
+    }
+}
+
+/**
+ * Shows a large destructive confirmation dialog for deleting a photo.
+ * @param {string} displayName - Display name of the photo being deleted
+ * @returns {Promise<boolean>} Whether the user confirmed
+ */
+function showDeletePhotoDialog(displayName) {
+    return new Promise((resolve) => {
+        const overlay = document.createElement('div');
+        overlay.className = 'cal-dialog-overlay';
+        overlay.innerHTML = `
+            <div class="cal-dialog">
+                <h3 class="cal-dialog__title">Excluir foto permanentemente?</h3>
+                <p class="cal-dialog__text">
+                    <strong>${displayName}</strong><br><br>
+                    Todas as conexoes desta foto serao removidas.
+                    Ela nao aparecera mais na navegacao.<br><br>
+                    <em>O PMTiles precisara ser regenerado para remover o ponto do mapa.</em>
+                </p>
+                <div class="cal-dialog__actions">
+                    <button class="cal-panel__btn cal-panel__btn--destructive" data-action="confirm">Excluir</button>
+                    <button class="cal-panel__btn cal-panel__btn--ghost" data-action="cancel">Cancelar</button>
+                </div>
+            </div>
+        `;
+
+        overlay.addEventListener('click', (e) => {
+            const btn = e.target.closest('[data-action]');
+            if (btn) {
+                overlay.remove();
+                resolve(btn.dataset.action === 'confirm');
+            }
+        });
+
+        document.body.appendChild(overlay);
+    });
+}
+
 /**
  * Refreshes targets and nearby photos without reloading the panorama.
  * Preserves the current camera view and calibration edits.
@@ -731,7 +815,7 @@ function onKeyDown(e) {
         }
     }
 
-    // Escape = Deselect target
+    // Escape = Cancel modes / Deselect target
     if (e.key === 'Escape') {
         if (state.setFromClickMode) {
             setSetFromClickMode(false);
@@ -752,8 +836,8 @@ function onKeyDown(e) {
         handleNextPhoto();
     }
 
-    // P or [ = Previous photo
-    if ((e.key === 'p' || e.key === '[') && !e.ctrlKey && !e.metaKey) {
+    // P or [ or Q = Previous photo
+    if ((e.key === 'p' || e.key === '[' || e.key === 'q') && !e.ctrlKey && !e.metaKey) {
         handlePrevPhoto();
     }