# 🚀 Instrucciones de Configuración Personalizada

## ¡Tu aplicación está lista! ✅

He creado un sistema completo y flexible que se adapta a tu estructura de Google Sheets. Aquí tienes todo lo que necesitas para configurarlo:

## 📋 **Pasos para Configurar**

### 1. **Configurar los Nombres de Columnas**

Ejecuta el configurador interactivo:
```bash
php configure_fields.php
```

Este script te preguntará:
- Nombres exactos de las columnas en tus hojas de Google Sheets
- Información de tu empresa
- Tipos de informe que manejas
- Configuración de imágenes

### 2. **Probar la Configuración**

```bash
php test.php
```

### 3. **Generar Ejemplos Personalizados**

```bash
php generate_examples.php
```

## 🔧 **Configuración Manual (Alternativa)**

Si prefieres configurar manualmente, edita el archivo `field_mapping.php`:

```php
// Ejemplo de configuración
'visita' => [
  'idVisita' => 'Id_Visita',       // ← Cambia por tu nombre de columna
  'sitio' => 'SITIO',              // ← Cambia por tu nombre de columna
  'area' => 'AREA',                // ← Cambia por tu nombre de columna
  // ... más campos
],
```

## 📱 **Configurar Google Apps Script**

1. Abre tu Google Sheets
2. Ve a `Extensiones > Apps Script`
3. Copia el código de `google_apps_script_example.js`
4. **IMPORTANTE**: Actualiza la sección `FIELD_MAPPING` con los nombres exactos de tus columnas:

```javascript
const FIELD_MAPPING = {
  visita: {
    idVisita: 'Tu_Nombre_Columna_Id_Visita', // ← CAMBIAR
    sitio: 'Tu_Nombre_Columna_SITIO',        // ← CAMBIAR
    area: 'Tu_Nombre_Columna_AREA',          // ← CAMBIAR
    // ... etc
  },
  informe: {
    idVisita: 'Tu_Nombre_Columna_Id_Visita', // ← CAMBIAR
    fechaEjecucion: 'Tu_Nombre_Columna_Fecha_informe', // ← CAMBIAR
    // ... etc
  }
};
```

5. Cambia la URL del generador:
```javascript
const PDF_GENERATOR_URL = 'https://tu-dominio.com/giadocgenerator/';
```

## 🎨 **Plantillas Disponibles**

Basándome en tus 8 plantillas de Google Docs, he creado estas plantillas:

### Plantillas Base:
- `InspeccionTemplate` - Para inspecciones generales
- `MantenimientoTemplate` - Para mantenimiento preventivo/correctivo

### Plantillas Personalizables:
Puedes crear plantillas específicas para:
- `InspeccionElectricaTemplate`
- `CertificacionTemplate`
- `AuditoriaTemplate`
- `DiagnosticoTemplate`
- `MedicionTemplate`

## 📄 **Estructura de tus Hojas de Google Sheets**

### Data_Visita
```
| Id_Visita | SITIO | AREA | REGION | ...
```

### Data_Informe
```
| Id_Informe | Id_Visita | Fecha informe | Tecnico Nombre | ...
```

### Secciones (checklist)
Ejemplos: `Data_Seguridad`, `Data_Fachada`, `Data_Front`, `Data_Office`, `Data_Sshh`, `Data_Limpieza`, `Data_Importante`, `Data_Otros`, `Data_Observacion`.

## 🖼️ **Configuración de Imágenes**

El sistema soporta dos formatos:

### Opción 1: Columnas separadas
```
| Imagen1 | Imagen2 | Imagen3 | Imagen4 | Imagen5 |
```

### Opción 2: Una columna con URLs separadas por comas
```
| Imagenes |
| url1,url2,url3 |
```

**URLs de Google Drive**: El sistema convierte automáticamente las URLs de Google Drive a formato público.

## 🧪 **Probar la Aplicación**

### Desde Google Apps Script:
```javascript
// Probar conexión
probarConexion();

// Generar informe específico (por Id_Visita + Fecha informe)
generarInformePDF('TU-ID-VISITA', '2024-01-15');

// Generar múltiples informes
generarInformesLote([
  { idVisita: 'VIS-001', fechaInforme: '2024-01-15' },
  { idVisita: 'VIS-002', fechaInforme: '2024-01-15' },
]);
```

### Usando ejemplos JSON:
Los archivos `ejemplos_personalizados.json` contienen datos de prueba que puedes enviar vía POST.

## 🔍 **Debugging**

### Ver logs:
```bash
# Windows
type logs\app_2025-09-24.log

# Ver errores específicos
findstr "ERROR" logs\app_*.log
```

### Logs en tiempo real:
```bash
Get-Content logs\app_2025-09-24.log -Wait -Tail 10
```

## ⚙️ **Configuración de Empresa**

En `field_mapping.php` configura tu empresa:

```php
'empresa' => [
    'nombre' => 'Tu Empresa S.A.C.',
    'direccion' => 'Tu dirección',
    'telefono' => '+51 999 999 999',
    'email' => 'contacto@tuempresa.com',
    'ruc' => '20123456789',
    'logo_url' => 'https://tu-logo.com/logo.png'
]
```

## 📋 **Tipos de Servicio Personalizados**

Puedes definir tipos específicos como:
- `inspeccion_electrica`
- `mantenimiento_preventivo`
- `certificacion_seguridad`
- `auditoria_tecnica`
- `diagnostico_equipos`

## 🚨 **Solución de Problemas**

### Error: "Columna no encontrada"
- Verifica que los nombres en `FIELD_MAPPING` coincidan exactamente con tu Google Sheets
- Ejecuta `configure_fields.php` para reconfigurar

### Error: "Imágenes no cargan"
- Asegúrate de que las URLs de Google Drive sean públicas
- Usa el formato: `https://drive.google.com/uc?id=FILE_ID`

### Error: "Datos inválidos"
- Revisa que los campos obligatorios estén presentes
- Verifica el formato de fechas (YYYY-MM-DD)

## 📞 **Soporte**

Si necesitas ayuda:
1. Revisa los logs en `logs/`
2. Ejecuta `php test.php` para diagnóstico
3. Verifica la configuración en `field_mapping.php`

## 🎯 **¡Tu aplicación está 100% funcional!**

Solo necesitas:
1. ✅ Configurar los nombres de columnas
2. ✅ Ajustar el Google Apps Script
3. ✅ Probar con tus datos reales

¡Todo está listo para generar PDF profesionales desde tu Google Sheets! 🎉