Astro SSR em Bun

Aplicação Astro com renderização no servidor (output: "server") executada pelo runtime Bun. Cada requisição monta o HTML do extrato no servidor: o navegador recebe o conteúdo pronto, sem depender de JavaScript no cliente. Use quando a página mostra dado que muda a cada acesso e não pode ser congelado no build — como um extrato bancário.

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

Infraestrutura realTypeScriptBunAstroPlaywrightDocker

Cenário Relações Comparar

Baixar cartão

Cenário

Consulta de extrato de conta corrente num banco digital. O saldo disponível, os últimos lançamentos (PIX, TED, boleto) e o protocolo da consulta são calculados no servidor a cada requisição, em centavos inteiros. O extrato sai marcado como no-store, private: nenhum proxy ou cache compartilhado guarda o saldo de um cliente para servir a outro.

Planta

Sequência

3/3

3 passos — reproduza para seguir o fluxo

chamada
resposta ou assíncrono
falha
passo
toque num participante para focar
Outras plantas de sequência

Como funciona

6 passos

SSR Astro servido por Bun em contêiner.

Esconde cada passo: lembre antes de tocar para revelar.

01
astro.config.mjs declara output: "server" com o adapter @astrojs/node em modo standalone
02
O frontmatter de src/pages/index.astro roda no servidor a cada requisição e chama statementBuild
03
statement_account.ts soma os lançamentos em centavos e gera um protocolo por consulta; a formatação em pt-BR acontece no servidor
04
A página define cache-control: no-store, private e entrega HTML semântico (table com caption, time)
05
bun ./dist/server/entry.mjs sobe o servidor gerado pelo build; o Dockerfile faz o mesmo em dois estágios, sem root
06
Os testes Playwright provam a assinatura do SSR: dado no HTML, página completa sem JavaScript, protocolo novo a cada requisição e extrato não cacheável

apps/front/astro-bun-app

6 arquivos

src/pages/

index.astroRota única: extrato renderizado no servidor a cada requisição

src/

statement_account.tsSaldo, lançamentos e protocolo da consulta, em centavos
statement.test.tstesteTestes E2E que provam o SSR (Playwright)

astro.config.mjsoutput: "server" e adapter Node standalone
playwright.config.tsSobe o build e espera a URL responder antes dos testes
DockerfileBuild em dois estágios; runtime só com dependências de produção e usuário sem privilégio

Executar · com Docker

$ bun install# dependências
$ bun run build
$ bun run start
$ bun run test# integração contra o serviço real
$

Servidor em http://localhost:4321. O bun run test sobe o build sozinho; com um Chromium já instalado fora da versão do Playwright, aponte PLAYWRIGHT_CHROMIUM_PATH para ele.