O que é o padrão Backend-for-Frontend e como ele se relaciona com um API gateway?

Question

Accepted Answer

A **Backend-for-Frontend (BFF)** é um gateway dedicado por tipo de cliente (web, mobile, partner). Em vez de um gateway genérico servindo todos os clientes, cada frontend obtém um backend personalizado para suas necessidades.

## O problema que resolve

Um aplicativo móvel e um aplicativo web têm diferentes necessidades de dados, tamanho de payload e chattiness. Uma única API genérica força compromissos e over-fetching.

```text
Without BFF:        With BFF:
  All clients          Web ─▶ Web BFF ─┐
     │                 Mobile ─▶ Mobile BFF ─┼─▶ microservices
  one generic API      Partner ─▶ Partner BFF ─┘
```

## O que um BFF faz

- **Agrega** várias chamadas de serviço em uma resposta moldada para o cliente.
- **Reduz** payloads para clientes limitados (mobile).
- Detém **lógica específica do cliente** para que os serviços permaneçam genéricos.

```js
// Mobile BFF: one call → compose a lean screen payload
app.get('/home', async (req) => {
  const [user, orders] = await Promise.all([
    usersApi.get(req.userId),
    ordersApi.recent(req.userId, { limit: 3 }) // small for mobile
  ]);
  return { name: user.name, recentOrders: orders }; // tailored shape
});
```

## BFF vs gateway

| | API Gateway | BFF |
|---|---|---|
| Escopo | Um para todos os clientes | Um por tipo de cliente |
| Lógica | Cross-cutting genérica | Modelagem específica do cliente |

## Armadilha

Muitas BFFs duplicam lógica; mantenha-as enxutas e evite vazar regras de negócio que pertencem aos serviços.

## Por que isso importa

BFFs permitem que cada frontend evolua em seu próprio ritmo com um backend que se encaixa, em vez de forçar cada cliente para um contrato compartilhado.

Eles complementam (não substituem) o gateway: o gateway lida com preocupações de borda como auth e roteamento, enquanto o BFF lida com agregação específica do cliente.

	API Gateway	BFF
Escopo	Um para todos os clientes	Um por tipo de cliente
Lógica	Cross-cutting genérica	Modelagem específica do cliente