Glossário
Termos da casa e da operação, no mesmo tom da wiki: primeiro o que muda para você; o detalhe técnico é opcional.
Nenhum termo encontrado. Tente outra palavra.
A
API (Application Programming Interface)
O que muda para você
API é como um "garçom" entre dois sistemas. Imagine que você está em um restaurante: você (o aplicativo) quer pedir comida da cozinha (outro sistema), mas não pode entrar lá diretamente. O garçom (API) leva seu pedido para a cozinha e traz a comida de volta para você.
Detalhe opcional
Interface de programação que define métodos de comunicação entre componentes de software. Especifica como diferentes sistemas podem interagir através de endpoints, métodos HTTP (GET, POST, PUT, DELETE) e formatos de dados como JSON.
Exemplo: GET /api/users retorna lista de usuários
Área 51
O que muda para você
Laboratório de segurança da Cara Core. É o lugar onde testamos padrões de acesso (quem entra, com qual identidade) antes de levar o mesmo cuidado para os outros produtos.
Detalhe opcional
Consultoria e baseline OIDC. Loja area51.caracore.com.br. Não confundir com o CaraCore Hub (encomendas) nem com o Reino OIDC (educação).
Wiki: projeto-area51.html
Azure
O que muda para você
Azure é como um "shopping center virtual" da Microsoft onde você pode alugar espaços para colocar seus sites, aplicativos e dados. Em vez de comprar computadores próprios, você "aluga" o que precisa na nuvem.
Detalhe opcional
Plataforma de computação em nuvem da Microsoft que oferece serviços como App Service (hospedagem web), Storage (armazenamento), SQL Database, Active Directory, Functions (serverless), entre outros.
Usado em: Área 51 (Azure) e presenças estáticas no GitHub Pages
B
Backend
O que muda para você
Backend é a "cozinha" do restaurante. É onde toda a "magia" acontece: processar pedidos, buscar informações no banco de dados, fazer cálculos. O cliente não vê, mas é essencial para tudo funcionar.
Detalhe opcional
Parte do sistema responsável pela lógica de negócio, processamento de dados, autenticação, autorização e comunicação com bancos de dados. Roda no servidor, não no navegador do usuário.
Tecnologias: Python/Flask, Node.js, Java, APIs REST
Blindagem fiscal
O que muda para você
Menos risco na nota fiscal e na rotina do caixa: o sistema ajuda a operação a ficar em dia, em vez de o lojista improvisar na hora da venda.
Detalhe opcional
Discurso de resultado do PDV (Selo Verde / conformidade). Em texto para cliente, preferir “menos risco fiscal” a “blindagem orientada a ROI”.
Produto: CaraCore PDV
Branch (Git)
O que muda para você
Branch é como criar uma "cópia paralela" do seu projeto para trabalhar sem bagunçar o original. É como tirar xerox de um documento para fazer anotações sem estragar o original.
Detalhe opcional
Ramificação no Git que permite desenvolvimento paralelo de features. A branch main contém o código estável, enquanto branches de feature (feature/login) isolam desenvolvimento específico.
Comando: git checkout -b feature/nova-funcionalidade
Bootstrap
O que muda para você
Bootstrap é como um "kit de moldes" para fazer sites bonitos. Em vez de criar botões, menus e layouts do zero, você usa peças prontas que já ficam elegantes e funcionam em celular e computador.
Detalhe opcional
Framework CSS que fornece componentes pré-construídos, grid system responsivo, utilitários de espaçamento e JavaScript para interações. Acelera desenvolvimento frontend com padrões consistentes.
Classes comuns: container, row, col-md-6, btn-primary
Bunker Digital
O que muda para você
Bunker Digital é o jeito Cara Core de manter dados e operação crítica no computador da empresa. Se a internet cair, o caixa, a agenda ou o backup local continuam funcionando.
Detalhe opcional
Arquitetura offline-first com persistência local (em geral SQLite) e nuvem só quando o desenho pede (FinOps/híbrido). Usado no PDV, Ink Agenda, CSO Transportes e na pré-release Windows do Hub (v2.1.0-rc1.10). O GA desse instalador segue em 2027.
C
CaraCore CSO
O que muda para você
Camada de auditoria operacional e governança de ativos da frota: Frotas já disponível em cso.caracore.com.br, com placa única e histórico por veículo como lastro para CBS/IBS. Não emite nota fiscal e não é rastreador GPS. Transportes + Virtual Tracker integrado em desenvolvimento, com alvo conjunto 08/Nov/2028 sujeito à validação. VT é capacidade de integração/localização pelo celular, não terceiro produto. Vitrine: cso-transp.caracore.com.br.
Detalhe opcional
Oficinas caracore-cso-quarkus (Java 21 · Quarkus · PostgreSQL · Qute/HTMX, produção em cso.caracore.com.br) e caracore-cso-transportes (Quarkus · JavaFX · Vue 3 · SQLite). Vitrine Pages: cso-transp.caracore.com.br — não substitui a aplicação.
Wiki: projeto-cso.html · Frotas: cso.caracore.com.br · Loja: cso-transp.caracore.com.br
CaraCore Hub
O que muda para você
Sistema de gestão logística interna para pontos de retirada (PUDOs): a encomenda é recebida no balcão, ganha posição de guarda e só sai com a retirada conferida, volume a volume. Nesta edição, os canais de venda conectados são Mercado Livre, Shopee e Temu. A pré-release Windows v2.1.0-rc1.10 está para avaliação em hub.caracore.com.br; o GA do instalador segue em 06/Abr/2027. Não é orquestrador interno da Cara Core.
Detalhe opcional
Aplicação web 2.1 (privada): Jakarta EE 10 · JSP · SQLite local, servida por Tomcat local. Loja hub.caracore.com.br.
Wiki: projeto-hub.html · manual de uso
CaraCore PDV
O que muda para você
Nome comercial da linha desktop em Rust + Tauri 2 (piloto Windows, v0.1.4). Convive com o CaraCore PDV Java (aplicação web local no navegador). São linhas independentes — nenhuma substitui a outra.
Detalhe opcional
Oficina caracore-pdv-rust. Loja pdv-rust.caracore.com.br. Download oficial: caracore-rust-pdv-releases/releases (tag v0.1.4). Não usar /releases/latest de caracore-pdv-releases (canal Java). Canal Java atual: v4.0.0 (lançada em 08/11/2026), com a v3.2.12-free como versão anterior, em pdv.caracore.com.br.
CaraCore PDV Java — aplicação web local
O que muda para você
É o caixa Local-First da Cara Core, em Java: o balcão registra a venda na máquina da loja e continua operando com a internet fora, com os dados em SQLite local. A v4.0.0, lançada em 08/11/2026, opera no Windows 10/11 x64 pelo launcher no Edge, com banco local e migração do banco da 3.2.x no primeiro acesso; a versão anterior v3.2.12-free cobre Windows, Linux e macOS. Sem servidor de terceiros no meio do caminho. Premium: assinatura mensal de R$ 79,90 com suporte, vendas e cadastros sem os tetos do Free (que vai até 100 vendas por mês), cálculo de CBS/IBS. Na v4.0.0, nem o Free nem o Premium emitem NF-e/NFC-e nem fazem PIX pelo sistema — o PIX é feito pela maquininha do banco, fora do PDV. PIX integrado (Mercado Pago) e NFC-e sob demanda (TecnoSpeed PlugNotas, já desenhada para a transição IBS/CBS) são módulos em desenvolvimento para a v4.1.0, com meta em 24/03/2027. NF-e e NFS-e não estão no escopo planejado. Saiba mais.
Detalhe opcional
Oficina caracore-pdv — Java 25, Quarkus, SQLite; na v4 a interface abre pelo launcher no Edge, e na 3.2.12-free pelo navegador (http://localhost:8080/login). Loja pdv.caracore.com.br. Wiki Fiscal e trilhas (cliente, suporte, contador, sócio) estão neste portal, em pdv/.
Wiki: projeto-pdv.html#java
CSS (Cascading Style Sheets)
O que muda para você
CSS é como a "roupa" do site. O HTML é como o corpo/esqueleto, e o CSS é a roupa que deixa tudo bonito: cores, tamanhos, posições, fontes. É o que faz um site ficar apresentável.
Detalhe opcional
Linguagem de estilo que controla apresentação visual de elementos HTML. Define cores, layout, tipografia, responsividade e animações. Funciona com seletores, propriedades e valores.
Exemplo: .btn { background-color: #007bff; }
Commit (Git)
O que muda para você
Commit é como tirar uma "foto" do seu progresso no projeto. Cada foto fica salva com uma descrição do que você fez. Se algo der errado, você pode voltar para uma "foto" anterior.
Detalhe opcional
Snapshot do estado atual do código que fica permanentemente salvo no histórico Git. Cada commit tem hash único, mensagem descritiva, autor e timestamp.
Comando: git commit -m "feat: adicionar login com Google"
Container (Docker)
O que muda para você
Container é como uma "caixa de mudança" para programas. Você coloca seu aplicativo e tudo que ele precisa dentro da caixa, e ela funciona igual em qualquer computador, sem conflitos.
Detalhe opcional
Unidade de software que empacota aplicação com todas dependências (libraries, runtime, ferramentas). Garante consistência entre ambientes (dev, test, prod) usando virtualização em nível de OS.
Comando: docker run -p 5000:5000 minha-app
D
Database (Banco de Dados)
O que muda para você
Banco de dados é como um "arquivo gigante e organizado" onde o sistema guarda todas as informações: usuários, produtos, pedidos, etc. É como uma biblioteca super organizada onde você encontra tudo rapidinho.
Detalhe opcional
Sistema de armazenamento estruturado que organiza dados em tabelas (SQL) ou documentos (NoSQL). Permite operações CRUD (Create, Read, Update, Delete) com queries otimizadas e transações ACID.
Tipos: PostgreSQL, MySQL, MongoDB, SQLite
Docker
O que muda para você
Docker é como uma empresa de mudanças que embala seu aplicativo em caixas padronizadas. Não importa se você está mudando de casa ou escritório - as caixas funcionam em qualquer lugar.
Detalhe opcional
Plataforma de containerização que simplifica deployment e versionamento de aplicações. Usa Dockerfile para definir ambiente, docker-compose para orquestração multi-container.
Arquivo: docker-compose.yml nos projetos Hub e Seed
E
Eco Mundo
O que muda para você
Apelido interno do mapa do ecossistema: um desenho de como a Cara Core se organiza — empresa (matriz), produtos, oficinas (onde o código vive) e lojas (onde o cliente baixa e lê).
Detalhe opcional
Página ecosistema.html. Na navegação da wiki o rótulo visível é Mapa; o apelido Eco Mundo permanece no título e neste glossário, para quem já usa o nome interno.
F
Flask
O que muda para você
Flask é como um "kit de ferramentas" para criar sites em Python. É mais simples que outras ferramentas - você pega só o que precisa e monta seu site do jeito que quiser.
Detalhe opcional
Micro-framework web para Python, minimalista e flexível. Oferece routing, templating (Jinja2), sessions, mas deixa escolha de database, forms, auth por conta do desenvolvedor.
Exemplo: @app.route('/api/users')
Frontend
O que muda para você
Frontend é a "vitrine da loja" - tudo que o cliente vê e toca: botões, menus, cores, textos. É a parte bonita e interativa do site que roda no seu navegador.
Detalhe opcional
Interface do usuário que roda no browser. Usa HTML (estrutura), CSS (visual), JavaScript (interatividade). Comunica com backend via APIs para buscar/enviar dados.
Tecnologias: HTML5, CSS3, JavaScript ES6+, Bootstrap
G
Garagem
O que muda para você
Estágio honesto: o produto (ou uma parte dele) ainda está em desenvolvimento e não está em oferta aberta. O que já existe é dito; o que ainda não se vende também.
Detalhe opcional
Exemplos: o GA do instalador Windows do Hub (06/Abr/2027; a pré-release v2.1.0-rc1.10 já está para avaliação) e o CSO Transportes desktop (08/Nov/2028). Garagem nomeia o que ainda aguarda o lançamento estável.
Git
O que muda para você
Git é como um "histórico detalhado" de tudo que aconteceu no seu projeto. Ele guarda cada mudança, quem fez, quando fez, e permite voltar no tempo se algo der errado.
Detalhe opcional
Sistema de controle de versão distribuído. Cada desenvolvedor tem cópia completa do histórico. Permite branches paralelas, merge de mudanças, resolução de conflitos.
Comandos: git add, git commit, git push, git pull
GitHub
O que muda para você
GitHub é like um "Google Drive para programadores". Você salva seu código lá, outras pessoas podem ver e ajudar, além de ter ferramentas para gerenciar projetos em equipe.
Detalhe opcional
Plataforma de hospedagem Git com interface web. Oferece repositories, pull requests, issues, actions (CI/CD), pages (hosting), collaboration tools.
Features: Pull Requests, GitHub Actions, GitHub Pages
Gestão de Frotas
O que muda para você
É a parte do CaraCore CSO que já funciona no navegador e faz a auditoria operacional da frota: cadastro de veículos, combustível, manutenções, motoristas, viagens e relatórios, com placa única e histórico por veículo como lastro para CBS/IBS. Começa grátis com até 3 veículos. Não é rastreador GPS e não emite nota fiscal.
Detalhe opcional
SaaS multi-tenant na oficina caracore-cso-quarkus. Planos FREE_3 / P5 / P10 / CORPORATE. Perfis ADMIN, GESTOR e ENTREGADOR. Produção em cso.caracore.com.br.
Wiki: projeto-cso.html#frotas
Gestão de Transportes
O que muda para você
É o CSO que mora no computador da empresa: entregas, equipe e clientes com dados locais. Alvo conjunto com Virtual Tracker integrado em 08/11/2028, sujeito à validação. Não substitui Frotas; a operação local não garante localização quando falta conexão.
Detalhe opcional
Oficina caracore-cso-transportes: Quarkus + SQLite, SPA Vue 3 e cliente JavaFX. Operação administrativa local; no Virtual Tracker integrado planejado, somente o desktop descriptografa, valida e guarda posições, mapa e histórico. Receber posições exige conexão; não há recuperação offline de trechos.
H
HTML (HyperText Markup Language)
O que muda para você
HTML é como o "esqueleto" de uma página web. Define onde vai o título, onde vai o texto, onde vai a imagem - a estrutura básica. É como a planta de uma casa.
Detalhe opcional
Linguagem de marcação que estrutura conteúdo web usando tags. Define elementos semânticos como headers, paragraphs, links, images, forms.
Tags: <div>, <p>, <h1>, <a>, <img>
HTTP/HTTPS
O que muda para você
HTTP é como o "idioma" que seu navegador usa para conversar com sites. HTTPS é a versão "segura" - como falar em código para ninguém escutar a conversa.
Detalhe opcional
Protocolo de comunicação web. HTTP transfere dados em texto claro, HTTPS adiciona criptografia TLS/SSL. Usa métodos GET, POST, PUT, DELETE e status codes (200, 404, 500).
Status: 200 OK, 404 Not Found, 500 Server Error
J
JavaScript
O que muda para você
JavaScript é como o "cérebro" das páginas web. Ele faz as coisas se moverem, responderem a cliques, validarem formulários - tudo que é interativo no site.
Detalhe opcional
Linguagem de programação interpretada que roda no browser (e server com Node.js). Manipula DOM, faz requisições AJAX, valida forms, cria animações.
Exemplo: document.getElementById('btn').addEventListener('click', ...)
JSON (JavaScript Object Notation)
O que muda para você
JSON é como uma "linguagem universal" para sistemas trocarem informações. É como escrever uma carta em um formato que qualquer programa consegue entender.
Detalhe opcional
Formato de dados texto para intercâmbio entre sistemas. Usa chaves-valor, arrays, objetos aninhados. Padrão para APIs REST.
Exemplo: {"name": "João", "age": 25}
M
Matriz · Oficina · Loja
O que muda para você
A matriz é o site da empresa (caracore.com.br). A oficina é o repositório onde o produto é construído. A loja é o subdomínio onde o cliente baixa e lê o produto.
Detalhe opcional
Regra: oficina caracore-<produto>, loja caracore-<produto>-releases, URL *.caracore.com.br. CSO tem duas URLs: aplicação em cso.caracore.com.br e vitrine em cso-transp.caracore.com.br.
Mapa: mapa do ecossistema (apelido interno: Eco Mundo)
MKT (Cara Core MKT)
O que muda para você
Espaço gratuito da Cara Core para rotina e presença digital com propósito. A Sala Cara Core é o ambiente de execução. Não é um produto à venda.
Detalhe opcional
Oficina caracore-mkt. Loja mkt.caracore.com.br. Sala canónica tools.caracore.com.br/sala/.
Wiki: projeto-mkt.html
O
OAuth
O que muda para você
OAuth é como um "sistema de visitante" de um prédio. Você se identifica na portaria (Google, Facebook) e ganha uma "pulseirinha" (token) para entrar em outros sites sem precisar dar sua senha.
Detalhe opcional
Protocolo de autorização que permite aplicações acessarem recursos em nome do usuário sem exposição de credenciais. Usado em "Login com Google", "Login com Facebook".
Flow: Authorization Code → Access Token → Resource Access
OIDC (OpenID Connect)
O que muda para você
OIDC é como um "RG digital". Além de autorizar o acesso (como OAuth), ele também confirma quem você é - seu nome, email, foto - de forma segura.
Detalhe opcional
Camada de identidade sobre OAuth 2.0. Adiciona ID Token (JWT) com informações do usuário. Padrão para Single Sign-On (SSO) e autenticação federada.
Usado em: Projeto Reino OIDC para aprendizado
P
PIX no PDV
O que muda para você
O comerciante gera e recebe o PIX na maquininha do banco, fora do PDV. O PDV registra a venda; o PIX não é executado por ele.
Detalhe opcional
Faz parte do posicionamento V3 de negócio (PME), não de um número de release. Não confundir V3 com v3.2.12-free (canal Java) nem com v0.1.4 (Rust). Ver transparência V3.
PUDO (ponto de retirada)
O que muda para você
É o balcão onde a encomenda do vizinho chega e é entregue: a loja recebe o volume de um canal de venda, guarda num lugar identificado e entrega quando a pessoa aparece. É a operação que o CaraCore Hub organiza.
Detalhe opcional
Do inglês Pick-Up and Drop-Off. No Hub, o fluxo é recebimento → guarda por posição → retirada conferida, com o banco em SQLite local. Canais com conector nesta edição: Mercado Livre, Shopee e Temu; Amazon e B2W não têm conector.
Wiki: projeto-hub.html · manual do Hub
Python
O que muda para você
Python é uma linguagem de programação "fácil de ler". É como se fosse quase português - você lê o código e entende o que está acontecendo, mesmo sem ser programador.
Detalhe opcional
Linguagem interpretada, dinamicamente tipada, com sintaxe clara. Usada em web (Flask/Django), data science, AI, automação. Grande ecossistema de bibliotecas (pip).
Versão: Python 3.11+ nos projetos Cara Core
Pull Request
O que muda para você
Pull Request é como pedir para alguém revisar seu trabalho antes de entregar. Você mostra o que fez e pede: "Pode dar uma olhada? Está bom para juntar com o projeto principal?"
Detalhe opcional
Mecanismo do GitHub para propor mudanças no código. Permite code review, discussão, testes automáticos antes do merge. Inclui diff de mudanças e histórico de commits.
Processo: Branch → Push → PR → Review → Merge
R
BioReator 4.0
O que muda para você
Estação no computador para acompanhar uma fermentação. A Community 1.1.1 está publicada. A Premium chega em 18/06/2027, sem preço e sem PIX.
Detalhe opcional
Oficina caracore-ru (Java 25 + JavaFX). Loja ru.caracore.com.br. MSI e ZIP na release bioreator-1.1.1. O EXE fica dentro do ZIP.
Wiki: projeto-bioreator.html
Repository (Repositório)
O que muda para você
Repositório é como uma "pasta de projeto" que guarda tudo: código, imagens, documentos, histórico de mudanças. É onde vive o projeto completo.
Detalhe opcional
Diretório Git que contém todos arquivos do projeto, histórico de commits, branches, tags. Pode ser local (sua máquina) ou remoto (GitHub, GitLab).
Estrutura: .git/, código fonte, README.md, .gitignore
REST API
O que muda para você
REST API é como um "cardápio padronizado" para sistemas. Você pede informações usando "verbos" específicos (GET para pegar, POST para criar) e recebe a resposta organizada.
Detalhe opcional
Architectural style para APIs web usando HTTP methods (GET, POST, PUT, DELETE), status codes, JSON, URLs representando recursos.
Exemplo: GET /api/users/123 retorna usuário ID 123
S
SQL (Structured Query Language)
O que muda para você
SQL é a "linguagem" para conversar com bancos de dados. É como fazer perguntas organizadas: "Me dê todos os usuários que se cadastraram hoje" ou "Apague este produto".
Detalhe opcional
Linguagem para gerenciar dados relacionais. Comandos principais: SELECT (consulta), INSERT (criar), UPDATE (alterar), DELETE (remover).
Exemplo: SELECT * FROM users WHERE age > 18
SSL/TLS
O que muda para você
SSL/TLS é como um "envelope lacrado" para proteger informações na internet. Quando você vê o "cadeadinho" no navegador, significa que sua conversa com o site está protegida.
Detalhe opcional
Protocolos criptográficos para comunicação segura. TLS é sucessor do SSL. Garante confidencialidade, integridade e autenticidade dos dados transmitidos.
Certificado: Let's Encrypt, certificados comerciais
T
Transportes (CSO)
O que muda para você
Nome curto da Gestão de Transportes: o aplicativo de computador do CaraCore CSO, previsto para 08/11/2028, para a operação de entregas não depender só da nuvem.
Detalhe opcional
Ver Gestão de Transportes e o hub projeto-cso.html. Oficina caracore-cso-transportes.
V
Virtual Tracker™
O que muda para você
É a capacidade futura de integrar Frotas e Transportes para acompanhar deslocamentos pelo celular do motorista, sem aparelho dedicado. Alvo conjunto com Transportes em 08/11/2028, sujeito à validação. Não é terceiro produto nem recurso já incluído na Frotas contratada hoje.
Detalhe opcional
Integração E2EE planejada: Frotas autentica e encaminha conteúdo cifrado em memória limitada, sem ler ou persistir trajetos/envelopes. Chave privada, mapa e histórico somente no desktop. Exige conexão, sem fila offline. Perfil de referência: presença 120 s quando necessária e posição 60 s em viagem, a medir; não é instantâneo. Ver limites e planejamento do CSO.
Versionamento
O que muda para você
Versionamento é como numerar as "edições" do seu projeto. Versão 1.0 é a primeira, 1.1 tem pequenas melhorias, 2.0 tem mudanças grandes. Como versões de um livro.
Detalhe opcional
Sistema para identificar diferentes estados do software. Semantic Versioning (SemVer): MAJOR.MINOR.PATCH (ex: 2.1.3). Git tags marcam releases específicas.
Padrão: v1.0.0, v1.1.0, v2.0.0-beta
Virtual Environment (venv)
O que muda para você
Virtual Environment é como ter "gavetas separadas" para cada projeto Python. Cada gaveta tem suas próprias ferramentas, sem misturar com outros projetos.
Detalhe opcional
Ambiente isolado para projetos Python que mantém dependências separadas. Evita conflitos entre versões de bibliotecas em diferentes projetos.
Comando: python -m venv venv && venv\Scripts\activate