O que é o Modelo C4?
O modelo C4 é uma forma simples e visual de descrever e comunicar arquitetura de software. Ele significa:
- Contexto – a visão geral (quem usa o sistema e quais outros sistemas existem ao seu redor)
- Contêiner – os blocos de construção técnicos de alto nível (aplicativo web, aplicativo móvel, bancos de dados, etc.)
- Componente – (opcional) estrutura interna de cada contêiner
- Código – (opcional) nível de classe/implementação
Ajuda equipes e partes interessadas a compreenderem o sistema em diferentes níveis de zoom sem se afogar em detalhes.
Abaixo aplicamos os dois primeiros níveis (Contexto e Contêiner) a um caso do mundo realSistema de Agendamento de Consultas Médicas.
Por que precisamos deste sistema?
O agendamento tradicional de consultas hospitalares é doloroso:
- Os pacientes ligam durante os horários de expediente e aguardam na fila
- Os funcionários verificam manualmente os horários dos médicos em sistemas em papel ou fragmentados
- Agendamentos duplos e ausências são comuns
- Não há forma fácil para os pacientes verem seu resumo médico ou participar de uma consulta por vídeo
- Lembretes são esquecidos → tempo de consulta desperdiçado
O novoSistema de Agendamento de Consultas Médicasresolve esses problemas ao oferecer aos pacientes agendamento autônomo 24/7, disponibilidade em tempo real, lembretes automáticos e integração com telemedicina e prontuário eletrônico.
Quais são os principais atores?
| Ator | Descrição |
|---|---|
| Paciente | Pessoa que precisa de cuidados médicos. Agende, reagende ou cancele consultas; participe de visitas virtuais |
| Pessoal de Saúde | Médicos, enfermeiros, recepcionistas que gerenciam horários e tratam pacientes |
Nível 1: Diagrama de Contexto do Sistema
Esta é a visão de 30.000 pés
@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
LAYOUT_DE_CIMA_PARA_BAIXO()
LAYOUT_COM_LEGENDA()
título Diagrama de Contexto do Sistema – Sistema de Agendamento de Consultas Médicas
Pessoa(paciente, “Paciente”, “Agenda consultas, participa de visitas por vídeo”)
Pessoa(pessoal_de_saúde, “Pessoal de Saúde”, “Médicos, enfermeiros, administradores”)
Sistema(sistema_de_agendamento, “Sistema de Agendamento de Consultas Médicas”, “Sistema principal para agendar, remarcar, cancelar consultas e consultas virtuais”)
Sistema_Ext(sistema_ehr, “Sistema EHR”, “Prontuários Eletrônicos de Saúde”)
Sistema_Ext(plataforma_telemedicina, “Plataforma de Telemedicina”, “Infraestrutura de consultas por vídeo”)
Sistema_Ext(sistema_agenda, “Sistema de Agenda do Hospital”, “Calendário mestre de médicos/consultórios”)
Sistema_Ext(sistema_mensagens, “Sistema de Mensagens do Hospital”, “Gateway de SMS/email”)
Rel(paciente, sistema_de_agendamento, “Agenda/remarca consultas, participa de chamadas por vídeo”)
Rel(paciente, plataforma_telemedicina, “Realiza consultas virtuais por meio de”)
Rel(paciente, sistema_ehr, “Visualiza seus próprios registros (somente leitura)”)
Rel(pessoal_de_saúde, sistema_de_agendamento, “Gerencia consultas”)
Rel(pessoal_de_saúde, sistema_ehr, “Lê/escrita registros de pacientes”)
Rel(pessoal_de_saúde, sistema_agenda, “Visualiza o calendário mestre”)
Rel(pessoal_de_saúde, sistema_mensagens, “Envia notificações”)
Rel(sistema_de_agendamento, sistema_agenda, “Verifica e atualiza a disponibilidade em tempo real”)
Rel(sistema_de_agendamento, sistema_ehr, “Sincroniza identificadores de pacientes e dados básicos”)
Rel(sistema_de_agendamento, sistema_mensagens, “Dispara lembretes por SMS/email”)
@enduml

Ponto-chave do contexto: Nosso sistema de agendamento é o hub central que conecta pacientes, equipe e quatro sistemas empresariais existentes.
Nível 2: Diagrama de Contêiner
Agora aumentamos o zoom e mostramos as principais partes técnicas dentro da nossa fronteira do sistema.

Contêineres Chave Explicados
| Contêiner | Tecnologia | Responsabilidade |
|---|---|---|
| Aplicativo Web de Agendamento | React + Node.js/Express | Aplicativo de página única usado por pacientes e equipe |
| Aplicativo Móvel | React Native | Experiência nativa iOS/Android para pacientes |
| Módulo de Telemedicina | WebRTC + servidor de sinalização | Chamadas de vídeo seguras, sala de espera, compartilhamento de tela |
| Motor de Agendamento | Python/Django | Lógica central de negócios: sem agendamentos duplos, tempos de buffer, feriados |
| Serviço de Notificação | Node.js + Redis + BullMQ | Entrega confiável de lembretes 24h, 2h e 15min antes |
| Banco de Dados de Pacientes (MySQL) | MySQL 8 | Dados pessoais, consentimento, idioma preferido |
| Banco de Dados de Agendamentos (PostgreSQL) | PostgreSQL 15 | Histórico de auditoria imutável de todos os agendamentos e alterações |
Quando usamos cada diagrama?
| Situação | Qual diagrama mostrar |
|---|---|
| Conversando com executivos do hospital ou pacientes | Diagrama de contexto (visão geral, sem jargões técnicos) |
| Onboarding de novos desenvolvedores | Diagrama de contêineres (mostra onde o código reside) |
| Discutindo limites de segurança e conformidade | Contêiner (clareza entre sistemas internos e externos) |
| Escolhendo a stack de tecnologia ou implantação em nuvem | Contêiner (mostra bancos de dados, filas de mensagens, etc.) |
| Elaborando RFP ou contrato com fornecedor externo | Contexto + Contêiner |
Como usarChatbot de Modelagem Visual com IA do Visual Paradigm para simplificar todo o processo de modelagem C4 para o sistema de agendamento de consultas médicas
Aqui está um fluxo de trabalho prático, passo a passo, que transforma horas de diagramação e documentação manuais em uma conversa de 10 a 15 minutos com a IA.

Passo 1: Comece do zero com uma única solicitação (30 segundos)
Apenas digite isso no chat de IA do Visual Paradigm:
“Crie um modelo C4 completo (diagramas de contexto e de contêineres) para um sistema moderno de agendamento de consultas médicas. Atores: Pacientes e Equipe de Saúde (médicos, enfermeiros, administradores). O sistema permite que os pacientes agendem, reagendem e cancelem consultas 24/7, participem de chamadas de videoconferência de telemedicina, recebam lembretes automatizados e visualizem seu próprio resumo médico. Integre-se a um sistema EHR existente, um sistema mestre de horários do hospital e uma gateway de mensagens. Use uma stack de tecnologia moderna: aplicativo web React, aplicativo móvel React Native, backend Node.js, motor de agendamento em Python, bancos de dados PostgreSQL + MySQL, WebRTC para vídeo.”
→ Em menos de 10 segundos você obtém um belo diagrama de contexto C4diagrama de contexto C4 e diagrama de contêineres C4 — quase idêntico aos exemplos do PlantUML que você viu anteriormente, mas já renderizado e pronto para apresentação.
Passo 2: Refine instantaneamente com comandos naturais (2 a 5 minutos)
Agora basta conversar com o diagrama:
- “Adicione um contêiner de Serviço de Notificação que envie lembretes por SMS e e-mail”
- “Conecte o Serviço de Notificação ao Sistema de Mensagens do Hospital”
- “Mostre o Módulo de Telemedicina usando WebRTC”
- “Divida o banco de dados em Banco de Dados de Pacientes (MySQL) e Banco de Dados de Agendamentos (PostgreSQL)”
- “Renomeie ‘Equipe de Saúde’ para ‘Médico / Enfermeiro / Recepcionista’ e adicione um ícone”
- “Mude o layout para superior para inferior e adicione uma legenda”
- “Faça com que o aplicativo web e o aplicativo móvel usem ambos HTTPS para o backend”
Cada comando atualiza instantaneamente o diagrama ao vivo — sem arrastar, sem reajustar, sem erros de sintaxe.
Passo 3: Faça suas perguntas sobre o diagrama (insights instantâneos)
Trate-o como um arquiteto experiente sentado ao seu lado:
- “Quais são os sistemas externos de que este depende?”
- “Liste todos os contêineres e suas tecnologias”
- “Quais são os principais limites de segurança?”
- “Gere um resumo executivo de uma página desta arquitetura”
- “Escreva uma descrição de três parágrafos para nosso RFP”
Você recebe imediatamente um texto bem escrito que pode copiar e colar em propostas, Confluence ou PowerPoint.
Passo 4: Obtenha documentação completa sob demanda (30 segundos)
Diga à IA:
“Gere documentação profissional de arquitetura para este modelo C4, incluindo descrição de contexto, descrição de contêiner, decisões principais de design e escolhas de tecnologia.”
Você recebe um documento completo e elegantemente formatado em Markdown ou pronto para Word em segundos.
Passo 5: Exporte com um clique para a ferramenta profissional quando precisar de colaboração em equipe
Quando o design for aprovado:
- Clique em“Abrir no Visual Paradigm Desktop” ou “Exportar como projeto .vpp”
- Todo o modelo (com formas, layout, notas, glossário) abre na ferramenta completa do Visual Paradigm para revisão em equipe, controle de versão, adição de diagramas de Componente ou Sequência, geração de PDF/PNG, etc.
Por que isso é uma mudança de jogo para o projeto de saúde
| Forma tradicional (2–8 horas) | Com o Visual Paradigm AI (10–15 minutos) |
|---|---|
| Abra o PlantUML / draw.io / Lucidchart | Apenas digite um parágrafo |
| Crie manualmente cada caixa e seta | A IA cria um diagrama com 95% de precisão instantaneamente |
| Corrija o layout e alinhamento repetidamente | A IA mantém o layout perfeito após cada edição |
| Escreva a documentação separadamente | Pergunte → obtenha documentação perfeita instantaneamente |
| Copie e cole entre ferramentas | Transferência sem problemas com um clique para uma ferramenta de desktop completa |
Resultado: Arquitetos de soluções, arquitetos de empresas e equipes de desenvolvimento agora podem produzir diagramas C4 e documentação prontos para os interessados mais rápido do que leva para agendar a próxima reunião.
Comece agora: vá para o Visual Paradigm Online → “Chat de IA” → cole a solicitação acima e veja a mágica acontecer em segundos.
Resumo
Usando apenas dois diagramas simples, podemos agora responder claramente:
- O que o sistema faz e quem se beneficia
- Como ele se encaixa na paisagem atual de TI hospitalar
- Quais aplicações principais e bancos de dados precisamos construir ou integrar
Essa clareza reduz dramaticamente os mal-entendidos entre os interessados do negócio, arquitetos e equipes de desenvolvimento — exatamente por isso que o modelo C4 se tornou o padrão de fato para documentação de arquitetura de software moderna.