Criar e Executar um Projeto FacturaScripts

FacturaScripts é uma solução robusta e flexível de ERP e CRM de código aberto, ideal para pequenas e médias empresas e freelancers. Com o ambiente de desenvolvimento local conveniente fornecido pelo ServBay, você pode facilmente criar, testar e executar projetos do FacturaScripts em seu sistema macOS.

Este guia irá orientá-lo em todo o processo de instalação e configuração do FacturaScripts utilizando o ServBay.

O que é o FacturaScripts?

FacturaScripts é um software de planejamento de recursos empresariais (ERP) e gestão de relacionamento com o cliente (CRM) desenvolvido com base em PHP e no framework Bootstrap. Ele é projetado para ajudar as empresas a gerenciar seus processos de negócios essenciais, incluindo:

• Emissão e gerenciamento de faturas
• Contabilidade
• Controle de estoque
• Gestão de clientes e fornecedores
• Gestão de projetos
• E muito mais...

Como um projeto de código aberto, ele possui uma comunidade ativa e permite que os usuários expandam e personalizem suas funcionalidades por meio de plugins.

Principais Características e Vantagens do FacturaScripts

• Código aberto e gratuito: Sem taxas de licença caras, você pode usar e modificar livremente.
• Funcionalidade abrangente: Cobre a maior parte das funcionalidades essenciais necessárias para as operações diárias de pequenas e médias empresas.
• Facilidade de uso: Interface relativamente intuitiva, com curva de aprendizado suave.
• Altamente expansível: Possui um rico mercado de plugins que permite adicionar novas funcionalidades ou integrar-se facilmente a outros serviços.
• Multiplataforma: Baseado na web, acessível em qualquer dispositivo que suporte navegadores modernos.
• Comunidade ativa: Você pode obter ajuda da comunidade quando encontrar problemas.
• Suporte multilíngue: Suporta vários idiomas, facilitando o uso por usuários de diferentes regiões.

Criar e Executar um Projeto FacturaScripts Usando o ServBay

O ServBay oferece um ambiente local ideal para executar aplicativos PHP, como o FacturaScripts. Ele integra Nginx/Apache, várias versões do PHP, MySQL/MariaDB/PostgreSQL e outros serviços comuns, além de fornecer uma interface gráfica para gerenciamento.

As principais etapas para rodar o FacturaScripts no ServBay incluem:

1. Baixar o código-fonte do FacturaScripts.
2. Criar uma pasta de projeto no diretório gerenciado pelo ServBay.
3. Criar o banco de dados e usuário do MySQL necessários para o FacturaScripts.
4. Configurar o servidor Apache para apontar para o diretório do projeto via ServBay.
5. Acessar via navegador e completar o assistente de instalação do FacturaScripts.

Criando um Projeto FacturaScripts (Baseado em um Pacote .zip Baixado)

Esta é uma das formas mais comuns de instalação local.

1. Baixar o FacturaScripts:

   • Acesse o site oficial do FacturaScripts (https://facturascripts.com/).
   • Vá para a seção de downloads e encontre o pacote .zip da versão estável mais recente para baixar.

2. Criar o diretório do projeto:

   • Abra o Finder e vá até o diretório onde o ServBay armazena arquivos de sites. Por padrão, sugerimos colocá-lo em /Applications/ServBay/www/.
   • Crie uma nova pasta neste diretório para armazenar o projeto FacturaScripts, nomeando, por exemplo, facturascripts_project.
   • Exemplo de caminho completo: /Applications/ServBay/www/facturascripts_project

3. Extrair os arquivos:

   • Extraia o arquivo .zip do FacturaScripts que você baixou na pasta facturascripts_project que acabou de criar.
   • Após a extração, a pasta facturascripts_project deve conter arquivos e diretórios como index.php, config.php (podendo ser gerado após a instalação), Core, Dinamic, Plugins etc.

Configuração Inicial (Configuração do Banco de Dados MySQL, etc.)

O FacturaScripts requer um banco de dados para armazenar todos os dados. Usaremos o serviço MySQL gerenciado pelo ServBay.

1. Certifique-se de que o serviço MySQL está em execução:

   • Abra o aplicativo ServBay.
   • No menu à esquerda, escolha "Serviços" - "MySQL".
   • Verifique se o serviço MySQL (ou MariaDB) está ativo. Se não estiver, clique no botão de alternância ao lado para ativá-lo.

2. Criar o banco de dados:

   • Você pode usar a ferramenta de gerenciamento de banco de dados embutida do ServBay (como o phpMyAdmin) ou criar o banco de dados via linha de comando.
   • Usando o phpMyAdmin (recomendado):
     • Na interface do ServBay, localize "Banco de Dados" - "MySQL" e clique no phpMyAdmin no canto superior direito.
     • Faça login no phpMyAdmin (geralmente usando o usuário root e a senha que você configurou no ServBay).
     • Clique na guia "Banco de Dados".
     • No campo "Criar Banco de Dados", insira o nome do banco de dados, como facturascripts_db.
     • Selecione um conjunto de caracteres adequado, recomendando utf8mb4_general_ci ou utf8mb4_unicode_ci.
     • Clique em "Criar".
   • Criar um usuário do banco de dados (opcional, mas recomendado): Por motivos de segurança, é aconselhável criar um usuário de banco de dados dedicado para o FacturaScripts, em vez de usar o usuário root.
     • Na página inicial do phpMyAdmin, clique na guia "Contas de Usuário".
     • Clique em "Adicionar Conta de Usuário".
     • Insira um nome de usuário (como facturascripts_user).
     • Escolha localhost como o nome do host.
     • Gere ou insira uma senha forte e certifique-se de anotar essa senha.
     • Marque "Criar um banco de dados com o mesmo nome do usuário e conceder todas as permissões" ou vá manualmente à parte "Banco de Dados" para conceder ao novo usuário todas as permissões no banco de dados facturascripts_db (ALL PRIVILEGES).
     • Clique em "Executar" na parte inferior da página.

3. Registrar as informações do banco de dados: Anote as informações do banco de dados que você criou:

   • Nome do banco de dados (facturascripts_db)
   • Nome de usuário do banco de dados (facturascripts_user)
   • Senha do usuário do banco de dados (a senha que você definiu)
   • Host do banco de dados (normalmente localhost ou 127.0.0.1)
   • Porta do banco de dados (o padrão do MySQL é 3306, que pode ser confirmado na lista de serviços do ServBay)

Essas informações serão usadas durante o processo de instalação do FacturaScripts.

Configuração do Servidor Web (Baseado em Apache)

Agora precisamos informar ao ServBay como servir o nosso projeto FacturaScripts através do Apache.

1. Certifique-se de que o serviço Apache está em execução:

   • Na interface "Serviços" do ServBay, confirme se o serviço Apache está ativo.

2. Adicionar um host:

   • No menu à esquerda do ServBay, escolha "Sites".
   • Clique no botão "+" à direita.
   • Na janela de configuração que aparece, preencha as seguintes informações:
     • Nome: Dê um nome descritivo a essa configuração de host, como FacturaScripts Demo.
     • Domínio: Insira o domínio que deseja usar para acessar o site local do FacturaScripts. Por conveniência, usaremos facturascripts.demo.
     • Tipo de Site: Selecione PHP, indicando que este é um site dinâmico em PHP.
     • Diretório Raiz: Clique no botão "Navegar" ou "Selecionar" para localizar e selecionar o diretório onde você criou e extraiu os arquivos do FacturaScripts (/Applications/ServBay/www/facturascripts_project).
     • Servidor Web: Selecione Apache e a versão do Apache que deseja usar.
     • Versão do PHP: Escolha uma versão do PHP que seja compatível com a versão do FacturaScripts que você baixou (consulte os requisitos do sistema do FacturaScripts, geralmente recomenda-se versões estáveis mais recentes, como PHP 8.1 ou 8.2).
     • Configurações Adicionais: Normalmente, mantenha as configurações padrão, a menos que tenha necessidades especiais.

3. Salvar a configuração:

   • Clique no botão "Adicionar".
   • O ServBay configurará automaticamente o host virtual do Apache e pode solicitar permissões de administrador para modificar o arquivo hosts do sistema, a fim de direcionar facturascripts.demo para o IP local (127.0.0.1). Por favor, permita esta operação.

4. Verificar extensões do PHP:

   • O FacturaScripts pode precisar de extensões específicas do PHP para funcionar corretamente (como pdo_mysql, gd, intl, zip, entre outras).
   • No ServBay, você pode gerenciar as extensões PHP instaladas. Normalmente, as extensões pré-instaladas do ServBay são suficientes, mas se a instalação indicar a falta de alguma extensão, você pode ativá-las na seção de configuração do PHP do ServBay.

Acessando o Site

Agora que tudo está pronto, você pode iniciar o processo de instalação online do FacturaScripts.

1. Abra um navegador: Abra seu navegador de internet preferido (como Chrome, Firefox, Safari).

2. Digite o endereço: Na barra de endereços, insira https://facturascripts.demo e pressione Enter.

3. Assistente de Instalação do FacturaScripts:

   • Se todas as configurações estiverem corretas, você deverá ver a tela de instalação do FacturaScripts.
   • Seleção de idioma: Escolha o idioma que você prefere usar.
   • Verificação do sistema: O instalador verificará se o ambiente do servidor (versão do PHP, extensões necessárias, permissões de diretório etc.) atende aos requisitos. Se o ServBay estiver configurado corretamente, tudo deve ser sinalizado em verde. Se houver problemas, verifique as configurações do PHP ou permissões de arquivo no ServBay, conforme as mensagens de erro.
   • Configuração do banco de dados: Esta é uma etapa crítica. Você precisará inserir as informações do banco de dados que criou e registrou anteriormente:
     • Tipo de banco de dados: Selecione MySQL.
     • Host: localhost ou 127.0.0.1.
     • Porta: 3306 (ou a porta do MySQL que você vê no ServBay).
     • Nome do banco de dados: facturascripts_db.
     • Nome de usuário: facturascripts_user.
     • Senha: A senha que você definiu para facturascripts_user.
     • Prefixo da tabela: Você pode manter o valor padrão fs_.
   • Conta de administrador: Defina o nome de usuário, senha e e-mail do administrador do FacturaScripts. Certifique-se de anotar essas informações, pois elas serão usadas para acessar o painel de administração.
   • Instalação: Clique no botão de instalação, e o FacturaScripts criará as tabelas do banco de dados e escreverá no arquivo de configuração.

4. Conclusão da instalação:

   • Após a instalação bem-sucedida, você normalmente será solicitado a excluir o diretório install (se existir e houver um aviso, para segurança).
   • Agora você deve conseguir acessar a página de login do FacturaScripts em http://facturascripts.demo. Use a conta de administrador que você acabou de configurar para fazer login e comece a explorar e usar o FacturaScripts!

---

Parabéns! Você criou e executou com sucesso um projeto FacturaScripts em um ambiente local macOS utilizando o ServBay. O ServBay simplificou a configuração e gestão do ambiente do servidor local, permitindo que você se concentre mais no desenvolvimento e uso do FacturaScripts em si.