Graceful Degradation

Mantém a resposta de pé quando parte dos serviços falha: em vez de erro, a visão da conta sai em um tier de capacidade — completa, parcial ou mínima — conforme o que respondeu. O cliente recebe o tier e adapta a interface.

passos: 6
arquivos: 5
teste: 1
tecnologias: 3

Lógica puraTypeScriptBunElysia

Cenário Relações Comparar

Baixar cartão

Cenário

O app de um banco digital monta a visão da conta com três serviços: saldo (core), PIX (limites e chaves, habilita o botão de transferir) e ofertas de investimento. Cada um é um processo Elysia (api_dependency.ts, portas 7040–7042) e a visão é agregada por outro processo Elysia (api_overview.ts, porta 7050). O demo deixa o PIX lento, derruba as ofertas e por fim o saldo.

Como funciona

6 passos

Desliga o acessório, mantém o essencial.

Esconde cada passo: lembre antes de tocar para revelar.

Vocabulário compartilhado

AbortSignal.timeout+4

Promise.allSettled+2

transfer+1

Graceful Degradation

X-Service-Tier+1

Graceful Degradation

01
Core × opcional declaradoSaldo é core; PIX e ofertas são opcionais — sem essa distinção o sistema não sabe quando degradar
02
`Promise.allSettled`Uma falha não cancela o que os outros serviços responderam
03
Timeout por serviçoAbortSignal.timeout transforma o serviço travado em falha, sem segurar a resposta inteira
04
TierNenhuma falha → FULL; só opcionais → DEGRADED; core → MINIMAL (somente leitura)
05
CapacidadesSem PIX some transfer; sem ofertas some offers
06
Tier exposto e logadoX-Service-Tier no response e uma linha de log por requisição

apps/patterns/graceful-degradation

5 arquivos

src/

degradation_overview.tsoverviewGet com Promise.allSettled e timeout por serviço, tierClassify
api_overview.tsAPI da visão da conta (Elysia, porta 7050) com o header X-Service-Tier
api_dependency.tsServiços de saldo, PIX e ofertas (Elysia, 7040–7042), com PUT /mode up, down ou slow
demo.tsdemoSobe os quatro processos e degrada um serviço de cada vez
degradation_overview.test.tstesteTier por falha, corte do serviço lento pelo timeout e header contra serviços reais