
Na arquitetura de software moderna, compreender a interação entre hardware físico e serviços em nuvem é fundamental. Este tutorial explora uma visualização arquitetural específica: oDiagrama de Contêineres de Nível 2 para um Sistema de Gateway IoT. Utilizando a metodologia do modelo C4 em um ambiente VPasCode, detalhamos como representar sistemas embarcados complexos, bancos de dados locais e fluxos de dados externos em uma única visão coesa.
Diferentemente de um diagrama de contexto de alto nível que mostra um sistema como uma caixa preta, um diagrama de Nível 2 “abre a caixa”. Ele revela os ambientes de execução internos, os limites dos processos e as tecnologias específicas (linguagens, bancos de dados) que sustentam a aplicação. Abaixo, percorremos a construção deste diagrama, as escolhas específicas de modelagem feitas e a lógica técnica por trás das relações.
O Modelo C4: Por que Usar Contêineres?
O modelo C4 é uma abordagem hierárquica para documentação de arquitetura de software. Ele consiste em quatro níveis:
- Nível 1 (Contexto): Mostra o sistema e seus usuários.
- Nível 2 (Contêiner): Mostra os blocos de construção técnicos de alto nível (contêineres) que compõem o sistema.
- Nível 3 (Componente): Mostra a estrutura interna de um contêiner.
- Nível 4 (Código): Mostra as classes de código reais e as dependências.
Este tutorial foca emNível 2. No exemplo fornecido, estamos modelando umSistema de Gateway IoT. Esta é uma fronteira crítica porque representa a borda da rede onde os sensores físicos encontram a nuvem.
Passo a Passo: Construindo o Diagrama
Para recriar esta arquitetura, utilizamos código PlantUML. Este código é analisado pelo editor VPasCode para renderizar o diagrama visual à direita.
1. Preparando o Cenário: Inclusões e Layout
Primeiro, precisamos carregar a biblioteca C4 PlantUML. Esta biblioteca fornece as formas padrão (pessoas, contêineres, caixas) e as regras de estilo.
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
LAYOUT_WITH_LEGEND()
OLAYOUTCOMLEGENDA() é uma diretiva específica que instrui o renderizador a organizar automaticamente os elementos e gerar uma legenda explicando o significado das formas (por exemplo, “Pessoa” vs “Contêiner”).
2. Definindo os Atores e Sistemas Externos
Antes de definir o que está dentro da gateway, devemos definir quem interage com ela e com o que ela se comunica externamente.
Person(homeowner, "Proprietário da Casa", "Monitora e controla o clima da casa.")
System_Ext(weather_api, "API Nacional de Meteorologia", "Fornece previsões de temperatura ambiente externa.")
- Person(homeowner…): Representa o usuário humano. O rótulo descreve seu papel.
- SystemExt(weatherapi…): Representa um sistema fora de nosso limite. Usamos
SystemExtem vez de um padrãoSystempara indicar que o código-fonte não está sob nosso controle (é uma API de terceiros).
3. O Limite do Sistema e os Contêineres
Este é o núcleo do diagrama. Definimos um SystemBoundary para agrupar tudo o que ocorre dentro do hardware da Gateway IoT.
System_Boundary(gateway_boundary, "Sistema de Gateway IoT") {
Container(firmware, "Serviço Daemon Principal", "C++ / FreeRTOS", "Interroga diretamente os registros de hardware de sensores físicos via I2C.")
ContainerDb(local_db, "Cache de Telemetria", "Arquivo SQLite", "Armazena temporariamente métricas de sensores durante interrupções generalizadas de conexão.")
Container(mqtt_client, "Cliente de Sincronização com a Nuvem", "Binário Go", "Envia pacotes de telemetria estruturados para cima através de um socket WAN seguro.")
}
Observe os tipos específicos de contêineres utilizados:
- Container(firmware…): Isso representa o firmware executado no microcontrolador. A descrição destaca a interação de baixo nível: interrogação de registros de hardware via
I2C. - ContainerDb(localdb…): Usamos
ContainerDbespecificamente para bancos de dados. A descrição explica o padrão “armazenar e encaminhar”: bufferização de dados quando a internet está indisponível. - Container(mqttclient…):Isso representa um processo de cliente (provavelmente executado como um thread separado ou processo sidecar) responsável pela conectividade com a nuvem.
4. Definindo Relacionamentos (As “Linhas”)
Finalmente, desenhamos as setas. No PlantUML, oRelcomando significa “Relacionamento”. A sintaxe é geralmenteRel(Origem, Destino, "Rótulo", "Protocolo").
Rel(homeowner, firmware, "Controla localmente via", "BLE")
Rel(firmware, local_db, "Grava métricas em", "SQL / IPC")
Rel(mqtt_client, local_db, "Consulta quadros atrasados de", "SQL / IPC")
Rel(mqtt_client, weather_api, "Obtém status ambiental via", "HTTPS")
Principais insights arquiteturais a partir desses relacionamentos:
- BLE (Bluetooth de Baixa Energia):O proprietário interage diretamente com o firmware via Bluetooth, não via nuvem.
- IPC (Comunicação entre Processos):Observe que o firmware e o cliente MQTT interagem com o banco de dados via
SQL / IPC. Isso implica que o banco de dados é um arquivo local (SQLite) que atua como uma ponte entre o processo de firmware em C++ e o processo de cliente em Go. - HTTPS:O cliente da nuvem conversa com a API de Clima pela internet pública.
Análise Técnica: O Padrão Armazenar e Encaminhar
Este diagrama ilustra um padrão clássico na engenharia de IoT:Armazenar e Encaminhar. No diagrama, oCache de Telemetria(SQLite) é o componente crítico. Ele desacopla a coleta de dados (firmware) da transmissão de dados (Cliente MQTT).
Sem este container, se a internet cair, os dados do sensor seriam perdidos. Ao introduzir oContainerDb, o sistema garante a integridade dos dados. O diagrama comunica claramente que o “Cliente de Sincronização com a Nuvem” deve ter lógica para consultar o banco de dados por “quadros atrasados” antes de enviar novos dados.
Conclusão
Ao utilizar o VPasCode e a biblioteca C4 PlantUML, transformamos uma arquitetura complexa de hardware e software em um diagrama claro e legível. A visualização de Nível 2 comunica efetivamente não apenas “quem utiliza o sistema, mas “como ele funciona internamente — destacando a separação de preocupações entre a consulta de sensores, o armazenamento local de dados e a sincronização com a nuvem.










