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.

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 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.

Java 25 Quarkus Navegador Rust Tauri 2
Sua missão como estagiário: Não misturar versões (v3.2.x ≠ v0.1.x) e não dizer que Rust substitui Java. Hub: projeto-pdv.html.

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.

Jakarta EE 10 Tomcat JSP SQLite
Sua missão como estagiário: Não misturar Hub com Área 51. Retomada no repositório privado: 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.

Java 21 Quarkus Qute/HTMX PostgreSQL JavaFX
Sua missão como estagiário: Na Frotas, Qute/HTMX e relay cifrado planejado, sem persistir telemetria. No Transportes, JavaFX/Vue e SQLite local. Não apresentar GPS como implementado; seguir as 21 tarefas integradas e os gates. Hub: projeto-cso.html.

🎓 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.

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!

Precisa de Ajuda?

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

Contato: suporte@caracore.com.br