From 0aa1365659521f85477e5a842df89991bdf44549 Mon Sep 17 00:00:00 2001 From: markosbenitez Date: Tue, 26 May 2026 11:07:06 -0300 Subject: [PATCH] =?UTF-8?q?docs:=20gu=C3=ADa=20de=20migraci=C3=B3n=20vault?= =?UTF-8?q?=20v3=20en=20secci=C3=B3n=20de=20actualizaci=C3=B3n=20del=20bot?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Agrega nota en sección 18 de DEPLOY.md sobre correr migrar_vault_v3.py al actualizar desde versiones anteriores a v0.4.0 con tenants existentes. Co-Authored-By: Claude Sonnet 4.6 --- DEPLOY.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/DEPLOY.md b/DEPLOY.md index 12a283f..60b6588 100644 --- a/DEPLOY.md +++ b/DEPLOY.md @@ -1069,6 +1069,27 @@ docker compose logs --tail=20 > diff .env.example .env > ``` +### Actualización especial: migración de credenciales a vault v3 (v0.4.0+) + +Si el servidor tenía abogados registrados **antes de la versión v0.4.0**, sus credenciales en la DB +están en formato v1 (cifrado simple). Hay que migrarlas a v3 (PBKDF2 + envelope encryption) **una sola vez**. + +Hacerlo después del `git pull` y **antes** del `docker compose up -d`: + +```bash +# Dentro del contenedor (o con uv si no usás Docker): +docker compose run --rm pedrito uv run python scripts/migrar_vault_v3.py --dry-run +# Verificar que lista los tenants esperados, luego migrar de verdad: +docker compose run --rm pedrito uv run python scripts/migrar_vault_v3.py +``` + +El script: +- Verifica que puede descifrar todos los tenants antes de tocar la DB +- Hace backup automático de la DB (`data/pasante.db.bak`) +- Si algo falla, no escribe nada — la DB original queda intacta + +Si todos los tenants registrados son nuevos (post v0.4.0), este paso no es necesario. + --- ## 19. Troubleshooting