Cardápio Web

Projeto criado na aula de introdução ao Framework Laravel

Sobre • Funcionalidades • Como executar • Tecnologias • Licença

💻 Sobre o projeto

Cardapio Web - permite aos clientes consultarem de forma virtual os produtos fornecidos por comércios em geral. Esse projeto visa conhecer como fazer um CRUD básico em Laravel.

---

⚙️ Funcionalidades

• Os usuários logados tem acesso ao menu administrativo, onde podem:

  • gerenciar os produtos disponíveis no cardápio
  • gerenciar as categorias dos produtos

• Os usuários tem acesso a parte pública da aplicação web, onde podem:

  • consultar os produtos disponíveis
  • efetuar um pedido de produtos por mensagem do whatsapp

---

🚀 Como executar o projeto

Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas: Git, Laravel e Node.js.

Além disto é bom ter um editor para trabalhar com o código como VSCode

🎲 Rodando o Projeto

Instalando as dependências

# Clone este repositório
$ git clone <https://github.com/USUARIO/REPOSITORIO.git>

# Acesse a pasta do projeto no terminal/cmd
$ cd cardapio-web

# Instale as dependências composer
$ composer install

# Instale as dependências npm (frontend)
$ npm install && npm run dev

Configurando o projeto

1. Faça uma cópia do arquivo .env.example e renomeie para .env:
2. Crie um banco de dados

Sugestão MariaDB ou MySQL: definição de collation: utf8mb4_general_ci

3. Configure a conexão com os dados do banco de dados no arquivo .env:

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=NOMEDOBANCO
    DB_USERNAME=USUARIO
    DB_PASSWORD=SENHA

Rodando o servidor

# Criação de nova chave de criptografia da aplicação:
php artisan key:generate
    
# Criação das tabelas e inserção dos dados no banco de dados:
php artisan migrate:fresh --force --seed

# Execute a aplicação em modo de desenvolvimento
php artisan serve

# O servidor iniciará na porta:8000 - acesse <http://localhost:8000>

🎲 Acesso ao Projeto (servidor)

Acesso à área pública da aplicação:

URL: http://domínio/

Acesso à área privada da aplicação:

URL: http://domínio/admin

Criar usuário pelo terminal usando tinker:

# Executar o tinker
php artisan tinker

# No tinker: 
>>> $user = new \App\Models\User;
>>> $user->email = '[email protected]';
>>> $user->password = Hash::make('senha'); # altere 'senha' para uma senha forte
>>> $user->name = 'Nome do Administrator';
>>> $user->save();
>>> exit() # sair do tinker

---

🛠 Tecnologias

As seguintes ferramentas foram usadas na construção do projeto:

• Laravel
• Node.js
• Bootstrap
• JQuery

As seguintes dependências foram incluidas no projeto:

• Módulo de linguagem Português do Brasil (pt_BR) para Laravel
• Laravel Fortify
• Laravel Permission
• Laravel UI

---

💪 Como contribuir para o projeto

1. Faça um fork do projeto.
2. Crie uma nova branch com as suas alterações: git checkout -b my-feature
3. Salve as alterações e crie uma mensagem de commit contando o que você fez: git commit -m "feature: My new feature"
4. Envie as suas alterações: git push origin my-feature

📝 Licença

Este projeto é um software de código aberto licenciado sob a licença gnu general public license version 3.0 (gplv3).