Screenshots

Arquitetura

Instalador_PDV.exe
├── Apache 2.4          Servidor web local
├── MariaDB 10.4        Banco de dados local
├── PHP 8.2             Backend
├── CodeIgniter 4       Framework
├── Bootstrap 4         Frontend
├── PowerShell          Launcher com splash screen
└── Inno Setup 6        Empacotamento e instalação

Desafios técnicos e decisões de projeto

• Escolha do banco de dados: Avaliei algumas opções antes de definir o banco. O sistema precisava de algo que funcionasse bem em modo portátil, sem exigir configuração do usuário, e que aguentasse o uso do dia a dia de um comércio sem engasgar. MariaDB com InnoDB se encaixou: leve, estável, suporta acessos simultâneos e roda embalado dentro do instalador sem nenhum setup extra.

• Empacotamento de três servidores num único instalador: O instalador carrega Apache, MariaDB e PHP dentro. Na primeira execução, o launcher inicia os serviços em ordem, aguarda cada um responder, e só então abre o navegador. Se uma porta estiver ocupada ou um serviço falhar, o sistema identifica o problema, exibe um diagnóstico para o usuário e encerra os serviços que já foram iniciados para não deixar processos soltos.

• Funcionar em qualquer Windows sem pré-requisitos: O sistema precisava funcionar em qualquer máquina Windows sem depender de nada que já estivesse instalado. Todas as bibliotecas necessárias vão dentro do instalador, incluindo as DLLs do Visual C++ Runtime. O launcher foi construído em PowerShell, que é nativo do Windows, depois de identificar que o VBScript foi descontinuado pela Microsoft no Windows 11. A validação final foi feita no Windows Sandbox para garantir que nenhuma dependência externa ficou de fora.

• Banco de dados portátil: Mover um banco MariaDB com InnoDB entre máquinas não é trivial. Os arquivos de dados precisam estar sincronizados com o tablespace global, e qualquer inconsistência impede o banco de iniciar. O processo de build limpa referências órfãs e transaction logs antes de empacotar, garantindo que tudo funcione na primeira execução em qualquer máquina.

• Tradução e formatação brasileira: O sistema original tinha suporte a múltiplos idiomas, mas o português brasileiro era parcial e genérico. Reescrevi 24 arquivos de idioma, adaptei moeda para R$, datas para dd/mm/aaaa e separador decimal com vírgula. Módulos foram renomeados para termos que fazem sentido no comércio brasileiro, como "Combos" e "Compras". A tela de login, o cabeçalho, o rodapé e o dashboard foram personalizados com a identidade visual do produto.

• Splash screen sem dependências externas: O launcher precisava mostrar uma tela de carregamento enquanto os serviços iniciam, mas sem instalar nenhum framework adicional. A solução foi construir a interface direto em PowerShell usando WinForms, que já vem no Windows. O resultado é uma splash screen com barra animada e mensagens de status, sem nenhuma dependência extra.

Requisitos

Autor

Lilton Carneiro Desenvolvedor Full Stack Fortaleza, CE