Actualizaciones

TraDoc guarda proyectos, salidas y el estado SQLite en data/ (/app/data en el contenedor). Haz una copia de ese directorio antes de cada actualización. Nunca ejecutes docker compose down -v ni borres ./data como parte de una actualización normal.

Antes de cada actualización

• Exporta el trabajo importante.
• Respalda data/.
• Anota el commit o el digest de imagen actual.
• Asegúrate de que no hay ningún proyecto en curso.

Registrar una imagen GHCR

docker compose images
docker image inspect --format '{{.RepoDigests}}' ghcr.io/lucas-lepajollec/tradoc:latest

Conserva ese digest o la etiqueta sha-<commit-completo>. Esa es la meta de reversión.

Imagen publicada (docker-compose.yml)

docker compose pull
docker compose up -d
docker compose logs --tail 100 tradoc

Confirma /health, la conexión del proveedor, la lista de proyectos y una exportación pequeña.

Para revertir:

Cambia la línea image: de Compose y vuelve a crear el servicio:

image: ghcr.io/lucas-lepajollec/tradoc:sha-<full-commit>

docker compose up -d

No recrees una etiqueta v1.0.0 para recuperar una instancia antigua.

Compilación local

git pull --ff-only
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

El archivo Compose predeterminado descarga la imagen publicada. El override de compilación explícito la sustituye por tradoc:local para un checkout del código fuente.

Checkout Git

git status --short
git pull --ff-only
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
npm --prefix web ci
npm --prefix web run build
.\.venv\Scripts\python.exe -m unittest discover -s tests -p "test_*.py"

No ejecutes git reset --hard para resolver cambios locales que no entiendas. Respáldalos o examínalos antes de actualizar.

Después

Conserva la copia anterior hasta completar la validación.