Guia de Início Rápido

Este guia ajudará você a criar seu primeiro diagrama de arquitetura no Archyl em apenas alguns minutos.

Passo 1: Criar uma Conta

1. Acesse app.archyl.com
2. Cadastre-se usando seu e-mail ou conecte-se com GitHub, GitLab ou Bitbucket
3. Verifique seu e-mail se você se cadastrou com e-mail

Passo 2: Criar Seu Primeiro Projeto

1. Clique em "Novo Projeto" no seu painel
2. Digite um nome para seu projeto (ex: "Minha Plataforma E-commerce")
3. Opcionalmente, adicione uma descrição e tags
4. Clique em "Criar Projeto"

Passo 3: Adicionar Seu Primeiro Sistema

1. No seu novo projeto, você começará no nível de Contexto do Sistema
2. Clique no botão "+" ou clique com o botão direito no canvas
3. Selecione "Adicionar Sistema"
4. Digite um nome (ex: "Plataforma E-commerce")
5. Adicione uma descrição do que o sistema faz

Passo 4: Adicionar Sistemas Externos

Sistemas reais não existem isoladamente. Adicione sistemas externos com os quais seu software interage:

1. Clique em "+" e selecione "Adicionar Sistema Externo"
2. Adicione sistemas como "Gateway de Pagamento", "Serviço de E-mail", "CDN"
3. Eles aparecerão com um estilo diferente para indicar que são externos

Passo 5: Criar Relacionamentos

Mostre como os sistemas se comunicam:

1. Clique no sistema de origem
2. Arraste do ponto de conexão até o sistema de destino
3. Adicione um rótulo descrevendo o relacionamento (ex: "Processa pagamentos via API")

Passo 6: Aprofundar nos Contêineres

Clique duas vezes no seu sistema principal para entrar no nível de Contêiner:

1. Adicione contêineres como "Aplicação Web", "Servidor API", "Banco de Dados"
2. Mostre como eles se comunicam entre si
3. Conecte-os aos sistemas externos

Próximos Passos

Parabéns! Você criou seu primeiro diagrama de arquitetura. Veja o que explorar a seguir:

• Conectar um Repositório - Deixe a IA descobrir sua arquitetura automaticamente
• Descoberta com IA - Aprenda como a IA analisa sua base de código
• Colaboração em Equipe - Convide seus colegas de equipe
• Exportar e Compartilhar - Compartilhe seus diagramas com stakeholders

Dicas para o Sucesso

• Comece no alto nível: Comece com o Contexto do Sistema antes de entrar nos detalhes
• Use nomes claros: Nomeie sistemas e contêineres de forma descritiva
• Adicione descrições: Seu eu do futuro (e sua equipe) agradecerão
• Itere: Documentação de arquitetura é algo vivo - atualize conforme seu sistema evolui