# 📄 Formato de Archivos TXT del Buque

## ✅ Sí, pueden ser archivos TXT

Los scripts procesan archivos **.txt** sin problema. El contenido dentro del archivo debe seguir el formato CSV (valores separados por coma).

## 📝 Formato del Archivo TXT

### Estructura del archivo

El archivo puede tener:
- **Extensión:** `.txt` (o cualquier otra, solo ajusta el patrón en el script)
- **Nombre:** Cualquier nombre (ej: `datos.txt`, `mediciones_20240115.txt`, `buque_data.txt`)
- **Contenido:** Líneas con datos CSV

### Formato de cada línea

Cada línea del archivo TXT debe tener este formato:

```
temperatura,humedad,presion,api_key,fecha_hora
```

**Ejemplo:**
```
23.5,60,1012,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:30:45
```

### Características

✅ **Permitido:**
- Líneas con datos CSV (una medición por línea)
- Líneas vacías (se ignoran)
- Líneas que empiezan con `#` (comentarios, se ignoran)
- Cualquier nombre de archivo

❌ **No permitido:**
- Formato diferente a CSV dentro del TXT
- Menos de 4 valores por línea
- Valores no numéricos en temperatura/humedad/presión

## 📋 Ejemplo Completo de Archivo TXT

```txt
# Archivo de mediciones del buque
# Generado el 2024-01-15
# Formato: temperatura,humedad,presion,api_key,fecha_hora

23.5,60,1012,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:30:45
24.2,58,1013,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:31:15
22.8,65,1010,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:31:45
25.1,55,1015,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:32:15
23.9,62,1011,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:32:45
```

## 🔄 Cómo Funciona

1. **El buque genera archivo TXT** → Ejemplo: `mediciones.txt`
2. **El archivo contiene líneas CSV** → Una medición por línea
3. **El script lee el TXT** → Procesa línea por línea
4. **Envía cada línea al servidor** → Vía HTTP POST
5. **Archivo procesado** → Se mueve a carpeta `procesados/`

## 📁 Ubicación de Archivos

El buque debe guardar los archivos TXT en:

```
buque/
└── archivos_buque/
    ├── mediciones_20240115.txt
    ├── datos_buque.txt
    └── mediciones_20240116.txt
```

## 🧪 Prueba Rápida

1. **Crear archivo de prueba:**
   ```bash
   echo "23.5,60,1012,BUQUE2024_SECRET_KEY_XYZ789,2024-01-15 10:30:45" > archivos_buque/test.txt
   ```

2. **Ejecutar script:**
   ```bash
   php procesar_archivos_txt.php
   ```

3. **Verificar:**
   - Los datos deben aparecer en `ver_datos.php`
   - El archivo debe moverse a `procesados/`

## ❓ Preguntas Frecuentes

### ¿Puede ser otro formato además de TXT?
Sí, puedes cambiar el patrón en el script:
```php
$patronArchivos = '*.dat';  // Para archivos .dat
$patronArchivos = '*.csv';  // Para archivos .csv
$patronArchivos = 'mediciones_*';  // Cualquier patrón
```

### ¿Puede el contenido ser JSON en lugar de CSV?
No directamente, pero puedes modificar el script para parsear JSON. El endpoint actual espera CSV.

### ¿Puede tener encabezados?
Sí, los encabezados se ignoran si empiezan con `#` o si no tienen el formato correcto.

### ¿Puede tener múltiples mediciones en una línea?
No, cada línea debe ser una medición completa.

---

**Resumen:** ✅ Sí, archivos TXT funcionan perfectamente. El contenido debe ser CSV (valores separados por coma).

