Contextualizando o uso da edge function e a orquestração anterior
Para nossa Edge Function (função de borda) desta vez, vamos utilizá-la para reservar carros, porque havíamos feito, no curso anterior, um tipo de Edge Function (função de borda) que serve para a orquestração, quando registramos nosso veículo. Agora, queremos reforçar a regra de negócio e a validação de informações. Para isso, vamos usar a Edge Function (função de borda) desta vez.
Deixamos um prompt (instrução) pronto e o deixamos em execução, pois sabemos que os assistentes demoram um pouco para responder, enquanto acompanhamos as coisas funcionando e revisamos o que fizemos.
No registrar veículo, que foi o que fizemos no curso anterior, trabalhamos com orquestração. Tínhamos os dados do nosso bucket (repositório), os dados do nosso veículo, a imagem do veículo e precisávamos registrar tudo em conjunto. Precisávamos ir ao banco de dados para registrar as informações, acessar o Storage (armazenamento) do Supabase para enviar a imagem, obter a URL dessa imagem e vinculá-la a esse veículo no nosso banco de dados. Dessa forma, a função registrar veículo orquestra serviços: chama o Storage (armazenamento), chama o banco de dados, pega a resposta do Storage (armazenamento), insere em outra tabela do banco de dados e faz tudo funcionar para que o registro de veículos ocorra corretamente.
Definindo a reserva atômica e tratando concorrência
Desta vez, queremos que a função garanta algumas regras. Enquanto isso acontece, vamos ver o prompt (instrução) que deixamos pronto. No nosso prompt (instrução), pedimos: criar uma Edge Function (função de borda) no Supabase para reservar carros e implementar uma reserva atômica — termo que pode soar estranho neste contexto. O que significa uma reserva atômica? Vamos ver com mais detalhes. Basicamente, o objetivo é, em uma única operação, verificar a disponibilidade, criar a reserva e bloquear o carro, impedindo o overbooking (excesso de reservas). Queremos três validações, três etapas distintas: verificar se o carro está disponível, criar a reserva (ou seja, efetivamente reservar o carro) e bloquear o carro, tudo de uma vez.
A operação atômica funciona assim: se qualquer uma dessas etapas falhar, toda a operação deve falhar. Então, se verificamos a disponibilidade e há disponibilidade, se criamos a reserva e deu certo, mas ao bloquear o carro ocorreu algum problema, precisamos desfazer a reserva. Em resumo, atômico significa que, ou toda a operação funciona por completo, ou tudo deve ser desfeito.
Dessa forma, sempre que formos reservar, primeiro verificaremos a disponibilidade, depois tentaremos criar a reserva e, em seguida, bloquear o carro. Se, ao verificar a disponibilidade, não houver disponibilidade, retornamos que não há disponibilidade. Se, ao criar a reserva, não for possível, retornamos que não foi possível criar a reserva. Se a reserva for criada, mas houver falha ao bloquear o carro, o problema pode ser, por exemplo, um volume muito grande de pedidos chegando ao mesmo tempo para aquele carro específico. Verificamos a disponibilidade, pegamos o ID de um carro físico (é um único carro) e, simultaneamente, outra operação de outra pessoa cliente tenta reservar o mesmo carro, porque ambas as verificações indicaram disponibilidade. As duas operações criam a reserva, mas a outra pessoa cliente foi mais rápida, concluiu a reserva e bloqueou o carro; quando formos bloquear, ocorrerá um erro. Nesse caso, precisamos desfazer, porque, em cenário de concorrência — concurrency (concorrência) — quando uma pessoa cliente conclui a operação, a outra não pode completá-la. Assim, se uma conseguiu bloquear o carro e a outra não, porque o carro já estava bloqueado, ao tentar bloquear, toda a função deve ser desfeita. É isso que chamamos de operação atômica: ou funciona completamente, ou não funciona, e então desfazemos os passos anteriores.
Especificando a requisição e validando no servidor
Também definimos alguns requisitos adicionais. Quando solicitarmos a reserva do carro, queremos receber um objeto em JSON (formato de intercâmbio de dados) com: ID do carro, data de início, data de fim, local de retirada, local de devolução e observações. Além disso, a chamada deve estar autenticada; ao chamar a função, precisa haver alguém autenticado no fluxo.
Por fim, além das regras sobre como queremos que a requisição chegue ao servidor, pedimos ao Supabase para validar algumas informações que, para nós, são óbvias, mas que para o sistema em desenvolvimento não serão óbvias.
Neste sistema, por exemplo, a data de início, a data de retirada do carro e a data de devolução do carro precisam fazer sentido. Temos que retirar o carro antes de devolvê-lo; não podemos fazer o contrário. Por isso, solicitamos a validação de que a data de início deve ser menor que a data de fim. Isso pode parecer óbvio para nós, mas, para um sistema, são apenas dois números. Se não pedirmos para validar nenhuma regra, o sistema analisará os dois números e, simplesmente, os salvará no banco de dados. Para nós, esses números precisam ter uma correlação: um deve ser, obrigatoriamente, anterior ao outro. Assim, a data de início precisa ser anterior à data de fim. Esse tipo de regra de negócio é o que estamos pedindo para validar aqui, e queremos que essa validação ocorra no servidor. Vamos ver isso também.
Por que validamos no servidor? Podemos, e é comum, ter o nosso frontend (interface de cliente) validando essas regras. Porém, precisamos ter a regra no servidor, porque o servidor é a nossa fonte da verdade. Quando a requisição chega ao servidor, a regra precisa estar válida e, se não estiver, deve retornar um erro.
A reserva só pode ser criada se não existir nenhuma reserva ou bloqueio que se sobreponha ao intervalo solicitado. Portanto, se, para o mesmo carro informado pelo campo carId, já existir uma reserva que coincida em algum dia do intervalo solicitado, a criação da nova reserva não pode ocorrer. Essa é outra regra que estamos estabelecendo.
Garantindo idempotência com chave de requisição
A função também deve ser idempotente. Esse termo pode parecer estranho para quem não vem do mundo do desenvolvimento, mas, basicamente, significa o seguinte: podemos ter erros na requisição ou alguém pode acessar nosso site e clicar repetidamente em “confirmar reserva”. Se isso acontecer, teremos várias requisições idênticas chegando ao nosso backend (servidor), o que pode gerar o problema de a mesma pessoa tentar reservar o mesmo carro diversas vezes. Com idempotência, se várias requisições idênticas chegarem, elas precisam produzir o mesmo resultado. O resultado da operação deve ser igual quando a requisição é exatamente igual.
Em termos práticos, teremos uma validação: se a primeira requisição chegou, conseguiu reservar o carro e retornou a reserva, então uma segunda, terceira ou quarta requisição com todos os campos idênticos não deve tentar executar a operação novamente nem gerar erro por o carro já estar reservado para a mesma pessoa. Em vez disso, deve responder informando que o carro já está reservado para essa pessoa e retornar sucesso. Assim, ao chegar a mesma informação ao backend (servidor), a resposta será sempre a mesma. Para possibilitar esse comportamento, utilizaremos uma chave de idempotência.
Implementando a transação atômica e o fluxo de validação
Há ainda algumas regras de implementação adicionais. Primeiro, vamos criar uma reserva atômica do carro no banco de dados; teremos uma função de banco de dados para isso e utilizaremos códigos de erro na nossa função de validação das Edge Functions (funções de borda).
Com base nisso, foi implementado o seguinte fluxo: utilizamos uma validação de JWT (JSON Web Token) para identificar o usuário; validamos a idempotência por meio da chave, a fim de verificar se a requisição já foi enviada; uma estratégia complementar de idempotência é, caso a mesma chave seja recebida, simplesmente ignorar a requisição seguinte porque a primeira já está em processamento; em seguida, validamos os campos e as informações fornecidas e, depois, chamamos a função do banco de dados que executará a transação de forma atômica. Dessa maneira, organizamos todo o processo e concentramos a lógica na função do banco de dados.
Para isso, foram criadas algumas tabelas: uma tabela de marcação de período bloqueado e uma tabela de cache (armazenamento em memória) de respostas por chave, para que, ao chegar a mesma requisição com a mesma chave, a resposta já esteja disponível, sem necessidade de reprocessamento. Também foi definido o esquema utilizado pela API (interface de programação de aplicações).
Verificando o código e integrando na aplicação
Agora, temos a função de reservar o carro criada e pudemos observar seu código em execução. Podemos validá-lo e verificar que as informações estão coerentes. O ideal é ler com atenção e tentar entender; mesmo sem conhecer código profundamente, há comentários que tornam o entendimento razoavelmente acessível. Obviamente, existem pontos mais complexos, mas é possível ter noção de que os passos descritos no assistente estão sendo executados.
A prova real, porém, é colocar essa função na aplicação para rodar. Vamos fazer isso.