#!/bin/bash
# Funciones compartidas por deploy-pruebas.sh y deploy-produccion.sh.
# No se ejecuta directamente.
#
# Es la misma base que se usa en Agrofiv. La diferencia está en el paso de
# dependencias: aquí Composer solo corre cuando cambió composer.json (ver
# actualizar_aplicacion), porque montacargas usa el fork de laravel/framework
# desde una carpeta del servidor y no conviene resolver dependencias en cada
# deploy.

# Binarios del servidor (cPanel con varias versiones de PHP).
# Se pueden sobrescribir con variables de entorno.
#
# Cron corre con un PATH mínimo (/usr/bin:/bin). En este servidor eso significa
# el git del sistema (1.8.3), no el de cPanel (2.x) que se usa en la terminal.
# Se antepone la ruta de cPanel para usar el mismo git en ambos casos. Además,
# los scripts solo usan comandos que también existen en git 1.8.3 (por eso no
# se usa "git -C" y el fetch lleva el refspec completo).
PATH="/usr/local/cpanel/3rdparty/lib/path-bin:/usr/local/bin:$PATH"
export PATH

cd "$APP_DIR" || { echo "ERROR: no se pudo entrar a $APP_DIR"; exit 1; }

PHP_BIN="${PHP_BIN:-$(command -v ea-php81 || echo /usr/local/bin/ea-php81)}"
COMPOSER_BIN="${COMPOSER_BIN:-/opt/cpanel/composer/bin/composer}"

LOG_DIR="$APP_DIR/storage/logs/deploy"
mkdir -p "$LOG_DIR"
LOG_FILE="$LOG_DIR/$(date +%Y-%m-%d_%H%M%S)_$ENTORNO.log"

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> "$LOG_FILE"
}

# Ejecuta un paso; si falla, avisa y termina.
paso() {
    local nombre="$1"; shift
    log ">>> $nombre: $*"
    if ! "$@" >> "$LOG_FILE" 2>&1; then
        log "FALLO en: $nombre"
        echo "ERROR en el deploy de $ENTORNO, paso: $nombre"
        [ -n "${NOTA_FALLO:-}" ] && echo "$NOTA_FALLO"
        echo "Commit: $(git rev-parse --short HEAD 2>/dev/null)"
        echo "Log completo: $LOG_FILE"
        echo "----- últimas líneas -----"
        tail -n 40 "$LOG_FILE"
        exit 1
    fi
}

# Evita que dos deploys corran al mismo tiempo sobre la misma carpeta.
# Sin argumento: si ya hay un deploy corriendo, termina sin hacer nada (el
# siguiente cron lo retoma). Con "esperar": espera hasta 10 minutos a que
# termine el otro; se usa cuando el deploy se pidió a propósito (--forzar).
tomar_candado() {
    exec 9> "$APP_DIR/storage/logs/deploy/.lock"
    if [ "${1:-}" = "esperar" ]; then
        if ! flock -w 600 9; then
            echo "ERROR: otro deploy de $ENTORNO lleva más de 10 minutos corriendo. No se hizo nada."
            exit 1
        fi
    elif ! flock -n 9; then
        exit 0
    fi
}

# Trae de GitHub el estado de la rama y actualiza origin/<rama>.
# El refspec completo es necesario: con git antiguo, "git fetch origin rama"
# no actualiza origin/rama y el script creería que no hay nada nuevo.
consultar_github() {
    git fetch --quiet origin "+refs/heads/$RAMA:refs/remotes/origin/$RAMA"
}

# Verifica que la carpeta esté en la rama que le corresponde.
verificar_rama() {
    local actual
    actual="$(git rev-parse --abbrev-ref HEAD 2>/dev/null)"
    if [ "$actual" != "$RAMA" ]; then
        echo "ERROR: $APP_DIR está en la rama '$actual' y debería estar en '$RAMA'. No se hizo nada."
        exit 1
    fi
}

# Anota en el log los archivos del repositorio que fueron editados directamente
# en el servidor (por ejemplo, el .htaccess que ajusta cPanel). No los toca.
anotar_cambios_locales() {
    local cambios
    cambios="$(git status --porcelain --untracked-files=no)"
    if [ -n "$cambios" ]; then
        log "Archivos editados directo en el servidor (se conservan):"
        echo "$cambios" >> "$LOG_FILE"
    fi
}

# Indica si hay que correr Composer en este deploy:
# - si se pidió con COMPOSER_SIEMPRE=si (lo pone la opción --composer), o
# - si composer.json cambió entre el commit anterior ($DESDE) y el nuevo.
# Si no se sabe desde dónde viene el deploy, se corre por seguridad.
toca_composer() {
    [ "${COMPOSER_SIEMPRE:-}" = "si" ] && return 0
    [ -z "${DESDE:-}" ] && return 0
    git cat-file -e "$DESDE^{commit}" 2>/dev/null || return 0
    ! git diff --quiet "$DESDE" HEAD -- composer.json
}

# Pasos comunes: código, dependencias, migraciones y cachés.
#
# El código se actualiza con un merge "fast-forward", no con reset --hard:
# los archivos editados en el servidor se conservan. Si uno de esos archivos
# también cambió en el repositorio, git se detiene sin modificar nada y el
# deploy falla con el nombre del archivo, para resolverlo a mano.
#
# Antes de llamarla, cada script define DESDE con el commit del que parte.
actualizar_aplicacion() {
    cd "$APP_DIR" || exit 1
    anotar_cambios_locales
    paso "Actualizar código" git merge --ff-only "origin/$RAMA"
    if toca_composer; then
        paso "Dependencias" "$PHP_BIN" "$COMPOSER_BIN" update --no-interaction
    else
        log "composer.json no cambió: se omite Composer."
    fi
    paso "Migraciones" "$PHP_BIN" artisan migrate --force
    paso "Limpiar cachés" "$PHP_BIN" artisan optimize:clear
    generar_documentacion_api
}

# Genera public/api-docs/api-docs.json con el APP_URL de ESTE ambiente
# (la URL queda escrita dentro del archivo al generarlo; por eso el archivo no
# va en el repositorio). Si falla solo deja un aviso en el log: la
# documentación de la API no debe detener un deploy.
generar_documentacion_api() {
    log ">>> Documentación API: artisan l5-swagger:generate"
    if ! "$PHP_BIN" artisan l5-swagger:generate >> "$LOG_FILE" 2>&1; then
        log "AVISO: no se pudo generar la documentación de la API (el deploy sigue)."
    fi
}

# Conserva solo los 30 logs más recientes.
limpiar_logs() {
    ls -1t "$LOG_DIR"/*.log 2>/dev/null | tail -n +31 | xargs -r rm -f
}
