Navegação

Guia do Estagiário

Seu primeiro passo na equipe de desenvolvimento da Cara Core Informática

Bem-vindo à Equipe!

Parabéns por fazer parte da equipe da Cara Core Informática! Este guia vai ajudá-lo a se orientar nos nossos projetos, tecnologias e práticas de desenvolvimento.

Dica importante: Este Wiki foi criado especialmente para você! Todas as explicações técnicas incluem analogias simples para facilitar o entendimento.

Seus Primeiros Passos

Siga esta lista de tarefas para se ambientar rapidamente:

Semana 1: Conhecendo os Projetos

Semana 2: Configurando o Ambiente

  • Instalar Python 3.11+ no seu computador
  • Configurar Git e GitHub
  • Instalar VS Code com extensões Python
  • Clonar repositórios de desenvolvimento

Semana 3: Primeira Contribuição

  • Executar os projetos localmente
  • Entender o fluxo de trabalho Git
  • Fazer sua primeira correção/melhoria
  • Criar seu primeiro Pull Request

Semana 4+: Desenvolvimento Contínuo

  • Participar de code reviews
  • Trabalhar em features completas
  • Aprender novas tecnologias
  • Mentoria com desenvolvedores seniores

Configuração do Ambiente de Desenvolvimento

O que é "Ambiente de Desenvolvimento"?

É como preparar sua "oficina de trabalho" no computador. Assim como um carpinteiro precisa de suas ferramentas organizadas, você precisa dos programas certos instalados e configurados para trabalhar com nossos projetos.

1. Instalar Python

O que é: Python é a linguagem de programação principal que usamos.

Como instalar:

  1. Acesse o site oficial em https://www.python.org/ (fora da rede restrita, se necessário)
  2. Baixe Python 3.11 ou superior
  3. Execute o instalador
  4. ✅ Marque "Add Python to PATH"
Importante: Sempre marque "Add to PATH" na instalação!

2. Configurar Git

O que é: Git é como um "histórico de versões" do código.

Como configurar:

  1. Baixe em https://git-scm.com/ (fora da rede restrita, se necessário)
  2. Instale com configurações padrão
  3. Configure seu nome e email:
git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

3. VS Code

O que é: Editor de código - onde você vai escrever e editar programas.

Extensões obrigatórias:

  • Python (Microsoft)
  • GitLens
  • Prettier
  • Live Server

4. GitHub

O que é: "Nuvem" onde guardamos todo o código dos projetos.

Primeiros passos:

  • Crie conta no GitHub: https://github.com/ (fora da rede restrita, se necessário)
  • Solicite acesso aos repositórios
  • Configure chave SSH (seu supervisor ajuda)

Entendendo Nossos Projetos

Aqui está uma explicação simplificada dos 5 projetos principais:

🏢 CaraCore Hub - "O Centro de Controle"

Para Leigos:

Imagine o Hub como a "central telefônica" da empresa. Ele conecta diferentes sistemas e programas, fazendo com que eles conversem entre si. É como ter um assistente que organiza todas as informações da empresa em um só lugar.

Para Estagiários:

Aplicação Python/Flask que funciona como API central. Integra diferentes serviços, gerencia dados e fornece endpoints REST para outros sistemas. Usa Docker para deployment e PostgreSQL como banco de dados.

Python Flask Docker PostgreSQL
Sua missão como estagiário: Ajudar a criar novos endpoints, melhorar a documentação da API e escrever testes automatizados.

🎓 Circuito Ferradura - Produto educacional em evolução

Para Leigos:

É uma proposta educacional da Cara Core para apresentar lógica, ábaco romano e primeiros passos em Python. O produto ainda está em evolução e depende de feedback real para amadurecer.

Para Estagiários:

Site educacional em HTML/CSS/JS com conteúdo Python introdutório, fases progressivas e pacotes locais para Windows/macOS. Foco em clareza, navegação simples e feedback de usuários.

HTML5 CSS3 JavaScript Bootstrap
Sua missão como estagiário: Melhorar textos, simplificar telas, testar os pacotes publicados e registrar feedback de pessoas interessadas.

Nossas Práticas de Desenvolvimento

Git Flow

Regra simples: Sempre crie uma nova branch para cada tarefa.

git checkout -b feature/minha-tarefa
Code Review

Regra simples: Todo código deve ser revisado por outro desenvolvedor antes de ir para produção.

Testes

Regra simples: Se você criou uma função, crie um teste para ela.

pytest test_minha_funcao.py

Próximos Passos

Agora que você leu este guia, é hora de colocar a mão na massa!

Ver Todos os Projetos Aprender Tecnologias Como Contribuir

Precisa de Ajuda?

Não hesite em perguntar! Estamos aqui para ajudá-lo a ter sucesso.

Contato: suporte@caracore.com.br