FAQ - Técnico

Perguntas técnicas para desenvolvedores e administradores do sistema.

---

Requisitos do sistema

• PHP 7.4 ou superior
• MySQL 5.7 ou MariaDB 10.4
• Extensões PHP: PDO, JSON, mbstring, curl

---

"Unknown database" ao acessar o sistema

Causa: O banco de dados não existe ou as credenciais estão incorretas.

Solução:

1. Verifique se o MySQL/MariaDB está em execução
2. Confirme as credenciais em privado/constantes/constantes.vf
3. O sistema tentará criar o banco automaticamente

Referência: Class/DB.class.php:341-361

---

Não consigo fazer login

Causa: Usuário não existe ou senha incorreta.

Solução:

1. Verifique se o usuário está cadastrado na tabela pessoas
2. O campo pess_usuario deve estar preenchido

Referência: login.html, _BD/conecta_login.php

---

Página em branco após login

Causa: Erro fatal no PHP.

Solução:

1. Verifique o arquivo erro.log para identificar o erro
2. Confirme que a sessão está sendo iniciada corretamente

Referência: index.php:3 (session_start)

---

"Call to undefined function" erros

Causa: Extensões PHP não instaladas.

Solução:

1. Verifique a versão do PHP (mínimo 7.4)
2. Instale as extensões: pdo, json, mbstring, curl

---

Erro de permissão em uploads

# Linux
chmod -R 775 uploads
chmod -R 775 uploadsAgenda
chown -R www-data:www-data /var/www/vfweb

---

QR Code não é gerado

Solução:

1. Verifique que a pasta phpqrcode/ existe
2. Confirme permissões de escrita
3. Verifique erros no erro.log

Referência: _Cadastros/impressao_etiquetas_qrcode.php

---

E-mail não é enviado

Solução:

1. Verifique as configurações de e-mail em _Configuracoes/
2. Confirme que a pasta PHPMailer/ está presente
3. Teste a conexão SMTP

Referência: Class/email.class.php

---

Como integrar com outros sistemas?

Utilize a API REST:

1. Gere a chave de API em _Configuracoes/ ou via Class/api.class.php
2. Utilize o endpoint configurado
3. Envie a chave no header X-API-Key

Referência: Class/api.class.php

---

O sistema suporta NF-e/NFS-e?

O módulo fiscal está planejado mas não implementado completamente. Estrutura existe em _Fiscal/.

---

Códigos de Erro Comuns

Código	Descrição
E001	Erro de conexão com banco
E002	Usuário ou senha inválidos
E003	Sessão expirada
E004	Permissão negada
E005	Registro não encontrado

---

Contato para Suporte

• Desenvolvedor: Vinicius Ferreira Fernandes
• GitHub: https://github.com/ViniciusFFernandes