SwellTrack Kayak Premium
# Manual de Usuario - SwellTrack (Kayak Navigation)
¡Bienvenido a **SwellTrack**, tu compañero de navegación marítima y fluvial de bajo coste diseñado específicamente para kayakistas! Esta aplicación ha sido construida bajo la filosofía **offline-first**, asegurando que sus herramientas más críticas (mapas, brújula, plan de flotación y wiki técnico) sigan siendo 100% operativas en alta mar o zonas remotas sin cobertura de datos móviles.
---
## Índice
1. [Introducción y Filosofía](#1-introducción-y-filosofía)
2. [Primeros Pasos e Interfaz General](#2-primeros-pasos-e-interfaz-general)
3. [Mapa y Navegación Híbrida](#3-mapa-y-navegación-híbrida)
4. [Guiado de Rumbo (Brújula y Cámara AR)](#4-guiado-de-rumbo-brújula-y-cámara-ar)
5. [Pronóstico de Clima, Mareas y Modo Fluvial (Caudal)](#5-pronóstico-de-clima-mareas-y-modo-fluvial-caudal)
6. [Gestor de Rutas e Integración con Wikiloc (GPX / GeoJSON)](#6-gestor-de-rutas-e-integración-con-wikiloc-gpx--geojson)
7. [Plan de Flotación y Alertas SOS Automáticas](#7-plan-de-flotación-y-alertas-sos-automáticas)
8. [Wiki Técnico de Seguridad y Paleo](#8-wiki-técnico-de-seguridad-y-paleo)
9. [Directorio de Alquileres y Portal de Negocios B2B](#9-directorio-de-alquileres-y-portal-de-negocios-b2b)
10. [Solución de Problemas y Preguntas Frecuentes (FAQ)](#10-solución-de-problemas-y-preguntas-frecuentes-faq)
---
## 1. Introducción y Filosofía
Navegar en kayak de mar o en aguas interiores implica enfrentarse a un entorno dinámico y potencialmente hostil. **SwellTrack** proporciona herramientas de seguridad activa y planificación combinando:
- **Resiliencia Offline**: Los datos de mapas, rutas y seguridad se guardan en la memoria local del dispositivo móvil para cuando pierdas la cobertura.
- **Seguridad Activa (Float Plan)**: Un plan de flotación en tiempo real que reacciona si te retrasas y genera alertas SOS en cola listas para ser enviadas cuando se recupere la señal.
- **Instrumentación de bajo coste**: Sustituye caros GPS de navegación dedicados mediante sensores integrados en teléfonos móviles de consumo común.
---
## 2. Primeros Pasos e Interfaz General
Al abrir la aplicación por primera vez en tu dispositivo móvil o navegador de escritorio, se activará la secuencia inicial:
### 2.1. Tutorial de Bienvenida
Un carrusel interactivo de 5 pantallas te guiará rápidamente a través de las funciones principales de la aplicación:
1. **SwellTrack**: Visión general del software.
2. **Mapa Híbrido**: Cómo alternar mapas online/offline y grabar rutas.
3. **Clima y Mareas/Caudal**: Cómo interpretar los avisos de seguridad.
4. **Plan de Flotación**: Cómo configurar tu contacto de emergencia terrestre.
5. **Wiki y Alquileres**: Acceso a manuales técnicos y centros de alquiler asociados.
*Puedes omitir el tutorial en cualquier momento presionando **Omitir** o completarlo hasta el final pulsando **Entendido**.*
### 2.2. Registro y Control de Acceso
El menú superior te permite iniciar sesión o registrarte en la comunidad de SwellTrack.
- **Modo Libre (No registrado)**: Acceso al mapa básico offline, pronósticos de clima estándar, visualización de rutas públicas y artículos wiki de nivel básico.
- **Miembro de la Comunidad (Registrado)**: Permite importar y exportar tus tracks de navegación a formatos universales (GPX/GeoJSON) y subir tus grabaciones.
- **Miembro Premium (PRO)**: Desbloquea artículos del Wiki Técnico con alto valor formativo (como auto-rescates y montaje de asientos con respaldo) y desbloquea rutas avanzadas protegidas.
### 2.3. Pantalla de Bloqueo del Dispositivo
En el agua, las salpicaduras pueden provocar falsos toques táctiles. SwellTrack incluye una funcionalidad de **Bloqueo de Pantalla** que deshabilita la entrada táctil accidental.
> [!TIP]
> Activa el bloqueo en el icono de candado del menú de navegación cuando guardes el móvil en tu funda estanca transparente de chaleco. Para desbloquearlo, realiza una pulsación larga sobre el botón de liberación en pantalla.
---
## 3. Mapa y Navegación Híbrida
La pestaña **Mapa** es el centro neurálgico de la aplicación. Muestra tu posición actual, las rutas comunitarias y los hitos del camino.
### 3.1. Modos de Mapa: Online MapLibre vs Caché Offline SVG
- **Modo Online**: Si dispones de cobertura, se renderizará un mapa fluido vectorial con **MapLibre GL JS**. Puedes cambiar el estilo a **Satélite** (usando imágenes satelitales de Google Maps) presionando el botón **Capas / Satélite** en la parte superior derecha.
- **Modo Offline**: Si estás en una zona sin cobertura, la app cambiará automáticamente a la **Caché Vectorial Activa** (representación SVG simplificada). Ésta simula la línea de costa regional (Cabo de Gata, Cap de Creus o Rías Baixas), archipiélagos (ej. Isla de San Simón, Isla Mock) y las cuadrículas de latitud/longitud del GPS de forma 100% offline.
### 3.2. Grabación de Travesías en Tiempo Real (Estilo Wikiloc)
Para registrar tu recorrido mientras navegas:
1. En la pestaña **Mapa** o **Rutas (Subpestaña Grabar)**, pulsa **Grabar Nueva Travesía** (identificado con el botón de grabación rojo 🔴).
2. El cronómetro interno de la aplicación comenzará a correr y el GPS trazará una línea naranja que se dibuja tras de ti.
3. **Métrica en vivo**: Se calcula de forma dinámica la distancia recorrida (en millas/km) y la duración total.
4. **Pausar/Reanudar**: Puedes pausar la grabación si desembarcas para descansar y reanudarla al volver al agua.
5. **Guardar**: Al finalizar, pulsa **Parar** y rellena el formulario de guardado:
- **Nombre de la Ruta** (ej. "Ruta de los Acantilados").
- **Dificultad** (Clase I Fácil, Clase II Moderada, Clase III Difícil).
- **Fotografía de Cubierta**: Permite capturar o subir una foto (se almacena de forma local codificada en Base64).
6. Una vez guardada, la ruta se incorporará a tu biblioteca local dentro de la pestaña **Rutas**.
### 3.3. Colocación de Puntos de Referencia (Hitos / POIs)
Puedes poblar el mapa con hitos geolocalizados mientras navegas o planificas:
- **Añadir Hito en Caliente (Grabación)**: En el panel inferior del mapa, introduce un nombre y selecciona la tipología:
- 🟢 **Embarque (Launch Site)**: Zonas idóneas para botar o sacar el kayak.
- 🔴 **Peligro (Hazard)**: Rocas someras, rompientes de fondo, corrientes fuertes o canales de tráfico marítimo.
- 🟣 **Pto. Interés (POI)**: Cuevas marinas, playas aisladas, fuentes de agua dulce o boyas.
- **Colocación Manual en Mapa**: Si tocas cualquier punto del mapa en modo de simulación, la app colocará un Hito Custom del tipo que tengas seleccionado en la barra inferior derecha y registrará sus coordenadas.
- **Editar Hitos**: En el panel "Puntos de Referencia", pulsa **Editar** en cualquiera de tus hitos guardados para modificar su nombre o corregir sus coordenadas de latitud/longitud con precisión decimal.
---
## 4. Guiado de Rumbo (Brújula y Cámara AR)
Un GPS convencional te dice dónde estás, pero la brújula te orienta hacia dónde vas. SwellTrack combina sensores magnéticos con herramientas visuales avanzadas.
```
[ Rumbo Norte (0°) ]
▲
| (Línea de alineación AR)
.-----+-----.
/ | \
/ .-' '-. \ <-- Aguja Azul (Rumbo Objetivo)
| / ▲ \ |
| | | | | <-- Aguja Roja/Gris (Norte Magnético)
| \ / |
\ '-. .-' /
\ | /
'-----+-----'
```
### 4.1. Sensor de Giroscopio y Simulación
- **Uso en Móvil**: La brújula lee el sensor `deviceorientation` de tu teléfono. Gira sobre ti mismo y la corona de la brújula rotará para reflejar el norte real.
- **Uso en Escritorio / PC**: Si estás planificando desde casa, puedes **hacer clic y arrastrar la corona** de la brújula para simular el giro de la proa del kayak.
### 4.2. Rumbo Objetivo (Target Heading) y Desviación
- **Rumbo de Navegación**: Puedes fijar un Rumbo Objetivo de forma manual usando el deslizador inferior (de 0° a 359°) o dejar que la app lo haga automáticamente.
- **Sincronización con el Mapa**: Si cargas una ruta activa en la app, activa la opción **Sincronizar con el Mapa**. La aplicación calculará dinámicamente el rumbo (bearing) desde tu posición GPS actual hacia el siguiente hito o destino final.
- **Instrucciones de Gobierno (Steering)**: El widget compara tu rumbo real con el objetivo y te da órdenes claras en pantalla:
- `✅ ¡Rumbo Correcto!` (Desviación inferior a 5°).
- `⬅️ Vira a babor (Izquierda) X°` (Si debes corregir rumbo a la izquierda).
- `➡️ Vira a estribor (Derecha) X°` (Si debes corregir rumbo a la derecha).
### 4.3. Guiado con Realidad Aumentada (Cámara AR)
Pulsa el botón **📷 Cámara AR**. La aplicación encenderá la cámara trasera de tu móvil y proyectará el dial de la brújula y las agujas de rumbo de forma semitransparente sobre la imagen real.
> [!IMPORTANT]
> Apunta con tu móvil hacia el horizonte marino. La línea de alineación roja te permitirá alinear físicamente hitos lejanos (como islas, faros o boyas) con tu rumbo objetivo instrumental, facilitando la navegación estimada incluso con niebla o baja visibilidad.
---
## 5. Pronóstico de Clima, Mareas y Modo Fluvial (Caudal)
El mar de fondo y el viento son factores determinantes para la viabilidad de una salida en kayak. SwellTrack integra datos meteo-marinos precisos provenientes del modelo de alta resolución de **Open-Meteo Marine**.
### 5.1. Alertas de Seguridad Automáticas
La aplicación evalúa los datos meteorológicos y fluviales locales en tiempo real y muestra tarjetas de alerta de tres niveles:
- 🟢 **Condiciones Favorables**: Mar tranquilo (olas < 0.7m), viento suave (< 10kt) y sin lluvias. Apto para cualquier nivel de palista.
- 🟡 **Precaución Recomendada**: Olas entre 0.7m y 1.0m, viento entre 10 y 12 nudos, o lluvias de intensidad moderada. Requiere chaleco obligatorio, experiencia y un kayak de travesía estanco.
- 🔴 **Condiciones Peligrosas / Alerta de Seguridad**: Se activa automáticamente si:
- La altura de ola supera **1.0 metros** (o tu configuración personalizada).
- La velocidad del viento supera **12 nudos** (o tu configuración personalizada).
- La energía del oleaje supera **400 kJ** (riesgo de vuelco crítico).
- La probabilidad de lluvia es superior al **75%** (riesgo de hipotermia o tormenta eléctrica).
- El caudal del río supera **20 m³/s** (en embalses/ríos).
### 5.2. Parámetros Críticos de Clima Marino
| Parámetro | Unidad | Importancia en Kayak |
| :--- | :--- | :--- |
| **Altura de Ola** | Metros (m) | Promedio de altura. Olas > 1m pueden voltear kayaks de recreo fácilmente en rompientes costeras. |
| **Periodo de Ola** | Segundos (s) | Tiempo entre crestas. Periodos largos (>8s) = olas suaves ("mar de fondo"). Periodos cortos (<5s) = olas empinadas y desordenadas ("mar de viento"). |
| **Energía de Ola** | Kilojulios (kJ) | Fuerza de impacto del mar. Se multiplica con la altura al cuadrado. Más de 300 kJ exige máxima atención. |
| **Dirección del Oleaje** | Grados (°) / Cardinal | Evita navegar con oleaje cruzado de costado (través). Busca navegar con las olas de cara o popa. |
| **Corrientes Superficiales** | Metros por segundo (m/s) | Corrientes > 0.5 m/s (1 nudo) reducen tu velocidad drásticamente si paleas en contra. |
> [!TIP]
> Toca los iconos de interrogación **(?)** junto a cada parámetro en la app para abrir un **Glosario Interactivo** que explica los conceptos de seguridad física específicos para kayaks.
### 5.3. Tabla y Curva de Mareas
Para kayakistas marinos, la marea condiciona las corrientes costeras y la accesibilidad a playas y rías:
- **Curva Harmónica de Marea**: Se proyecta un gráfico con la evolución de la marea para las próximas 24 horas basado en los constituyentes astronómicos principales.
- **Tide Scrubber Slider**: Arrastra el control deslizante de horas para ver la altura estimada de la marea en metros para cualquier momento del día.
- **Marea Viva vs Muerta**: Indica el coeficiente de marea. Coeficientes altos (>80, Mareas Vivas) generan corrientes extremas en canales estrechos.
- **Dirección de Flujo**: Te avisa si la marea está en fase **Creciente (Llenando) ↑** o **Vaciante (Vaciando) ↓** para que planifiques navegar con la corriente a favor.
### 5.4. Modo Fluvial (Detección de Caudal Inland)
Si la aplicación detecta que tu posición GPS se encuentra en un cuerpo de agua continental (como el *Embalse de San Juan, Madrid*), la interfaz desactivará automáticamente las pestañas de olas y mareas costeras y activará el **Modo Inland (Fluvial)**:
- Muestra el **Caudal Activo** en metros cúbicos por segundo (m³/s).
- Grafica el caudal a lo largo de las 24 horas del día.
- Incorpora una **línea de límite de seguridad roja** (establecida por defecto en 20 m³/s). Si el caudal supera esta línea, la app activará inmediatamente la alerta roja de peligro por corrientes fluviales rápidas.
---
## 6. Gestor de Rutas e Integración con Wikiloc (GPX / GeoJSON)
SwellTrack fomenta el intercambio de información utilizando formatos de datos geográficos abiertos e interoperables.
### 6.1. Explorador de Rutas Comunitarias
En la pestaña **Rutas**, puedes ver un listado de tracks populares de la comunidad (ej. "Cabo de Gata - Sirenas", "Ría de Vigo - San Simón", "Cap de Creus - Portlligat").
Cada ficha de ruta muestra:
- Foto de la zona, distancia total (millas/km) y duración estimada de paleo.
- Valoración por estrellas de otros palistas.
- Atributo de **Flujo Óptimo**: Indicación de qué combinación de mareas (llenante/vaciante) y vientos es idónea para esa travesía.
- Botón **Cargar en Mapa** para iniciar la navegación instrumental.
### 6.2. Importación desde Wikiloc (GPX)
Si has descargado un track de Wikiloc o de tu reloj GPS en formato `.gpx`:
1. Ve a la subpestaña **Explorar** y presiona **Importar desde Wikiloc (GPX)**.
2. Selecciona el archivo `.gpx` de tu dispositivo.
3. La aplicación procesará de forma local el archivo:
- Extraerá los puntos de traza (trackpoints) para dibujar la línea en el mapa.
- Calculará automáticamente la distancia acumulada.
- Detectará los puntos de paso (`<wpt>`) transformándolos en hitos (Embarque, Hitos, etc.) interactivos.
4. La ruta quedará guardada de forma local y lista para navegar offline.
### 6.3. Exportación en GeoJSON o GPX
Para utilizar tus rutas o tracks grabados en otros programas de cartografía (como QGIS o Google Earth):
1. Selecciona la ruta en el listado de detalles.
2. Pulsa el botón **Exportar GeoJSON** o **Exportar GPX**.
3. Se descargará un archivo estructurado con un elemento tipo `LineString` para la ruta y elementos tipo `Point` para los hitos/POIs de paso.
---
## 7. Plan de Flotación y Alertas SOS Automáticas
La funcionalidad de **Plan de Flotación** es el pilar de la seguridad activa de SwellTrack, inspirada en protocolos profesionales de rescate marítimo.
```
[ Palista en el agua ] [ Contacto en Tierra ]
No hace check-in Móvil recibe SMS SOS con:
antes del ETA - Coordenadas GPS exactas.
│ - Posición What3Words (3 palabras).
▼ - Enlace a ruta programada.
[ Temporizador Expira ] ───────────────► - Teléfonos Salvamento Marítimo.
(Alerta SOS local offline)
```
### 7.1. Activación del Plan
Antes de salir al agua, configura tu plan en la pestaña **Seguridad**:
1. **Ruta**: Selecciona la ruta que vas a realizar (o "Navegación Libre" si no tienes un track predefinido).
2. **Contacto de Emergencia**: Escribe el nombre de tu contacto en tierra (ej. tu pareja, familiar o club náutico).
3. **Móvil del Contacto**: Introduce su número de teléfono.
4. **ETA (Tiempo Estimado de Regreso)**: Ajusta el selector de tiempo (ej. 3 horas) según la duración de tu paleo más un margen de seguridad.
5. Presiona **Activar Plan de Flotación**.
La pantalla pasará a modo de monitoreo activo, mostrando un temporizador en cuenta regresiva y un botón verde destacado: **Estoy a Salvo (Check-In)**.
*(Nota: Para pruebas de simulación, la aplicación acelera el tiempo a razón de 1 segundo real = 1 minuto de navegación).*
### 7.2. Coordenadas What3Words (w3w)
Durante el monitoreo, la aplicación traduce tus coordenadas GPS decimales complejas a un sistema simplificado de tres palabras (ej. `///cangrejo.velero.brisa`).
> [!IMPORTANT]
> Si sufres una emergencia y debes contactar por radio VHF (Canal 16), dicta estas tres palabras al operador de radio. Le permitirán ubicarte en un cuadrante exacto de 3x3 metros en el mar de manera rápida, eliminando errores de pronunciación de números GPS bajo estrés.
### 7.3. Protocolo de Emergencia SOS Excedido (ETA Expirado)
Si el temporizador de seguridad llega a cero sin que hayas pulsado **Estoy a Salvo**:
1. La aplicación activará visualmente la pantalla de **Alerta de Emergencia**.
2. **Mecanismo Offline**: Dado que el temporizador corre de forma local en el hilo de fondo del dispositivo, la alarma saltará aunque no tengas cobertura.
3. Se generará de forma automática en la cola del dispositivo un mensaje SMS de socorro pre-formateado:
> `[EMERGENCIA SWELLTRACK] El palista no regresó a tiempo. Última ubicación conocida: [Coords GPS]. What3Words: ///cangrejo.velero.brisa. Ruta: [Nombre de la Ruta]. Contacte con Salvamento Marítimo (900 202 202) o Emergencias (112) si no logra localizarlo.`
4. **Disparo SMS**: La app abrirá el compositor de SMS nativo de tu móvil con el número del contacto en tierra y el cuerpo del mensaje listos para ser enviados con una sola pulsación. El dispositivo enviará el SMS tan pronto recupere la mínima señal de red móvil (incluso red de voz 2G estándar).
5. Si regresas sano y salvo tras expirar el tiempo, pulsa **Falsa Alarma (Check-In)** para desactivar el protocolo y notificar que estás seguro.
---
## 8. Wiki Técnico de Seguridad y Paleo
La app contiene una biblioteca técnica integrada para consultas rápidas sobre teoría y seguridad náutica en frío.
### 8.1. Categorías del Buscador
- **Seguridad**: Protocolos de llamadas de socorro (MAYDAY, PAN PAN, SECURITE), reglas sobre el uso del chaleco salvavidas, hipotermia y shock por agua fría.
- **Técnica**: Mecánica correcta del paleo hacia adelante rotando el torso, giros de barrido (sweep stroke) y apoyos bajos (low brace) para evitar vuelcos.
- **Equipo**: Consejos para el mantenimiento de timones y orzas metálicas de fibra, y ajuste ergonómico de asientos de kayak.
### 8.2. Esquemas de Asiento y Ergonomía (PRO)
Los artículos especiales orientados a la mejora del rendimiento y ergonomía física, como el **Montaje de Asiento con Respaldo**, incluyen esquemas visuales integrados:
- **Vista Superior (Esquema de Anclaje)**: Detalla la tensión y posición de los mosquetones marinos y las correas de tracción delanteras/traseras para evitar lesiones.
- **Vista Lateral (Ángulo de Soporte)**: Muestra el ángulo ideal del respaldo (95-100 grados) respecto a la línea de cubierta del kayak para una correcta palada activa y control del canteo con rodillas.
---
## 9. Directorio de Alquileres y Portal de Negocios B2B
SwellTrack conecta a los palistas locales con negocios de turismo activo y proveedores de equipamiento en las áreas de navegación GPS activas.
### 9.1. Búsqueda y Filtro de Tiendas Cercanas
Cuando la aplicación detecta tu geolocalización, la pestaña **Alquileres** filtra y te muestra los centros de kayak autorizados en esa zona (ej. *Cabo de Gata Kayak Aventura* en La Fabriquilla o *Rías Baixas Surf & Kayak Club* en Redondela).
- **Ver en Mapa**: Centra la cámara de navegación en la localización física del establecimiento, marcándolo con un icono parpadeante de kayak 🛶.
- **Reserva de Alta Fidelidad**: Permite seleccionar el tipo de kayak de la flota disponible, indicar la fecha, el número de unidades y las horas de alquiler. La app calculará de forma automática el precio estimado de la reserva.
- **Pre-Reserva con Código QR**: Tras confirmar la reserva gratuita, la aplicación generará una tarjeta con un código QR único y un número de referencia offline (ej. `STK-4812`). Solo debes presentar esta pantalla en el establecimiento físico para retirar tus kayaks y gestionar el pago en destino.
### 9.2. Portal de Socios B2B
Si eres propietario de una empresa de alquiler de kayaks:
1. Pulsa el botón **Registrar mi Negocio** en el banner inferior del directorio.
2. Completa el formulario de propuesta comercial adjuntando el Nombre comercial, CIF/Registro, Teléfono de contacto, Dirección y Precio base estimado por hora de alquiler de flota.
3. El equipo de SwellTrack verificará tu licencia de turismo activo y tus seguros de responsabilidad civil para darte de alta como **Verified Partner** (Socio verificado) y habilitar la pasarela de pagos integrada de la app.
---
## 10. Solución de Problemas y Preguntas Frecuentes (FAQ)
### ¿Por qué mi brújula no se orienta correctamente?
Asegúrate de que tu móvil tenga giroscopio y magnetómetro integrados. En dispositivos móviles, debes conceder permisos de acceso a la orientación de pantalla y sensores físicos en la configuración de tu navegador o del sistema. Si estás en un navegador de escritorio, recuerda que puedes simular la orientación arrastrando la corona con el ratón.
### ¿El Plan de Flotación consumirá toda mi batería por el GPS?
El plan de flotación de SwellTrack está optimizado para funcionar en segundo plano con un consumo de batería extremadamente bajo, refrescando la posición GPS en intervalos eficientes y evitando el renderizado constante de mapas gráficos cuando la pantalla está apagada.
### ¿Qué ocurre si me quedo sin cobertura durante una emergencia?
El temporizador de seguridad de la app corre de forma interna y no requiere conexión a Internet. Si expira el tiempo, la app creará el mensaje SOS y lo colocará en la cola de envío SMS nativa del teléfono. Los SMS operan sobre canales de control celular de voz (2G) que tienen mucha mayor penetración de cobertura que las redes de datos (3G/4G/5G). El mensaje saldrá en cuanto el teléfono capte un hilo de cobertura telefónica.
### ¿Cómo importo rutas desde Wikiloc si estoy offline?
Para importar rutas GPX en entornos offline, debes haber descargado previamente el archivo `.gpx` en la memoria interna de tu dispositivo antes de salir de la zona de cobertura. La aplicación procesará y estructurará el archivo internamente sin necesidad de conectarse a ningún servidor externo.