Este repositório contém o código para o sistema de gestão de vendas e estoque da Mad Kandy, uma loja de doces com temática de Halloween. O sistema foi desenvolvido com Laravel para o back-end e oferece integração com o banco de dados e o controle de estoque de forma automatizada.

Este guia assume que o usuário tem alguma experiência com o uso de terminais de comando para execução de comandos simples e acesso à internet. Caso essa seja sua primeira vez utilizando um sistema Laravel, siga os passos abaixo para configurar sua máquina.

Antes de executar o sistema, certifique-se de ter os seguintes programas instalados:

1. XAMPP

   • Baixar XAMPP
   • Configuração Adicional:
     Após a instalação, abra o arquivo de configuração do PHP php.ini localizado na pasta php do XAMPP e habilite a extensão zip removendo o ; antes dela. Isso é necessário para que o Composer possa instalar as bibliotecas.

2. Composer (Gerenciador de dependências do PHP)

   • Baixar Composer
   • Atenção: Durante a instalação, certifique-se de configurar corretamente o PATH do PHP para que ele seja reconhecido no terminal.

3. Laravel (Framework PHP)

   • Após instalar o Composer, abra o terminal e execute o seguinte comando para instalar o Laravel globalmente:

     composer global require laravel/installer

Clone o repositório ou faça o download do projeto diretamente pelo GitHub:
Repositório do Projeto

Após o download, extraia o conteúdo para um diretório de sua preferência. Acesse o diretório back-end via terminal.

No terminal, dentro da pasta back-end, execute o comando:

composer install

Esse comando fará com que o Composer instale todas as dependências necessárias para o funcionamento do servidor web.

Localize o arquivo .env.example no diretório back-end e crie uma cópia dele renomeando para .env (remova a parte .example).
Esse arquivo permite configurar as informações de acesso ao banco de dados. Caso utilize algo além do SQLite (como MySQL), atualize as variáveis correspondentes.

Com o arquivo .env configurado, execute os seguintes comandos no terminal:

1. Gere a chave de segurança:

   php artisan key:generate

2. Crie um vínculo simbólico para os recursos de armazenamento:

   php artisan storage:link

3. Execute as migrações para configurar o banco de dados:

   php artisan migrate

   • Caso precise resetar o banco de dados no futuro, utilize:

     php artisan migrate:refresh

Para iniciar o servidor, execute o seguinte comando no terminal, ainda no diretório back-end:

php artisan serve

Esse comando deve ser repetido sempre que for necessário iniciar o sistema.

Com o servidor em execução, navegue até o diretório front-end e abra o arquivo index.html em seu navegador. Isso permitirá acessar o sistema de gestão de vendas e estoque da Mad Kandy.

Este projeto está licenciado sob a Licença Apache 2.0. Contribuições são bem-vindas!