Objetivo

Projeto criado para fins didáticos.

Sobre o projeto

Uma simples API para cadastro de transações feita com Laravel e Sanctum.

A interface de usuario se encontra no repositorio DT Money V2.

Como executar o projeto

Pré-requisitos

• Docker
• Docker Compose
• PHP
• Composer

Executando o projeto

Clone o repositório com:

git clone git@github.com:IgorThierry/dt-money-api-laravel.git

Entre na pasta do projeto:

cd dt-money-api-laravel

Instale as dependências com:

composer install

Crie o arquivo .env com:

cp .env.example .env

Gere a chave da aplicação com:

php artisan key:generate

Preencha o arquivo .env com as informações do banco de dados:

# senha padrão do banco de dados quando usamos o pacote sail
# é "password"
DB_PASSWORD=password

Crie uma senha para o usuário admin no arquivo .env:

# essa senha vai ser usada para autenticar o usuário admin
ADMIN_PASSWORD=sua-senha

Suba os containers com:

./vendor/bin/sail up -d

Execute as migrations com:

./vendor/bin/sail artisan migrate

Execute os seeders com:

./vendor/bin/sail artisan db:seed

Acesse a aplicação em http://localhost

Testando a aplicação

Para testar a aplicação basta utilizar o software de sua preferência, como o Insomnia ou o Postman.

Na raiz desse projeto tem um arquivo com as rotas da aplicação, que você pode importar no Insomnia ou Postman.

COLLECTION.har

Rotas

Autenticação

Show Laravel Version

GET /

Login

POST /login

{
    "email": "admin@test.com.br",
    "password": "sua-senha"
}

Logout

POST /logout

User

Mostra informações do usuário logado

GET /api/user

Transações

Listar transações

GET /api/transactions

Criar transação

POST /api/transactions

{
    "description": "Lanche",
    "type": "outcome",
    "price": 49.9,
    "category": "comida"
}

Deletar transação

DELETE /api/transactions/{id}