Feature/swarm phase4 persistence

.cursorrules

@@ -0,0 +1,148 @@
+# 🚫 REGLAS ESTRICTAS - iURi Pescadores
+
+## ⚠️ ARCHIVOS PROHIBIDOS (NUNCA TOCAR)
+
+### Frontend - UI Core (PROTEGIDA)
+```
+frontend/src/router*
+frontend/src/layouts/**
+frontend/src/components/Sidebar*
+frontend/src/pages/**
+```
+
+**Razón:** Estos archivos controlan la estructura principal de la aplicación (rutas, layout, navegación, páginas). Cualquier cambio aquí rompe el flujo completo de la app.
+
+---
+
+## ✅ UBICACIONES CORRECTAS POR MÓDULO
+
+### Species Recognition
+```
+frontend/src/components/species/**
+```
+- `SpeciesRecognition.tsx`
+- `Fish3DViewer.tsx`
+- `GeometricAnalysis.tsx`
+- `SpeciesComparison.tsx`
+- etc.
+
+### Otros Módulos (futuros)
+```
+frontend/src/components/fishing/**    → Pesca Inteligente
+frontend/src/components/safety/**     → Seguridad
+frontend/src/components/maps/**       → Mapas
+frontend/src/components/ai/**         → IA
+frontend/src/components/chat/**       → Chat
+```
+
+---
+
+## 🔧 REGLAS DE DESARROLLO
+
+### Framework y Tooling
+- **Frontend:** React + Vite (NO cambiar)
+- **Backend:** FastAPI + Python 3.10+
+- **Base de datos:** SQLite (migración futura a PostgreSQL)
+- **3D:** React Three Fiber + Drei
+- **Estilos:** TailwindCSS
+
+### Git Workflow
+- ❌ **NO hacer push directo a `main`**
+- ✅ **Crear PRs** para cualquier cambio
+- ✅ Trabajar en ramas feature/fix/chore
+- ✅ Commits descriptivos
+
+### Arquitectura de Nuevas Features
+1. **Backend primero:** Crear API en `backend/api/`, servicio en `backend/services/`
+2. **Frontend después:** Crear componentes en `frontend/src/components/[modulo]/`
+3. **NO tocar rutas/layout:** Usar las páginas existentes o pedir permiso explícito
+4. **Integración:** Las nuevas features se AGREGAN, no REEMPLAZAN las existentes
+
+---
+
+## 📋 RECORDATORIOS
+
+### ¿Qué es iURi Pescadores?
+**iURi NO ES:**
+- ❌ Una app de reconocimiento de especies
+- ❌ Una app de tracking de barcos
+- ❌ Una app solo de chat/IA
+
+**iURi ES:**
+✅ **PLATAFORMA COMPLETA** con múltiples módulos integrados:
+- Gestión de flota
+- Pesca inteligente
+- Seguridad marítima
+- IA multi-propósito
+- Reconocimiento de especies (UNO de los módulos)
+- Tracking en tiempo real
+- Chat asistencial
+- Dashboard con métricas
+- Y más...
+
+### Antes de Hacer Cambios
+1. **¿Toco archivos prohibidos?** → NO proceder
+2. **¿Cambio el framework?** → NO proceder
+3. **¿Reemplazo funcionalidad existente?** → NO, solo agregar
+4. **¿Push directo a main?** → NO, hacer PR
+5. **¿Está claro el módulo/ubicación?** → Sí, proceder
+
+---
+
+## 🎯 FLUJO CORRECTO DE ENTRADA
+
+```
+Usuario → localhost:5173
+  ↓
+/login (LoginPage)
+  ↓
+Autenticación (Auth API)
+  ↓
+/dashboard (Dashboard con Sidebar completo)
+  ↓
+Navega por Sidebar a cualquier módulo:
+  - /fishing (Pesca Inteligente)
+  - /species (Identificar Especie)
+  - /chat (Chat Geral)
+  - /safety (Segurança)
+  - /map (Mapa en Tiempo Real)
+  - /ai (IA Preditiva)
+  - /ai-unificada (IA Unificada)
+  - /ai-local (IA Local)
+  - /settings (Configurações)
+```
+
+**Punto de entrada:** `/login` → NO `/species` ni otro módulo específico
+
+---
+
+## 🚨 SI SE ROMPE ALGO
+
+1. **NO hacer push** si algo no funciona
+2. **Verificar que no tocaste archivos prohibidos:**
+   ```bash
+   git diff --name-only | grep -E '^(frontend/src/router|frontend/src/layouts|frontend/src/components/Sidebar|frontend/src/pages/)'
+   ```
+3. **Si tocaste archivos prohibidos:**
+   ```bash
+   git restore frontend/src/router*
+   git restore frontend/src/layouts/
+   git restore frontend/src/components/Sidebar*
+   git restore frontend/src/pages/
+   ```
+4. **Reportar el error** y esperar instrucciones
+
+---
+
+## 📚 DOCUMENTACIÓN DE REFERENCIA
+
+- `ARQUITECTURA_COMPLETA_IURI.md` → Visión general del sistema
+- `INTEGRACION_GFW_SPECIES.md` → Integración GFW
+- `backend/README.md` → Documentación del backend
+- `/docs` → Documentación adicional
+
+---
+
+**Última actualización:** 22 Octubre 2025  
+**Versión:** 1.0.0
+

.cursorrules.md

@@ -0,0 +1,76 @@
+# 🛡️ Reglas Estrictas para Cursor/Codex - iURi
+
+## ❌ PROHIBIDO (bloqueo automático)
+
+1. **NO borrar/renombrar** `src/components/marine/*`
+2. **NO introducir** `react-leaflet` (usar MapLibre GL JS o Leaflet directo)
+3. **NO usar** WebSocket `:8000` sin gate de `VITE_USE_IURI_WS`
+4. **NO cambiar nombres** de envs críticas:
+   - `VITE_SIGNALK_WS`
+   - `VITE_MQTT_WS`
+   - `VITE_VESSEL_ID`
+5. **NO tocar** archivos protegidos salvo que sea el objetivo del PR:
+   - `src/router*`
+   - `src/layouts/`
+   - `src/components/Sidebar*`
+   - `src/pages/`
+
+## ✅ ANTES DE MERGEAR (obligatorio)
+
+1. Ejecutar `frontend/scripts/premerge_guard.sh`
+2. Ejecutar `frontend/scripts/llm_diff_review.sh` (Ollama local)
+3. Adjuntar salida de ambos en descripción del PR
+4. Si hay cambios en marine/: ejecutar `frontend/scripts/sanity_stack.sh`
+5. Capturas de pantalla del módulo afectado
+
+## 📋 COMMITS ATÓMICOS
+
+- 1 objetivo por PR (ejemplos válidos):
+  - ✅ `feat(marine): add wind widget`
+  - ✅ `fix(i18n): sync missing keys pt/es`
+  - ✅ `chore(marine): gate WS behind VITE_USE_IURI_WS`
+
+- Ejemplos **NO** válidos (muy amplios):
+  - ❌ `feat: marine panel + i18n + lazy load + fixes`
+  - ❌ `refactor: everything`
+
+## 🧠 USO DE IA LOCAL (Ollama)
+
+Antes de proponer código que toque:
+- `src/components/marine/`
+- `src/hooks/use*Marine*`
+- `src/hooks/useSignalK.ts`
+- `src/hooks/useMQTT.ts`
+- `docker-compose.marine.yml`
+
+**EJECUTAR:**
+```bash
+cd frontend
+MODEL=llama3.2 bash scripts/llm_diff_review.sh
+```
+
+Y **ADJUNTAR** la salida al mensaje/PR.
+
+## 📚 DOCUMENTACIÓN DE REFERENCIA
+
+- `gateway/README.md` → Stack marino completo
+- `.env.example` → Variables obligatorias
+- `ARQUITECTURA_COMPLETA_IURI.md` → Visión del sistema
+
+## 🚨 SI ALGO SE ROMPE
+
+1. **NO hacer push** si `/dashboard` no carga
+2. **Verificar** que no tocaste archivos prohibidos:
+   ```bash
+   git diff --name-only origin/main | grep -E '^(frontend/src/router|frontend/src/layouts|frontend/src/components/Sidebar|frontend/src/pages/)'
+   ```
+3. Si tocaste archivos prohibidos, **revertir**:
+   ```bash
+   git restore frontend/src/router* frontend/src/layouts/ frontend/src/components/Sidebar* frontend/src/pages/
+   ```
+
+---
+
+**Última actualización:** 30 Octubre 2025  
+**Versión:** 2.0 (con guardián IA local)
+

.dockerignore

@@ -0,0 +1,42 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.log
+*.db
+*.sqlite
+*.sqlite3
+.env
+.env.*
+.git/
+.gitignore
+node_modules/
+frontend/node_modules/
+frontend/dist/
+frontend/build/
+.cache/
+.idea/
+.vscode/
+*.md
+docs/
+logs/
+logs_24_7/
+temp_files/
+venv/
+venv_*/
+.DS_Store
+*.swp
+*.swo
+*~
+archive/
+backup/
+recovered_code/
+iuri_v2/
+iuri_sd_webui/
+prototipado/
+tests/
+*.test.py
+test_*.py
+*.zip
+*.tar.gz
+

.git-hooks/pre-commit

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+# .git-hooks/pre-commit — Hook automático de protección
+# Se ejecuta ANTES de cada commit para crear snapshot de seguridad
+
+set -e
+
+echo ""
+echo "🛡️ Hook de protección activado..."
+
+# Verificar archivos críticos (reglas del repo)
+CRITICAL_FILES=(
+  "backend/main.py"
+  "frontend/src/App.tsx"
+  "frontend/src/components/asistente/AsistenteIuri.tsx"
+  "docker-compose.full.yml"
+  "nginx/conf.d/iuriapp.conf"
+)
+
+echo "🔍 Verificando archivos críticos..."
+
+for file in "${CRITICAL_FILES[@]}"; do
+  if [ ! -f "$file" ]; then
+    echo "❌ ERROR: Archivo crítico faltante o borrado: $file"
+    echo "   ABORTANDO commit para proteger tu código"
+    echo ""
+    echo "💡 Si querés borrar este archivo, primero:"
+    echo "   1. Crea un snapshot manual: ./scripts/commit-snapshot.sh"
+    echo "   2. Agrega el archivo a .gitignore si no lo necesitas"
+    echo ""
+    exit 1
+  fi
+done
+
+echo "✅ Todos los archivos críticos presentes"
+
+# Verificar que no se toquen archivos prohibidos (de las reglas del repo)
+PROTECTED_PATTERNS=(
+  "frontend/src/router"
+  "frontend/src/layouts/"
+  "frontend/src/components/Sidebar"
+  "frontend/src/pages/"
+)
+
+echo "🔍 Verificando archivos protegidos..."
+
+CHANGED_FILES=$(git diff --cached --name-only)
+
+for pattern in "${PROTECTED_PATTERNS[@]}"; do
+  if echo "$CHANGED_FILES" | grep -q "^${pattern}"; then
+    echo "⚠️ ADVERTENCIA: Intentás modificar archivos protegidos:"
+    echo "$CHANGED_FILES" | grep "^${pattern}"
+    echo ""
+    echo "📋 Según las reglas del repo, estos archivos están PROTEGIDOS:"
+    echo "   • frontend/src/router*"
+    echo "   • frontend/src/layouts/**"
+    echo "   • frontend/src/components/Sidebar*"
+    echo "   • frontend/src/pages/**"
+    echo ""
+    echo "💡 Si REALMENTE necesitas cambiarlos:"
+    echo "   1. Revisa las reglas en el archivo de reglas del repo"
+    echo "   2. Crea snapshot: ./scripts/commit-snapshot.sh"
+    echo "   3. Documenta por qué es necesario"
+    echo ""
+    echo "❓ ¿Continuar de todas formas? (s/N): "
+    read -r response
+    if [[ ! "$response" =~ ^[Ss]$ ]]; then
+      echo "❌ Commit abortado por protección"
+      exit 1
+    fi
+  fi
+done
+
+echo "✅ No se tocan archivos protegidos"
+
+# Crear snapshot automático en commits grandes
+CHANGES_COUNT=$(echo "$CHANGED_FILES" | wc -l)
+
+if [ "$CHANGES_COUNT" -gt 10 ]; then
+  echo ""
+  echo "📸 Cambios grandes detectados ($CHANGES_COUNT archivos)"
+  echo "   Creando snapshot de seguridad automático..."
+
+  DATE=$(date +"%Y%m%d-%H%M%S")
+  BACKUP_BRANCH="auto-backup-$DATE"
+
+  # Crear branch de backup (sin ejecutar commit-snapshot.sh para evitar loop)
+  git branch "$BACKUP_BRANCH" 2>/dev/null || true
+
+  echo "✅ Snapshot automático: $BACKUP_BRANCH"
+  echo "   Para volver: git checkout $BACKUP_BRANCH"
+fi
+
+echo ""
+echo "✅ Pre-commit hook completado - commit permitido"
+echo ""
+
+exit 0
+