Cara Core Seed

Contador de Licenças — foco localhost e Windows Desktop

Privado Licença Proprietária Estável Java SQLite Windows Desktop
Repositório Privado

Este projeto possui código-fonte privado e é protegido por licença proprietária da Cara Core Informática. Apresentação e download no canal institucional: delivery/seed e delivery/seed/download.

Visão Geral

O que é o Seed?

O Cara Core Seed é o Contador de Licenças para quem compra os produtos Cara Core (PDV, Minerador 4.0, Reino OIDC, Hub) para rodar no Windows. O cliente vê e gerencia suas licenças com transparência e em conformidade com a LGPD.

Escopo atual:

  • 🖥️ Foco localhost e Windows Desktop: Aplicativo roda no computador do cliente
  • 📦 EXE para Windows: Instalador com Electron + servidor local (JRE + WAR)
  • 🗄️ SQLite local: Banco único no escopo; dados em caracore-seed.db
  • 🔐 Portal de controle: Transparência e auditoria de licenças (inspirado no Minerador 4.0)

Arquitetura

WAR Java com SQLite local; Electron inicia JRE + WAR e abre a interface em http://localhost:9080 (ou porta configurada). Dois perfis: Contador de Clientes (uso interno) e Comprador (consulta somente leitura).

Stack:

  • Backend: Java (WAR), SQLite (único banco no escopo)
  • Desktop: Electron; abre localhost após iniciar servidor embutido
  • Licença: license.key em %APPDATA%\caracore-seed-desktop (Windows)
  • Testes: UT (Maven), HTTP (pytest), E2E (Selenium) com foco em localhost e Desktop

Foco: localhost e Windows Desktop

Para o usuário final

O Seed roda no computador do cliente (Windows). Ao abrir o aplicativo, o servidor sobe em localhost e a interface abre no navegador embutido. Tudo fica local: banco SQLite, dados de licenças, portal de controle. R$ 29,90 (valor único).

  • 📦 Baixar EXE: delivery/seed e caracore-seed-releases
  • 🔑 license.key: Colocado em %APPDATA%\caracore-seed-desktop (ou junto ao EXE)
  • 🖥️ 100% offline: Funciona sem internet após instalação

Estrutura do repositório

caracore-seed/
├── electron/           # Desktop (EXE): main.js, licenseGate, localhost
├── project_seed/       # Backend Java (WAR), SQLite
├── data/               # caracore-seed.db (SQLite local)
├── scripts/            # build_seed_desktop.bat, testes (localhost)
├── README.md           # Escopo: localhost + Windows Desktop
└── delivery (matriz) / caracore-seed-releases (filial)

Banco: apenas SQLite no escopo; propriedade -Dapp.db.path=./data/caracore-seed.db (opcional).

Funcionalidades Principais

Gestão de licenças

Para leigos: O cliente vê quais licenças possui (PDV, Minerador, Reino OIDC, Hub), onde estão ativas e até quando valem.

Técnico: Validação RSA-2048, license.key atrelado ao hardware; perfis Contador e Comprador.

SQLite local

Para leigos: Todos os dados ficam no próprio computador, em um único arquivo.

Técnico: Apenas SQLite no escopo; caracore-seed.db; sem PostgreSQL nem outros bancos.

Windows Desktop (Electron)

Para leigos: Instalador EXE; ao abrir, o sistema sobe sozinho e abre a tela em localhost.

Técnico: Electron inicia JRE + WAR; interface em http://localhost:9080 (ou porta configurada).

Portal de controle

Para leigos: Área onde o cliente consulta licenças, transparência e LGPD.

Técnico: Dashboard, listagem de licenças, clientes, assinaturas, auditoria; API REST local.

Como usar e links

Para o cliente

  1. Baixar o EXE em delivery/seed (canal institucional)
  2. Instalar no Windows; obter license.key (ID de Ativação + PIX)
  3. Colocar license.key em %APPDATA%\caracore-seed-desktop (ou junto ao EXE)
  4. Abrir o aplicativo: sobe em localhost e abre a interface

Desenvolvimento e testes

Testes com foco em localhost e Desktop Electron: UT (Maven), HTTP (pytest), E2E (Selenium). Ver README_PY.md no repositório; definir CARACORE_BASE_URL=http://localhost:9080/caracore-seed para Desktop.

Build EXE: scripts/build_seed_desktop.bat; publicar em caracore-seed-releases.