Troubleshooting

🚫 No local consumer was found

Cause: local consumer is not running.
Fix: run

python manage.py run_workflow_starter

🕳️ Workflow stuck in PENDING

Causes:

• no active consumers for the required service
• missing heartbeats (WorkflowConsumerHeartbeat)

Check that external services are running and write heartbeats correctly.

📄 CSV is not returned

/csv-result returns CSV only if the result contains list[dict]. Otherwise it returns 204 No Content.

💬 Slack notifications not sent

Check:

• SLACK_BOT_TOKEN
• SLACK_NOTIFICATION_CHANNEL
• Slack API availability from the environment

🔗 Link Switcher does not accept domains

Check:

• LINK_SWITCHER_BASE_URL
• LINK_SWITCHER_API_KEY
• link‑switcher service availability

🐳 Docker Compose does not build

docker-compose.yml references ./resources/docker/supervisor/Dockerfile.
If the file is missing, use build/resources/Dockerfile or update the path.