Aula

Explicar arquitetura de sistemas

Nível: B2

Objetivo

Narrar a arquitetura de um sistema em inglês para um time técnico: enquadrar o high-level design, apresentar os components, descrever o data flow entre eles, marcar boundaries claros e localizar os integration points, usando vocabulário natural de engenharia em voz alta.

Explicação

Explicar arquitetura em inglês é diferente de ler uma spec: o time precisa entender a figura mental em tempo real. Para isso, a fala B2 segue uma ordem previsível em quatro camadas — high-level, components, data flow, boundaries — e usa sinais de sequência e de contraste para guiar a audiência.

1. High-level framing (enquadrar o todo)

Comece situando o sistema antes de qualquer detalhe. Use marcadores de alto nível:

`At a high level, the system consists of three main parts.`
`Broadly speaking, we have an edge layer, a service layer, and a data layer.`
`The way I'd frame it: X talks to Y, which talks to Z.`
`If you zoom out, it's basically a pipeline with a few side paths.`

`At a high level` e `broadly speaking` sinalizam que você está simplificando de propósito — útil antes de entrar nos detalhes.

2. Components (quem faz o quê)

Cada componente merece uma frase curta com a sua responsabilidade:

`The API gateway handles authentication and rate limiting.`
`The auth service is responsible for issuing and validating tokens.`
`The order service owns the checkout flow.`
`The payment service is a separate component that we own jointly with finance.`

Padrões B2 úteis para nomear responsabilidade:

Padrão	Exemplo
`X handles Y`	`The load balancer handles the initial traffic split.`
`X is responsible for Y`	`The cache is responsible for absorbing read load.`
`X owns Y`	`The order service owns the cart state.`
`X is in charge of Y`	`The scheduler is in charge of retrying failed jobs.`

3. Data flow (como o dado se move)

O coração da narração é a sequência: request comes in → hits X → gets routed to Y → ends up in Z. Use verbos de movimento e preposições de lugar:

`The request comes in through the API gateway.`
`From there, it hits the auth service, which validates the token.`
`Once it's authenticated, it gets routed to the order service.`
`The order service then writes to the database and publishes a message to the queue.`
`Reads flow from the database into the cache, so the second request is much faster.`

Sinais de sequência B2:

`first` / `then` / `after that` / `from there` / `once X is done` / `finally`
`in parallel` / `at the same time` / `concurrently`
`right before` / `right after` / `by the time`

4. Boundaries e integration points

A diferença entre boundary e integration point é B2 puro:

Boundary = linha de responsabilidade. `The boundary between the order service and the payment service is enforced through a contract.`
Integration point = onde dois sistemas se tocam. `The main integration point is a REST API; the secondary one is an event stream.`

Frases-modelo para marcar limites:

`X and Y are decoupled through a message queue.`
`X communicates with Y over gRPC.`
`The two services are kept independent by a well-defined contract.`
`Anything that crosses this boundary goes through the auth layer.`
`Internally, the team can do whatever they want; externally, we expose a stable contract.`

5. Trade-offs em voz alta (opcional, mas B2)

Quando alguém pergunta *por que* uma decisão foi tomada, use estrutura de trade-off:

`We chose X over Y because latency mattered more than cost in that region.`
`The trade-off is consistency for availability.`
`It's not ideal, but it keeps the boundary clean.`
`On the upside, we get isolation; on the downside, we have one more hop.`

`On the upside / on the downside` é uma das expressões B2 mais naturais para apresentar trade-offs durante uma walkthrough.

Exemplos

Inglês	Tradução	Observação
At a high level, the platform consists of an edge layer, a service layer, and a data layer.	Em alto nível, a plataforma consiste em uma camada de borda, uma camada de serviços e uma camada de dados.	Enquadramento inicial com consist of.
The request comes in through the API gateway, where it gets authenticated and rate-limited.	A requisição entra pelo API gateway, onde é autenticada e tem a taxa limitada.	Padrão: comes in through + gets + past participle.
From there, it's routed to the order service, which owns the checkout flow.	Daí, ela é roteada para o serviço de pedidos, que é dono do fluxo de checkout.	From there + it's routed to; relative clause com which.
The order service then publishes a message to the queue, and the payment service picks it up asynchronously.	O serviço de pedidos então publica uma mensagem na fila, e o serviço de pagamento consome de forma assíncrona.	Then + publishes + picks it up asynchronously para marcar o integration point.
The boundary between the order service and the payment service is enforced through a published contract.	O limite entre o serviço de pedidos e o serviço de pagamento é garantido por um contrato publicado.	Boundary + is enforced through + contract.
Reads flow from the primary database into the cache, so subsequent requests are served from memory.	As leituras fluem do banco primário para o cache, então as requisições seguintes são servidas da memória.	Data flow explícito: flow from X into Y.
On the upside, we get isolation between teams; on the downside, we have one more network hop.	No lado bom, ganhamos isolamento entre times; no lado ruim, temos um hop de rede a mais.	Estrutura de trade-off B2 com on the upside / on the downside.
The cache sits between the service and the database, absorbing most of the read load.	O cache fica entre o serviço e o banco, absorvendo a maior parte da carga de leitura.	Sits between + V-ing descreve um boundary físico/lógico.

Erros comuns

Trocar consist of por consist in: `the system consists in three parts` está errado; use `consists of` (é formado por).
Misturar o verbo de movimento: `The request enters through the API gateway` é aceitável, mas `comes in through` soa mais natural em arquitetura; `enters in` está errado.
Usar talk no lugar errado: `X talk to Y` (plural sem -s) soa infantil em apresentação; use `X talks to Y` ou, no plural, `the services talk to each other`.
Esquecer a preposição em data flow: `data flows X to Y` está errado; use `data flows from X to Y` ou `reads flow from X into Y`.
Confundir boundary com integration point: `the integration point between X and Y` é aceitável, mas `the boundary between X and Y` descreve a separação de responsabilidade, não o ponto de contato.
Colocar then no lugar errado: `then the order service publishes` funciona, mas `the order service publishes then` está fora de ordem natural.
Marcar trade-offs sem contraste: `we chose X, we lost cost` é monossilábico; use `on the upside / on the downside` ou `the trade-off is X for Y`.
Encerrar a walkthrough sem fechar o diagrama: depois do detalhe, retome `so, going back to the diagram, ...` para reancorar a audiência.

Prática guiada

Reescreva cada bullet como uma frase B2 de walkthrough, variando o bloco gramatical.

High-level framing

`Gateway → auth service → order service → database` → `At a high level, the request goes through the gateway, hits the auth service, and then reaches the order service, which talks to the database.`

Componentes e responsabilidade

`cache, reads, fast` → `The cache sits between the service and the database, and it's responsible for serving reads fast.`

Data flow com integração assíncrona

`order service writes, queue, payment service consumes` → `The order service writes to the database and publishes a message to the queue; the payment service picks it up asynchronously.`

Boundary e contract

`payment service, stable contract, independent team` → `The boundary between the order service and the payment service is enforced through a stable contract, which lets each team evolve independently.`

Trade-off

`chose async, latency worse, isolation better` → `We chose the async path. On the upside, we get team isolation; on the downside, latency takes a small hit.`

Repare como cada bloco (framing, components, data flow, boundary, trade-off) começa com um marcador explícito — é isso que mantém a walkthrough B2 clara mesmo quando o diagrama é denso.

Resumo

Uma walkthrough B2 de arquitetura segue quatro camadas em ordem: high-level framing (at a high level, broadly speaking, the system consists of...), components (X handles / is responsible for / owns Y), data flow (the request comes in through X, gets routed to Y, ends up in Z) e boundaries + integration points (X and Y are decoupled through / communicate over / the boundary is enforced by). A narração usa sinais de sequência (first, then, from there, once, finally) e contraste (on the upside / on the downside) para que a audiência consiga reconstruir o diagrama mental sem ver a figura.

Vocabulário

Palavras principais

18 itens

high-levelde alto nível, simplificado

At a high level, the platform has three main parts.

Em alto nível, a plataforma tem três partes principais.

high-level designdesign de alto nível (visão geral antes do detalhe)

The high-level design is on slide three.

O design de alto nível está no slide três.

componentcomponente (peça do sistema)

Each component has a clear responsibility.

Cada componente tem uma responsabilidade clara.

subsystemsubsistema (componente maior, com partes internas)

The reporting subsystem runs on its own cluster.

O subsistema de relatórios roda em um cluster separado.

data flowfluxo de dados

The data flow is one-way, from producer to consumer.

O fluxo de dados é em mão única, do produtor para o consumidor.

boundarylimite (linha de responsabilidade entre partes)

The boundary between teams is enforced through a contract.

O limite entre times é garantido por um contrato.

integration pointponto de integração (onde dois sistemas se conectam)

The main integration point is the public REST API.

O principal ponto de integração é a API REST pública.

API gatewayAPI gateway (entrada única para vários serviços)

The API gateway handles authentication and rate limiting.

O API gateway cuida da autenticação e do rate limit.

auth serviceserviço de autenticação

The auth service validates every incoming token.

O serviço de autenticação valida cada token recebido.

load balancerbalanceador de carga

The load balancer spreads traffic across three regions.

O balanceador de carga distribui o tráfego entre três regiões.

message queuefila de mensagens

The order service publishes events to a message queue.

O serviço de pedidos publica eventos em uma fila de mensagens.

cache layercamada de cache

The cache layer sits in front of the database.

A camada de cache fica na frente do banco de dados.

read replicaréplica de leitura (cópia do banco só para ler)

Reads go to the read replica to keep the primary free for writes.

As leituras vão para a réplica, para manter o primário livre para escritas.

single point of failureponto único de falha

That database is still a single point of failure.

Esse banco ainda é um ponto único de falha.

synchronoussíncrono (chamada que bloqueia até a resposta)

The legacy call is synchronous, so latency stacks up.

A chamada legada é síncrona, então a latência se acumula.

asynchronousassíncrono (chamada que não bloqueia)

The new path is asynchronous and uses a queue.

O novo caminho é assíncrono e usa uma fila.

to routerotear, encaminhar

The gateway routes the request to the right service.

O gateway roteia a requisição para o serviço correto.

to pick upconsumir, pegar (uma mensagem na fila)

The payment service picks the message up within seconds.

O serviço de pagamento consome a mensagem em segundos.

História

História: Explicar arquitetura de sistemas

Nível: B2

História em inglês

The architecture walkthrough

On Monday morning, Priya walked into the conference room with a printed diagram and a laser pointer. She was about to walk the team through the new payments platform before the design review. "At a high level, the platform has three main parts: an edge layer, a service layer, and a data layer," she began. The way she framed it, every part had one job and one boundary, and she wanted the team to see that on slide two.

Walking through the components

She then pointed at the edge layer and said, "The API gateway handles authentication and rate limiting." "Right behind it, the auth service is responsible for validating the token against the identity provider." "The order service owns the checkout flow, and the payment service is the component we own jointly with the finance team." She paused to let the team write down the responsibilities before moving on.

The data flow

Next, Priya walked the team through the data flow, starting at the gateway. "The request comes in through the API gateway, gets authenticated, and from there it gets routed to the order service." "Once the order is created, the order service writes to the database and publishes an event to the queue." "The payment service picks the event up asynchronously, captures the funds, and writes the result back to the same database." "Reads, on the other hand, flow from the primary into the cache, so the second page load is much faster," she added.

Boundaries and integration points

Then she moved to the slide about boundaries, which was the part the senior engineers cared about most. "The boundary between the order service and the payment service is enforced through a published contract, and that contract hasn't changed in six months." "The main integration point between the two is the message queue; the secondary one is a synchronous REST call we use for refunds." "Anything that crosses this boundary goes through the auth layer first, so we don't have to trust the network," she said.

Trade-offs and questions

When someone asked why they had not gone fully async on the refund path, Priya was ready. "On the upside, the async path gives us full team isolation. On the downside, the refund UX takes an extra second, and finance did not want that." "The trade-off is team isolation for user-perceived latency, and we chose to keep the synchronous refund path for now." She closed the walkthrough by saying, "So, going back to the diagram, every arrow here corresponds to one boundary and one integration point, and that's the part I'd like you to challenge in the review." The team spent the next twenty minutes arguing about the synchronous refund path, which was exactly the conversation Priya had hoped to start.

Tradução linha por linha

Inglês	Tradução
On Monday morning, Priya walked into the conference room with a printed diagram and a laser pointer.	Na segunda de manhã, Priya entrou na sala com um diagrama impresso e um apontador laser.
She was about to walk the team through the new payments platform before the design review.	Ela ia conduzir o time pela nova plataforma de pagamentos antes da design review.
"At a high level, the platform has three main parts: an edge layer, a service layer, and a data layer," she began.	"Em alto nível, a plataforma tem três partes principais: uma camada de borda, uma camada de serviços e uma camada de dados", ela começou.
The way she framed it, every part had one job and one boundary, and she wanted the team to see that on slide two.	O jeito como ela enquadrava, cada parte tinha um trabalho e um limite, e ela queria que o time visse isso no slide dois.
She then pointed at the edge layer and said, "The API gateway handles authentication and rate limiting."	Ela então apontou para a camada de borda e disse: "O API gateway cuida da autenticação e do rate limit."
"Right behind it, the auth service is responsible for validating the token against the identity provider."	"Logo atrás, o serviço de autenticação é responsável por validar o token contra o provedor de identidade."
"The order service owns the checkout flow, and the payment service is the component we own jointly with the finance team."	"O serviço de pedidos é dono do fluxo de checkout, e o serviço de pagamento é o componente que mantemos em conjunto com o time de finanças."
She paused to let the team write down the responsibilities before moving on.	Ela fez uma pausa para deixar o time anotar as responsabilidades antes de seguir.
Next, Priya walked the team through the data flow, starting at the gateway.	Em seguida, Priya conduziu o time pelo fluxo de dados, começando pelo gateway.
"The request comes in through the API gateway, gets authenticated, and from there it gets routed to the order service."	"A requisição entra pelo API gateway, é autenticada, e daí é roteada para o serviço de pedidos."
"Once the order is created, the order service writes to the database and publishes an event to the queue."	"Quando o pedido é criado, o serviço de pedidos grava no banco e publica um evento na fila."
"The payment service picks the event up asynchronously, captures the funds, and writes the result back to the same database."	"O serviço de pagamento consome o evento de forma assíncrona, captura os fundos e grava o resultado de volta no mesmo banco."
"Reads, on the other hand, flow from the primary into the cache, so the second page load is much faster," she added.	"As leituras, por outro lado, fluem do primário para o cache, então o segundo carregamento de página é bem mais rápido", ela acrescentou.
Then she moved to the slide about boundaries, which was the part the senior engineers cared about most.	Então ela foi para o slide sobre limites, que era a parte pela qual os engenheiros seniores mais se interessavam.
"The boundary between the order service and the payment service is enforced through a published contract, and that contract hasn't changed in six months."	"O limite entre o serviço de pedidos e o serviço de pagamento é garantido por um contrato publicado, e esse contrato não muda há seis meses."
"The main integration point between the two is the message queue; the secondary one is a synchronous REST call we use for refunds."	"O principal ponto de integração entre os dois é a fila de mensagens; o secundário é uma chamada REST síncrona que usamos para reembolsos."
"Anything that crosses this boundary goes through the auth layer first, so we don't have to trust the network," she said.	"Qualquer coisa que cruze esse limite passa antes pela camada de autenticação, então não precisamos confiar na rede", ela disse.
When someone asked why they had not gone fully async on the refund path, Priya was ready.	Quando alguém perguntou por que eles não tinham tornado o caminho de reembolso totalmente assíncrono, Priya estava pronta.
"On the upside, the async path gives us full team isolation. On the downside, the refund UX takes an extra second, and finance did not want that."	"No lado bom, o caminho assíncrono nos dá isolamento total entre times. No lado ruim, a UX do reembolso leva um segundo a mais, e o time de finanças não queria isso."
"The trade-off is team isolation for user-perceived latency, and we chose to keep the synchronous refund path for now."	"O trade-off é isolamento entre times em troca de latência percebida pelo usuário, e escolhemos manter o caminho de reembolso síncrono por enquanto."
She closed the walkthrough by saying, "So, going back to the diagram, every arrow here corresponds to one boundary and one integration point, and that's the part I'd like you to challenge in the review."	Ela fechou a walkthrough dizendo: "Então, voltando ao diagrama, cada seta aqui corresponde a um limite e a um ponto de integração, e essa é a parte que eu gostaria que vocês questionassem na review."
The team spent the next twenty minutes arguing about the synchronous refund path, which was exactly the conversation Priya had hoped to start.	O time passou os vinte minutos seguintes discutindo o caminho de reembolso síncrono, que era exatamente a conversa que Priya queria iniciar.

Notas de vocabulário

walk the team through = conduzir o time por (explicar passo a passo); padrão B2 de walkthrough
At a high level, the platform has three main parts = framing inicial com at a high level + has + lista de três
The way she framed it = the way + sujeito + past = o jeito como; expresses o enquadramento
The API gateway handles authentication and rate limiting = componente + handles + responsabilidade
is responsible for validating the token = is responsible for + V-ing marca a responsabilidade de um componente
owns the checkout flow = owns = é dono de; descreve posse de estado/fluxo
The request comes in through the API gateway = data flow: comes in through X marca o primeiro hop
from there it gets routed to = from there + it gets + past participle + to; continua o data flow
Once the order is created, the order service writes to the database = once + past simple + main clause = pré-condição em B2
publishes an event to the queue = publishes ... to the queue = integração via mensagem assíncrona
picks the event up asynchronously = picks X up + asynchronously = consome mensagem de forma não bloqueante
Reads flow from the primary into the cache = data flow explícito: flow from X into Y
The boundary ... is enforced through a published contract = boundary + is enforced through + contract; marca limite de responsabilidade
The main integration point between the two is the message queue = integration point between X and Y; descreve o ponto de contato
Anything that crosses this boundary goes through the auth layer first = crosses + boundary + goes through X first; gate de entrada
On the upside ... On the downside = expressão fixa para trade-off em B2
The trade-off is X for Y = the trade-off is + X + for + Y; resume o que se troca
going back to the diagram = marcador para reancorar a audiência no slide após o detalhe

Perguntas de compreensão

What was Priya about to do on Monday morning?
How did Priya frame the system at a high level?
What does the API gateway handle?
Which component owns the checkout flow?
Describe the data flow from the gateway to the database.
How does the payment service consume the order event?
How is the boundary between the order service and the payment service enforced?
What are the two integration points between the order service and the payment service?
Why did the team keep the synchronous refund path instead of going fully async?
How did Priya close the walkthrough, and what did she ask the team to do?

Prática com a história

Reescreva usando high-level framing: o sistema tem gateway, serviço de pedidos, fila, banco.
Reescreva com data flow: a requisição entra pelo gateway, é roteada para o serviço de pedidos.
Reescreva com boundary + contract: os dois serviços estão separados por um contrato.
Reescreva com trade-off B2: o lado bom é isolamento; o lado ruim é latência maior.
Combine as duas frases em uma com integration point assíncrono: o serviço publica. O worker consome.

Prática

Exercícios e teste

Próxima etapa

7blocos de exercícios disponíveis neste tema

12questões de teste para revisar depois da aula

A próxima melhoria é transformar esses arquivos em perguntas com resposta no navegador. Por enquanto, esta página já organiza o estudo e permite seguir a aula inteira sem abrir os arquivos manualmente.