Objetivo

Criar um laboratório Protheus reproduzível para estudo e desenvolvimento, usando Docker Compose para organizar License Server, PostgreSQL, DBAccess e AppServer.

O foco do projeto é reduzir setup manual, versionar configuração de ambiente e registrar decisões operacionais que normalmente ficam dispersas durante a montagem de um ambiente Protheus.

Estado atual

  • Ambiente base validado em Docker Compose
  • Serviços license, postgres-iniciado, dbaccess-postgres e appserver documentados
  • Geração automatizada de dbaccess.ini, odbc.ini e odbcinst.ini
  • Script de validação para arquivos obrigatórios antes da subida
  • WebApp e porta TCP do AppServer parametrizados via .env

Decisões de engenharia

  • Manter artefatos Protheus fora do Git, incluindo RPO e arquivos de systemload
  • Versionar apenas modelos, scripts e documentação operacional
  • Gerar a configuração efetiva do DBAccess com dbaccesscfg
  • Usar healthcheck no PostgreSQL antes da inicialização do DBAccess
  • Manter o primeiro lab com escopo controlado, sem REST, CI/CD ou observabilidade

Próximas fases

  • Organização avançada do projeto e boas práticas com Docker Compose
  • Automação com scripts adicionais e Makefile
  • Evolução do gerenciamento de configuração com .env
  • Persistência, backup e restore do PostgreSQL
  • Atualização controlada das imagens Protheus
  • Integração com GitHub Actions