codigo0/PLAN_LIMPIEZA_DOCKER.md

# 📁 PLAN DE LIMPIEZA Y OPTIMIZACIÓN DEL PROYECTO (Docker)

**Proyecto:** EMERGES TES - Protocolo Rápido  
**Base:** React 18 + TypeScript + Vite + TailwindCSS + **Docker**  
**Fecha:** 2024-12-19  
**Ruta:** `/home/planetazuzu/protocolo-r-pido`

---

## 🎯 OBJETIVOS DE LIMPIEZA

- ✅ Eliminar archivos innecesarios (backups, duplicados, obsoletos)
- ✅ Optimizar estructura (organizar recursos pendientes)
- ✅ Reducir tamaño del proyecto sin afectar funcionalidad
- ✅ Mantener integridad de la aplicación PWA
- ✅ Consolidar documentación redundante
- ✅ **Optimizar para despliegue con Docker**

---

## 🐳 DESPLIEGUE CON DOCKER (Nuevo)

### Configuración Docker Creada

- ✅ `Dockerfile` - Multi-stage build optimizado
- ✅ `docker-compose.yml` - Gestión simplificada
- ✅ `deploy-docker.sh` - Script de despliegue
- ✅ `.dockerignore` - Optimización de build
- ✅ `.github/workflows/deploy-docker.yml` - Auto-deploy
- ✅ `DEPLOYMENT_DOCKER.md` - Documentación completa

### Ventajas de Docker

- ✅ **Aislamiento:** App corre en su propio contenedor
- ✅ **Consistencia:** Mismo entorno en dev y producción
- ✅ **Fácil despliegue:** Un solo comando
- ✅ **Rollback fácil:** Volver a imagen anterior
- ✅ **Sin dependencias:** No requiere Node.js en servidor

---

## 📂 ESTRUCTURA ACTUAL PARA LIMPIEZA

### 1. 📦 ARCHIVOS DEL SISTEMA Y TEMPORALES (ELIMINAR)

```bash
# Archivos del sistema operativo
find . -type f -name ".DS_Store" -delete
find . -type f -name "Thumbs.db" -delete
find . -type f -name ".localized" -delete
find . -type f -name "*.swp" -delete  # Vim swap files
find . -type f -name "*.swo" -delete

# Logs de npm/yarn
find . -type f -name "npm-debug.log*" -delete
find . -type f -name "yarn-debug.log*" -delete
find . -type f -name "yarn-error.log*" -delete

# Archivos de IDE (pero mantener .vscode/extensions.json si existe)
rm -rf .idea/
rm -rf *.iml
rm -rf *.sublime-*
```

### 2. 🗑️ CARPETAS DE BACKUP Y REDUNDANTES (MOVER/ELIMINAR)

#### Carpeta principal a limpiar: `_BACKUP_MD/` (203 archivos)

```bash
# Crear carpeta de archivos eliminados (por si acaso)
mkdir -p ../deleted_backups_$(date +%Y%m%d)

# Mover archivos .md duplicados (ya existen en public/manual/)
find _BACKUP_MD/ -name "*.md" -exec mv {} ../deleted_backups_$(date +%Y%m%d)/ \;

# Mover archivos .docx (no necesarios en producción)
find _BACKUP_MD/ -name "*.docx" -exec mv {} ../deleted_backups_$(date +%Y%m%d)/ \;

# Mover scripts Python de backup
find _BACKUP_MD/ -name "*.py" -exec mv {} ../deleted_backups_$(date +%Y%m%d)/ \;

# Finalmente eliminar carpeta vacía
rmdir _BACKUP_MD/
```

#### Carpeta: `imagenes-pendientes/` (60 archivos)

```bash
# Verificar qué imágenes son realmente necesarias
echo "=== IMÁGENES PENDIENTES ==="
find imagenes-pendientes/ -type f \( -name "*.png" -o -name "*.jpg" -o -name "*.svg" \) | wc -l

# Mover imágenes que coinciden con nombres existentes en public/assets/
for img in imagenes-pendientes/*; do
  base=$(basename "$img")
  if [ ! -f "public/assets/infografias/$base" ]; then
    echo "Manteniendo pendiente: $base"
  else
    echo "Duplicado, moviendo: $base"
    mv "$img" ../deleted_backups_$(date +%Y%m%d)/
  fi
done

# Si la carpeta queda vacía, eliminar
rmdir imagenes-pendientes/ 2>/dev/null || echo "Carpeta con archivos restantes"
```

#### Carpeta: `MANUAL_TES_DIGITAL/` (110 archivos .md)

```bash
# Esta carpeta parece duplicado de public/manual/
# Mover fuera del proyecto
mv MANUAL_TES_DIGITAL/ ../backup_manual_completo_$(date +%Y%m%d)/
```

### 3. 📝 DOCUMENTACIÓN REDUNDANTE (CONSOLIDAR)

```bash
# Crear carpeta organizada para documentación
mkdir -p docs/consolidated/
mkdir -p docs/archive/

# Archivos de deployment a mantener:
# - DEPLOYMENT_DOCKER.md (NUEVO - Docker)
# - DEPLOYMENT_SERVER.md (PM2)
# - VERCEL_DEPLOYMENT.md
# - DEPLOYMENT_GITHUB.md
# - RESUMEN_DEPLOY_8607.md

# Archivos de desarrollo a mantener:
# - ESTADO_FUNCIONALIDADES.md
# - SPA_ROUTING_CONFIG.md
# - CHECKLIST_PWA_COMPLETA.md
# - VERIFICACION_PWA.md

# Mover el resto a archive
find . -maxdepth 1 -name "*.md" ! -name "README.md" ! -name "DEPLOYMENT_*.md" ! -name "RESUMEN_*.md" ! -name "ESTADO_*.md" ! -name "SPA_*.md" ! -name "CHECKLIST_*.md" ! -name "VERIFICACION_*.md" -exec mv {} docs/archive/ \;
```

### 4. 🐍 SCRIPTS PYTHON OBSOLETOS

```bash
# Crear carpeta para scripts de mantenimiento
mkdir -p scripts/maintenance/
mkdir -p scripts/archive/

# Scripts que SÍ deben mantenerse (útiles):
# - scripts/verificar-manual.ts (TypeScript)

# Mover scripts obsoletos a archive
mv analisis_profundo_contenido.py scripts/archive/ 2>/dev/null || true
mv buscar_multimedia_exhaustivo.py scripts/archive/ 2>/dev/null || true
mv copiar_archivos_manual.py scripts/archive/ 2>/dev/null || true
mv generar_documento_word.py scripts/archive/ 2>/dev/null || true
mv generar_reportes_app.py scripts/archive/ 2>/dev/null || true
mv mejorar_reporte_1.py scripts/archive/ 2>/dev/null || true
mv reorganizar_proyecto.sh scripts/archive/ 2>/dev/null || true
```

### 5. ⚙️ CONFIGURACIONES DE DESPLIEGUE

#### Con Docker (NUEVO - Mantener)

```bash
# Configuraciones Docker a MANTENER:
# - Dockerfile ✅
# - docker-compose.yml ✅
# - deploy-docker.sh ✅
# - .dockerignore ✅
# - .github/workflows/deploy-docker.yml ✅
```

#### Sin Docker (Opcional - Mover a backup)

```bash
# Configuraciones a MOVER a backup (pero mantener en repo):
mkdir -p configs/backup/

# PM2 (alternativa a Docker)
# - ecosystem.config.js (mantener por si acaso)
# - deploy.sh (mantener por si acaso)

# Otras plataformas (mover a backup)
mv vercel.json configs/backup/ 2>/dev/null || true
mv netlify.toml configs/backup/ 2>/dev/null || true
mv nginx.conf.example configs/backup/ 2>/dev/null || true
mv public/.htaccess configs/backup/ 2>/dev/null || true
mv public/_redirects configs/backup/ 2>/dev/null || true
```

### 6. 🗂️ OPTIMIZAR ESTRUCTURA DE ARCHIVOS

```bash
# 1. Limpiar node_modules (se reinstalarán en Docker build)
rm -rf node_modules
rm -f package-lock.json

# 2. Verificar archivos grandes
find . -type f -size +5M 2>/dev/null | head -10

# 3. Limpiar posibles builds anteriores
rm -rf dist/
rm -rf build/
rm -rf .next/
rm -rf out/

# 4. Limpiar imágenes Docker antiguas (opcional)
docker system prune -a --volumes 2>/dev/null || true
```

---

## 📋 SCRIPT COMPLETO DE LIMPIEZA (Docker)

```bash
#!/bin/bash
# cleanup_project_docker.sh

set -e  # Detenerse en errores

echo "🚀 INICIANDO LIMPIEZA DEL PROYECTO (Docker)"
echo "==========================================="

# 1. Backup del estado actual
BACKUP_DIR="../project_backup_$(date +%Y%m%d_%H%M%S)"
echo "📦 Creando backup en: $BACKUP_DIR"
mkdir -p "$BACKUP_DIR"
tar -czf "$BACKUP_DIR/project_backup.tar.gz" . --exclude='node_modules' --exclude='dist' --exclude='.git'

# 2. Archivos del sistema
echo "🗑️  Limpiando archivos del sistema..."
find . -type f \( -name ".DS_Store" -o -name "Thumbs.db" -o -name "*.swp" -o -name "*.swo" \) -delete

# 3. Logs
echo "📝 Eliminando logs..."
find . -type f -name "*.log" -delete

# 4. Carpetas de backup grandes
if [ -d "_BACKUP_MD" ]; then
    echo "📚 Manejando _BACKUP_MD..."
    mkdir -p "$BACKUP_DIR/backup_md"
    mv _BACKUP_MD/* "$BACKUP_DIR/backup_md/" 2>/dev/null || true
    rmdir _BACKUP_MD 2>/dev/null || true
fi

# 5. Manual duplicado
if [ -d "MANUAL_TES_DIGITAL" ]; then
    echo "📖 Manejando manual duplicado..."
    mv MANUAL_TES_DIGITAL "$BACKUP_DIR/"
fi

# 6. Imágenes pendientes (solo mover duplicados)
if [ -d "imagenes-pendientes" ]; then
    echo "🖼️  Procesando imágenes pendientes..."
    mkdir -p "$BACKUP_DIR/imagenes_pendientes"
    for img in imagenes-pendientes/*; do
        if [ -f "$img" ]; then
            base=$(basename "$img")
            if [ -f "public/assets/infografias/$base" ]; then
                mv "$img" "$BACKUP_DIR/imagenes_pendientes/"
            fi
        fi
    done
fi

# 7. Limpiar node_modules (Docker los instalará)
echo "📦 Limpiando dependencias locales..."
rm -rf node_modules
rm -f package-lock.json

# 8. Limpiar builds anteriores
echo "🏗️  Limpiando builds anteriores..."
rm -rf dist/ build/ .next/ out/

# 9. Organizar documentación
echo "📄 Organizando documentación..."
mkdir -p docs/consolidated
mkdir -p docs/archive

# Mover archivos .md a archive (excepto esenciales)
find . -maxdepth 1 -name "*.md" ! -name "README.md" ! -name "DEPLOYMENT_*.md" ! -name "RESUMEN_*.md" ! -name "ESTADO_*.md" ! -name "SPA_*.md" ! -name "CHECKLIST_*.md" ! -name "VERIFICACION_*.md" -exec mv {} docs/archive/ \;

# 10. Scripts de mantenimiento
echo "🐍 Organizando scripts..."
mkdir -p scripts/archive
mv *.py scripts/archive/ 2>/dev/null || true
mv *.sh scripts/archive/ 2>/dev/null || true

# Mantener scripts esenciales en su lugar
if [ -f "scripts/verificar-manual.ts" ]; then
    mv scripts/archive/verificar-manual.ts scripts/ 2>/dev/null || true
fi

# Mantener scripts de deploy
if [ -f "deploy-docker.sh" ]; then
    mv scripts/archive/deploy-docker.sh . 2>/dev/null || true
fi

# 11. Verificar Docker
echo "🐳 Verificando Docker..."
if command -v docker &> /dev/null; then
    echo "✅ Docker instalado"
    docker --version
else
    echo "⚠️  Docker no instalado (opcional para desarrollo local)"
fi

echo "✅ LIMPIEZA COMPLETADA"
echo "======================"
echo "Espacio liberado aproximado:"
du -sh . "$BACKUP_DIR"
echo ""
echo "🎯 Proyecto listo para desarrollo con Docker"
echo ""
echo "📝 Próximos pasos:"
echo "   1. docker-compose up -d --build  (construir y ejecutar)"
echo "   2. docker-compose logs -f        (ver logs)"
echo "   3. ./deploy-docker.sh            (deploy completo)"
```

---

## 🔍 VERIFICACIÓN POST-LIMPIEZA (Docker)

```bash
# 1. Verificar que Docker funciona
docker --version
docker compose version

# 2. Construir imagen Docker
docker-compose build

# 3. Verificar que la imagen se construyó
docker images | grep emerges-tes

# 4. Ejecutar contenedor
docker-compose up -d

# 5. Verificar que la app funciona
curl http://localhost:8607

# 6. Ver logs
docker-compose logs -f

# 7. Verificar tamaño del proyecto
du -sh .  # Debería ser < 100MB (sin node_modules)

# 7. Verificar estructura final
tree -L 2 -I 'node_modules|dist|build|.git'
```

---

## 🏗️ ESTRUCTURA FINAL OPTIMIZADA (Docker)

```
protocolo-r-pido/
├── public/                    # Archivos públicos (78 archivos)
│   ├── assets/               # Imágenes optimizadas
│   ├── manual/               # Manual médico (78 .md)
│   ├── manifest.json
│   ├── sw.js
│   └── favicon.svg
├── src/                      # Código fuente (~136 archivos)
│   ├── components/           # Componentes React
│   ├── data/                 # Datos TypeScript
│   ├── hooks/               # Custom hooks
│   ├── pages/               # Páginas
│   └── utils/               # Utilidades
├── docs/                     # Documentación consolidada
│   ├── consolidated/        # Docs esenciales
│   └── archive/            # Docs antiguas
├── scripts/                  # Scripts esenciales
│   └── verificar-manual.ts
├── .github/                  # CI/CD
│   └── workflows/
│       ├── deploy.yml       # PM2 (alternativa)
│       └── deploy-docker.yml # Docker (principal)
├── Dockerfile               # 🐳 Docker build
├── docker-compose.yml       # 🐳 Docker compose
├── deploy-docker.sh         # 🐳 Script deploy Docker
├── .dockerignore           # 🐳 Docker ignore
├── package.json
├── vite.config.ts
├── tailwind.config.ts
├── tsconfig.*.json
└── README.md
```

---

## 📊 ESTIMACIÓN DE ESPACIO LIBERADO

| Antes | Después | Liberado |
|-------|---------|----------|
| ~500 MB | ~150 MB | ~350 MB |
| 400+ archivos | ~250 archivos | ~150 archivos |

**Con Docker:**
- ✅ No necesita `node_modules` en servidor
- ✅ Build se hace en contenedor
- ✅ Imagen Docker optimizada (~200MB)

---

## ⚠️ PRECAUCIONES

- ✅ **Backup primero:** El script crea backup automático
- ✅ **Probar Docker:** Verificar que `docker-compose build` funcione
- ✅ **Verificar PWA:** Service Worker y manifest deben funcionar
- ✅ **Manual médico:** No eliminar archivos de `public/manual/`
- ✅ **Imágenes esenciales:** No eliminar de `public/assets/`
- ✅ **Dockerfile:** No eliminar archivos Docker

---

## 🔄 PROCESO RECOMENDADO (Docker)

```bash
# 1. Backup manual extra (por si acaso)
cp -r /home/planetazuzu/protocolo-r-pido /home/planetazuzu/protocolo-backup

# 2. Ejecutar limpieza
cd /home/planetazuzu/protocolo-r-pido
bash cleanup_project_docker.sh

# 3. Verificar Docker
docker-compose build
docker-compose up -d

# 4. Verificar que funciona
curl http://localhost:8607

# 5. Si todo está bien, eliminar backups viejos
# (Mantener solo el más reciente)
```

---

## 🐳 VENTAJAS DE DOCKER EN LIMPIEZA

1. **No necesita node_modules local:** Docker los instala en build
2. **Build aislado:** No contamina el sistema
3. **Fácil rollback:** Volver a imagen anterior
4. **Reproducible:** Mismo resultado en cualquier servidor
5. **Limpieza automática:** `.dockerignore` excluye archivos innecesarios

---

## 📝 CHECKLIST DE LIMPIEZA CON DOCKER

- [ ] Backup creado
- [ ] Archivos del sistema eliminados
- [ ] Carpetas de backup movidas
- [ ] Documentación consolidada
- [ ] Scripts obsoletos archivados
- [ ] Configuraciones organizadas
- [ ] `node_modules` eliminado (Docker lo instalará)
- [ ] Builds anteriores eliminados
- [ ] Dockerfile verificado
- [ ] `docker-compose build` funciona
- [ ] `docker-compose up -d` funciona
- [ ] App accesible en `http://localhost:8607`
- [ ] Logs accesibles: `docker-compose logs -f`

---

**Última actualización:** 2024-12-19  
**Despliegue:** Docker (puerto 8607)