Laravel Pastry API

Api para o gerenciamento de uma pastelaria desenvolvida com Laravel 12 e a biblioteca sanctum para o gerenciamento de autenticação. O sistema permite Listar, Criar, Ler, Editar e Excluir (CRUDL) dados para os seguintes módulos: Produtos, Clientes e Pedidos. Ainda conta com um sistema de autenticação com Login, Registo e Logout.

A documentação da API pode ser acessada na routa /docs

Cobertura da documentação: Autenticação e CRUDL de clientes, produtos e pedidos

Cobertura de testes automatizados

Tecnologias Usadas

• PHP 8.4
• Laravel 12
• Mysql
• Laravel sanctum
• PHPUnit
• Docker com Laravel Sail
• Postman

Requisitos

Necessário ter o docker instalado na máquina. Se for windows vai precisar do WSL

Como instalar na máquina local

Clone o repositório

git clone https://github.com/katalekoweb/katalekoweb/laravel-pastry-api.git
cd katalekoweb/laravel-pastry-api

Copie o ficheiro .env

cp .env.example .env

Instale as dependencias

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php84-composer:latest \
    composer install --ignore-platform-reqs

Rode os containers com o Laravel sail

./vendor/bin/sail up -d

Gere a chave do programa

./vendor/bin/sail artisan key:generate

Rode as migrations e os seeders

./vendor/bin/sail artisan migrate --seed

Instale as dependencias npm

./vendor/bin/sail npm i

Faça o build das libs npm

./vendor/bin/sail npm run build

Acesse o seu projeto num de cliente de API como o post man ou Insonia

Url: http://locathost/api/v1/login, Method: POST
Login | username:admin@admin.com, senha: password
O seeder de dados já com com 4 categorias predefinidas ("Salgado", "Doce", "Especial", "Bebidas")

Como rodar os testes

Acessar o terminal do ambiente sail

./vendor/bin/sail bash

E rode:

php artisan test

Imagens

Meu email: juliofeli78@gmail.com

Linkedin: https://www.linkedin.com/in/juliaokataleko

Whatsapp: https://wa.me/244922660717