Servicio de purga de expedientes prescritos

1Recorrer el árbol con Files.walk

Files.walk devuelve un Stream<Path> perezoso que baja por todos los subdirectorios. Mantiene descriptores de directorio abiertos: try-with-resources es obligatorio, no opcional.

try (Stream<Path> stream = Files.walk(raizExpedientes)) {
    List<Path> candidatos = stream
            .filter(Files::isRegularFile)
            .filter(this::estaPrescrito)
            .collect(Collectors.toList());
}

• Implementar ServicioPurgaExpedientes recorriendo el árbol con Files.walk (o Files.walkFileTree) dentro de try-with-resources

2Aplicar la regla R4 de prescripción

3 meses para infracciones leves, 6 meses para graves/muy graves, desde la comisión sin notificación.

private boolean estaPrescrito(Expediente expediente) {
    Period plazo = expediente.getGravedad() == Gravedad.LEVE
            ? Period.ofMonths(3)
            : Period.ofMonths(6); // graves y muy graves
    LocalDate limite = expediente.getFechaComision().plus(plazo);
    return expediente.getNotificacion() == null
            && LocalDate.now().isAfter(limite);
}

• Aplicar el plazo de 3 meses (leves) o 6 meses (graves/muy graves) desde la fecha de comisión sin notificación (R4)

3Filtrar con PathMatcher o Stream

Si el filtro es por patrón de ruta (p.ej. solo ficheros .json), compílalo una sola vez con PathMatcher en vez de repetir la compilación glob en cada iteración del bucle.

PathMatcher matcher = FileSystems.getDefault()
        .getPathMatcher("glob:**/*.json");
// reutilizar matcher.matches(path) dentro del filtro del stream

• Filtrar los candidatos a purgar con PathMatcher (compilado una vez) o con operadores de Stream

4Borrar ficheros y directorios vacíos

Files.delete sobre un directorio solo funciona si está vacío: borra primero los ficheros del expediente y comprueba después si el directorio quedó vacío.

Files.delete(ficheroExpediente);
Path directorio = ficheroExpediente.getParent();
try (Stream<Path> contenido = Files.list(directorio)) {
    if (contenido.findAny().isEmpty()) {
        Files.delete(directorio); // ahora sí está vacío
    }
}

• Borrar primero el/los fichero(s) del expediente prescrito con Files.delete
• Comprobar tras el borrado si el directorio quedó vacío y, si es así, eliminarlo también

5Registro y control de ejecución

Deja rastro de qué se purgó antes de borrarlo, y no dejes que la purga se dispare sola.

@Slf4j
public class ServicioPurgaExpedientes {

    public int purgar() throws IOException {
        int purgados = 0;
        for (Expediente expediente : localizarPrescritos()) {
            log.info("Purgando expediente prescrito {} (comisión {})",
                    expediente.getNumero(), expediente.getFechaComision());
            eliminar(expediente);
            purgados++;
        }
        return purgados;
    }
}

• Registrar en log cada expediente antes de purgarlo (número y fecha de comisión)
• Asegurar que la purga no se ejecuta automáticamente al arranque, solo bajo demanda

6Endpoint y pruebas

@PostMapping("/expedientes/purga")
public ResponseEntity<Integer> purgar() throws IOException {
    int purgados = servicioPurga.purgar();
    return ResponseEntity.ok(purgados);
}

• Exponer POST /expedientes/purga devolviendo la cantidad de expedientes purgados
• Usar java.nio.file (Path/Files) en toda la implementación, nunca java.io.File
• Escribir una prueba que confirme que los expedientes no prescritos quedan intactos tras la purga

!Problemas frecuentes

✓Criterios de aceptación

• Usa la API java.nio.file, no java.io.File
• Distingue correctamente el plazo por gravedad (3 vs. 6 meses)
• Elimina los directorios que quedan vacíos tras la purga
• Los expedientes no prescritos quedan intactos
• Registra en log cada expediente purgado antes de borrarlo
• El endpoint devuelve el número de expedientes purgados
• La purga no se ejecuta automáticamente al arranque