backend/docs/commands/AUDITOR_COMMAND.md

Comando de Auditoría de Pedimentos

📝 Descripción

El comando auditor es una herramienta flexible para ejecutar tareas de auditoría y verificación de datos relacionados con pedimentos de una organización específica. Permite ejecutar todas las tareas o seleccionar específicamente cuáles ejecutar.

🔍 Tareas Disponibles

• remesas: Auditoría de remesas y procesamiento de COVEs
• partidas: Creación y validación de partidas faltantes
• coves: Auditoría de COVEs y su estado
• acuse-cove: Verificación de acuses de COVEs
• edocs: Auditoría de E-documents
• acuses: Verificación de acuses generales

💻 Uso

Ver Tareas Disponibles

python manage.py auditor --list

Ejecutar Todas las Tareas

python manage.py auditor <organizacion_id>
# o explícitamente
python manage.py auditor <organizacion_id> --tareas todas

Ejecutar Tareas Específicas

# Ejecutar solo auditoría de remesas y COVEs
python manage.py auditor <organizacion_id> --tareas remesas coves

# Ejecutar partidas y acuses
python manage.py auditor <organizacion_id> --tareas partidas acuses

# Ejecutar E-documents y acuses de COVEs
python manage.py auditor <organizacion_id> --tareas edocs acuse-cove

Ejecución en Docker

docker exec -it EFC_backend_dev python manage.py auditor <organizacion_id> [opciones]

Ejemplos

# Listar tareas disponibles
python manage.py auditor --list

# Auditar todo para una organización
python manage.py auditor 9d705e97-d3f2-4b6c-8d92-9f1af2b2d4b4

# Auditar solo remesas y COVEs
python manage.py auditor 9d705e97-d3f2-4b6c-8d92-9f1af2b2d4b4 --tareas remesas coves

📊 Monitoreo y Resultados

Indicadores de Estado

• ✓ Tarea iniciada correctamente
• ✗ Error en la ejecución

Información Mostrada

• ID de la organización
• Número total de pedimentos
• Task ID de cada tarea iniciada
• Tiempo total de ejecución
• Estado de cada tarea

⚠️ Consideraciones Importantes

Requisitos Previos

• Acceso al servidor/contenedor
• Permisos de Django
• ID válido de organización
• Celery en ejecución

Recomendaciones

1. Antes de Ejecutar

   • Realizar respaldo de datos
   • Verificar disponibilidad de recursos
   • Comprobar conexión con servicios

2. Durante la Ejecución

   • Monitorear logs de Celery
   • Verificar uso de recursos
   • No interrumpir el proceso

3. Después de la Ejecución

   • Verificar logs
   • Validar resultados
   • Documentar incidencias

🔧 Solución de Problemas

Errores Comunes

1. Organización no encontrada

   • Verificar ID de organización
   • Confirmar existencia de pedimentos

2. Tareas no inician

   • Verificar estado de Celery
   • Comprobar permisos
   • Revisar conexiones

3. Errores de ejecución

   • Consultar logs detallados
   • Verificar disponibilidad de servicios
   • Comprobar estado de la base de datos

📝 Notas Adicionales

• Las tareas se ejecutan de forma asíncrona
• El tiempo mostrado corresponde solo a la inicialización
• Las tareas continúan en segundo plano
• Se recomienda ejecutar en horarios de bajo tráfico

🔍 Logs y Monitoreo

Para un seguimiento detallado, revisar:

• Logs de Celery
• Logs de Django
• Monitor de tareas de Celery