C4 Nível de Contexto: Contexto do Sistema

Use esta habilidade quando

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

Não use esta habilidade quando

• A tarefa não estiver relacionada ao nível de contexto C4: contexto do sistema
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

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

Visão Geral do Sistema

Descrição Curta

[Descrição em uma frase do que o sistema faz]

Descrição Longa

[Descrição detalhada do propósito do sistema, suas capacidades e os problemas que ele resolve]

Personas

[Nome da Persona]

• Tipo: [Usuário Humano / Usuário Programático / Sistema Externo]
• Descrição: [Quem é essa persona e o que ela precisa]
• Objetivos: [O que essa persona quer alcançar]
• Principais Recursos Utilizados: [Lista de recursos que essa persona utiliza]

Recursos do Sistema

[Nome do Recurso]

• Descrição: [O que este recurso faz]
• Usuários: [Quais personas usam este recurso]
• Jornada do Usuário: [Link para o mapa da jornada do usuário]

Jornadas do Usuário

Jornada [Nome do Recurso] - [Nome da Persona]

3. ...

Jornada de Integração [Sistema Externo]

2. ...

Sistemas Externos e Dependências

[Nome do Sistema Externo]

• Tipo: [Banco de Dados, API, Serviço, Fila de Mensagens, etc.]
• Descrição: [O que este sistema externo fornece]
• Tipo de Integração: [API, Eventos, Transferência de Arquivos, etc.]
• Propósito: [Por que o sistema depende disso]

Diagrama de Contexto do Sistema

[Diagrama Mermaid mostrando o sistema, usuários e sistemas externos]

Documentação Relacionada

• Documentação de Contêiner
• Documentação de Componente

## Context Diagram Template

According to the [C4 model](https://c4model.com/diagrams/system-context), a System Context diagram shows the system as a box in the center, surrounded by its users and the other systems that it interacts with. The focus is on **people (actors, roles, personas) and software systems** rather than technologies, protocols, and other low-level details.

Use proper Mermaid C4 syntax:

```mermaid
C4Context
    title Diagrama de Contexto do Sistema

    Person(user, "Usuário", "Usa o sistema para atingir seus objetivos")
    System(system, "Nome do Sistema", "Fornece os recursos X, Y e Z")
    System_Ext(external1, "Sistema Externo 1", "Fornece o serviço A")
    System_Ext(external2, "Sistema Externo 2", "Envia eventos para")
    SystemDb(externalDb, "Banco de Dados Externo", "Armazena dados")

    Rel(user, system, "Usa")
    Rel(system, external1, "Usa", "API")
    Rel(system, external2, "Envia eventos para")
    Rel(system, externalDb, "Lê e escreve em")

Princípios Chave (de c4model.com):

• Foque em pessoas e sistemas de software, não em tecnologias
• Mostre claramente o limite do sistema
• Inclua todos os usuários (humanos e programáticos)
• Inclua todos os sistemas externos com os quais o sistema interage
• Mantenha-o amigável para stakeholders - compreensível por públicos não técnicos
• Evite mostrar tecnologias, protocolos ou detalhes de baixo nível

Exemplos de Interações

• "Criar documentação de nível de Contexto C4 para o sistema"
• "Identificar todas as personas e criar mapas de jornada do usuário para recursos chave"
• "Documentar sistemas externos e criar um diagrama de contexto do sistema"
• "Analisar a documentação do sistema e criar documentação de contexto abrangente"
• "Mapear jornadas de usuário para todos os recursos chave, incluindo usuários programáticos"

Principais Distinções

• vs Agente C4-Container: Fornece uma visão de alto nível do sistema; o agente Container foca na arquitetura de implantação
• vs Agente C4-Component: Foca no contexto do sistema; o agente Component foca na estrutura lógica dos componentes
• vs Agente C4-Code: Fornece uma visão geral amigável para stakeholders; o agente Code fornece detalhes técnicos do código

Exemplos de Saída

Ao criar documentação de contexto, forneça:

• Descrições claras do sistema (curta e longa)
• Documentação abrangente de personas (humana e programática)
• Listas completas de recursos com descrições
• Mapas detalhados de jornada do usuário para todos os recursos chave
• Documentação completa de sistemas externos e dependências
• Diagrama de contexto Mermaid mostrando o sistema, usuários e sistemas externos
• Links para a documentação de contêiner e componente

…