<plugin>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-maven-plugin</artifactId>
  <configuration>
    <mainClass>com.nexussoftware.bibliotech.web.BiblioTechApplication</mainClass>
  </configuration>
</plugin>

./mvnw -pl bibliotech-web clean package
java -jar bibliotech-web/target/bibliotech-web-1.0.0.jar

bibliotech-web-1.0.0.jar
├── META-INF/MANIFEST.MF          ← Main-Class: org.springframework.boot.loader.launch.JarLauncher
├── org/springframework/boot/loader/   ← el carregador
└── BOOT-INF/
    ├── classes/                  ← el teu codi i els teus recursos
    ├── lib/                      ← ~50 jars de dependències
    └── classpath.idx

$ java -Djarmode=tools -jar bibliotech-web.jar list-layers
dependencies
spring-boot-loader
snapshot-dependencies
application

# Extreure cada capa al seu directori
java -Djarmode=tools -jar bibliotech-web.jar extract --layers --launcher --destination extret/

<plugin>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-maven-plugin</artifactId>
  <configuration>
    <layers>
      <enabled>true</enabled>
    </layers>
  </configuration>
</plugin>

<properties>
  <!-- Fixa la data de les entrades del jar: sense aixo, cada construccio difereix -->
  <project.build.outputTimestamp>2026-08-05T00:00:00Z</project.build.outputTimestamp>
</properties>

./mvnw clean package
sha256sum target/bibliotech-web-1.0.0.jar
# a3f7... (el mateix hash en qualsevol màquina, avui i d'aquí a un any)

<plugin>
  <groupId>io.github.git-commit-id</groupId>
  <artifactId>git-commit-id-maven-plugin</artifactId>
  <version>9.0.1</version>
  <executions>
    <execution><goals><goal>revision</goal></goals></execution>
  </executions>
  <configuration>
    <generateGitPropertiesFile>true</generateGitPropertiesFile>
    <includeOnlyProperties>
      <property>^git.branch$</property>
      <property>^git.commit.id.abbrev$</property>
      <property>^git.commit.time$</property>
      <property>^git.build.version$</property>
    </includeOnlyProperties>
  </configuration>
</plugin>

$ curl https://bibliotech.nexussoftware.com/actuator/info
{
  "git": {
    "branch": "main",
    "commit": { "id": "a3f7e91", "time": "2026-08-05T09:14:22Z" }
  },
  "build": { "version": "1.4.2", "artifact": "bibliotech-web", "time": "2026-08-05T09:20:11Z" }
}

# ==============================================================================
# ETAPA 1: CONSTRUCCIÓ
# Aquesta etapa té Maven, el JDK complet i el codi font. Res d'això
# arriba a la imatge final: només es fa servir per produir el jar.
# ==============================================================================
FROM eclipse-temurin:21-jdk-alpine AS constructor

WORKDIR /build

# Copiar NOMÉS els fitxers de dependències primer.
# Docker posa cada instrucció a la memòria cau: mentre els POM no canviïn, la
# descàrrega de dependències (el pas més lent, 2-3 minuts) se salta del tot.
COPY .mvn/ .mvn/
COPY mvnw pom.xml ./
COPY bibliotech-domini/pom.xml           bibliotech-domini/
COPY bibliotech-aplicacio/pom.xml        bibliotech-aplicacio/
COPY bibliotech-infraestructura/pom.xml  bibliotech-infraestructura/
COPY bibliotech-web/pom.xml              bibliotech-web/
COPY bibliotech-consola/pom.xml          bibliotech-consola/

# go-offline descarrega totes les dependències sense compilar res.
# --mount=type=cache manté ~/.m2 entre construccions (BuildKit).
RUN --mount=type=cache,target=/root/.m2 \
    ./mvnw -B dependency:go-offline -DskipTests

# ARA sí que copiem el codi font. Si només canvia el codi,
# Docker reutilitza la capa anterior i no torna a descarregar res.
COPY bibliotech-domini/src           bibliotech-domini/src
COPY bibliotech-aplicacio/src        bibliotech-aplicacio/src
COPY bibliotech-infraestructura/src  bibliotech-infraestructura/src
COPY bibliotech-web/src              bibliotech-web/src

# -DskipTests: les proves ja es van executar a CI (12-05). Repetir-les aquí
# duplica el temps i requeriria Docker dins de Docker per a Testcontainers.
RUN --mount=type=cache,target=/root/.m2 \
    ./mvnw -B -pl bibliotech-web -am clean package -DskipTests

# Extreure el jar en capes
RUN java -Djarmode=tools -jar bibliotech-web/target/bibliotech-web-*.jar \
         extract --layers --launcher --destination extret

# ==============================================================================
# ETAPA 2: EXECUCIÓ
# Imatge mínima: només JRE (no JDK), sense Maven, sense codi font,
# sense eines de compilació. Menys superfície, menys vulnerabilitats.
# ==============================================================================
FROM eclipse-temurin:21-jre-alpine AS execucio

# Etiquetes OCI estàndard: metadades que les eines de l'ecosistema llegeixen
LABEL org.opencontainers.image.title="BiblioTech" \
      org.opencontainers.image.description="Biblioteca tecnica de Nexus Software" \
      org.opencontainers.image.vendor="Nexus Software" \
      org.opencontainers.image.licenses="Proprietary"

# Utilitats mínimes:
#  - curl per al HEALTHCHECK
#  - tzdata perquè les zones horàries funcionin (Alpine no les porta)
#  - dumb-init com a PID 1: reenvia els senyals correctament al procés Java
RUN apk add --no-cache curl tzdata dumb-init && \
    rm -rf /var/cache/apk/*

ENV TZ=Europe/Madrid

# ---- Usuari NO root ----
# Si un atacant aconsegueix execució de codi, no ha de tenir root al
# contenidor. És la mitigació més barata i eficaç que existeix.
RUN addgroup -S -g 1001 bibliotech && \
    adduser -S -u 1001 -G bibliotech -h /app bibliotech

WORKDIR /app

# ---- Les capes, en ordre d'estabilitat (menys canviant primer) ----
# Cada COPY és una capa de Docker. En canviar només el codi, únicament
# l'última capa (~1 MB) es reconstrueix i es transfereix.
COPY --from=constructor --chown=bibliotech:bibliotech /build/extret/dependencies/ ./
COPY --from=constructor --chown=bibliotech:bibliotech /build/extret/spring-boot-loader/ ./
COPY --from=constructor --chown=bibliotech:bibliotech /build/extret/snapshot-dependencies/ ./
COPY --from=constructor --chown=bibliotech:bibliotech /build/extret/application/ ./

USER bibliotech

EXPOSE 8080

# ---- Opcions de la JVM ----
#  MaxRAMPercentage=75      fa servir el 75 % del límit del contenidor per al heap
#  InitialRAMPercentage=50  arrenca amb la meitat: menys redimensionats
#  UseG1GC                  GC equilibrat; per a <2 vCPU considerar SerialGC
#  ExitOnOutOfMemoryError   davant d'un OOM, morir: que l'orquestrador reiniciï
#                           (una JVM en OOM serveix peticions a mig fer, que és pitjor)
#  HeapDumpOnOutOfMemoryError  bolcat per diagnosticar (10-07)
#  file.encoding=UTF-8      explícit: no depenem de l'entorn
ENV JAVA_OPTS="\
    -XX:MaxRAMPercentage=75.0 \
    -XX:InitialRAMPercentage=50.0 \
    -XX:+UseG1GC \
    -XX:+ExitOnOutOfMemoryError \
    -XX:+HeapDumpOnOutOfMemoryError \
    -XX:HeapDumpPath=/tmp/bolcat.hprof \
    -Djava.security.egd=file:/dev/./urandom \
    -Dfile.encoding=UTF-8"

# Comprovació de salut a nivell de contenidor
HEALTHCHECK --interval=30s --timeout=3s --start-period=45s --retries=3 \
  CMD curl -fsS http://localhost:8080/actuator/health/readiness || exit 1

# dumb-init com a PID 1 reenvia SIGTERM al procés Java: sense això,
# l'aturada ordenada (secció 18) no funciona.
ENTRYPOINT ["dumb-init", "--"]

# Forma "shell" perquè $JAVA_OPTS s'expandeixi. exec fa que Java sigui
# el procés fill directe i rebi els senyals.
CMD exec java $JAVA_OPTS org.springframework.boot.loader.launch.JarLauncher

docker build -t bibliotech:1.4.2 -t bibliotech:latest .

docker run -d --name bibliotech \
  -p 8080:8080 \
  --memory=768m --cpus=1.5 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e BIBLIOTECH_DB_URL=jdbc:postgresql://db:5432/bibliotech \
  -e BIBLIOTECH_DB_USER=bibliotech \
  -e BIBLIOTECH_DB_PASSWORD="$DB_PASSWORD" \
  bibliotech:1.4.2

docker logs -f bibliotech
docker exec bibliotech curl -s localhost:8080/actuator/health

# Tot el que no cal per construir
.git/
.github/
.idea/
.vscode/
*.iml

target/
**/target/

*.md
docs/
LICENSE

# CRÍTIC: res d'això no ha d'entrar al context de construcció
.env
*.env
**/application-local.yml
*.pem
*.p12
*.jks
secrets/

Dockerfile
.dockerignore
compose.yaml

docker build --no-cache --progress=plain . 2>&1 | head -5
# => transferring context: 1.24MB    (bé)
# Sense .dockerignore seria, típicament, 250 MB.

./mvnw -pl bibliotech-web spring-boot:build-image \
  -Dspring-boot.build-image.imageName=bibliotech:1.4.2

<plugin>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-maven-plugin</artifactId>
  <configuration>
    <image>
      <name>registre.nexussoftware.com/bibliotech:${project.version}</name>
      <env>
        <BP_JVM_VERSION>21</BP_JVM_VERSION>
        <BPE_DELIM_JAVA_TOOL_OPTIONS xml:space="preserve"> </BPE_DELIM_JAVA_TOOL_OPTIONS>
        <BPE_APPEND_JAVA_TOOL_OPTIONS>-XX:MaxRAMPercentage=75</BPE_APPEND_JAVA_TOOL_OPTIONS>
      </env>
    </image>
  </configuration>
</plugin>

<plugin>
  <groupId>com.google.cloud.tools</groupId>
  <artifactId>jib-maven-plugin</artifactId>
  <version>3.4.3</version>
  <configuration>
    <from><image>eclipse-temurin:21-jre-alpine</image></from>
    <to><image>registre.nexussoftware.com/bibliotech:${project.version}</image></to>
    <container>
      <user>1001:1001</user>
      <ports><port>8080</port></ports>
      <jvmFlags>
        <jvmFlag>-XX:MaxRAMPercentage=75.0</jvmFlag>
      </jvmFlags>
    </container>
  </configuration>
</plugin>

./mvnw -pl bibliotech-web jib:build         # publica directament al registre
./mvnw -pl bibliotech-web jib:dockerBuild   # o construeix al Docker local

FROM eclipse-temurin:21-jdk-alpine AS jre-minim
RUN jlink \
    --add-modules java.base,java.logging,java.sql,java.naming,java.management,\
java.instrument,java.security.jgss,java.desktop,jdk.unsupported,jdk.crypto.ec \
    --strip-debug --no-man-pages --no-header-files --compress=2 \
    --output /jre-minim

$ docker run --memory=512m eclipse-temurin:21-jre java -XX:+PrintFlagsFinal -version | grep MaxHeapSize
   size_t MaxHeapSize = 134217728    # 128 MB = 25 % de 512 MB

docker run -e JAVA_OPTS="-XX:NativeMemoryTracking=summary" bibliotech:1.4.2
docker exec bibliotech jcmd 1 VM.native_memory summary

# compose.yaml
name: bibliotech

services:

  db:
    image: postgres:16-alpine
    container_name: bibliotech-db
    environment:
      POSTGRES_DB: bibliotech
      POSTGRES_USER: bibliotech
      POSTGRES_PASSWORD: ${DB_PASSWORD:-bibliotech}
    ports:
      - "5432:5432"
    volumes:
      - dades-db:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U bibliotech -d bibliotech"]
      interval: 5s
      timeout: 3s
      retries: 10
      start_period: 10s

  app:
    build:
      context: .
      dockerfile: Dockerfile
    image: bibliotech:${VERSION:-dev}
    container_name: bibliotech-app
    depends_on:
      db:
        condition: service_healthy      # espera el healthcheck, no només l'arrencada
    environment:
      SPRING_PROFILES_ACTIVE: docker
      BIBLIOTECH_DB_URL: jdbc:postgresql://db:5432/bibliotech
      BIBLIOTECH_DB_USER: bibliotech
      BIBLIOTECH_DB_PASSWORD: ${DB_PASSWORD:-bibliotech}
      JAVA_OPTS: "-XX:MaxRAMPercentage=75 -XX:+UseG1GC"
    ports:
      - "8080:8080"
    deploy:
      resources:
        limits:
          memory: 768M
          cpus: '1.5'
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:8080/actuator/health/readiness"]
      interval: 15s
      timeout: 3s
      retries: 5
      start_period: 60s
    restart: unless-stopped

volumes:
  dades-db:

docker compose up -d --build       # construir i aixecar
docker compose logs -f app         # seguir els registres
docker compose ps                  # estat i salut
docker compose exec db psql -U bibliotech    # entrar a la base de dades
docker compose down                # aturar (les dades sobreviuen)
docker compose down -v             # aturar i ESBORRAR les dades

java -jar bibliotech-web.jar \
     --spring.config.additional-location=file:/etc/bibliotech/

apiVersion: v1
kind: ConfigMap
metadata:
  name: bibliotech-config
data:
  SPRING_PROFILES_ACTIVE: "prod"
  BIBLIOTECH_PRESTEC_DIESPERDEFECTE: "15"
  LOGGING_LEVEL_COM_NEXUSSOFTWARE_BIBLIOTECH: "INFO"
---
apiVersion: v1
kind: Secret
metadata:
  name: bibliotech-secrets
type: Opaque
stringData:
  BIBLIOTECH_DB_PASSWORD: "…"        # gestionat amb Sealed Secrets o un gestor extern
  METADADES_API_KEY: "…"

curl -s localhost:8080/actuator/env/bibliotech.multa.euros-per-dia | jq
# mostra el valor efectiu I de quina font va venir

<dependency>
  <groupId>org.flywaydb</groupId>
  <artifactId>flyway-core</artifactId>
</dependency>
<dependency>
  <groupId>org.flywaydb</groupId>
  <artifactId>flyway-database-postgresql</artifactId>
</dependency>

spring:
  jpa:
    hibernate:
      ddl-auto: validate        # Hibernate VERIFICA, Flyway MANA
  flyway:
    enabled: true
    locations: classpath:db/migration
    baseline-on-migrate: true   # per a una base de dades que ja existia
    validate-on-migrate: true   # detecta scripts ja aplicats que han canviat
    out-of-order: false         # no permet aplicar una versió anterior a l'última

bibliotech-infraestructura/src/main/resources/db/migration/
├── V1__esquema_inicial.sql
├── V2__indexs_cataleg.sql
├── V3__afegir_columna_valor_material.sql
├── V4__taula_reserves.sql
├── V5__estat_devolucio_i_recarrecs.sql
└── R__vista_estadistiques_us.sql        ← R = repetible: es reexecuta si canvia

-- V1__esquema_inicial.sql
CREATE TABLE materials (
    id                    BIGSERIAL PRIMARY KEY,
    tipus                 VARCHAR(20)  NOT NULL,   -- discriminador SINGLE_TABLE (ADR-004)
    isbn                  VARCHAR(17)  NOT NULL UNIQUE,
    titol                 VARCHAR(200) NOT NULL,
    autor                 VARCHAR(150),
    any_publicacio        INTEGER,
    unitats_totals        INTEGER      NOT NULL DEFAULT 1 CHECK (unitats_totals >= 0),
    unitats_disponibles   INTEGER      NOT NULL DEFAULT 1 CHECK (unitats_disponibles >= 0),
    version               BIGINT       NOT NULL DEFAULT 0,   -- @Version (11-03)
    creat_el              TIMESTAMPTZ  NOT NULL DEFAULT now(),
    CONSTRAINT chk_disponibles_no_supera_totals
        CHECK (unitats_disponibles <= unitats_totals)
);

CREATE TABLE empleats (
    id            BIGSERIAL PRIMARY KEY,
    nom           VARCHAR(150) NOT NULL,
    correu        VARCHAR(200) NOT NULL UNIQUE,
    departament   VARCHAR(100),
    data_alta     DATE         NOT NULL,
    version       BIGINT       NOT NULL DEFAULT 0
);

CREATE TABLE prestecs (
    id                 BIGSERIAL PRIMARY KEY,
    material_id        BIGINT      NOT NULL REFERENCES materials(id),
    empleat_id         BIGINT      NOT NULL REFERENCES empleats(id),
    data_prestec       DATE        NOT NULL,
    data_venciment     DATE        NOT NULL,
    data_devolucio     DATE,
    estat              VARCHAR(20) NOT NULL,
    version            BIGINT      NOT NULL DEFAULT 0,
    CONSTRAINT chk_venciment_posterior CHECK (data_venciment >= data_prestec),
    CONSTRAINT chk_devolucio_posterior
        CHECK (data_devolucio IS NULL OR data_devolucio >= data_prestec)
);

-- Índexs per a les consultes que de debò es fan
CREATE INDEX idx_prestec_empleat_estat ON prestecs(empleat_id, estat);
CREATE INDEX idx_prestec_venciment     ON prestecs(data_venciment)
                                       WHERE data_devolucio IS NULL;  -- parcial
CREATE INDEX idx_material_titol        ON materials USING gin(to_tsvector('spanish', titol));

-- Dades de referència que l'aplicació necessita per arrencar
INSERT INTO empleats (nom, correu, departament, data_alta) VALUES
    ('Marta Ruiz',  '[email protected]',  'Arquitectura', '2024-03-01'),
    ('Diego Alonso','[email protected]','Backend',      '2025-01-15'),
    ('Nuria Vidal', '[email protected]', 'Plataforma',   '2023-09-10');

./mvnw flyway:info       # quines migracions hi ha i quines estan aplicades
./mvnw flyway:validate   # comprova les sumes de comprovació
./mvnw flyway:migrate    # aplica les pendents
./mvnw flyway:repair     # arregla la taula de control (amb compte!)

@Test
void totesLesMigracionsSAplicanSobrePostgresNet() {
    Flyway flyway = Flyway.configure()
            .dataSource(POSTGRES.getJdbcUrl(), POSTGRES.getUsername(), POSTGRES.getPassword())
            .locations("classpath:db/migration")
            .load();

    MigrateResult resultat = flyway.migrate();

    assertThat(resultat.success).isTrue();
    assertThat(resultat.migrationsExecuted).isGreaterThan(0);
    // I que l'esquema resultant coincideix amb el que espera Hibernate:
    assertThatNoException().isThrownBy(() -> validarEsquemaContraEntitats());
}

-- V6__reanomenar_columna.sql
ALTER TABLE prestecs RENAME COLUMN data_venc TO data_venciment;

-- FASE 1: V6__afegir_data_venciment.sql   (compatible amb l'app v1)
ALTER TABLE prestecs ADD COLUMN data_venciment DATE;

UPDATE prestecs SET data_venciment = data_venc WHERE data_venciment IS NULL;

-- Trigger de doble escriptura: tant se val quina versió de l'app escrigui
CREATE OR REPLACE FUNCTION sincronitzar_data_venciment() RETURNS TRIGGER AS $$
BEGIN
    IF NEW.data_venciment IS DISTINCT FROM OLD.data_venciment THEN
        NEW.data_venc := NEW.data_venciment;
    ELSIF NEW.data_venc IS DISTINCT FROM OLD.data_venc THEN
        NEW.data_venciment := NEW.data_venc;
    END IF;
    RETURN NEW;
END;
$$ LANGUAGE plpgsql;

CREATE TRIGGER trg_sincronitzar_data
    BEFORE INSERT OR UPDATE ON prestecs
    FOR EACH ROW EXECUTE FUNCTION sincronitzar_data_venciment();

-- FASE 3: V8__eliminar_data_venc.sql   (només després de confirmar que v1 ja no corre)
DROP TRIGGER IF EXISTS trg_sincronitzar_data ON prestecs;
DROP FUNCTION IF EXISTS sincronitzar_data_venciment();
ALTER TABLE prestecs DROP COLUMN data_venc;
ALTER TABLE prestecs ALTER COLUMN data_venciment SET NOT NULL;

# /etc/systemd/system/bibliotech.service
[Unit]
Description=BiblioTech - Biblioteca tecnica de Nexus Software
After=network.target postgresql.service
Wants=postgresql.service

[Service]
Type=simple
User=bibliotech
Group=bibliotech
WorkingDirectory=/opt/bibliotech

EnvironmentFile=/etc/bibliotech/entorn       # secrets, amb permisos 600
ExecStart=/usr/bin/java $JAVA_OPTS -jar /opt/bibliotech/bibliotech-web.jar

SuccessExitStatus=143                        # 128 + SIGTERM: aturada ordenada, no és fallada
Restart=on-failure
RestartSec=10

# Aturada ordenada: SIGTERM, i 60 s abans de SIGKILL
KillSignal=SIGTERM
TimeoutStopSec=60

# Enduriment: mínim privilegi (12-07)
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/log/bibliotech /var/lib/bibliotech

StandardOutput=journal
StandardError=journal
SyslogIdentifier=bibliotech

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now bibliotech
sudo systemctl status bibliotech
sudo journalctl -u bibliotech -f

apiVersion: apps/v1
kind: Deployment
metadata:
  name: bibliotech
  labels:
    app: bibliotech
spec:
  replicas: 3                       # tres instàncies: alta disponibilitat
  revisionHistoryLimit: 5           # històric per a la tornada enrere

  strategy:
    type: RollingUpdate             # actualització progressiva (secció 20)
    rollingUpdate:
      maxSurge: 1                   # com a molt 1 pod extra durant la transició
      maxUnavailable: 0             # MAI menys de 3 disponibles: sense tall de servei

  selector:
    matchLabels:
      app: bibliotech

  template:
    metadata:
      labels:
        app: bibliotech
        version: "1.4.2"
    spec:
      # Marge perquè l'aturada ordenada acabi (secció 18)
      terminationGracePeriodSeconds: 60

      securityContext:              # mínim privilegi a nivell de pod
        runAsNonRoot: true
        runAsUser: 1001
        fsGroup: 1001

      containers:
        - name: bibliotech
          image: registre.nexussoftware.com/bibliotech:1.4.2   # etiqueta EXACTA, mai 'latest'
          imagePullPolicy: IfNotPresent

          ports:
            - name: http
              containerPort: 8080

          envFrom:
            - configMapRef: { name: bibliotech-config }
            - secretRef:    { name: bibliotech-secrets }

          resources:
            requests:                # el que el planificador reserva
              memory: "512Mi"
              cpu: "250m"
            limits:                  # el sostre; superar-lo en memòria = OOMKilled
              memory: "768Mi"
              cpu: "1500m"

          # --- Sondes (secció 17) ---
          startupProbe:              # protegeix l'arrencada: fins a 100 s
            httpGet: { path: /actuator/health/liveness, port: http }
            failureThreshold: 20
            periodSeconds: 5

          livenessProbe:             # continua viu? Si no, REINICIAR
            httpGet: { path: /actuator/health/liveness, port: http }
            periodSeconds: 10
            failureThreshold: 3

          readinessProbe:            # pot atendre? Si no, TREURE DEL BALANCEJADOR
            httpGet: { path: /actuator/health/readiness, port: http }
            periodSeconds: 5
            failureThreshold: 2

          securityContext:
            allowPrivilegeEscalation: false
            readOnlyRootFilesystem: true       # res no escriu a l'arrel
            capabilities: { drop: ["ALL"] }

          volumeMounts:
            - name: tmp
              mountPath: /tmp                  # necessari: Tomcat i els bolcats hi escriuen

      volumes:
        - name: tmp
          emptyDir: {}
---
apiVersion: v1
kind: Service
metadata:
  name: bibliotech
spec:
  selector:
    app: bibliotech
  ports:
    - port: 80
      targetPort: http
  type: ClusterIP
---
apiVersion: policy/v1
kind: PodDisruptionBudget           # protegeix durant el manteniment del clúster
metadata:
  name: bibliotech
spec:
  minAvailable: 2
  selector:
    matchLabels:
      app: bibliotech

kubectl apply -f k8s/
kubectl rollout status deployment/bibliotech
kubectl get pods -l app=bibliotech
kubectl logs -f -l app=bibliotech --tail=100
kubectl rollout undo deployment/bibliotech         # tornada enrere immediata

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus     # NOMÉS el necessari (12-07)
      base-path: /actuator
  endpoint:
    health:
      probes:
        enabled: true                # habilita /health/liveness i /health/readiness
      show-details: when-authorized  # el detall, només a qui té permís
      group:
        readiness:
          include: db, diskSpace     # si la BD no respon, no estem llestos
        liveness:
          include: livenessState     # només l'estat del procés
  health:
    livenessstate:
      enabled: true
    readinessstate:
      enabled: true

$ curl localhost:8080/actuator/health/liveness
{"status":"UP"}

$ curl localhost:8080/actuator/health/readiness
{"status":"UP","components":{"db":{"status":"UP"},"diskSpace":{"status":"UP"}}}

@Component
public class SalutPassarelaMetadades implements HealthIndicator {

    private final PassarelaMetadades passarela;

    @Override
    public Health health() {
        try {
            boolean disponible = passarela.comprovarDisponibilitat();
            return disponible
                    ? Health.up().withDetail("passarela", "disponible").build()
                    // DEGRADED, no DOWN: l'aplicacio funciona sense metadades externes.
                    // Marcar DOWN aqui trauria del balancejador una app perfectament usable.
                    : Health.status("DEGRADED").withDetail("passarela", "no respon").build();
        } catch (Exception e) {
            return Health.status("DEGRADED").withException(e).build();
        }
    }
}

server:
  shutdown: graceful            # deixa d'acceptar peticions noves i espera les actuals

spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s

@Component
public class TancamentOrdenat {

    private static final Logger log = LoggerFactory.getLogger(TancamentOrdenat.class);

    private final ExecutorService executorImportacions;

    /**
     * @PreDestroy s'executa quan el context de Spring es tanca,
     * cosa que passa en rebre SIGTERM.
     */
    @PreDestroy
    public void enAturar() {
        log.info("Aturada ordenada: tancant recursos");

        executorImportacions.shutdown();      // no accepta tasques noves
        try {
            if (!executorImportacions.awaitTermination(20, TimeUnit.SECONDS)) {
                log.warn("Importacions sense acabar despres de 20 s; forcant");
                executorImportacions.shutdownNow();
            }
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
            executorImportacions.shutdownNow();
        }
        log.info("Aturada ordenada completada");
    }
}

lifecycle:
  preStop:
    exec:
      command: ["sh", "-c", "sleep 10"]     # donar temps al balancejador a actualitzar-se

# Generar l'arxiu CDS durant la construcció de la imatge
RUN java -XX:ArchiveClassesAtExit=/app/app.jsa \
         -Dspring.context.exit=onRefresh \
         org.springframework.boot.loader.launch.JarLauncher

ENV JAVA_OPTS="$JAVA_OPTS -XX:SharedArchiveFile=/app/app.jsa"

<profile>
  <id>native</id>
  <build>
    <plugins>
      <plugin>
        <groupId>org.graalvm.buildtools</groupId>
        <artifactId>native-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</profile>

./mvnw -Pnative native:compile -pl bibliotech-web
./bibliotech-web/target/bibliotech-web       # arrenca en 80 ms

@Service
public class GestorPrestecs {

    private final PropietatsBiblioTech props;

    public Prestec prestar(Isbn isbn, Long idEmpleat, Integer dies) {
        if (props.funcionalitats().reservaAutomatica()) {
            // Codi nou, desplegat pero desactivat fins que es decideixi
            return prestarAmbReservaAutomatica(isbn, idEmpleat, dies);
        }
        return prestarClassic(isbn, idEmpleat, dies);
    }
}

bibliotech:
  funcionalitats:
    reserva-automatica: false          # s'activa amb una variable d'entorn, sense desplegar
    prestec-prioritari: true
    informe-pdf: false

kubectl rollout undo deployment/bibliotech
docker compose up -d --force-recreate   # amb l'etiqueta anterior
sudo systemctl stop bibliotech && cp bibliotech-1.4.1.jar bibliotech-web.jar && sudo systemctl start bibliotech

# Còpia diària
pg_dump -h db -U bibliotech -Fc bibliotech > bibliotech-$(date +%F).dump

# Còpia prèvia a QUALSEVOL migració destructiva
pg_dump -h db -U bibliotech -Fc bibliotech > pre-migracio-v8-$(date +%F-%H%M).dump

# .github/workflows/cd.yml
name: Lliurament continu

on:
  push:
    branches: [main]
    tags: ['v*']

env:
  REGISTRE: ghcr.io
  IMATGE: ${{ github.repository }}

permissions:
  contents: read
  packages: write
  id-token: write          # per signar la imatge amb cosign

jobs:

  # ---------------------------------------------------------------
  # 1. Reutilitza la verificació completa de 12-05
  # ---------------------------------------------------------------
  verificar:
    uses: ./.github/workflows/ci.yml

  # ---------------------------------------------------------------
  # 2. Construir i publicar la imatge
  # ---------------------------------------------------------------
  imatge:
    name: Construir i publicar imatge
    runs-on: ubuntu-latest
    needs: verificar
    outputs:
      digest: ${{ steps.construir.outputs.digest }}
      etiquetes: ${{ steps.meta.outputs.tags }}

    steps:
      - uses: actions/checkout@v4

      - name: Configurar QEMU
        uses: docker/setup-qemu-action@v3        # per construir per a arm64

      - name: Configurar Buildx
        uses: docker/setup-buildx-action@v3

      - name: Autenticar-se al registre
        uses: docker/login-action@v3
        with:
          registry: ${{ env.REGISTRE }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Calcular etiquetes i metadades
        id: meta
        uses: docker/metadata-action@v5
        with:
          images: ${{ env.REGISTRE }}/${{ env.IMATGE }}
          tags: |
            type=semver,pattern={{version}}
            type=semver,pattern={{major}}.{{minor}}
            type=sha,prefix=,format=short          # traçabilitat al commit
            type=raw,value=latest,enable={{is_default_branch}}

      - name: Construir i publicar
        id: construir
        uses: docker/build-push-action@v6
        with:
          context: .
          platforms: linux/amd64,linux/arm64
          push: true
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          cache-from: type=gha                    # memòria cau de capes entre execucions
          cache-to: type=gha,mode=max
          provenance: true
          sbom: true                              # inventari de components (12-07)

      - name: Analitzar vulnerabilitats de la imatge
        uses: aquasecurity/[email protected]
        with:
          image-ref: ${{ env.REGISTRE }}/${{ env.IMATGE }}@${{ steps.construir.outputs.digest }}
          severity: 'CRITICAL,HIGH'
          exit-code: '1'                          # bloqueja si hi ha vulnerabilitats greus

      - name: Signar la imatge
        uses: sigstore/cosign-installer@v3
      - run: cosign sign --yes ${{ env.REGISTRE }}/${{ env.IMATGE }}@${{ steps.construir.outputs.digest }}

  # ---------------------------------------------------------------
  # 3. Preproducció: automàtic
  # ---------------------------------------------------------------
  preproduccio:
    name: Desplegar a preproducció
    runs-on: ubuntu-latest
    needs: imatge
    environment:
      name: preproduccio
      url: https://preproduccio.bibliotech.nexussoftware.com

    steps:
      - name: Desplegar
        run: |
          kubectl set image deployment/bibliotech \
            bibliotech=${{ env.REGISTRE }}/${{ env.IMATGE }}@${{ needs.imatge.outputs.digest }} \
            --namespace=preproduccio
          kubectl rollout status deployment/bibliotech -n preproduccio --timeout=5m

      - name: Proves de fum
        run: |
          BASE=https://preproduccio.bibliotech.nexussoftware.com
          curl -fsS "$BASE/actuator/health/readiness" | jq -e '.status == "UP"'
          curl -fsS "$BASE/api/materials?size=1"      | jq -e '.contingut | length >= 0'
          echo "Proves de fum correctes"

  # ---------------------------------------------------------------
  # 4. Producció: requereix aprovació manual
  # ---------------------------------------------------------------
  produccio:
    name: Desplegar a producció
    runs-on: ubuntu-latest
    needs: [imatge, preproduccio]
    if: startsWith(github.ref, 'refs/tags/v')     # només des d'una etiqueta de versió
    environment:
      name: produccio                             # amb revisors obligatoris configurats
      url: https://bibliotech.nexussoftware.com

    steps:
      - name: Desar la revisió actual, per si cal tornar
        id: actual
        run: |
          ACTUAL=$(kubectl get deployment/bibliotech -n produccio \
                   -o jsonpath='{.spec.template.spec.containers[0].image}')
          echo "imatge_anterior=$ACTUAL" >> $GITHUB_OUTPUT

      - name: Desplegar (actualització progressiva)
        run: |
          kubectl set image deployment/bibliotech \
            bibliotech=${{ env.REGISTRE }}/${{ env.IMATGE }}@${{ needs.imatge.outputs.digest }} \
            --namespace=produccio
          kubectl rollout status deployment/bibliotech -n produccio --timeout=10m

      - name: Verificar salut després del desplegament
        id: verificar
        run: |
          sleep 30
          BASE=https://bibliotech.nexussoftware.com
          for i in $(seq 1 10); do
            if curl -fsS "$BASE/actuator/health/readiness" | jq -e '.status == "UP"' > /dev/null; then
              echo "Instancia sana (intent $i)"; sleep 5
            else
              echo "::error::Verificacio de salut fallida"; exit 1
            fi
          done
          # Comprovar que la taxa d'errors no s'ha disparat
          ERRORS=$(curl -fsS "$BASE/actuator/metrics/http.server.requests?tag=outcome:SERVER_ERROR" \
                    | jq '.measurements[0].value // 0')
          if (( $(echo "$ERRORS > 10" | bc -l) )); then
            echo "::error::Massa errors 5xx despres del desplegament"; exit 1
          fi

      - name: Tornada enrere automàtica si alguna cosa ha fallat
        if: failure()
        run: |
          echo "::warning::Desplegament fallit; tornant a la versio anterior"
          kubectl rollout undo deployment/bibliotech -n produccio
          kubectl rollout status deployment/bibliotech -n produccio --timeout=5m

      - name: Notificar el resultat
        if: always()
        run: |
          ESTAT="${{ job.status }}"
          curl -X POST "${{ secrets.WEBHOOK_EQUIP }}" \
            -H 'Content-Type: application/json' \
            -d "{\"text\":\"Desplegament de BiblioTech ${{ github.ref_name }}: $ESTAT\"}"

// AMB 3 INSTANCIES: aixo envia TRES avisos a cada empleat, tots els dies
@Scheduled(cron = "0 0 8 * * *")
public void enviarAvisosDiaris() {
    serveiAvisos.avisarVencimentsProxims(3);
}

// Opcio A: ShedLock — bloqueig distribuit a la base de dades
@Scheduled(cron = "0 0 8 * * *")
@SchedulerLock(name = "avisosDiaris", lockAtMostFor = "10m", lockAtLeastFor = "1m")
public void enviarAvisosDiaris() {
    serveiAvisos.avisarVencimentsProxims(3);
}

# Opció B: un CronJob de Kubernetes que invoca la CLI de 12-03.
# Avantatge: el planificador no viu a l'aplicació.
apiVersion: batch/v1
kind: CronJob
metadata:
  name: bibliotech-avisos
spec:
  schedule: "0 8 * * *"
  concurrencyPolicy: Forbid           # no encavalcar execucions
  jobTemplate:
    spec:
      backoffLimit: 3
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: cli
              image: registre.nexussoftware.com/bibliotech-cli:1.4.2
              args: ["avisos", "enviar", "--dies-antelacio=3"]
              envFrom:
                - secretRef: { name: bibliotech-secrets }

apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: bibliotech
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: bibliotech
  minReplicas: 3
  maxReplicas: 10
  metrics:
    - type: Resource
      resource:
        name: cpu
        target: { type: Utilization, averageUtilization: 70 }
  behavior:
    scaleDown:
      stabilizationWindowSeconds: 300     # no reduir a la primera baixada: evita oscil·lació

# ==============================================================================
# ETAPA 1: CONSTRUCCIÓ
# ==============================================================================
FROM eclipse-temurin:21-jdk-alpine AS constructor

WORKDIR /build

COPY .mvn/ .mvn/
COPY mvnw pom.xml ./
COPY bibliotech-domini/pom.xml           bibliotech-domini/
COPY bibliotech-aplicacio/pom.xml        bibliotech-aplicacio/
COPY bibliotech-infraestructura/pom.xml  bibliotech-infraestructura/
COPY bibliotech-consola/pom.xml          bibliotech-consola/

RUN --mount=type=cache,target=/root/.m2 \
    ./mvnw -B -pl bibliotech-consola -am dependency:go-offline -DskipTests

COPY bibliotech-domini/src           bibliotech-domini/src
COPY bibliotech-aplicacio/src        bibliotech-aplicacio/src
COPY bibliotech-infraestructura/src  bibliotech-infraestructura/src
COPY bibliotech-consola/src          bibliotech-consola/src

RUN --mount=type=cache,target=/root/.m2 \
    ./mvnw -B -pl bibliotech-consola -am clean package -DskipTests

RUN java -Djarmode=tools -jar bibliotech-consola/target/bibliotech-cli.jar \
         extract --layers --launcher --destination extret

# ==============================================================================
# ETAPA 2: GENERAR L'ARXIU CDS
# S'executa l'aplicació una vegada amb --help perquè carregui les classes,
# i se'n memoritza el resultat. Això retalla ~1,5 s de cada arrencada, que
# multiplicat per les execucions de cron sí que importa.
# ==============================================================================
FROM eclipse-temurin:21-jre-alpine AS cds

WORKDIR /app
COPY --from=constructor /build/extret/ ./

RUN java -XX:ArchiveClassesAtExit=/app/cli.jsa \
         org.springframework.boot.loader.launch.JarLauncher --help > /dev/null 2>&1 || true

# ==============================================================================
# ETAPA 3: EXECUCIÓ
# ==============================================================================
FROM eclipse-temurin:21-jre-alpine AS execucio

LABEL org.opencontainers.image.title="BiblioTech CLI" \
      org.opencontainers.image.description="Eina de linia d ordres de BiblioTech" \
      org.opencontainers.image.vendor="Nexus Software"

# tzdata per a les dates; dumb-init perquè Ctrl+C i SIGTERM arribin al procés
# (la cancel·lació neta de 12-03 en depèn).
# NO s'instal·la curl: no hi ha healthcheck per fer.
RUN apk add --no-cache tzdata dumb-init && rm -rf /var/cache/apk/*
ENV TZ=Europe/Madrid

RUN addgroup -S -g 1001 bibliotech && \
    adduser -S -u 1001 -G bibliotech -h /app bibliotech

WORKDIR /app

COPY --from=cds --chown=bibliotech:bibliotech /app/ ./

USER bibliotech

# Opcions ORIENTADES A L'ARRENCADA, no al rendiment sostingut.
# El procés viu segons: compilar a fons amb C2 no s'amortitza mai.
#   TieredStopAtLevel=1    només C1: compilació ràpida i lleugera
#   UseSerialGC            el GC més barat d'inicialitzar (una sola tasca, poca memòria)
#   SharedArchiveFile      fa servir el CDS de l'etapa 2
#   MaxRAMPercentage=75    conscient del cgroup, com sempre
ENV JAVA_OPTS="\
    -XX:TieredStopAtLevel=1 \
    -XX:+UseSerialGC \
    -XX:SharedArchiveFile=/app/cli.jsa \
    -XX:MaxRAMPercentage=75.0 \
    -Xshare:auto \
    -Dspring.main.banner-mode=off \
    -Dfile.encoding=UTF-8"

# SENSE EXPOSE: la CLI no escolta en cap port.
# SENSE HEALTHCHECK: el procés acaba; no hi ha res a vigilar.

ENTRYPOINT ["dumb-init", "--", "sh", "-c", \
            "exec java $JAVA_OPTS org.springframework.boot.loader.launch.JarLauncher \"$@\"", "--"]

# CMD són els arguments PER DEFECTE, substituïbles en executar
CMD ["--help"]

docker build -f Dockerfile.cli -t bibliotech-cli:1.4.2 .

docker run --rm bibliotech-cli:1.4.2 cataleg llistar --format=json
docker run --rm -e BIBLIOTECH_DB_URL=… bibliotech-cli:1.4.2 avisos enviar --dies-antelacio=3

# Comprovar l'efecte del CDS
docker run --rm bibliotech-cli:1.4.2 --version   # ~1,1 s en lloc de ~2,6 s

apiVersion: batch/v1
kind: CronJob
metadata:
  name: bibliotech-avisos-diaris
  labels:
    app: bibliotech
    component: tasques-programades
spec:
  schedule: "0 8 * * 1-5"           # de dilluns a divendres a les 8:00
  timeZone: "Europe/Madrid"         # Kubernetes 1.27+: fonamental amb l'horari d'estiu

  concurrencyPolicy: Forbid         # si l'anterior continua corrent, NO llançar-ne una altra
  successfulJobsHistoryLimit: 3
  failedJobsHistoryLimit: 5
  startingDeadlineSeconds: 600      # si el clúster estava caigut, hi ha 10 min de marge

  jobTemplate:
    spec:
      backoffLimit: 2               # 2 reintents davant d'una fallada
      activeDeadlineSeconds: 900    # matar si supera els 15 minuts
      ttlSecondsAfterFinished: 86400

      template:
        metadata:
          labels:
            app: bibliotech
            tasca: avisos
        spec:
          restartPolicy: OnFailure

          securityContext:
            runAsNonRoot: true
            runAsUser: 1001

          containers:
            - name: cli
              image: registre.nexussoftware.com/bibliotech-cli:1.4.2
              imagePullPolicy: IfNotPresent

              args:
                - "avisos"
                - "enviar"
                - "--dies-antelacio=3"
                - "--silencios"        # sense decoració: la sortida va al log

              envFrom:
                - configMapRef: { name: bibliotech-config }
                - secretRef:    { name: bibliotech-secrets }

              resources:
                requests: { memory: "256Mi", cpu: "100m" }
                limits:   { memory: "512Mi", cpu: "1000m" }

              securityContext:
                allowPrivilegeEscalation: false
                readOnlyRootFilesystem: true
                capabilities: { drop: ["ALL"] }

              volumeMounts:
                - name: tmp
                  mountPath: /tmp

          volumes:
            - name: tmp
              emptyDir: {}

kubectl get cronjob bibliotech-avisos-diaris
kubectl create job --from=cronjob/bibliotech-avisos-diaris prova-manual   # executar ja
kubectl logs job/prova-manual

-- V9__partir_nom_empleat_fase1.sql

ALTER TABLE empleats ADD COLUMN nom_pila VARCHAR(80);
ALTER TABLE empleats ADD COLUMN cognoms  VARCHAR(120);

-- Poblar amb una heurística conservadora:
-- la PRIMERA paraula és el nom; la resta, els cognoms.
-- És imperfecta per a noms compostos ("Josep Maria"), i per això
-- es conserva la columna original i es genera un informe de revisió.
UPDATE empleats
SET nom_pila = split_part(trim(nom), ' ', 1),
    cognoms  = NULLIF(trim(substring(trim(nom) from position(' ' in trim(nom)) + 1)), '')
WHERE nom_pila IS NULL;

-- Cas especial: un sol terme (sense espais) → tot és nom
UPDATE empleats
SET nom_pila = trim(nom), cognoms = NULL
WHERE position(' ' in trim(nom)) = 0;

-- Trigger de sincronia bidireccional: tant se val quina versió de l'app escrigui
CREATE OR REPLACE FUNCTION sincronitzar_nom_empleat() RETURNS TRIGGER AS $$
BEGIN
    IF TG_OP = 'INSERT' THEN
        IF NEW.nom_pila IS NULL AND NEW.nom IS NOT NULL THEN
            -- Va escriure l'app v1 (columna antiga): derivar les noves
            NEW.nom_pila := split_part(trim(NEW.nom), ' ', 1);
            NEW.cognoms  := NULLIF(trim(substring(trim(NEW.nom)
                                    from position(' ' in trim(NEW.nom)) + 1)), '');
        ELSIF NEW.nom IS NULL AND NEW.nom_pila IS NOT NULL THEN
            -- Va escriure l'app v2 (columnes noves): derivar l'antiga
            NEW.nom := trim(NEW.nom_pila || ' ' || COALESCE(NEW.cognoms, ''));
        END IF;
    ELSIF TG_OP = 'UPDATE' THEN
        IF NEW.nom IS DISTINCT FROM OLD.nom THEN
            NEW.nom_pila := split_part(trim(NEW.nom), ' ', 1);
            NEW.cognoms  := NULLIF(trim(substring(trim(NEW.nom)
                                    from position(' ' in trim(NEW.nom)) + 1)), '');
        ELSIF NEW.nom_pila IS DISTINCT FROM OLD.nom_pila
           OR NEW.cognoms  IS DISTINCT FROM OLD.cognoms THEN
            NEW.nom := trim(NEW.nom_pila || ' ' || COALESCE(NEW.cognoms, ''));
        END IF;
    END IF;
    RETURN NEW;
END;
$$ LANGUAGE plpgsql;

CREATE TRIGGER trg_sincronitzar_nom
    BEFORE INSERT OR UPDATE ON empleats
    FOR EACH ROW EXECUTE FUNCTION sincronitzar_nom_empleat();

-- Vista de revisió manual: els casos que l'heurística probablement va fallar
CREATE OR REPLACE VIEW v_empleats_revisio_nom AS
SELECT id, nom, nom_pila, cognoms,
       CASE
         WHEN nom_pila IN ('Josep','Jose','Maria','Joan','Anna','Lluis','Francesc','Pere')
              AND cognoms LIKE '% %'                     THEN 'possible nom compost'
         WHEN cognoms ~ '^(de|del|dels|la|les|els|van|von|di|da) ' THEN 'cognom amb particula'
         WHEN cognoms IS NULL                            THEN 'sense cognoms'
         ELSE 'revisar'
       END AS motiu
FROM empleats
WHERE nom_pila IN ('Josep','Jose','Maria','Joan','Anna','Lluis','Francesc','Pere')
   OR cognoms ~ '^(de|del|dels|la|les|els|van|von|di|da) '
   OR cognoms IS NULL;

@Entity
public class Empleat {

    @Column(name = "nom_pila", length = 80)
    private String nomPila;

    @Column(name = "cognoms", length = 120)
    private String cognoms;

    /**
     * La columna antiga continua existint i la mante el trigger.
     * insertable/updatable a false: JPA MAI no l'escriu.
     * Es conserva mapejada nomes per poder llegir-la si calgues.
     */
    @Column(name = "nom", insertable = false, updatable = false)
    private String nomCompletHeretat;

    public String nomComplet() {
        return cognoms == null ? nomPila : nomPila + " " + cognoms;
    }
}

-- V11__partir_nom_empleat_fase3.sql

-- Verificació prèvia: si alguna cosa va quedar incoherent, AVORTAR
DO $$
DECLARE incoherents INTEGER;
BEGIN
    SELECT count(*) INTO incoherents
    FROM empleats
    WHERE nom_pila IS NULL
       OR trim(nom) IS DISTINCT FROM trim(nom_pila || ' ' || COALESCE(cognoms, ''));

    IF incoherents > 0 THEN
        RAISE EXCEPTION 'Hi ha % empleats amb nom incoherent. Revisa v_empleats_revisio_nom abans de contraure.', incoherents;
    END IF;
END $$;

DROP TRIGGER IF EXISTS trg_sincronitzar_nom ON empleats;
DROP FUNCTION IF EXISTS sincronitzar_nom_empleat();
DROP VIEW IF EXISTS v_empleats_revisio_nom;

ALTER TABLE empleats ALTER COLUMN nom_pila SET NOT NULL;
ALTER TABLE empleats DROP COLUMN nom;

CREATE INDEX idx_empleat_cognoms ON empleats(cognoms, nom_pila);

@Tag("integracio")
class MigracioNomEmpleatIT extends ProvaAmbPostgres {

    @Test
    void parteixCorrectamentElsNomsConeguts() {
        // Estat inicial: fins a V8, amb la columna antiga
        flywayFinsA("8");
        jdbc.update("""
                insert into empleats (nom, correu, data_alta) values
                    ('Marta Ruiz',              '[email protected]',  '2024-03-01'),
                    ('Diego Alonso',            '[email protected]',  '2025-01-15'),
                    ('Nuria Vidal',             '[email protected]',  '2023-09-10'),
                    ('Josep Maria Ferre Roig',  '[email protected]',  '2022-05-20'),
                    ('Anna de la Torre',        '[email protected]',   '2021-11-02'),
                    ('Prince',                  '[email protected]', '2020-01-01')
                """);

        flywayFinsA("9");     // aplicar la fase 1

        assertThat(consultar("[email protected]"))
                .containsExactly("Marta", "Ruiz");
        assertThat(consultar("[email protected]"))
                .containsExactly("Nuria", "Vidal");

        // Casos dificils: l'heuristica els divideix malament, i aixo es ESPERAT
        assertThat(consultar("[email protected]"))
                .containsExactly("Josep", "Maria Ferre Roig");     // requereix revisio manual
        assertThat(consultar("[email protected]"))
                .containsExactly("Anna", "de la Torre");

        // Un sol terme
        assertThat(consultar("[email protected]"))
                .containsExactly("Prince", null);

        // I tots apareixen a la vista de revisio, que es l'important:
        // la migracio no preten encertar sempre, preten NO PERDRE DADES
        // i assenyalar el que cal revisar.
        assertThat(jdbc.queryForList("select correu from v_empleats_revisio_nom", String.class))
                .contains("[email protected]", "[email protected]",
                          "[email protected]");
    }

    @Test
    void elTriggerSincronitzaEnLesDuesDireccions() {
        flywayFinsA("9");

        // L'app v1 escriu la columna antiga
        jdbc.update("insert into empleats (nom, correu, data_alta) values (?,?,?)",
                    "Carles Sanz", "[email protected]", Date.valueOf("2026-01-01"));
        assertThat(consultar("[email protected]")).containsExactly("Carles", "Sanz");

        // L'app v2 escriu les columnes noves
        jdbc.update("""
                insert into empleats (nom_pila, cognoms, correu, data_alta)
                values (?,?,?,?)""",
                "Elena", "Ferrer Rico", "[email protected]", Date.valueOf("2026-01-02"));
        assertThat(jdbc.queryForObject(
                "select nom from empleats where correu = ?", String.class,
                "[email protected]"))
                .isEqualTo("Elena Ferrer Rico");
    }

    @Test
    void laFase3AvortaSiQuedenIncoherencies() {
        flywayFinsA("9");
        // Provocar una incoherencia saltant-se el trigger
        jdbc.update("alter table empleats disable trigger trg_sincronitzar_nom");
        jdbc.update("insert into empleats (nom, correu, data_alta) values (?,?,?)",
                    "Sense Partir", "[email protected]", Date.valueOf("2026-01-03"));
        jdbc.update("alter table empleats enable trigger trg_sincronitzar_nom");

        assertThatThrownBy(() -> flywayFinsA("11"))
                .hasMessageContaining("nom incoherent");

        // I el mes important: la columna antiga CONTINUA AQUI. No s'ha perdut res.
        assertThat(existeixColumna("empleats", "nom")).isTrue();
    }
}

# k8s/blau-verd/service.yaml
# El Service apunta a UN color. Commutar = canviar el selector.
apiVersion: v1
kind: Service
metadata:
  name: bibliotech
  labels: { app: bibliotech }
spec:
  selector:
    app: bibliotech
    color: blau                  # ← això és el que canvia en la commutació
  ports:
    - port: 80
      targetPort: 8080
---
# Service auxiliar per provar el color inactiu SENSE trànsit real
apiVersion: v1
kind: Service
metadata:
  name: bibliotech-preview
spec:
  selector:
    app: bibliotech
    color: verd                  # s'ajusta abans de les proves de fum
  ports:
    - port: 80
      targetPort: 8080
---
# k8s/blau-verd/deployment-plantilla.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: bibliotech-COLOR
  labels: { app: bibliotech, color: COLOR }
spec:
  replicas: 3
  selector:
    matchLabels: { app: bibliotech, color: COLOR }
  template:
    metadata:
      labels: { app: bibliotech, color: COLOR }
    spec:
      terminationGracePeriodSeconds: 60
      containers:
        - name: bibliotech
          image: IMATGE
          ports: [{ name: http, containerPort: 8080 }]
          envFrom:
            - configMapRef: { name: bibliotech-config }
            - secretRef:    { name: bibliotech-secrets }
          resources:
            requests: { memory: "512Mi", cpu: "250m" }
            limits:   { memory: "768Mi", cpu: "1500m" }
          startupProbe:
            httpGet: { path: /actuator/health/liveness, port: http }
            failureThreshold: 20
            periodSeconds: 5
          readinessProbe:
            httpGet: { path: /actuator/health/readiness, port: http }
            periodSeconds: 5

# .github/workflows/cd-blau-verd.yml
name: Desplegament blau-verd

on:
  push:
    tags: ['v*']

env:
  NAMESPACE: produccio
  REGISTRE: ghcr.io
  IMATGE: ${{ github.repository }}

jobs:

  # ---------------------------------------------------------------
  # 1. Determinar els colors
  # ---------------------------------------------------------------
  colors:
    runs-on: ubuntu-latest
    outputs:
      actiu:   ${{ steps.detectar.outputs.actiu }}
      inactiu: ${{ steps.detectar.outputs.inactiu }}
    steps:
      - name: Configurar kubectl
        uses: azure/k8s-set-context@v4
        with:
          kubeconfig: ${{ secrets.KUBECONFIG }}

      - name: Detectar el color actiu
        id: detectar
        run: |
          ACTIU=$(kubectl get service bibliotech -n $NAMESPACE \
                  -o jsonpath='{.spec.selector.color}')
          if [ "$ACTIU" = "blau" ]; then INACTIU="verd"; else INACTIU="blau"; fi
          echo "actiu=$ACTIU"     >> $GITHUB_OUTPUT
          echo "inactiu=$INACTIU" >> $GITHUB_OUTPUT
          echo "::notice::Actiu: $ACTIU — es desplegara a: $INACTIU"

  # ---------------------------------------------------------------
  # 2. Desplegar al color inactiu (sense trànsit)
  # ---------------------------------------------------------------
  desplegar-inactiu:
    runs-on: ubuntu-latest
    needs: colors
    steps:
      - uses: actions/checkout@v4
      - uses: azure/k8s-set-context@v4
        with: { kubeconfig: '${{ secrets.KUBECONFIG }}' }

      - name: Generar i aplicar el Deployment del color inactiu
        run: |
          COLOR=${{ needs.colors.outputs.inactiu }}
          IMG=${{ env.REGISTRE }}/${{ env.IMATGE }}:${{ github.ref_name }}

          sed -e "s|COLOR|$COLOR|g" -e "s|IMATGE|$IMG|g" \
              k8s/blau-verd/deployment-plantilla.yaml | kubectl apply -n $NAMESPACE -f -

          kubectl rollout status deployment/bibliotech-$COLOR -n $NAMESPACE --timeout=10m

      - name: Apuntar el Service de previsualització al color inactiu
        run: |
          kubectl patch service bibliotech-preview -n $NAMESPACE \
            -p '{"spec":{"selector":{"app":"bibliotech","color":"${{ needs.colors.outputs.inactiu }}"}}}'

  # ---------------------------------------------------------------
  # 3. Proves de fum contra el color inactiu
  # ---------------------------------------------------------------
  fum:
    runs-on: ubuntu-latest
    needs: [colors, desplegar-inactiu]
    steps:
      - uses: azure/k8s-set-context@v4
        with: { kubeconfig: '${{ secrets.KUBECONFIG }}' }

      - name: Executar proves contra el color inactiu
        run: |
          kubectl port-forward service/bibliotech-preview 18080:80 -n $NAMESPACE &
          PF=$!
          sleep 8
          set -e

          BASE=http://localhost:18080

          echo "→ Salut"
          curl -fsS "$BASE/actuator/health/readiness" | jq -e '.status == "UP"'

          echo "→ Versio desplegada"
          VERSIO=$(curl -fsS "$BASE/actuator/info" | jq -r '.build.version')
          test "v$VERSIO" = "${{ github.ref_name }}" \
            || { echo "::error::Versio inesperada: $VERSIO"; exit 1; }

          echo "→ Cataleg"
          curl -fsS "$BASE/api/materials?size=1" | jq -e '.contingut | length >= 0'

          echo "→ Errors esperats (404 i 400)"
          test "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/api/materials/978-9999999999")" = "404"
          test "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/api/materials/no-isbn")" = "400"

          kill $PF
          echo "Proves de fum correctes"

  # ---------------------------------------------------------------
  # 4. Commutar el trànsit (amb aprovació manual)
  # ---------------------------------------------------------------
  commutar:
    runs-on: ubuntu-latest
    needs: [colors, fum]
    environment:
      name: produccio            # amb revisors obligatoris
      url: https://bibliotech.nexussoftware.com
    steps:
      - uses: azure/k8s-set-context@v4
        with: { kubeconfig: '${{ secrets.KUBECONFIG }}' }

      - name: Commutar el Service al color nou
        run: |
          kubectl patch service bibliotech -n $NAMESPACE \
            -p '{"spec":{"selector":{"app":"bibliotech","color":"${{ needs.colors.outputs.inactiu }}"}}}'
          echo "::notice::Transit commutat a ${{ needs.colors.outputs.inactiu }}"

  # ---------------------------------------------------------------
  # 5. Vigilar 5 minuts; tornar enrere si la taxa d'error puja
  # ---------------------------------------------------------------
  vigilar:
    runs-on: ubuntu-latest
    needs: [colors, commutar]
    steps:
      - uses: azure/k8s-set-context@v4
        with: { kubeconfig: '${{ secrets.KUBECONFIG }}' }

      - name: Vigilar la taxa d'errors durant 5 minuts
        id: vigilancia
        run: |
          BASE=https://bibliotech.nexussoftware.com
          LLINDAR_ERRORS=0.02          # 2 % de 5xx

          for i in $(seq 1 10); do
            sleep 30

            TOTAL=$(curl -fsS "$BASE/actuator/metrics/http.server.requests" \
                    | jq '.measurements[] | select(.statistic=="COUNT") | .value')
            ERRORS=$(curl -fsS "$BASE/actuator/metrics/http.server.requests?tag=outcome:SERVER_ERROR" \
                      | jq '.measurements[] | select(.statistic=="COUNT") | .value // 0')

            TAXA=$(echo "scale=4; $ERRORS / ($TOTAL + 1)" | bc)
            echo "Comprovacio $i/10 — total=$TOTAL errors=$ERRORS taxa=$TAXA"

            if (( $(echo "$TAXA > $LLINDAR_ERRORS" | bc -l) )); then
              echo "::error::Taxa d errors $TAXA per sobre del llindar $LLINDAR_ERRORS"
              exit 1
            fi

            if ! curl -fsS "$BASE/actuator/health/readiness" | jq -e '.status == "UP"' > /dev/null; then
              echo "::error::La sonda de disponibilitat falla"
              exit 1
            fi
          done
          echo "Vigilancia superada"

      - name: TORNADA ENRERE automàtica
        if: failure()
        run: |
          echo "::warning::Tornant al color ${{ needs.colors.outputs.actiu }}"
          # La tornada enrere es INSTANTANIA: el color anterior continua ences i sa
          kubectl patch service bibliotech -n $NAMESPACE \
            -p '{"spec":{"selector":{"app":"bibliotech","color":"${{ needs.colors.outputs.actiu }}"}}}'

          curl -X POST "${{ secrets.WEBHOOK_EQUIP }}" \
            -H 'Content-Type: application/json' \
            -d '{"text":"🔴 BiblioTech ${{ github.ref_name }}: tornada enrere automatica a ${{ needs.colors.outputs.actiu }}"}'
          exit 1

  # ---------------------------------------------------------------
  # 6. Retirar el color antic, una hora després
  # ---------------------------------------------------------------
  retirar-antic:
    runs-on: ubuntu-latest
    needs: [colors, vigilar]
    steps:
      - uses: azure/k8s-set-context@v4
        with: { kubeconfig: '${{ secrets.KUBECONFIG }}' }

      - name: Esperar una hora abans de retirar
        run: sleep 3600      # finestra de seguretat: tornada enrere instantània durant 1 hora

      - name: Reduir el color antic a zero rèpliques
        run: |
          # No s'ESBORRA el Deployment: s'escala a 0.
          # Aixi el manifest es conserva i tornar a aixecar-lo es una ordre.
          kubectl scale deployment/bibliotech-${{ needs.colors.outputs.actiu }} \
            --replicas=0 -n $NAMESPACE

          curl -X POST "${{ secrets.WEBHOOK_EQUIP }}" \
            -H 'Content-Type: application/json' \
            -d '{"text":"✅ BiblioTech ${{ github.ref_name }} estable. Color ${{ needs.colors.outputs.actiu }} retirat."}'