Teste: danielbastos/revendamais

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[docker-compose.yml]
+indent_size = 4

.env.example

@@ -0,0 +1,69 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+# APP_MAINTENANCE_STORE=database
+
+PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+# CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_SCHEME=null
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"
+
+#Habilitando xdebug
+SAIL_XDEBUG_MODE=develop,debug,coverage
+SAIL_XDEBUG_CONFIG="client_host=host.docker.internal idekey=vscode"

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

.gitignore

@@ -0,0 +1,24 @@
+*.log
+.DS_Store
+.env
+.env.backup
+.env.production
+.phpactor.json
+.phpunit.result.cache
+/.fleet
+/.idea
+/.nova
+/.phpunit.cache
+/.vscode
+/.zed
+/auth.json
+/node_modules
+/public/build
+/public/hot
+/public/storage
+/storage/*.key
+/storage/pail
+/vendor
+Homestead.json
+Homestead.yaml
+Thumbs.db

README.md

@@ -1,54 +1,106 @@
-## Teste para Desenvolvedor PHP/Laravel
-
-Bem-vindo ao teste de desenvolvimento para a posição de Desenvolvedor PHP/Laravel. 
-
-O objetivo deste teste é desenvolver uma API Rest para o cadastro de fornecedores, permitindo a busca por CNPJ ou CPF, utilizando Laravel no backend.
-
-## Descrição do Projeto
-
-### Backend (API Laravel):
-
-#### CRUD de Fornecedores:
-- **Criar Fornecedor:**
-  - Permita o cadastro de fornecedores usando CNPJ ou CPF, incluindo informações como nome/nome da empresa, contato, endereço, etc.
-  - Valide a integridade e o formato dos dados, como o formato correto de CNPJ/CPF e a obrigatoriedade de campos.
-
-- **Editar Fornecedor:**
-  - Facilite a atualização das informações de fornecedores, mantendo a validação dos dados.
-
-- **Excluir Fornecedor:**
-  - Possibilite a remoção segura de fornecedores.
-
-- **Listar Fornecedores:**
-  - Apresente uma lista paginada de fornecedores, com filtragem e ordenação.
-
-#### Migrations:
-- Utilize migrations do Laravel para definir a estrutura do banco de dados, garantindo uma boa organização e facilidade de manutenção.
-
-## Requisitos
-
-### Backend:
-- Implementar busca por CNPJ na [BrasilAPI](https://brasilapi.com.br/docs#tag/CNPJ/paths/~1cnpj~1v1~1{cnpj}/get) ou qualquer outro endpoint público.
-
-## Tecnologias a serem utilizadas
-- Framework Laravel (PHP) 9.x ou superior
-- MySQL ou Postgres
-
-## Critérios de Avaliação
-- Adesão aos requisitos funcionais e técnicos.
-- Qualidade do código, incluindo organização, padrões de desenvolvimento e segurança.
-- Documentação do projeto, incluindo um README detalhado com instruções de instalação e operação.
-
-## Bônus
-- Implementação de Repository Pattern.
-- Implementação de testes automatizados.
-- Dockerização do ambiente de desenvolvimento.
-- Implementação de cache para otimizar o desempenho.
-
-## Entrega
-- Para iniciar o teste, faça um fork deste repositório; Se você apenas clonar o repositório não vai conseguir fazer push.
-- Crie uma branch com o nome que desejar;
-- Altere o arquivo README.md com as informações necessárias para executar o seu teste (comandos, migrations, seeds, etc);
-- Depois de finalizado, envie-nos o pull request;
-
-
+## Revenda Mais - Projeto de testes
+
+### Pré-requisitos
+Docker instalado (https://www.docker.com)
+Git
+
+Após clonar o projeto, siga as intruções abaixo:
+
+### 1 - Copiando o env
+```
+cp .env.example .env
+```
+
+### 2 - Instalando dependências
+```
+sail composer install
+sail npm install && sail npm run build
+```
+
+### 3 - Iniciando os serviços
+```
+./vendor/bin/sail up -d
+```
+
+### 4 - migration e seed
+```
+./vendor/bin/sail php artisan migrate
+./vendor/bin/sail php artisan db:seed
+```
+
+
+
+## Sobre o projeto
+O módulo RevendaMais tem 2 objetivos:
+- O primeiro é implementar um endpoint REST para gerenciar os dadso de fornecedores, sejam eles pessoas físicas ou jurídicas. 
+- O segundo implementar um facade para APIs de busca de informações de pessoas jurídicas. 
+
+Algumas considerações:
+- A opção de isolar em packages é apenas uma decisão de organização e demonstrar o uso da opção. 
+- Foi implementado apenas 1 caso de testes, que é a Rule do objeto de validação de documento (CPF/CNPJ)
+- Implementei a validação dentro do SupplierController e o ValidateDocument como um objeto separado para demonstrar o uso.
+- Não compreendi se a integração com a brasilapi tinha a intenção de completar os dados do cadastro de fornecedores ou apenas retornar os dados para a tela. Acabei optando pela segunda opção.
+- Deixei a API aberta. Não teria tempo de implementar o suporte de autenticação. 
+
+O teste esta na pasta padrão. Roda com o comando padrão:
+```
+./vendor/bin/sail php artisan test
+```
+
+## Endpoints
+
+Find:
+GET /revendamais/suppliers
+```
+curl --request GET \
+  --url 'http://127.0.0.1/revendamais/suppliers?document=74386567000184&order=name&direction=desc&limit=2'
+```
+
+Create:
+POST /revendamais/suppliers
+```
+curl --request POST \
+  --url http://127.0.0.1/revendamais/suppliers \
+  --header 'Content-Type: application/json' \
+  --data '{
+	"document": "84719590000105",
+	"email": "empresa1@exemplo.com",
+	"name": "Empresa S/A",
+	"business_name": "Empresa"
+}'
+```
+
+Get:
+GET /revendamais/suppliers/{id}
+```
+curl --request GET \
+  --url http://127.0.0.1/revendamais/suppliers/2
+```
+
+Update:
+PUT /revendamais/suppliers/{id}
+```
+curl --request PUT \
+  --url http://127.0.0.1/revendamais/suppliers/2 \
+  --header 'Content-Type: application/json' \
+  --data '{
+	"document": "20598877000133",
+	"email": "empresa4@exemplo.com",
+	"name": "Empresa 2 S/A",
+	"business_name": "Empresa 2"
+}'
+```
+
+Delete:
+DELETE /revendamais/suppliers/{id}
+```
+curl --request DELETE \
+  --url http://127.0.0.1/revendamais/suppliers/2
+```
+
+Busca de CNPJ:
+GET /revendamais/cnpj/{cnpj}
+```
+curl --request GET \
+  --url http://127.0.0.1/revendamais/cnpj/27865757000102
+```

app/Http/Controllers/Controller.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\Http\Controllers;
+
+abstract class Controller
+{
+    //
+}

app/Models/User.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Models;
+
+// use Illuminate\Contracts\Auth\MustVerifyEmail;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Notifications\Notifiable;
+
+class User extends Authenticatable
+{
+    /** @use HasFactory<\Database\Factories\UserFactory> */
+    use HasFactory, Notifiable;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var list<string>
+     */
+    protected $fillable = [
+        'name',
+        'email',
+        'password',
+    ];
+
+    /**
+     * The attributes that should be hidden for serialization.
+     *
+     * @var list<string>
+     */
+    protected $hidden = [
+        'password',
+        'remember_token',
+    ];
+
+    /**
+     * Get the attributes that should be cast.
+     *
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
+}

app/Providers/AppServiceProvider.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    /**
+     * Register any application services.
+     */
+    public function register(): void
+    {
+        //
+    }
+
+    /**
+     * Bootstrap any application services.
+     */
+    public function boot(): void
+    {
+        //
+    }
+}

artisan

@@ -0,0 +1,18 @@
+#!/usr/bin/env php
+<?php
+
+use Illuminate\Foundation\Application;
+use Symfony\Component\Console\Input\ArgvInput;
+
+define('LARAVEL_START', microtime(true));
+
+// Register the Composer autoloader...
+require __DIR__.'/vendor/autoload.php';
+
+// Bootstrap Laravel and handle the command...
+/** @var Application $app */
+$app = require_once __DIR__.'/bootstrap/app.php';
+
+$status = $app->handleCommand(new ArgvInput);
+
+exit($status);