DEV Community: Amanda Pereira

Como você está contribuindo com a comunidade e resolvendo seus problemas pessoais?

Amanda Pereira — Tue, 01 Apr 2025 14:55:41 +0000

Sem dúvidas, 2025 é o ano em que mais estou me empenhando em criar projetos pessoais, mas focando em solucionar problemas reais: os meus problemas.

Mockai (https://mockai.com.br) foi contruído pensando no meu problema de sempre precisar cadastrar dados para realizar testes;
Para o LangPt (https://packagist.org/packages/constpereiradev/lang-pt), pensei em como em todo projeto novo Laravel eu preciso ficar traduzindo os retornos padrões do framework;
QuickDoc (https://quickdoc.space) foi feito visando resolver o meu problema diário em construir documentações;

Até mesmo o AppOpener (https://github.com/constpereiradev/app-opener), um simples script python, eu o utilizo todos os dias desde que o criei, e ele elimina pelo menos 15 minutos de trabalho.

Nesse ano também tomei a iniciativa de investir numa hospedagem para que meus projetos saiam do localhost.

Essas experiências têm contribuido diretamente no meu desenvolvimento pessoal, e estou praticando aquilo que um bom desenvolvedor precisa dominar: resolver problemas. Sem reinventar a roda ou tentar ser extraordinária, mas sendo original nas minhas próprias ideias.

Enquanto muitos se preocupam com o impacto da IA na tecnologia, percebo que há problemas cotidianos que ainda exigem soluções práticas e personalizadas. Aproveito disso todos os dias para ter novas ideias e desenvolver meus próprios projetos (e isso não significa que a IA não possa ser uma auxiliar nesse processo).

Entre algumas das minhas metas está me tornar mais ativa em redes como o medium e o dev.to, onde tenho alguns poucos artigos publicados, pois um desenvolvedor que acumula conhecimento sem compartilhá-lo não constrói pontes, apenas paredes.

E você, o que construiu nesses 4 meses?

Conheça meu portfólio: https://pereiradev.vercel.app/
Vamos nos conectar e desenvolver soluções para problemas sem pensar no seu tamanho.

DesenvolvimentoDeSoftware

Programação

ResoluçãoDeProblemas

CompartilhamentoDeConhecimento

DevLife

Tecnologia

Aprendizado

OpenSource

ComunidadeTech

Inovação

Mockai - Gerador de Dados Mockados para Desenvolvedores

Amanda Pereira — Wed, 05 Mar 2025 22:04:33 +0000

Como desenvolvedora, sempre enfrentei desafios ao criar dados fictícios para testes. Esse processo manual consumia tempo e frequentemente resultava em inconsistências que afetavam a qualidade do software.

Pensando nessa problemática, desenvolvi o Mockai, uma ferramenta web simples que automatiza a geração de dados mockados, permitindo que você se concentre no que realmente importa: desenvolver soluções de qualidade.

🚀 Por que o Mockai é essencial?

Agilidade no Desenvolvimento: Elimine o tempo gasto na criação manual de dados de teste e acelere o ciclo de desenvolvimento.

Qualidade Assegurada: Garanta que suas aplicações sejam testadas com dados consistentes e realistas, reduzindo a ocorrência de bugs.

Flexibilidade: Personalize os dados gerados para atender às necessidades específicas do seu projeto, seja para testes unitários, de integração ou de performance.

🛠️ Tecnologia por trás do Mockai

O Mockai foi desenvolvido utilizando o recém-lançado Laravel Cloud e Laravel 12, que oferecem uma infraestrutura robusta e escalável, garantindo desempenho e confiabilidade.

🔥 O que vem por aí?

O projeto está atualmente em fase beta (MVP), mas novas funcionalidades já estão em desenvolvimento, incluindo:

Retorno de raw query para maior controle sobre os dados gerados.

Criação de tabelas e colunas personalizadas para atender diferentes necessidades.

Autenticação para que você possa salvar e gerenciar seus projetos com segurança.

✨ Experimente o Mockai!

Te convido a testar o Mockai e compartilhar seu feedback. Sua opinião é essencial para melhorarmos ainda mais a ferramenta.

👉 Acesse agora: https://mockai.laravel.cloud/

📬 Contato

Se tiver dúvidas, sugestões ou quiser trocar ideias, entre em contato comigo:

📧 E-mail: seu-email@email.com🐦 Twitter: @seuTwitter💼 LinkedIn: seuLinkedIn

Fico no aguardo do seu feedback e espero que o Mockai ajude a tornar o seu desenvolvimento mais ágil e eficiente! 🚀

Dev, o que são boas práticas?

Amanda Pereira — Wed, 10 Apr 2024 15:16:46 +0000

Olá! Meu nome é Amanda Pereira.

Identação? Comentários? Documentação? Manual do usuário? O assunto de hoje é sobre boas práticas.
Afinal, qual são as práticas que irão facilitar o trabalho das pessoas que irão precisar fazer manutenção num código escrito por mim?

Depois de 7 meses de experiência, tenho a propriedade de falar que passei por situações complicadas que me levaram ao seguinte questionamento: como essa pessoa esperava que eu fosse entender esse código? Desde então, venho me dedicando pra que a próxima pessoa não passe por situações como essa, seguindo as seguintes práticas:

Comentários

Antes de ingressar no mercado de trabalho, achava que comentários se tornavam desnecessários se um código fosse legível, afinal,

$ nome = 'amanda'
return $nome;

é um trecho código auto-explicativo, certo?

Aí é que vem o erro de muitos: achar que comentários devem explicar linha por linha de um código, quando na verdade, devem explicar um código no geral;

/*
Esse relatório possui os dados X. Um dado, quando acontece algo Y, recebe status Z.

Status A: explicação do status.
Status B: explicação do status.
Status C: explicação do status.

Relação (nome da relação): O model X possui relação Many To Many com o model Y.
*/

Quem precisar dar manutenção na função que possui esse trecho de comentário, certamente não terá dificuldades para entender o que aquele código faz e as regras que ele possui.

Não repita código

Não repita uma função, crie uma genérica para ser reutilizada.

public function subtrairNumeros($num1, $num2){
  return $num1 - $num2;
}
public function somarNumeros($num1, $num2){
  return $num1 + $num2;
}

public function calculadora(){
  $num1 = 10; $num2 = 10;
  $soma = $this->somarNumeros($num1, $num2);
  $subtracao = $this->subtrairNumeros($num1, $num2);
}

Documentação

O que é essa tal de documentação? Como é feita?

De diversas maneiras. Uma documentação pode ser feita no README do seu repositório, num documento Word, através de comentários, através de UML. É essencial criar o diagrama do seu banco de dados e das relações que existem nele, assim, o próximo dev vai saber o nome de cada especificação e encontra-las vai ficar mais fácil.

Um arquivo md também é interessante.

Tenha sempre em mente formas de deixar claro a ideia do seu projeto, como utilizar e onde encontrar os recursos que você criou.

Código

Por fim, mantenha o seu código legível, se uma variável guarda uma idade, dê a ela o nome de $idade. Se a sua função soma números, dê a ela o nome somarNumeros(); Mantenha a identação adequada e não deixe seu código ultrapassar sua tela. Retorne mensagens de erro;

E o principal: se coloque no lugar do próximo profissional que ocupará seu lugar.

Onde me encontrar

LinkedIn

GitHub

How to make a CRUD REST API with LARAVEL 10?

Amanda Pereira — Wed, 10 Apr 2024 14:17:49 +0000

Hey you! Im glad you're here.
Before we begin, I want to clarify that this tutorial covers the basics of creating a CRUD REST API with Laravel 10. While I'll do my best to explain the concepts and provide a step-by-step guide, I want to emphasize that I'm not an expert in the field. It's important to delve deeper into the topic and consult the official documentation for a comprehensive understanding. This article serves as a starting point, but it won't cover everything you need to know. With that said, let's get started!

Laravel documentation is pretty complete and clear about all the functionalities of the framework, and PHP has such a big community, where you can ask and help everyone.

I'm gonna make an Product CRUD.

Open your terminal and create your Model, Controller and Migration.

php artisan make:model Product

php artisan make:controller ProductController

php artisan make:migration create_products_table

Let's configure the Products table. Imagine that our product has title, description and price.

public function up(): void
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->string('description');
            $table->float('price');
            $table->timestamps();
        });
    }

After that, you must "tell" your model that you can put values in these columns.

Go to your product model and put this line of code.

protected $fillable = [
        'title',
        'description',
        'price',
    ];

I guess you can realize that if you had an column called "color" you would have to add it in the array. This is how you say that these inputs are able to be fill.

Go to your product controller. Here is where the magic happens before you write the routes. Inside the class, let's make our first function. I'm gonna call it 'index'.

use App\Models\Product;

class ProductController extends Controller{

  public function index(){

          $products = Product::all();

          return response()->json([
              'Products: ' => $products,
          ]);
      }
}

Let's understand what is going on here…
4.1 Everytime you refer to something that is on another file, you have to _tell _your code where is it. This is why the line use App\Models\Product; exists.

4.2 The variable $products is receiving all products from your database. Remember that you were on its models file? There it is.

4.3 We are returning a json script with our products (you will see them just after store on database).

Create Store, Show, Update and Delete functions.

public function store(Request $request){

        $input = $request->validate([
            'title' => ['required'],
            'description' => ['required'],
            'price' => ['required'],
        ]);

        $product = Product::create($input);

        if ($product->save()){

            return response()->json([
                'Message: ' => 'Success!',
                'Product created: ' => $product
            ], 200);

        }else {

            return response([

                'Message: ' => 'We could not create a new product.',

            ], 500);
        }

    }

Now you can create new products!
See more about validation here and HTTP client here.

public function show(string $id){

        $product = Product::find($id);

        if ($product){

            return response()->json([
                'Message: ' => 'Product found.',
                'Product: ' => $product
            ], 200);

        }else {

            return response([

                'Message: ' => 'We could not find the product.',

            ], 500);
        }

Now you can find a product by the id.

public function update(Request $request, string $id){

        $product = Product::find($id);

        if($product){

           $input = $request->validate([
              'title' => ['required'],
              'description' => ['required'],
              'price' => ['required'],
            ]);

            $product->title = $input['title'];
            $product->description = $input['description'];
            $product->price = $input['price'];

            if($product->save()){

                return response()->json([

                    'Message: ' => 'Product updated with success.',
                    'Product: ' => $product

                ], 200);

            }else {

                return response([

                    'Message: ' => 'We could not update the product.',

                ], 500);

            }
        }else {

            return response([

                'Message: ' => 'We could not find the product.',

            ], 500);
        }

    }

Now you can update the informations of your product by the id.

public function destroy(string $id){

        $product = Product::find($id);

        if($product){

            $product->delete();

            return response()->json([

                'Message: ' => 'product deleted with success.',

            ], 200);

        }else {

            return response([

                'Message: ' => 'We could not find the product.',

            ], 500);
        }

    }

Now you can delete a product by the id.

Now you have to create the routes, or you will can not access your api and test your functions. Go to api.php.

use App\Http\Controllers\ProductController;

Route::controller(ProductController::class)->group(function () {

    Route::get('products', 'index');
    Route::post('product/create', 'store');
    Route::put('product/update/{id}', 'update');
    Route::get('product/read/{id}', 'show');
    Route::delete('product/delete/{id}', 'destroy');

});

For me, using an group route is the best way of make a clean code, but of course you can do it without the group. Here you have to understand what is get, post, put and delete, or you'll be just copying and pasting code.
The route you created could be totally diferent, but we have to follow the patterns of the documentation.
Don't forget to pass the id to the route if you passed it to the function.

That's it! Run your migrations, start your server and enjoy it!
When I made my first REST API, I didn't knew how it really works or where to see what was happening, that's why I use Postman today. Search about it and i'm sure you are gonna understand.
Follow me on GitHub!
See my Linkedin!