Nível de Container C4: Implantação de Sistema

Use esta habilidade quando

• Trabalhando em tarefas ou fluxos de trabalho de implantação de sistema no nível de container C4
• Precisando de orientação, melhores práticas ou checklists para implantação de sistema no nível de container C4

Não use esta habilidade quando

• A tarefa não estiver relacionada à implantação de sistema no nível de container C4
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.

Containers

[Nome do Container]

• Nome: [Nome do container]
• Descrição: [Breve descrição do propósito e implantação do container]
• Tipo: [Aplicação Web, API, Banco de Dados, Fila de Mensagens, etc.]
• Tecnologia: [Tecnologias principais: Node.js, Python, PostgreSQL, Redis, etc.]
• Implantação: [Docker, Kubernetes, Serviço de Nuvem, etc.]

Propósito

[Descrição detalhada do que este container faz e como ele é implantado]

Componentes

Este container implanta os seguintes componentes:

• • Documentação: c4-component-name.md

Interfaces

[Nome da API/Interface]

• Protocolo: [REST/GraphQL/gRPC/Eventos/etc.]
• Descrição: [O que esta interface fornece]
• Especificação: [Link para o arquivo OpenAPI/Swagger/API Spec]
• Endpoints:
  • GET /api/resource - [Descrição]
  • POST /api/resource - [Descrição]

Dependências

Containers Utilizados

• [Nome do Container]: [Como é usado, protocolo de comunicação]

Sistemas Externos

• [Sistema Externo]: [Como é usado, tipo de integração]

Infraestrutura

• Configuração de Implantação: [Link para Dockerfile, manifesto K8s, etc.]
• Escalabilidade: [Estratégia de escalabilidade horizontal/vertical]
• Recursos: [Requisitos de CPU, memória, armazenamento]

Diagrama de Container

Use a sintaxe correta do Mermaid C4Container:

C4Container
    title Container Diagram for [System Name]

    Person(user, "User", "Uses the system")
    System_Boundary(system, "System Name") {
        Container(webApp, "Web Application", "Spring Boot, Java", "Provides web interface")
        Container(api, "API Application", "Node.js, Express", "Provides REST API")
        ContainerDb(database, "Database", "PostgreSQL", "Stores data")
        Container_Queue(messageQueue, "Message Queue", "RabbitMQ", "Handles async messaging")
    }
    System_Ext(external, "External System", "Third-party service")

    Rel(user, webApp, "Uses", "HTTPS")
    Rel(webApp, api, "Makes API calls to", "JSON/HTTPS")
    Rel(api, database, "Reads from and writes to", "SQL")
    Rel(api, messageQueue, "Publishes messages to")
    Rel(api, external, "Uses", "API")

**Key Principles** (from [c4model.com](https://c4model.com/diagrams/container)):

- Show **high-level technology choices** (this is where technology details belong)
- Show how **responsibilities are distributed** across containers
- Include **container types**: Applications, Databases, Message Queues, File Systems, etc.
- Show **communication protocols** between containers
- Include **external systems** that containers interact with

Modelo de Especificação de API

Para cada API de container, crie uma especificação OpenAPI/Swagger:

openapi: 3.1.0
info:
  title: [Container Name] API
  description: [API description]
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: Production server
paths:
  /api/resource:
    get:
      summary: [Operation summary]
      description: [Operation description]
      parameters:
        - name: param1
          in: query
          schema:
            type: string
      responses:
        '200':
          description: [Response description]
          content:
            application/json:
              schema:
                type: object

Exemplos de Interações

• "Sintetizar todos os componentes em containers com base nas definições de implantação"
• "Mapear os componentes da API para containers e documentar suas APIs como especificações OpenAPI"
• "Criar documentação em nível de container para a arquitetura de microsserviços"
• "Documentar interfaces de container como especificações Swagger/OpenAPI"
• "Analisar manifestos do Kubernetes e criar documentação de container"

Principais Distinções

• vs Agente C4-Component: Mapeia componentes para unidades de implantação; o agente de componente foca na agrupamento lógico
• vs Agente C4-Context: Fornece detalhes em nível de container; o agente de contexto cria diagramas de sistema de alto nível

…