# ✅ Actualizar Assets con .gitattributes

## 🎯 Pregunta

¿El `.gitattributes` con `merge=ours` bloquea el comando `php artisan project:update-assets`?

## ✅ Respuesta: NO

**El `.gitattributes` NO afecta el comando `project:update-assets`.**

### ¿Por qué?

1. **`.gitattributes` solo afecta operaciones de Git:**
   - Merge
   - Pull
   - Rebase
   - Operaciones de Git en general

2. **`project:update-assets` es una operación del sistema de archivos:**
   - Copia archivos físicamente
   - NO interactúa con Git
   - Es un comando de Laravel, no de Git

3. **Son independientes:**
   - `.gitattributes` protege durante **pulls/merges**
   - `project:update-assets` actualiza archivos **físicamente**

---

## 🚀 Cómo Funciona

### Durante Pull/Merge (Git):
```
git pull origin cd-system
  ↓
Git ve .gitattributes
  ↓
merge=ours → Mantiene versión local
  ↓
NO sobrescribe archivos protegidos
```

### Durante Update Assets (Laravel):
```
php artisan project:update-assets public/cd-project/assets --backup
  ↓
Laravel copia archivos físicamente
  ↓
NO interactúa con Git
  ↓
SÍ actualiza los archivos
```

---

## ✅ Proceso Correcto para Actualizar Assets

### Paso 1: Colocar Assets en la Carpeta Temporal

```bash
# Colocar tus nuevos assets en:
public/cd-project/assets/

# Archivos requeridos:
# - logo.png
# - logo-2.png
# - logo-alternative.png
# - favicon.ico
# - apple-touch-icon.png
# - favicon.svg
# - web-app-manifest-192x192.png
# - web-app-manifest-512x512.png
# - site.webmanifest
```

### Paso 2: Ejecutar el Comando

```bash
# El comando SÍ funcionará, .gitattributes NO lo bloquea
php artisan project:update-assets public/cd-project/assets --backup
```

**El comando:**
- ✅ Copiará los logos a `public/cd-project/img/logos/`
- ✅ Copiará los favicons a `public/cd-project/img/favicon/`
- ✅ Creará backup si usas `--backup`
- ✅ NO será bloqueado por `.gitattributes`

### Paso 3: Verificar que se Actualizaron

```bash
# Verificar logos
ls -la public/cd-project/img/logos/

# Verificar favicons
ls -la public/cd-project/img/favicon/
```

### Paso 4: Commitear los Cambios (Opcional)

```bash
# Agregar los nuevos assets
git add public/cd-project/img/logos/
git add public/cd-project/img/favicon/

# Commitear
git commit -m "feat: Actualizar assets del proyecto"
```

---

## 🔍 Si el Comando No Funciona

### Posibles Causas (NO relacionadas con .gitattributes):

1. **Permisos de archivos:**
   ```bash
   # Verificar permisos
   ls -la public/cd-project/assets/
   
   # Dar permisos si es necesario
   chmod 644 public/cd-project/assets/*
   ```

2. **Ruta incorrecta:**
   ```bash
   # Verificar que la carpeta existe
   ls -la public/cd-project/assets/
   
   # Usar ruta absoluta si hay dudas
   php artisan project:update-assets /ruta/absoluta/a/assets --backup
   ```

3. **Archivos con nombres incorrectos:**
   ```bash
   # Verificar nombres (case-sensitive)
   ls -la public/cd-project/assets/ | grep -i logo
   
   # Deben ser exactamente:
   # - logo.png (no Logo.png ni LOGO.PNG)
   # - logo-2.png
   # - logo-alternative.png
   ```

4. **Problema con el comando:**
   ```bash
   # Ver ayuda del comando
   php artisan project:update-assets --help
   
   # Ejecutar con verbose
   php artisan project:update-assets public/cd-project/assets --backup -v
   ```

---

## 📋 Resumen: Cuándo se Aplica Cada Protección

| Operación | ¿Protegido por .gitattributes? | ¿Se Puede Actualizar? |
|-----------|-------------------------------|----------------------|
| `git pull` | ✅ SÍ | ❌ NO (se mantiene versión local) |
| `git merge` | ✅ SÍ | ❌ NO (se mantiene versión local) |
| `php artisan project:update-assets` | ❌ NO | ✅ SÍ (actualiza físicamente) |
| Editar manualmente | ❌ NO | ✅ SÍ (editas directamente) |
| `cp` o `mv` manual | ❌ NO | ✅ SÍ (copias directamente) |

---

## ✅ Conclusión

**Puedes actualizar assets cuando quieras usando:**
```bash
php artisan project:update-assets public/cd-project/assets --backup
```

**El `.gitattributes` NO lo bloquea.**

**El `.gitattributes` solo protege durante pulls/merges de Git.**

---

## 🚀 Ejemplo Completo

```bash
# 1. Colocar nuevos assets
cp /ruta/a/nuevos/assets/* public/cd-project/assets/

# 2. Ejecutar comando (SÍ funcionará)
php artisan project:update-assets public/cd-project/assets --backup

# 3. Verificar
ls -la public/cd-project/img/logos/
ls -la public/cd-project/img/favicon/

# 4. Commitear (opcional)
git add public/cd-project/img/
git commit -m "feat: Actualizar assets del proyecto"

# 5. En el futuro, cuando hagas pull:
git pull origin cd-system
# Los assets NO se sobrescribirán gracias a .gitattributes
```

---

**Última actualización:** Diciembre 2024