feat: descripción del cambio

Author: mechmind-dwv

docs/API_REFERENCE.md

@@ -0,0 +1,347 @@
+# 🚀 Neural Nexus - Guía de Despliegue
+
+## 📋 Requisitos Previos
+
+### 🖥️ Hardware Mínimo
+
+| Componente | Orchestrator | Edge Node | Raspberry Pi | NVIDIA Jetson |
+|------------|-------------|-----------|--------------|---------------|
+| **CPU** | 4 cores @ 2.5GHz | 2 cores @ 1.8GHz | ARM Cortex-A72 | ARM Cortex-A78AE |
+| **RAM** | 8GB DDR4 | 4GB DDR4 | 4GB LPDDR4 | 8GB LPDDR4x |
+| **Storage** | 100GB SSD | 50GB SSD | 32GB microSD | 64GB eMMC |
+| **Network** | 1Gbps | 100Mbps | 100Mbps | 1Gbps |
+| **GPU** | Opcional | Opcional | - | NVIDIA GPU |
+
+### 🐳 Software Requerido
+
+```bash
+# Instalar Docker y Docker Compose
+curl -fsSL https://get.docker.com -o get-docker.sh
+sh get-docker.sh
+sudo usermod -aG docker $USER
+
+# Instalar Docker Compose
+sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+sudo chmod +x /usr/local/bin/docker-compose
+
+# Instalar Kubernetes (opcional)
+curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
+echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
+sudo apt-get update
+sudo apt-get install -y kubectl
+```
+
+## 🏗️ Despliegue Local (Desarrollo)
+
+### 1. 📥 Clonar y Configurar
+
+```bash
+# Clonar repositorio
+git clone https://github.com/mechmind-dwv/core-system.git
+cd core-system
+
+# Configurar variables de entorno
+cp .env.example .env
+nano .env
+```
+
+### 2. 🔧 Configuración de Entorno
+
+```bash
+# .env
+NEURAL_NEXUS_ENV=development
+ORCHESTRATOR_HOST=localhost
+ORCHESTRATOR_PORT=8080
+POSTGRES_PASSWORD=neural_nexus_2024
+REDIS_PASSWORD=redis_neural_nexus
+MQTT_USERNAME=neural_nexus
+MQTT_PASSWORD=mqtt_neural_nexus
+```
+
+### 3. 🚀 Levantar Servicios
+
+```bash
+# Desarrollo completo
+docker-compose --profile development up -d
+
+# Solo servicios core
+docker-compose up -d neural-nexus-orchestrator neural-nexus-node postgres redis mosquitto
+
+# Verificar servicios
+docker-compose ps
+```
+
+### 4. 🧪 Verificar Instalación
+
+```bash
+# Health check del orchestrator
+curl http://localhost:8080/health
+
+# Verificar nodo edge
+curl http://localhost:8081/health
+
+# Verificar métricas
+curl http://localhost:8080/metrics
+```
+
+## 🌐 Despliegue en Producción
+
+### 1. 🏭 Usando Docker Swarm
+
+```bash
+# Inicializar swarm
+docker swarm init
+
+# Crear stack de producción
+docker stack deploy -c docker-compose.prod.yml neural-nexus
+
+# Verificar servicios
+docker service ls
+```
+
+### 2. ☸️ Despliegue en Kubernetes
+
+```yaml
+# k8s/namespace.yaml
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: neural-nexus
+  labels:
+    name: neural-nexus
+```
+
+```bash
+# Aplicar manifiestos
+kubectl apply -f k8s/namespace.yaml
+kubectl apply -f k8s/configmap.yaml
+kubectl apply -f k8s/secrets.yaml
+kubectl apply -f k8s/orchestrator.yaml
+kubectl apply -f k8s/node.yaml
+
+# Verificar despliegue
+kubectl get pods -n neural-nexus
+kubectl get services -n neural-nexus
+```
+
+### 3. 🔧 Configuración avanzada
+
+```yaml
+# k8s/orchestrator.yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: neural-nexus-orchestrator
+  namespace: neural-nexus
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: neural-nexus-orchestrator
+  template:
+    metadata:
+      labels:
+        app: neural-nexus-orchestrator
+    spec:
+      containers:
+      - name: orchestrator
+        image: neuralnexus/orchestrator:latest
+        ports:
+        - containerPort: 8080
+        - containerPort: 50051
+        env:
+        - name: RUST_LOG
+          value: "info"
+        - name: DATABASE_URL
+          valueFrom:
+            secretKeyRef:
+              name: neural-nexus-secrets
+              key: database-url
+        resources:
+          requests:
+            memory: "512Mi"
+            cpu: "500m"
+          limits:
+            memory: "1Gi"
+            cpu: "1000m"
+        livenessProbe:
+          httpGet:
+            path: /health
+            port: 8080
+          initialDelaySeconds: 30
+          periodSeconds: 10
+        readinessProbe:
+          httpGet:
+            path: /ready
+            port: 8080
+          initialDelaySeconds: 5
+          periodSeconds: 5
+```
+
+## 📱 Despliegue en Dispositivos Edge
+
+### 1. 🥧 Raspberry Pi
+
+```bash
+# Preparar Raspberry Pi
+sudo apt-get update
+sudo apt-get install -y docker.io
+sudo systemctl enable docker
+sudo usermod -aG docker pi
+
+# Instalar Neural Nexus
+docker run -d \
+  --name neural-nexus-rpi \
+  --restart unless-stopped \
+  -v /opt/neural-nexus:/app/data \
+  -v /opt/neural-nexus/config:/app/config \
+  -p 8080:8080 \
+  -e DEVICE_TYPE=raspberry-pi \
+  -e ORCHESTRATOR_URL=https://orchestrator.your-domain.com \
+  neuralnexus/raspberry-pi:latest
+
+# Verificar funcionamiento
+docker logs neural-nexus-rpi
+```
+
+### 2. 🚀 NVIDIA Jetson
+
+```bash
+# Instalar JetPack (si no está instalado)
+sudo apt-get install nvidia-jetpack
+
+# Verificar CUDA
+nvidia-smi
+
+# Desplegar Neural Nexus
+docker run -d \
+  --name neural-nexus-jetson \
+  --restart unless-stopped \
+  --runtime nvidia \
+  -v /opt/neural-nexus:/app/data \
+  -v /opt/neural-nexus/models:/app/models \
+  -p 8080:8080 \
+  -e DEVICE_TYPE=jetson \
+  -e GPU_ACCELERATION=true \
+  neuralnexus/jetson:latest
+```
+
+### 3. 🔧 Configuración Automática
+
+```bash
+# Script de auto-configuración
+#!/bin/bash
+# scripts/deploy-edge.sh
+
+DEVICE_TYPE=${1:-generic}
+ORCHESTRATOR_URL=${2:-http://localhost:8080}
+
+echo "🚀 Desplegando Neural Nexus en $DEVICE_TYPE"
+
+# Detectar arquitectura
+ARCH=$(uname -m)
+case $ARCH in
+    armv7l) IMAGE_TAG="arm32v7" ;;
+    aarch64) IMAGE_TAG="arm64v8" ;;
+    x86_64) IMAGE_TAG="amd64" ;;
+    *) echo "Arquitectura no soportada: $ARCH"; exit 1 ;;
+esac
+
+# Crear directorio de configuración
+sudo mkdir -p /opt/neural-nexus/{config,data,models,logs}
+
+# Generar configuración
+cat > /opt/neural-nexus/config/node.toml << EOF
+[node]
+id = "$(hostname)-$(date +%s)"
+type = "$DEVICE_TYPE"
+location = "$(hostname)"
+
+[orchestrator]
+url = "$ORCHESTRATOR_URL"
+heartbeat_interval = 30
+
+[inference]
+model_path = "/app/models/current.onnx"
+batch_size = 1
+max_latency_ms = 100
+EOF
+
+# Desplegar contenedor
+docker run -d \
+  --name neural-nexus-$DEVICE_TYPE \
+  --restart unless-stopped \
+  -v /opt/neural-nexus:/app \
+  -p 8080:8080 \
+  neuralnexus/edge-$IMAGE_TAG:latest
+
+echo "✅ Neural Nexus desplegado exitosamente"
+```
+
+## 🔧 Configuración de Red
+
+### 1. 🌐 Load Balancer (Nginx)
+
+```nginx
+# /etc/nginx/sites-available/neural-nexus
+upstream neural_nexus_orchestrator {
+    server orchestrator1.neural-nexus.com:8080;
+    server orchestrator2.neural-nexus.com:8080;
+    server orchestrator3.neural-nexus.com:8080;
+}
+
+server {
+    listen 80;
+    server_name neural-nexus.com;
+    
+    location / {
+        proxy_pass http://neural_nexus_orchestrator;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+    
+    location /metrics {
+        proxy_pass http://neural_nexus_orchestrator;
+        allow 10.0.0.0/8;
+        deny all;
+    }
+}
+```
+
+### 2. 🔒 SSL/TLS con Let's Encrypt
+
+```bash
+# Instalar Certbot
+sudo apt-get install certbot python3-certbot-nginx
+
+# Obtener certificado
+sudo certbot --nginx -d neural-nexus.com
+
+# Auto-renovación
+sudo crontab -e
+# Añadir: 0 12 * * * /usr/bin/certbot renew --quiet
+```
+
+## 📊 Monitoreo y Logging
+
+### 1. 📈 Prometheus + Grafana
+
+```yaml
+# docker-compose.monitoring.yml
+version: '3.8'
+
+services:
+  prometheus:
+    image: prom/prometheus:latest
+    ports:
+      - "9090:9090"
+    volumes:
+      - ./monitoring/prometheus.yml:/etc/prometheus/prometheus.yml
+      - prometheus_data:/prometheus
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.console.libraries=/etc/prometheus/console_libraries'
+      - '--web.console