# 🎓 Configuración del Encabezado de Certificados

## 📋 Información General

Los certificados en PDF ahora incluyen un **encabezado profesional** con el logo y datos de tu empresa. Todos estos elementos se configuran mediante variables de entorno en el archivo `.env`.

## 🔧 Configuración del .env

Edita tu archivo `.env` y actualiza las siguientes variables con los datos de tu empresa:

```env
# ===== CONFIGURACIÓN DE DATOS DE LA EMPRESA =====
EMPRESA_NOMBRE=Escuela de Fútbol
EMPRESA_RAZON_SOCIAL=Escuela de Fútbol S.A.S
EMPRESA_NIT=123456789-1
EMPRESA_DIRECCION=Calle Principal 123, Apartado 456
EMPRESA_CIUDAD=Bogotá, Colombia
EMPRESA_TELEFONO=+57 1 2345678
EMPRESA_EMAIL=info@escuelafutbol.com
EMPRESA_WEBSITE=www.escuelafutbol.com
EMPRESA_LOGO_PATH=logo.png
```

### Descripción de cada variable:

| Variable | Descripción | Ejemplo |
|----------|-------------|---------|
| `EMPRESA_NOMBRE` | Nombre común de la empresa | "Escuela de Fútbol" |
| `EMPRESA_RAZON_SOCIAL` | Razón social completa (como aparece en registros) | "Escuela de Fútbol S.A.S" |
| `EMPRESA_NIT` | Número de Identificación Tributaria | "123456789-1" |
| `EMPRESA_DIRECCION` | Dirección completa | "Calle Principal 123" |
| `EMPRESA_CIUDAD` | Ciudad y país | "Bogotá, Colombia" |
| `EMPRESA_TELEFONO` | Número telefónico de contacto | "+57 1 2345678" |
| `EMPRESA_EMAIL` | Email de contacto | "info@escuelafutbol.com" |
| `EMPRESA_WEBSITE` | Sitio web de la empresa | "www.escuelafutbol.com" |
| `EMPRESA_LOGO_PATH` | Nombre del archivo del logo | "logo.png" |

## 📁 Ubicación del Logo

El logo debe estar ubicado en:

```
storage/app/public/logo.png
```

### Pasos para agregar el logo:

1. **Coloca el archivo de imagen** en la carpeta `storage/app/public/`
2. **Actualiza el nombre** en el `.env` si es diferente a `logo.png`
3. **Formatos soportados**: PNG, JPG, JPEG, GIF
4. **Tamaño recomendado**: 100x100 px (se ajustará automáticamente)

### Crear carpeta si no existe:
```bash
mkdir -p storage/app/public
# Luego copia tu logo.png aquí
```

## 🎨 Elementos que se Muestran en el Encabezado

El encabezado de cada certificado incluirá:

```
[LOGO]    |  Razón Social          | ⭐
          |  Nombre de Empresa     | OFICIAL
          |  NIT: 123456789-1      |
          |  Dirección             |
          |  Ciudad, País          |
          |  Teléfono: +57...      |
          |  email@empresa.com     |
          |  www.empresa.com       |
```

## 📄 Estructura Completa del Certificado

```
┌─────────────────────────────────────────────┐
│ [LOGO] | DATOS EMPRESA | SELLO OFICIAL ⭐  │
├─────────────────────────────────────────────┤
│                                             │
│   CERTIFICADO DE PARTICIPACIÓN              │
│   Reconocimiento Oficial                    │
│                                             │
│   Certifica que:                            │
│                                             │
│   NOMBRE DEL DEPORTISTA                     │
│   ━━━━━━━━━━━━━━━━━━━━━                     │
│                                             │
│   Ha completado satisfactoriamente...       │
│                                             │
│   [Descripción del programa]                │
│                                             │
│   Expedido: dd/mm/yyyy | Nº: CERT-2026-001 │
│   Válido hasta: dd/mm/yyyy                  │
│                                             │
├─────────────────────────────────────────────┤
│  [FIRMA] | FECHA EMISIÓN                    │
│  Director | dd/mm/yyyy                      │
├─────────────────────────────────────────────┤
│  Certificado N° CERT-2026-001               │
│  ✓ Documento Oficial de [EMPRESA]           │
└─────────────────────────────────────────────┘
```

## ✅ Verificar Configuración

Después de configurar las variables en el `.env`:

1. **Limpia el caché** (opcional pero recomendado):
   ```bash
   php artisan config:cache
   ```

2. **Genera una certificación de prueba**
3. **Descarga el PDF** para verificar que el encabezado aparece correctamente
4. **Verifica que el logo se muestre** en la esquina superior izquierda

## 🔴 Solución de Problemas

### El logo no aparece en el PDF
- ✅ Verifica que el archivo existe en `storage/app/public/`
- ✅ Confirma que el nombre en `.env` coincide con el nombre del archivo
- ✅ Asegúrate de que `EMPRESA_LOGO_PATH` sea correcta

### Los datos de la empresa no se muestran
- ✅ Verifica que las variables están definidas en `.env`
- ✅ Ejecuta `php artisan config:cache` para limpiar el caché
- ✅ Reinicia tu servidor de desarrollo

### El logo se ve pixelado o distorsionado
- ✅ Usa una imagen de mayor resolución (mínimo 200x200 px)
- ✅ Usa formato PNG con fondo transparente para mejores resultados
- ✅ Ajusta el tamaño del logo en el CSS si es necesario

## 📧 Email con PDF Adjunto

Cuando se crea una certificación, se envía automáticamente un **email** al deportista con:

- ✅ El PDF del certificado adjunto
- ✅ Link para descargar desde la plataforma
- ✅ Detalles de la certificación
- ✅ Datos de contacto de la empresa (del .env)

## 🚀 Próximos Pasos

1. Configura todos los datos en el `.env`
2. Sube tu logo a `storage/app/public/`
3. Crea una certificación de prueba
4. Descarga el PDF para verificar
5. Personaliza el CSS en `pdf.blade.php` si necesitas cambios adicionales

---

**¿Necesitas ayuda?** Revisa la sección de solución de problemas arriba.