Uso de IA · Usuarios y accesos

    @Tool(name = "consultar_usuario",
          description = "Devuelve los datos de un usuario por su identificador UUID: correo y nombre enmascarados, estatus, roles y área.")
    public String consultarUsuario(
            @ToolParam(description = "Identificador UUID del usuario", required = true) String usuarioId) {
        RegistroHerramientasUsadas.registrar("consultar_usuario");
        String cuerpo = gateway.get()
                .uri(constructor -> constructor.path(RUTA_BASE + "/usuarios/{id}")
                        .build(UUID.fromString(usuarioId.trim())))
                .retrieve()
                .body(String.class);
        return FiltroDatosSensibles.redactar(cuerpo).texto();
    }

    @Tool(name = "preparar_alta_usuario",
          description = "Prepara el alta de un usuario nuevo. No crea el usuario y no pide contraseña: "
                  + "devuelve el identificador de la acción y un código de confirmación. "
                  + "El administrador completa el alta en la pantalla de altas, donde escribe la contraseña temporal.")
    public String prepararAltaUsuario(
            @ToolParam(description = "Correo electrónico del usuario nuevo", required = true) String correo,
            @ToolParam(description = "Nombre completo del usuario nuevo", required = true) String nombreCompleto,
            @ToolParam(description = "Roles separados por coma. Valores: ADMIN, FINANZAS, CONTADOR, VENTAS, COMPRAS, "
                    + "ALMACEN, OPERACIONES, CALIDAD, DIRECCION, LEGAL", required = true) String roles) {
        RegistroHerramientasUsadas.registrar("preparar_alta_usuario");
        String correoLimpio = correo == null ? "" : correo.trim();
        String nombreLimpio = nombreCompleto == null ? "" : nombreCompleto.trim();
        List<String> rolesLista = roles == null ? List.of()
                : Arrays.stream(roles.split(",")).map(String::trim).filter(r -> !r.isEmpty()).toList();
        if (!correoLimpio.matches("^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$")) {
            return "El correo no es válido. Pide el correo completo del usuario.";
        }
        if (nombreLimpio.isEmpty()) {
            return "Falta el nombre completo del usuario.";
        }
        if (rolesLista.isEmpty() || !ROLES_ALTA.containsAll(rolesLista)) {
            return "Roles inválidos. Usa solo: " + String.join(", ", ROLES_ALTA) + ".";
        }
        String usuario = SecurityContextHolder.getContext().getAuthentication().getName();
        String payload = aJson(Map.of("correo", correoLimpio, "nombreCompleto", nombreLimpio, "roles", rolesLista));
        AccionPendiente accion = acciones.preparar(usuario, AccionesPendientes.TIPO_USUARIO_ALTA, payload,
                "Alta de usuario " + correoLimpio + " con roles " + String.join(", ", rolesLista));
        return "Alta preparada: acción " + accion.id() + ", vence " + accion.expiraUtc()
                + ". Código de confirmación: " + codigos.generar(accion.id(), accion.usuario())
                + ". El usuario aún no existe. Completa el alta en /usuarios/altas/" + accion.id()
                + ", donde se escribe la contraseña temporal.";
    }

    static final String RUTA_BASE = "/usuarios-accesos-ms/v1";