📦

Manual de instalação e preparação do ambiente

Caminhos conferidos no snapshot agenda.barberbot(1).zip

1. Antes de começar

  • Faça backup do código e do banco antes de substituir arquivos.
  • Use ambiente separado da produção para validar login, agenda, pagamentos, uploads, cron e webhooks.
  • Não publique .env, sistema/conexao.php, dumps, logs ou credenciais.

Snapshot conferido: 4,292 arquivos; SHA-256 9eccad1c28899e0fc365f5b4cd2cecdd04cb3caf36e1d9e12bf186cfd9d6b1dc.

2. Requisitos observados

  • Servidor web capaz de executar PHP.
  • PDO com driver MySQL/MariaDB, porque a conexão principal usa new PDO(...).
  • cURL e JSON para integrações HTTP presentes em vários fluxos.
  • mbstring e dom para a biblioteca DOMPDF incluída no projeto.
  • Permissão de gravação somente nas pastas usadas por upload, cache, sessão e logs.

O projeto não possui um arquivo raiz que declare formalmente a versão mínima da aplicação. A biblioteca DOMPDF incluída aceita PHP 7.1 ou 8.x, mas a implantação deve usar a mesma versão validada no ambiente atual antes de qualquer atualização.

3. Publicação dos arquivos

  1. Extraia o conteúdo do pacote na raiz configurada para o domínio.
  2. Preserve a estrutura de pastas; os require e include usam caminhos relativos.
  3. Confirme a presença dos pontos de entrada: index.php, agendamentos.php, protese.php, sistema/index.php, sistema/painel/index.php e sistema/painel_cliente/index.php.

4. Banco de dados

  1. Crie um banco MySQL/MariaDB para o ambiente.
  2. Importe o dump correspondente a esta revisão: barberbotcom_agenda(1).sql.
  3. O dump enviado possui 67 tabelas e 698 campos.
  4. Depois da importação, não aplique alterações manuais sem registrar uma migração ou script reproduzível.

SHA-256 do dump: 0fea56bcea243f0c8932fad69b3598495f0664ca07430c4d211729a0b52b62c3

5. Conexão e ambiente

A conexão com o banco está no arquivo:

sistema/conexao.php

Esse arquivo concentra host, banco, usuário, senha, URL do sistema, timezone e leitura da tabela config. Preencha os valores no servidor sem copiar credenciais para a documentação.

O arquivo raiz .env do snapshot contém parâmetros de licença e alertas. Ele não substitui a configuração atual do banco em sistema/conexao.php.

6. Pastas graváveis encontradas no código

  • sistema/painel/images/analises/ — fotos das análises.
  • sistema/painel/images/simulacoes/ — originais e imagens simuladas.
  • cron/logs/ — logs de rotinas que criam ou usam essa pasta.
  • webhook/sessions/ e webhook/webhook_dedupe/ — estado e controle de duplicidade do webhook.
  • Pastas de imagens, relatórios e uploads específicas de cada módulo que chama move_uploaded_file ou file_put_contents.

Conceda apenas a permissão necessária ao usuário do PHP. Não use permissão global de escrita como solução permanente.

7. Rotinas agendadas e integrações

  • A pasta cron/ contém 13 arquivos PHP no snapshot.
  • Antes de cadastrar um cron, abra o arquivo e confirme parâmetros, timezone, logs e dependências.
  • As integrações de pagamento estão em pagamentos/, asaas/, asaas_contas/ e asaas_planos/.
  • Configurações de IA estão relacionadas a config/config_openai.php e aos campos correspondentes da tabela config.

8. Checklist de validação

  1. Abrir o site público sem erros fatais.
  2. Testar login profissional e login do cliente.
  3. Cadastrar um cliente fictício e um agendamento de teste.
  4. Confirmar leitura e gravação no banco.
  5. Testar upload em módulo autorizado.
  6. Executar cron e webhook apenas com credenciais de teste.
  7. Revisar logs e remover dados de teste antes da liberação.