Primeros pasos¶
Requisitos¶
- Docker Desktop para el flujo local recomendado.
- Python 3.12 si vas a correr comandos fuera de contenedor.
- PostgreSQL 16 y Redis 7 si no usas Docker.
- Graphviz solo para regenerar el ERD.
Levantar la app con Docker¶
La aplicación queda en http://localhost:8000.
El compose monta el repo en /app, así que los cambios de templates, Python y
docs fuente se ven en el contenedor. Aun así, algunos cambios pueden requerir
reinicio según caché/imports de Django.
Generar documentación local¶
pip install -r requirements-docs.txt
python -B manage.py build_docs --settings=config.settings.docs --no-strict
Después visita http://localhost:8000/docs/.
Comprobaciones útiles¶
python -B manage.py check --settings=config.settings.docker
python -B -m mkdocs build --dirty --site-dir docs_site
Datos demo¶
El comando de arranque del compose ejecuta seed_demo para crear datos
operativos de ejemplo. Si necesitas repetirlo manualmente: