signalk-mareas-ihm 1.3.0 → 2.0.0

package/README.md

@@ -6,277 +6,172 @@
 
 ## Español
 
-Plugin de Signal K para **predicción de mareas en España** usando datos oficiales del **IHM (Instituto Hidrográfico de la Marina)**.
+Plugin de Signal K para **predicción de mareas en España** usando datos oficiales del **IHM (Instituto Hidrográfico de la Marina)**, con **Visor de Fondeo** integrado, alarmas inteligentes y soporte para domótica.
 
-### Características
+### Características principales
 
+#### Mareas
 - **Predicción de mareas** automática por GPS o selección manual de estación
-- **Aplicación con interfaz visual (WebApp)** integrada en Signal K: consulta mareas, curvas de marea interactivas, selección de estación y configuración de alarmas
-- **Alarma de varada** configurable con aviso anticipado, sonido silenciable y estados visuales (compatible con KIP, OpenPlotter, etc.)
-- **Caché offline** de al menos 2 meses de predicciones
+- **Curvas de marea interactivas** con HAT/LAT anuales, cursor interactivo y etiquetas de pleamar/bajamar
+- **Coeficientes oficiales IHM** con descarga automática
 - **Consejo táctico** para las Rías Baixas (experimental)
-- **Bilingüe**: interfaz en español e inglés
-
-### Modos de funcionamiento
+- **Caché offline** de al menos 2 meses de predicciones
 
-| Modo | Descripción |
-|---|---|
-| **AUTOMÁTICO** (por defecto) | Detecta la estación IHM más cercana por GPS. Si no hay GPS al arrancar, usa **Vigo** como estación por defecto hasta que llegue señal. |
-| **MANUAL** | Selección libre de cualquier estación IHM. |
+#### Visor de Fondeo
+- **Mapa Leaflet** con posición GPS en tiempo real y capas múltiples (ESRI, Bing, Google, IHM S-52, SonarChart, MBTiles offline)
+- **Anchor Watch** con alarma de garreo visual y sonora
+- **Cadena largada** con slider bidireccional y cálculo automático
+- **Radio de borneo y alarma** con etiquetas en la carta
+- **Sincronización multi-dispositivo** en tiempo real (SSE)
+
+#### AIS Inteligente
+- **Detección de colisión** con targets AIS en zona de borneo
+- **ACK por target individual** — silencia alarma de un barco sin desactivar la alarma general
+- **Detección de garreo ajeno** — si un target ACKed se acerca >2m/min, la alarma se reactiva
+- **Estimación de ancla** de otros barcos mediante análisis de track (centroide + radio máximo)
+- **Anillos de colisión persistentes** en la carta
+
+#### Alarmas Inteligentes
+- **Alarma de varada** solo cuando el barco está parado (SOG < 0.5kn)
+- **Detección de sonda** congelada, inestable, fuera de rango
+- **Alarmas independientes** de garreo, AIS y sonda con control individual
+- **Previsión meteorológica** integrada (Open-Meteo) con múltiples modelos
+
+#### Domótica / KIP
+- **Botones KIP** para fondear/levar y activar/desactivar alarmas
+- **Endpoints REST** para Alexa, Google Home, Node-RED, MQTT
+- **Endpoint toggle** para mandos a distancia con un solo botón
+
+#### Bilingüe completo
+- Interfaz en **español e inglés** en todas las vistas
+- Idioma sincronizado entre Landing, Mareas y Visor de Fondeo
+- Banderas de idioma en la barra inferior del visor
+
+### URLs
+
+| URL | Función |
+|-----|---------|
+| `/signalk-mareas-ihm/` | Landing — selector Mareas / Visor de Fondeo |
+| `/signalk-mareas-ihm/mareas` | Vista de Mareas (directo) |
+| `/signalk-mareas-ihm/visorfondeo` | Visor de Fondeo (directo) |
+
+### Domótica — Endpoints REST
 
-### Paths publicados
+```bash
+# Fondear/Levar con un solo botón
+curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/toggle
 
-En `vessels.self.environment.tide.*`:
+# Fondear en posición GPS actual
+curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/drop
 
-| Path | Descripción |
-|---|---|
-| `environment.tide.heightNow` | Altura actual de la marea (m) |
-| `environment.tide.heightNextHigh` | Próxima pleamar (m) |
-| `environment.tide.heightNextLow` | Próxima bajamar (m) |
-| `environment.tide.tendency` | Subiendo / Bajando |
-| `environment.tide.percentage` | Porcentaje del ciclo (0–100) |
-| `environment.tide.stationName` | Estación activa |
-| `environment.tide.coef` | Coeficiente de marea |
-| `environment.tide.vessel.draftEffective` | Calado efectivo (calado + margen × 1.15) |
-| `environment.tide.vessel.groundingRisk` | Riesgo de varada (true/false) |
-| `environment.tide.vessel.groundingStatus` | Estado físico |
-| `environment.tide.vessel.finalExpctDepthBKeel` | Sonda mínima esperada |
+# Levar ancla
+curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/lift
 
-La lista completa está disponible en **INSTRUCCIONES** dentro de la WebApp.
+# Estado simple (para monitorización)
+curl http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/simple
+```
 
-### Requisitos
+### KIP — Paths para Boolean Control
 
-- Signal K Server ≥ 2.x
-- Node.js ≥ 18
-- `navigation.position` (GPS) para detección automática de estación (opcional: funciona sin GPS usando estación por defecto)
+| Path | Función |
+|------|---------|
+| `environment.anchor.mareasIhm.anchorCommand` | Fondear (true) / Levar (false) |
+| `environment.anchor.mareasIhm.garreoAlarmCommand` | Alarma garreo ON/OFF |
+| `environment.anchor.mareasIhm.aisAlarmCommand` | Alarma AIS ON/OFF |
 
 ### Instalación
 
-**Desde la App Store de Signal K** (recomendado): busca "Mareas" o "IHM".
-
-**Manual:**
-
 ```bash
+cd /home/pi
+unzip -o signalk-mareas-ihm_v1.3.1_RevXX.zip
+cd signalk-mareas-ihm
+npm install && npm run build && npm pack
 cd ~/.signalk
-npm install signalk-mareas-ihm
-# Reiniciar Signal K
+npm install /home/pi/signalk-mareas-ihm/signalk-mareas-ihm-1.3.1.tgz --save
+sudo systemctl restart signalk
 ```
 
-### Configuración
-
-En *Server → Plugin Config*:
-
-- **IHM base URL**: URL del servicio IHM
-- **Refresco caché (horas)**: por defecto 48 h
-- **Frecuencia de actualización**: minutos entre actualizaciones
-
-El calado del barco se lee automáticamente de Signal K (`design.draft`) o se puede configurar desde la WebApp (ventana ALARMA → margen de seguridad).
-
-### Changelog
-
-#### v1.3.0
-- **Visor de Fondeo**: nueva página independiente `/mapafondeo` con mapa Leaflet a pantalla completa.
-  - Icono de barco SVG cenital con escala real según `design.length` / `design.beam` y rotación por heading/COG. A zoom bajo se sustituye por diana roja.
-  - Línea cadena proa→ancla con rumbo y distancia en tiempo real.
-  - Círculos dinámicos: borneo (azul) y alarma (rojo) con etiquetas de metros permanentes.
-  - Sliders de radio borneo y alarma ajustables en caliente.
-  - Marcador de ancla ⚓ arrastrable con actualización inmediata de círculos.
-  - Track GPS con historial de 3000 puntos.
-  - Targets AIS cercanos (diferencia estáticos vs dinámicos).
-  - Detección de `@signalk/tracks-plugin` con popup recomendación.
-  - Botón meteo → Open-Meteo con temperatura, viento, presión, precipitación.
-  - Capas: OSM, OpenSeaMap, MBTiles con slider de transparencia individual.
-  - Historial últimas 5 posiciones del ancla con fecha/hora.
-  - Favicon, botón volver a Mareas IHM, copyright OSM/OpenSeaMap.
-  - Escala gráfica dinámica (metros).
-- **Cartas MBTiles**: servidor de tiles integrado (better-sqlite3) para cartas raster. Selector de carpeta (default `/home/pi/charts`), checkboxes + opacidad por carta.
-- **Alarma de Garreo**: evaluación cada 5s distancia barco-ancla. Radio alarma = swingRadiusMax + margen ajustable (slider 1-50m). Notificación Signal K estándar.
-- **Cadena editable**: clic en caja Cadena para introducir metros reales largados, persiste en backend, sincroniza con Visor.
-- **Paths Signal K nuevos**: `watchEnabled`, `anchorLat`, `anchorLon`, `distanceToAnchor`, `alarmRadius`, `dragging`.
-- **Layout mejorado**: grid auto-fill sin scroll, cajas expandidas al espacio disponible.
-
-#### v1.2.1
-- **UI Fondeo renovada**: cajas resultado con títulos uniformes 14px, Cadena y Profundidad en naranja, Estado Marea muestra resumen, Status Profundidad con estado varada, Publicar SK en barra verde.
-- **Config overlay**: panel configuración se superpone sin scroll, con botón Calcular naranja.
-- **Botones 170px**: todos los botones de la barra principal ampliados.
-- **Fix alarma**: notificaciones OpenPlotter se limpian correctamente (state:normal).
-- **Fix hBow**: corregido borrado de altura de roldana.
-- **Fix Publicar SK**: estado persistente entre reinicios.
-
-#### v1.2.0
-- ⚓ **Calculadora de fondeo**: nueva pestaña FONDEO con modelo de scope náutico. Cadena recomendada, radio de borneo, publicación opcional en Signal K (`environment.anchor.mareasIhm.*`).
-- 🔇 **Fix notificaciones**: la alarma de varada suena una sola vez (antes se repetía cada 60s).
-- 📡 **Arranque sin GPS/Internet**: lista hardcoded de todas las estaciones IHM españolas. Siempre hay estaciones disponibles para elegir.
-- 📋 **Nuevos paths FONDEO**: nuevos paths publicados en Signal K relacionados con la función FONDEO.
-- 🔍 **Tamaño estable al Zoom**: la interfaz siempre llena la ventana al 100% por defecto, sin encogerse al reducir o ampliar el zoom del navegador.
-
-#### v1.1.1
-- Coeficientes IHM oficiales con auto-descarga del PDF. Elimina el "dato bailante".
-- Fix zona horaria: coeficiente usa hora local española (no UTC).
-- Fix ESM `__dirname` para módulos ES.
-
-#### v1.1.0
-- Alarma de varada: aviso 24h, anticipada, snooze, silenciar sonido.
-- Curvas de marea interactivas (SVG).
-- Bilingüe ES/EN completo.
-- Salida/Puesta sol (integración Derived Data).
-- Consejo táctico Rías Baixas (experimental).
-
-#### v1.0.0
-- Versión inicial: datos IHM, AUTO/MANUAL, paths Signal K.
-
-### Créditos y licencia
-
-Licencia Apache 2.0. Derivado originalmente de `signalk-tides` (Brandon Keepers, Joachim Bakke, Scott Bender y contribuidores). Véase `NOTICE` para detalles de atribución.
-
-📧 Contacto: **tradesolutions@gmail.com** (indicar "MAREAS (IHM)" en el asunto)
-
 ---
 
 ## English
 
-Signal K plugin for **tide predictions in Spain** using official data from the **IHM (Instituto Hidrográfico de la Marina — Spanish Navy Hydrographic Institute)**.
+Signal K plugin for **Spanish tide predictions** using official data from **IHM (Instituto Hidrográfico de la Marina)**, with integrated **Anchor Watch Viewer**, smart alarms and home automation support.
 
-### Features
+### Main Features
 
+#### Tides
 - **Automatic tide prediction** by GPS or manual station selection
-- **Visual WebApp** integrated in Signal K: view tides, interactive tide curves, station selection and alarm configuration
-- **Grounding alarm** with advance warning, mutable sound and visual states (compatible with KIP, OpenPlotter, etc.)
-- **Offline cache** of at least 2 months of predictions
+- **Interactive tide curves** with annual HAT/LAT, interactive cursor and high/low tide labels
+- **Official IHM coefficients** with automatic download
 - **Tactical advice** for the Rías Baixas (experimental)
-- **Bilingual**: Spanish and English interface
-
-### Operating modes
-
-| Mode | Description |
-|---|---|
-| **AUTOMATIC** (default) | Picks the nearest IHM station by GPS. If no GPS is available at startup, defaults to **Vigo** until a fix arrives. |
-| **MANUAL** | Freely pick any IHM station. |
-
-### Published paths
+- **Offline cache** of at least 2 months of predictions
 
-Under `vessels.self.environment.tide.*`:
+#### Anchor Watch Viewer
+- **Leaflet map** with real-time GPS position and multiple layers (ESRI, Bing, Google, IHM S-52, SonarChart, offline MBTiles)
+- **Anchor Watch** with visual and audible drag alarm
+- **Chain deployed** with bidirectional slider and automatic calculation
+- **Swing and alarm radius** with chart labels
+- **Multi-device real-time sync** (SSE)
+
+#### Smart AIS
+- **Collision detection** with AIS targets in swing zone
+- **Per-target ACK** — silence alarm for one boat without disabling the general alarm
+- **External dragging detection** — if an ACKed target approaches >2m/min, alarm reactivates
+- **Anchor estimation** for other boats via track analysis (centroid + max radius)
+- **Persistent collision rings** on chart
+
+#### Smart Alarms
+- **Grounding alarm** only when boat is stopped (SOG < 0.5kn)
+- **Sounder detection** for frozen, unstable, out-of-range readings
+- **Independent alarms** for drag, AIS and depth with individual control
+- **Weather forecast** integrated (Open-Meteo) with multiple models
+
+#### Home Automation / KIP
+- **KIP buttons** for drop/lift and alarm enable/disable
+- **REST endpoints** for Alexa, Google Home, Node-RED, MQTT
+- **Toggle endpoint** for single-button remote controls
+
+#### Full Bilingual
+- Interface in **Spanish and English** across all views
+- Language synced between Landing, Tides and Anchor Watch Viewer
+- Language flags in the viewer's bottom bar
+
+### URLs
+
+| URL | Function |
+|-----|----------|
+| `/signalk-mareas-ihm/` | Landing — Tides / Anchor Watch selector |
+| `/signalk-mareas-ihm/mareas` | Tides view (direct) |
+| `/signalk-mareas-ihm/visorfondeo` | Anchor Watch Viewer (direct) |
+
+### Home Automation — REST Endpoints
 
-| Path | Description |
-|---|---|
-| `environment.tide.heightNow` | Current tide height (m) |
-| `environment.tide.heightNextHigh` | Next high water (m) |
-| `environment.tide.heightNextLow` | Next low water (m) |
-| `environment.tide.tendency` | Rising / Falling |
-| `environment.tide.percentage` | Tide cycle percentage (0–100) |
-| `environment.tide.stationName` | Active station |
-| `environment.tide.coef` | Tidal coefficient |
-| `environment.tide.vessel.draftEffective` | Effective draft (draft + margin × 1.15) |
-| `environment.tide.vessel.groundingRisk` | Grounding risk (true/false) |
-| `environment.tide.vessel.groundingStatus` | Physical state |
-| `environment.tide.vessel.finalExpctDepthBKeel` | Expected minimum depth under keel |
+```bash
+# Drop/Lift with single button
+curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/toggle
 
-The full list is available under **INSTRUCTIONS** in the WebApp.
+# Drop anchor at current GPS
+curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/drop
 
-### Requirements
+# Lift anchor
+curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/lift
 
-- Signal K Server ≥ 2.x
-- Node.js ≥ 18
-- `navigation.position` (GPS) for automatic station detection (optional: works without GPS using a default station)
+# Simple status (for monitoring)
+curl http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/simple
+```
 
 ### Installation
 
-**From the Signal K App Store** (recommended): search for "Mareas" or "IHM".
-
-**Manual:**
-
 ```bash
+cd /home/pi
+unzip -o signalk-mareas-ihm_v1.3.1_RevXX.zip
+cd signalk-mareas-ihm
+npm install && npm run build && npm pack
 cd ~/.signalk
-npm install signalk-mareas-ihm
-# Restart Signal K
+npm install /home/pi/signalk-mareas-ihm/signalk-mareas-ihm-1.3.1.tgz --save
+sudo systemctl restart signalk
 ```
 
-### Configuration
-
-In *Server → Plugin Config*:
-
-- **IHM base URL**: IHM service URL
-- **Cache refresh (hours)**: default 48 h
-- **Update frequency**: minutes between updates
-
-Vessel draft is read automatically from Signal K (`design.draft`) or can be configured from the WebApp (ALARM window → safety margin).
-
-### Changelog
-
-#### v1.3.0
-- **Anchor Map Viewer**: new standalone `/mapafondeo` page with full-screen Leaflet map.
-  - Cenital sailboat SVG icon scaled to real `design.length`/`design.beam`, heading rotation. Falls back to red target at low zoom.
-  - Chain line bow→anchor with bearing and real-time distance.
-  - Dynamic circles: swing (blue) and alarm (red) with permanent meter labels.
-  - Adjustable sliders for swing and alarm radius.
-  - Draggable anchor ⚓ marker with instant circle update.
-  - GPS track (3000 points), AIS targets, OpenSeaMap overlay.
-  - Tracks-plugin detection with install recommendation popup.
-  - Meteo button → Open-Meteo (temperature, wind, pressure, rain).
-  - MBTiles charts with per-layer opacity slider.
-  - Last 5 anchor positions history with timestamps.
-- **MBTiles Charts**: integrated tile server (better-sqlite3) for raster charts. Folder selector, per-chart opacity control.
-- **Anchor Drag Alarm**: 5-second evaluation. Alarm radius = swingRadiusMax + adjustable margin (1-50m slider). Standard Signal K notification.
-- **Editable Chain**: click chain box to enter actual deployed meters, persisted in backend, synced to Viewer.
-- **New Signal K paths**: `watchEnabled`, `anchorLat`, `anchorLon`, `distanceToAnchor`, `alarmRadius`, `dragging`.
-- **Improved layout**: auto-fill grid, no scroll, boxes expand to fill available space.
-
-#### v1.2.1
-- **UI Fondeo renovada**: cajas resultado con títulos uniformes 14px, Cadena y Profundidad en naranja, Estado Marea muestra resumen, Status Profundidad con estado varada, Publicar SK en barra verde.
-- **Config overlay**: panel configuración se superpone sin scroll, con botón Calcular naranja.
-- **Botones 170px**: todos los botones de la barra principal ampliados.
-- **Fix alarma**: notificaciones OpenPlotter se limpian correctamente (state:normal).
-- **Fix hBow**: corregido borrado de altura de roldana.
-- **Fix Publicar SK**: estado persistente entre reinicios.
-
-#### v1.2.0
-- ⚓ **Anchoring calculator**: new ANCHOR tab with nautical scope model. Recommended chain, swing radius, optional Signal K publication (`environment.anchor.mareasIhm.*`).
-- 🔇 **Notification fix**: grounding alarm sounds once (previously repeated every 60s).
-- 📡 **Startup without GPS/Internet**: hardcoded list of all Spanish IHM stations. Stations always available for selection.
-- 📋 **New ANCHOR paths**: new Signal K paths published for the ANCHOR function.
-- 🔍 **Stable Zoom size**: UI always fills the window at 100% by default, no shrinking or growing when changing browser zoom.
-
-#### v1.1.1
-- Official IHM coefficients with PDF auto-download. Eliminates "dancing data".
-- Timezone fix: coefficient uses Spanish local time (not UTC).
-- ESM `__dirname` fix for ES modules.
-
-#### v1.1.0
-- Grounding alarm: 24h warning, advance alarm, snooze, mute sound.
-- Interactive tide curves (SVG).
-- Full ES/EN bilingual interface.
-- Sunrise/Sunset (Derived Data integration).
-- Rías Baixas tactical advice (experimental).
-
-#### v1.0.0
-- Initial release: IHM data, AUTO/MANUAL, Signal K paths.
-
-### Credits and license
-
-Apache 2.0 License. Originally derived from `signalk-tides` (Brandon Keepers, Joachim Bakke, Scott Bender and contributors). See `NOTICE` for attribution details.
-
-📧 Contact: **tradesolutions@gmail.com** (include "MAREAS (IHM)" in the subject)
-
-### v1.3.0 — Visor de Fondeo + Alarma de Garreo
-
-**ES:**
-- **Visor de Fondeo** (`/signalk-mareas-ihm/mapafondeo`): Página standalone Leaflet a pantalla completa.
-  - Icono SVG cenital velero escalado a `design.length`/`design.beam` con rotación heading. Diana roja a zoom bajo.
-  - Línea cadena proa→ancla, círculos borneo (azul) y alarma (rojo) con etiquetas metros.
-  - Sliders ajustables, ancla arrastrable, track GPS, targets AIS, OpenSeaMap.
-  - Cartas MBTiles con slider opacidad por capa. Botón meteo → Open-Meteo.
-  - Historial 5 últimas posiciones ancla. Favicon, botón volver, copyright.
-- **Alarma de Garreo**: Detección cada 5s. Radio = swingRadiusMax + margen slider (1-50m). Notificación SK `notifications.signalk-mareas-ihm.anchorDrag`.
-- **Servidor MBTiles** (better-sqlite3): Carga cartas `.mbtiles` desde `/home/pi/charts/` (configurable).
-- **Cadena editable**: Clic caja Cadena → introducir metros reales largados, persiste backend.
-- **Paths SK nuevos**: `watchEnabled`, `anchorLat`, `anchorLon`, `distanceToAnchor`, `alarmRadius`, `dragging`.
-- **Layout**: Grid auto-fill sin scroll, cajas expandidas.
-
-**EN:**
-- **Anchor Map** (`/signalk-mareas-ihm/mapafondeo`): New standalone Leaflet page showing position, anchor, and swing radius. Mobile accessible.
-- **Anchor Drag Alarm**: Continuous drag detection. Alarm radius = swingRadiusMax + 5m. Signal K notification `notifications.signalk-mareas-ihm.anchorDrag`.
-- **MBTiles Server**: Auto-loads nautical chart `.mbtiles` files (SAS Planet) from `/home/pi/charts/` (configurable). Checkboxes to switch between charts without reloading.
-- **Layers**: OpenSeaMap overlay, OSM CartoDB Dark fallback when no local MBTiles.
-- **Map Button**: Box 9 in anchor grid (double width), opens map in new tab.
-- **Search**: Search across Instructions and Changelog with highlighting and auto-scroll.
-- **New Signal K paths**: `environment.anchor.mareasIhm.watchEnabled`, `.anchorLat`, `.anchorLon`, `.distanceToAnchor`, `.alarmRadius`, `.dragging`.
+---
+
+© IHM — Datos oficiales del Instituto Hidrográfico de la Marina de España

package/dist/build-info.json

@@ -0,0 +1,7 @@
+{
+  "version": "2.0.0",
+  "timestamp": "20260522-2339",
+  "gitHash": null,
+  "gitDirty": true,
+  "builtAt": "2026-05-22T21:39:55.610Z"
+}