================================================================================ LOTIFY REQUESTER - INSTRUCCIONES DE USO CON DOCKER ================================================================================ 📦 PROYECTO DOCKERIZADO CON ÉXITO ✅ La base de datos backup_peticiones.db es ahora PERSISTENTE ================================================================================ PASOS PARA INICIAR ================================================================================ 1️⃣ MIGRAR BASE DE DATOS EXISTENTE (solo la primera vez) Ejecuta: migrate_db.bat Esto moverá backup_peticiones.db a data/backup_peticiones.db 2️⃣ VERIFICAR QUE DOCKER ESTÁ LISTO Ejecuta: test_docker.bat Verifica que Docker Desktop está instalado y corriendo 3️⃣ INICIAR EL SERVICIO Ejecuta: docker-start.bat O manualmente: docker-compose up -d --build 4️⃣ VERIFICAR QUE FUNCIONA Abre en el navegador: http://localhost:8073/health Deberías ver: {"status": "ok", "message": "..."} 5️⃣ ACCEDER AL PANEL DE ADMINISTRACIÓN URL: http://localhost:8073/admin Usuario: lotify Contraseña: Lot1fyrequest3r$ ================================================================================ COMANDOS ÚTILES ================================================================================ ▶️ Iniciar servicio: docker-start.bat 📊 Ver logs: docker-logs.bat ⏹️ Detener servicio: docker-stop.bat 🔄 Reiniciar: docker-compose restart 📋 Ver estado: docker ps ================================================================================ PERSISTENCIA DE DATOS ================================================================================ ✅ La base de datos se guarda en: data/backup_peticiones.db ✅ Los datos PERSISTEN en estos casos: - Reinicio del contenedor - Detener y volver a iniciar (docker-compose down + up) - Actualización del código - Reconstrucción de la imagen ❌ Los datos SE PIERDEN solo si: - Eliminas el directorio data/ - Ejecutas: docker-compose down -v ================================================================================ ESTRUCTURA DE ARCHIVOS ================================================================================ requester/ ├── data/ ← VOLUMEN PERSISTENTE │ └── backup_peticiones.db ← BASE DE DATOS (PERSISTE) ├── templates/ ├── app.py ├── email_functions.py ├── run_production.py ├── requirements.txt ├── Dockerfile ← Configuración Docker ├── docker-compose.yml ← Orquestación Docker └── [scripts .bat] ← Utilidades Windows ================================================================================ ENDPOINTS DISPONIBLES ================================================================================ GET / → Página raíz GET /health → Health check POST /backup → Guardar petición GET /backup/ → Consultar petición GET /backup/list → Listar peticiones GET /admin → Panel de administración GET /admin/email/ → Ver email POST /admin/email//enviar → Enviar email ================================================================================ PRUEBA RÁPIDA ================================================================================ PowerShell: $body = @{ empresa = "Test" empleado = "Juan" email = "test@example.com" } | ConvertTo-Json Invoke-RestMethod -Uri "http://localhost:8073/backup" -Method POST -Body $body -ContentType "application/json" ================================================================================ SOLUCIÓN DE PROBLEMAS ================================================================================ ❌ Puerto 8073 ocupado → Cambiar puerto en docker-compose.yml → O detener el proceso: netstat -ano | findstr :8073 ❌ Docker no inicia → Verificar que Docker Desktop está corriendo → Ver logs: docker-compose logs ❌ No se guardan los datos → Verificar que existe el directorio data/ → Ver logs: docker-compose logs -f ================================================================================ DOCUMENTACIÓN ADICIONAL ================================================================================ 📖 README.md → Documentación general 📖 QUICKSTART.md → Guía de inicio rápido 📖 DOCKER.md → Documentación Docker detallada 📖 ESTRUCTURA.md → Estructura del proyecto 📖 CHANGELOG_DOCKER.md → Cambios realizados ================================================================================ BACKUP MANUAL DE LA BASE DE DATOS ================================================================================ La base de datos está en: data/backup_peticiones.db Para hacer backup: copy data\backup_peticiones.db backup_peticiones_20251013.db ================================================================================ ACTUALIZAR EL CÓDIGO ================================================================================ 1. Detener: docker-compose down 2. Modificar código 3. Reiniciar: docker-compose up -d --build ✅ La base de datos se mantiene intacta ================================================================================ CONTACTO Y SOPORTE ================================================================================ Si tienes problemas: 1. Revisa los logs: docker-compose logs -f 2. Verifica la configuración en docker-compose.yml 3. Asegúrate de que Docker Desktop está corriendo ================================================================================ ✅ CHECKLIST DE VERIFICACIÓN ================================================================================ □ Docker Desktop instalado y corriendo □ Puerto 8073 disponible □ Base de datos migrada a data/ (si existía) □ Servicio iniciado: docker-compose up -d □ Health check OK: http://localhost:8073/health □ Panel admin accesible: http://localhost:8073/admin □ Prueba de petición POST exitosa ================================================================================ 🎉 ¡LISTO PARA USAR! ================================================================================ El proyecto está completamente dockerizado y la base de datos es persistente. Ejecuta: docker-start.bat Y accede a: http://localhost:8073/admin ================================================================================