Guia do Estagiário
Primeira semana: contexto, padrão de entrega e qual produto resolve qual dor. PDV, CSO, Hub e Ink Agenda são o núcleo; o restante do portfólio não compete com eles.
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.
Seus Primeiros Passos
Siga esta lista de tarefas para se ambientar rapidamente:
Semana 1: Conhecendo os Projetos
- Leia a Visão Geral dos Projetos
- Explore cada projeto no Portfólio
- Veja o mapa do ecossistema (matriz, produtos, oficinas, lojas)
- Baixe o ReinoOIDC.exe (projeto educativo FREE)
- Acesse a Área 51 (se tiver permissão)
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:
- Acesse o site oficial em
https://www.python.org/(fora da rede restrita, se necessário) - Baixe Python 3.11 ou superior
- Execute o instalador
- ✅ Marque "Add Python to PATH"
2. Configurar Git
O que é: Git é como um "histórico de versões" do código.
Como configurar:
- Baixe em
https://git-scm.com/(fora da rede restrita, se necessário) - Instale com configurações padrão
- 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 projetos com os quais você mais vai cruzar no início:
CaraCore PDV — Java web local e Rust desktop
O que muda para você
É o caixa da loja. Existem duas linhas: a aplicação Java local, hoje na v4.0.0 (lançada em 08/11/2026 para Windows 10/11 x64, aberta pelo launcher no Edge), com a v3.2.12-free como versão anterior multiplataforma no navegador (Windows, Linux e macOS); e o piloto Rust desktop (Windows, v0.1.4). Ambas operam localmente; nenhuma substitui a outra.
Detalhe opcional
Oficinas caracore-pdv (Java 25 · Quarkus · SQLite; UI no navegador) e caracore-pdv-rust (Rust · Tauri 2 · React). Lojas pdv.caracore.com.br e pdv-rust.caracore.com.br. Download Rust = GitHub Releases.
CaraCore Hub — gestão de encomendas
O que muda para você
É o sistema do ponto de retirada (PUDO): encomendas do Mercado Livre, da Shopee e da Temu entram numa fila só, o estoque tem mapa de guarda e a retirada é conferida. Não é a “central telefônica” da Cara Core. A pré-release Windows v2.1.0-rc1.10 está para avaliação; o GA do instalador segue em 06/Abr/2027.
Detalhe opcional
Repositório privado caracore-hub (Jakarta EE 10 · JSP · Tomcat embutido no instalador · SQLite local). Python/Flask é Área 51, não Hub. Loja: hub.caracore.com.br.
caracore-hub/docs/contexto-rapido.md. Wiki: projeto-hub.html · manual de uso.
CaraCore CSO — auditoria de frota e Transportes
O que muda para você
Frotas já faz a auditoria operacional da frota no navegador — veículos, combustível, manutenção e equipe, com placa única e histórico por veículo como lastro para CBS/IBS. Não emite nota fiscal e não é GPS. Transportes organizará as entregas no computador; o Virtual Tracker integrado permitirá acompanhar deslocamentos pelo celular. Alvo conjunto 08/11/2028, sujeito à validação. Mapa e histórico somente na empresa; acompanhamento exige conexão, sem fila offline.
Detalhe opcional
Duas oficinas: caracore-cso-quarkus (Frotas Web, produção) e caracore-cso-transportes (desktop bunker). Aplicação: cso.caracore.com.br · vitrine: cso-transp.caracore.com.br.
🎓 Circuito Ferradura - Produto educacional em evolução
O que muda para você
É 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.
Detalhe opcional
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.
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!
Precisa de Ajuda?
Não hesite em perguntar! Estamos aqui para ajudá-lo a ter sucesso.
Contato: suporte@caracore.com.br