Primeira semana: contexto, padrão de entrega e qual produto resolve qual dor. PDV, CSO e Hub são o núcleo; o restante do portfólio não compete com eles.
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.
Siga esta lista de tarefas para se ambientar rapidamente:
É 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.
O que é: Python é a linguagem de programação principal que usamos.
Como instalar:
https://www.python.org/ (fora da rede restrita, se necessário)O que é: Git é como um "histórico de versões" do código.
Como configurar:
https://git-scm.com/ (fora da rede restrita, se necessário)git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"O que é: Editor de código - onde você vai escrever e editar programas.
Extensões obrigatórias:
O que é: "Nuvem" onde guardamos todo o código dos projetos.
Primeiros passos:
https://github.com/ (fora da rede restrita, se necessário)Aqui está uma explicação simplificada dos projetos com os quais você mais vai cruzar no início:
É o caixa da loja. Existem dois programas: o Java maduro (Windows, Linux e macOS, canal v3.2.2-free) e o Rust piloto (Windows, v0.1.2). Os dois vendem no computador da loja, mesmo sem internet. Nenhum substitui o outro.
Oficinas caracore-pdv (Java 25 · Quarkus · JavaFX) e caracore-pdv-rust (Rust · Tauri 2 · React). Lojas pdv.caracore.com.br e pdv-rust.caracore.com.br. Download Rust = GitHub Releases.
É o sistema do centro de distribuição: pedidos do Mercado Livre, da Shopee e da Temu entram numa fila só, o estoque tem mapa e a retirada é conferida. Não é a “central telefônica” da Cara Core. A vitrine já existe; o instalador Windows sai em 06/Abr/2027.
Oficina caracore-hub (Jakarta EE 10 · WAR · Tomcat · JSP). PostgreSQL e Redis na web atual; SQLite no destino bunker. 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.
É o caderno da frota que deixa de ser planilha. No navegador a empresa cuida de veículos, combustível, oficina e equipe. O aplicativo de computador (2028) guarda os dados críticos na empresa. Não é rastreador GPS.
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.
É 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.
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.
Regra simples: Sempre crie uma nova branch para cada tarefa.
git checkout -b feature/minha-tarefa
Regra simples: Todo código deve ser revisado por outro desenvolvedor antes de ir para produção.
Regra simples: Se você criou uma função, crie um teste para ela.
pytest test_minha_funcao.py
Agora que você leu este guia, é hora de colocar a mão na massa!
Não hesite em perguntar! Estamos aqui para ajudá-lo a ter sucesso.
Contato: suporte@caracore.com.br