maintenance: respaldar y vaciar volumen de archivos en fresh-start

Ajusta el preview para limpiar también Departamentos importados, conservar sólo estructura sembrada y reiniciar configuración institucional editable. Reactiva FK antes de eliminar usuarios.

api-v3/package.json

@@ -9,7 +9,7 @@
     "start:dev": "nest start --watch",
     "typecheck": "tsc --noEmit",
     "test": "tsc -p tsconfig.test.json --noEmit && node --import tsx --test test/**/*.test.ts",
-    "migration:run": "node dist/database/migration-cli.js run && node dist/cli/fresh-start-reset.js --preview",
+    "migration:run": "node dist/database/migration-cli.js run && node dist/cli/fresh-start-reset.js --apply DHV2-FRESH-START-20260905",
     "migration:show": "node dist/database/migration-cli.js show",
     "migration:revert": "node dist/database/migration-cli.js revert",
     "bootstrap:admin": "node dist/cli/bootstrap-admin.js",

scripts/deploy-github.sh

@@ -114,7 +114,7 @@ rollback() {
   echo
   if [ -d "$BACKUP" ]; then
     echo "Backup PRE disponible en: $BACKUP"
-    echo "Las migraciones son forward-only; database-before.dump queda disponible para restauración manual si hiciera falta."
+    echo "database-before.dump y asset-media-before.tar.gz permiten una restauración manual integral si hiciera falta."
   else
     echo "No fue necesario crear backup PRE: el fallo ocurrió durante el preflight del candidato, antes de tocar producción."
   fi
@@ -207,9 +207,15 @@ install -m 600 .env "$BACKUP/.env"
 git rev-parse HEAD > "$BACKUP/previous.sha"
 printf '%s\n' "$TARGET_SHA" > "$BACKUP/target.sha"
 docker compose ps -a > "$BACKUP/docker-before.txt"
+
+echo "Respaldando volumen de fotos/importaciones..."
+docker compose run --rm --no-deps --user root \
+  -v "$BACKUP:/backup" \
+  api sh -lc 'tar -czf /backup/asset-media-before.tar.gz -C /app/storage/asset-media .'
+
 (
   cd "$BACKUP"
-  sha256sum database-before.dump source-before.tar.gz .env previous.sha target.sha docker-before.txt > SHA256SUMS.txt
+  sha256sum database-before.dump source-before.tar.gz asset-media-before.tar.gz .env previous.sha target.sha docker-before.txt > SHA256SUMS.txt
   sha256sum -c SHA256SUMS.txt
 )
 chmod 600 "$BACKUP"/* "$BACKUP/.env" 2>/dev/null || true
@@ -228,11 +234,31 @@ docker compose build api migrate web </dev/null
 
 PHASE="migrations"
 echo
-echo "========== MIGRACIONES =========="
+echo "========== MIGRACIONES + FRESH START =========="
 docker compose --profile tools run --rm migrate </dev/null
 docker compose --profile tools run --rm migrate npm run migration:show </dev/null | tee "$BACKUP/migrations.txt"
 grep -Fq 'Pending migrations: no' "$BACKUP/migrations.txt"
 
+PHASE="media-clean"
+echo
+echo "========== LIMPIEZA DE ARCHIVOS CARGADOS =========="
+docker compose run --rm --no-deps --user root api sh -lc '
+  set -eu
+  ROOT=/app/storage/asset-media
+  before="$(find "$ROOT" -type f 2>/dev/null | wc -l | tr -d " ")"
+  echo "files_before=$before"
+  for path in "$ROOT"/* "$ROOT"/.[!.]* "$ROOT"/..?*; do
+    [ -e "$path" ] || continue
+    rm -rf -- "$path"
+  done
+  mkdir -p "$ROOT/imports"
+  chown -R node:node "$ROOT"
+  after="$(find "$ROOT" -type f 2>/dev/null | wc -l | tr -d " ")"
+  echo "files_after=$after"
+  [ "$after" = "0" ]
+' | tee "$BACKUP/media-clean.txt"
+grep -Fq 'files_after=0' "$BACKUP/media-clean.txt"
+
 PHASE="recreate"
 echo
 echo "========== RECREATE API + WEB =========="
@@ -284,7 +310,7 @@ git rev-parse HEAD > "$BACKUP/deployed.sha"
 printf 'API=%s\nWEB=%s\n' "$EXPECTED_API_VERSION" "$EXPECTED_WEB_VERSION" > "$BACKUP/deployed-versions.txt"
 (
   cd "$BACKUP"
-  sha256sum database-after.dump deployed.sha deployed-versions.txt health.json migrations.txt docker-after.txt >> SHA256SUMS.txt
+  sha256sum database-after.dump deployed.sha deployed-versions.txt health.json migrations.txt media-clean.txt docker-after.txt >> SHA256SUMS.txt
   sha256sum -c SHA256SUMS.txt
 )
 chmod 600 "$BACKUP"/* "$BACKUP/.env" 2>/dev/null || true