DEV Community: Leonardo Souza

Meu primeiro projeto REAL

Leonardo Souza — Thu, 11 Jul 2024 18:15:39 +0000

Como tudo começou...

Ano passado conheci a FCamara em um evento que eles organizaram junto ao GDG Santos. Descobri que às quintas-feiras o escritório fica aberto para pessoas que queiram estudar ou trabalhar. Desde então tenho frequentado o Orange Hub, onde em uma dessas idas conheci o Lucas Batista , desenvolvedor mobile sênior e coordenador do projeto que vou falar hoje.

O Lucas me apresentou a Ariane Salerno , empreendedora local com a demanda de um sistema para cadastro de vendas personalizado. Até então o cadastro do seu negócio era realizado manualmente, impossibilitando, ou pelo menos dificultando muito, a análise dos dados. De forma geral, o modo trabalho atual não possibilitava a tomada de decisões a partir de seu histórico.

Sobre o projeto

Passamos então a ter reuniões semanais, sob a orientação do Lucas, para construir uma solução baseada nas especificidades do tipo de negócio da Ariane. Inicialmente alinhamos quais funcionalidades seriam necessárias e a partir disso caminhamos para o desenvolvimento e feedbacks.

Considerando as necessidades apresentadas, alinhei com o Lucas que tecnologias seriam utilizadas, optando pelas quais eu tinha maior familiaridade:

Backend: Nest.JS, com Prisma.
Frontend: React, mais especificamente a biblioteca de componentes React Mantine, que utiliza Typescript nos componentes.

Funcionalidades

As funções básicas de um CRUD (criar, ler, editar e deletar) foram as primeiras implementadas, assim como a autenticação.

No momento estamos desenvolvendo o BackOffice para avançar na geração dos relatórios.

Desafios

Backend e uso de ORM

Por mais que eu estivesse familiarizado com o Nest, não foi tão natural escrever um projeto do zero. Demorei certo tempo para entender como validar as requisições do backend e como usar o Prisma, coisa que nunca havia feito.

Dados e normalização de dados

No início, pensar nas tabelas, como elas se comunicariam, porque elas se comunicariam, foi algo que demandou muita análise, alguns testes e vários migrations.

React e Typescript

No frontend as coisas ficaram mais complicadas. Fazia bastante tempo que não mexia com React e tive que recorrer à documentação. O typescript foi bem desafiador de implementar devido ao caráter verboso da linguagem, porém trouxe robustez ao sistema.

React - Passagem de dados entre componentes

Alguns problemas na comunicação entre os componentes surgiram, como por exemplo mandar os dados de um componente filho para o pai para que ele atualizasse os dados das vendas. Implementando context e providers foi possível padronizar a comunicação.

Versionamento

Apesar de estar desenvolvendo sozinho, tenho utilizado o git para entender como seria o fluxo de trabalho em um projeto colaborativo, experienciando criação de branches para funcionalidades e correção de bugs, merge das branchs, criação de pull requests.

Aprendizados

O trabalho no projeto tem desenvolvido minhas habilidades de comunicação e gestão de expectativas com a cliente, alinhando as demandas e traduzindo isso em código.
Com o tempo tenho notado minha melhoria técnica, como maior agilidade em criar e gerenciar CRUDS e ter insights nas ferramentas e plataformas utilizadas, tornando o código mais robusto em termos de segurança e qualidade.
Além disso, este projeto tem me proporcionado familiaridade com refatoração de código, hospedagem de serviços, desenvolvimento contínuo e colaborativo.

Próximos passos

Tem sido um caminho de muito aprendizado até aqui, e o plano é continuar evoluindo tecnicamente, especialmente na comunicação entre os componentes do React, na elaboração de testes e no versionamento de código. Quero ainda explorar mais ferramentas cloud, como o Vercel e, futuramente, GCP e AWS.

Agradecimentos

Algumas pessoas têm sido fundamentais para esse processo, especificamente com tecnologia, por me ajudarem de N formas a aprender algo novo, como Lucas Viana, Leonardo Santos Severino, Lucas Batista e Gabriel Sanzone .
Obrigado pela dedicação e paciência em compartilhar conhecimento.
Agradeço também à minha família e Letícia por acreditarem em mim e por todo apoio durante essa jornada

Funções

Leonardo Souza — Wed, 15 May 2024 01:29:00 +0000

Queria começar a escrever uns artigos tem um tempo e hoje na aula de estrutura de dados tive essa idéia de escrever sobre funções e espero que possa servir para o pessoal da monitoria de algoritmos e pra você que possívelmente ficou curioso e veio ler.

Funções primeiramente servem pra não repetirmos código. Existe um princípio de desenvolvimento de software chamado DRY (Don't repeat yourself), uma versão diferente do que os menudos diriam "Não se repita".

Imagina um código dessa forma:

#include <iostream>
#include <cmath>
using namespace std;

int main() {
    // Cálculo da área do retângulo

    //base 5 - altura 10
    float baseRetangulo = 5;
    float alturaRetangulo = 10;
    float areaRetangulo = baseRetangulo * alturaRetangulo;
    cout << "Área do retângulo: " << areaRetangulo << endl;

    //base 7 - altura 11
    float baseRetangulo = 7;
    float alturaRetangulo = 11;
    float areaRetangulo = baseRetangulo * alturaRetangulo;
    cout << "Área do retângulo: " << areaRetangulo << endl;

    //base 8 - altura 12
    float baseRetangulo = 8;
    float alturaRetangulo = 12;
    float areaRetangulo = baseRetangulo * alturaRetangulo;
    cout << "Área do retângulo: " << areaRetangulo << endl;
    return 0;
}

Poderíamos facilmente ter escrito esse código dessa forma abaixo e perceba como ficou mais fácil de ler o que está acontecendo. Além disso, eu repito o código infinitamente menos.

#include <iostream>
#include <cmath> 

using namespace std;

// Função para calcular a área do retângulo
float calcularAreaRetangulo(float base, float altura) {
    return base * altura;
}

int main() {
    // Exemplos de uso das funções
    cout << "Área do retângulo: " << calcularAreaRetangulo(5, 10) << endl;
    cout << "Área do retângulo: " << calcularAreaRetangulo(7, 11) << endl;
    cout << "Área do retângulo: " << calcularAreaRetangulo(8, 12) << endl;
    return 0;
}

Suponho que concorde que fica muito mais fácil de entender o código e usá-lo para calcular as áreas das formas geométrica. Eu escrevo muito menos linhas e consigo usar valores diferentes de uma forma muito mais fácil.

E esse exemplo é bem simples, em um sistema mais complexo, os benefícios são infinitamente maiores.

Para defini-las usamos essa estrutura:

    tipoDeRetorno nomeDafuncao(tipoParametro1 nomeParametro1, tipoParametro2 nomeParametro2, ...) {
        //conteúdo da função
}

Primeiramente declaramos o tipo de retorno, ou seja, o que aquela função vai entregar pra gente.

Pode ser void se não retornar nada, pode ser int se retornar um inteiro (igual a função da área do retângulo por exemplo), float se eu retornar números decimais...

Agora entra a parte mais complicadinha, vamos falar sobre os parâmetros. Usando aquela função dá área do retângulo, percebe que no início, avisamos o programa que ela vai retornar um número decimal? E além disso, percebe que depois da abertura dos parênteses, temos duas variáveis?

float calcularAreaRetangulo(float base, float altura) {
    return base * altura;
}

Essas variáveis são chamadas de parâmetros, elas dizem que pro funcionamento da função, eu vou precisar de 2 coisas, no caso o número da base e o número da altura. E se observamos a linha de baixo vemos que a única coisa que essa função faz é pegar esses valores e multiplica-los então claro, precisaremos de 2 valores para isso.

Mas perceba, quando eu declaro essa função como fiz no código de cima, eu NÃO ESTOU PASSANDO VALOR NENHUM. Aquilo ali só diz pro computador, vou precisar de 2 coisas aqui, mas não tem valor nenhum definido ali.

E como eu defino um valor? Simples, primeiro você precisa executar (chamar) essa função. E para isso é só fazer assim.

float area = calcularAreaRetangulo();

Se você definir a função da forma que fiz e executar esse código, perceberá que terá um erro. O erro nos diz o seguinte:

candidate function not viable: requires 2 arguments, but 0 were provided

Ou seja, são necessários 2 argumentos mas eu não entreguei nenhum. E você pode se perguntar, mas o que são argumentos? Eles são justamente o valor que eu passo, o que preencherá o vazio que existe nos parâmetros (lembra que eles não existem? eles só avisam que eu vou precisar de alguma coisa ali?).

E agora quando eu chamo a função dessa forma aqui:

float area = calcularAreaRetangulo(3, 4);

Terei como resultado 12!

Então lembra:

PARÂMETRO É O QUE EU ESPERO RECEBER

ARGUMENTO É O QUE EU MANDO PARA A FUNÇÃO SER EXECUTADA