Gerar um gráfico e executar localmente (Windows/macOS/Linux)

Gerar um gráfico e executar localmente (Windows/macOS/Linux)

Este guia mostra como gerar um projeto ZIP a partir do construtor DEMO e executá-lo localmente com Docker.

  1. Na página inicial, abra o construtor DEMO e escolha o tipo de gráfico.
  2. Clique em Editar gráfico.
  3. Preencha Séries e Valores. Ajuste eixos e opções, se necessário.
  4. Clique em Gerar ZIP. Em Confirmar, verifique se sua assinatura está ativa e o contador de ZIP > 0.
  5. Extraia o arquivo baixado.
  6. Instale e inicie o Docker Desktop a partir de docker.com.
  7. Na pasta extraída, execute o script central:
    • Windows: dê dois cliques em run-docker-windows.bat
    • macOS/Linux:
      chmod +x ./run-docker-unix.sh
      ./run-docker-unix.sh
    Os scripts tentam primeiro iniciar os containers sem rebuild. Se as imagens não existirem, tentarão carregar base-images.tar (se presente) e só então farão um build único se necessário.
  8. Abra no navegador:
    • Frontend: http://localhost:8081/
    • Backend: http://localhost:8080/

Dica: Se seu plano inclui licença offline, baixe-a em Configurações e coloque em frontend/public/license.cwclic.

Avançado (offline, rebuild, stop)

Preparação offline (fazer uma vez com Internet)

Em uma máquina com Internet, execute:

  • Windows: preload-base-images-windows.bat
  • macOS/Linux: ./preload-base-images-unix.sh

O script baixa as imagens base do Docker e empacota em base-images.tar. Copie esse arquivo para a máquina offline ao lado do projeto.

Carregar imagens offline

Na máquina offline (ao lado de docker-compose.yml):

  • Windows: load-base-images-windows.bat
  • macOS/Linux: ./load-base-images-unix.sh

Alternativamente, execute o script central — ele tentará carregar base-images.tar automaticamente.

Forçar rebuild

  • Windows: run-docker-windows.bat rebuild
  • macOS/Linux: ./run-docker-unix.sh rebuild
  • ou var. de ambiente: CWC_REBUILD=1

Parar / limpar

  • Parar containers: stop-docker-windows.bat ou ./stop-docker-unix.sh
  • Limpeza completa (remover volumes) manual:
    docker compose down -v

Solução de problemas

  • Docker não está em execução: abra o Docker Desktop e tente novamente.
  • Portas em uso: altere as portas em docker-compose.yml e reinicie.
  • Permissões (mac/linux): execute chmod +x ./run-docker-unix.sh.
  • Sem Internet / erro auth.docker.io: use o fluxo offline — prepare base-images.tar, carregue com load-base-images-* e execute o script central novamente.