Diagnóstico

/docs/ muestra 404 o vacío

Django sirve archivos desde docs_site/. Genera el sitio:

python -B manage.py build_docs --settings=config.settings.docs --no-strict

Si Windows bloquea archivos de docs_site, cierra el navegador o servidor que lo esté usando y vuelve a correr el build. Para desarrollo rápido:

python -B -m mkdocs build --dirty --site-dir docs_site

El panel no inicia

docker compose ps
docker compose logs --tail=100 web
docker compose logs --tail=100 db

Verifica variables de entorno, conexión a Postgres y migraciones.

No llegan notificaciones en tiempo real

Revisa Redis, Daphne y el WebSocket:

docker compose logs --tail=100 redis
docker compose logs --tail=100 web

La bandeja puede seguir mostrando notificaciones aunque falle Redis porque el evento se persiste en base de datos.

ERD no se genera

Instala Graphviz y dependencias documentales. Luego ejecuta:

python scripts/generate_erd.py

MkDocs falla en modo estricto

Usa --no-strict para desarrollo si hay advertencias no críticas. Para revisar en detalle:

python -B -m mkdocs build --verbose --site-dir docs_site