se agrego comando del auditor

api/customs/management/commands/AUDITOR_COMMAND.md

@@ -0,0 +1,122 @@
+# 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
+```bash
+python manage.py auditor --list
+```
+
+### Ejecutar Todas las Tareas
+```bash
+python manage.py auditor <organizacion_id>
+# o explícitamente
+python manage.py auditor <organizacion_id> --tareas todas
+```
+
+### Ejecutar Tareas Específicas
+```bash
+# 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
+```bash
+docker exec -it EFC_backend_dev python manage.py auditor <organizacion_id> [opciones]
+```
+
+### Ejemplos
+```bash
+# 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