DEV Community: Fábio Carvalho

Saia do Loop - Data Annotation.

Fábio Carvalho — Wed, 20 Sep 2023 01:07:39 +0000

Bem vindo a série Saia do Loop ! No tutorial de hoje nós vamos falar de Data Annotation (ou anotações de dados) que existem dentro da programação C#. Dito isso, vamos começar criando um projeto vázio de console utilizando qualquer versão do .Net 3.1 para cima em nosso Visual Studio Community.

Vamos começar criando uma nova classe chamada Pessoa. Para isso no seu projeto, clique com o botão direito e em seguida clique em Add e em seguida Class.

Na classe Pessoa.cs que criamos, vamos adicionar alguns campos. Sendo eles Nome, Idade e Data de Nascimento.

 public class Pessoa
    {
        public string Nome { get; set; }
        public int Idate { get; set; }
        public DateTime DataDeNascimento { get; set; }
    }

Ótimo, com o nosso objeto Pessoa criado, vamos entender agora como as Data Annotation funcionam. As datas annotations são usadas para import regras em propriedades de classe. Por exemplo, em nosso objeto Pessoa nós queremos que o nome seja obrigatório e que tenha no mínimo 3 caractéres. Ou seja, todo nome precisa ter ao menos 3 letras para ser considerado um nome válido.

Dito isso, usando data annotation nós podemos criar essa regra diretamente em nossa propriedade, veja o exemplo abaixo:

    public class Pessoa
    {
        [Required]
        [MinLength(3, ErrorMessage = "Nome precisa ter pelo menos 3 caracteres.")]
        public string Nome { get; set; }
        public int Idade { get; set; }
        public DateTime DataNascimento { get; set; }
    }

No exemplo anterior, nós incluímos duas notações (data annotation) a Required e MinLenght, sendo que na segunda, nós passamos 2 parâmetros, o primeiro é o número mínimo de caractéres que é 3, e em seguida definimos uma mensagem de erro.

Para entender mais, a Microsoft tem uma excelente documentação sobre que você pode ver neste link.

Mas continuando, ao incluir as anotações e dados em seu código, você deverá notar que automaticamente um novo using será adicionado a sua classe.

Este using é necessário para utilizarmos as anotações, então tenha atenção para não esquecer a sua referência. Dito isso, vamos incluir mais anotações para os demais campos.

O campo idade deverá ter entre 0 e 150 anos
O campo de data devera ser válido, e não ser menor que 1900 ou maior que 31/12/2099

    public class Pessoa
    {
        [Required]
        [MinLength(3, ErrorMessage = "Nome precisa ter pelo menos 3 caracteres.")]
        public string Nome { get; set; }

        [Range(0, 150, ErrorMessage = "Idade deve ser entre 0 e 150.")]
        public int Idade { get; set; }

        [DataType(DataType.Date)]
        [Range(typeof(DateTime), "1/1/1900", "12/31/2099", ErrorMessage = "Data fora do intervalo permitido.")]
        public DateTime DataNascimento { get; set; }
    }

Preste anteção que a princípio a data está no formato americano, isso se deve porquê por padrão a anotação valida no formato americano, para formatar e validar no padrão brasileiro, é necessário construir uma anotação customizada.

Por exemplo, caso tivéssemos a seguinte classe em nosso projeto:

   public class BrazilianDateAttribute : ValidationAttribute
    {
     public DateTime MinDate { get; set; }
        public DateTime MaxDate { get; set; }

        public BrazilianDateAttribute(string minDate, string maxDate)
        {
            MinDate = DateTime.ParseExact(minDate, "dd/MM/yyyy", CultureInfo.InvariantCulture);
            MaxDate = DateTime.ParseExact(maxDate, "dd/MM/yyyy", CultureInfo.InvariantCulture);
        }

        public override bool IsValid(object value)
        {
            DateTime date;
            var isValid = DateTime.TryParseExact(
                Convert.ToString(value),
                "dd/MM/yyyy",
                CultureInfo.CurrentCulture,
                DateTimeStyles.None,
                out date
            );

            return isValid && date >= MinDate && date <= MaxDate;
        }

Poderiamos usar a validação da seguinte maneira:

public class Pessoa
    {
        [Required]
        [MinLength(3, ErrorMessage = "Nome precisa ter pelo menos 3 caracteres.")]
        public string Nome { get; set; }

        [Range(0, 150, ErrorMessage = "Idade deve ser entre 0 e 150.")]
        public int Idade { get; set; }

        [BrazilianDate("01/01/1900", "31/12/2099", ErrorMessage = "Data fora do intervalo permitido.")]
        public DateTime DataNascimento { get; set; }
    }

Com isso, dentro de nossa Program.cs, estamos prontos para criar um exemplo em nosso método Main e testarmos as validações:

static void Main(string[] args)
        {
            var pessoa = new Pessoa
            {
                Nome = "Jo", //Nome incorreto
                Idade = -1, //Idate incorreta
                DataNascimento = new DateTime(3000, 1, 1) // Data fora do intervalo
            };

            var results = new List<ValidationResult>();
            var isValid = Validator.TryValidateObject(pessoa, new ValidationContext(pessoa), results, true);

            if (!isValid)
            {
                foreach (var validationResult in results)
                {
                    Console.WriteLine(validationResult.ErrorMessage);
                }
            }

            Console.ReadKey();
        }

Execute, a aplicação e veja os erros que irão acontecer no console.

E pronto, com isso você já deve entender a ideia do que são as Data Annotations, um famoso recurso do C#.

Nos vemos no próximo tutorial! :)

Conectando o VS Community ao Azure DevOps

Fábio Carvalho — Thu, 07 Sep 2023 14:48:18 +0000

Primeiros Passos
Instale o Visual Studio Community: Se você ainda não tem, baixe e instale o Visual Studio Community do site oficial.

Conectando ao Azure DevOps
Abra o Visual Studio Community: Inicie o programa e você vai ver a tela inicial.

Vá para "Team Explorer": Você pode encontrar essa opção no menu "View" e depois em "Team Explorer", ou simplesmente pressionando Ctrl + \, Ctrl + M.

Conecte-se ao Azure DevOps:

No "Team Explorer", clique em "Connect to a Project".
Isso abrirá uma janela nova. Clique em "Add Azure DevOps Server".
Digite a URL:

Uma janela vai aparecer pedindo a URL do Azure DevOps.
Digite a URL do seu Azure DevOps. Geralmente é algo como https://dev.azure.com/NomeDaSuaOrganizacao/SeuProjeto.

Faça Login: Você será solicitado a entrar com suas credenciais (usuário e senha ou token).

Escolha o Projeto: Depois de logado, você verá uma lista de projetos. Clique no projeto em que você quer trabalhar.

Clone ou Abra o Projeto: Você terá a opção de clonar o repositório para o seu computador ou abrir um projeto já clonado.

🎉 Pronto! 🎉
Agora você está conectado ao Azure DevOps e pronto para começar a trabalhar no seu projeto direto do Visual Studio Community!

Espero que esse tutorial seja útil e fácil de seguir! 😊

Como clonar um projeto no Azure DevOps

Fábio Carvalho — Thu, 07 Sep 2023 14:31:40 +0000

Primeiros Passos
Abra o Azure DevOps: Vá até o site do Azure DevOps e faça login.

Escolha o Projeto: No menu de repositórios do lado esquerdo na barra de menus, clique em file e selecione o projeto que você quer copiar para o seu computador.

Opção 1: Usando Git CLI (Linha de Comando)

Botão "Clone": Vai ter um botão chamado "clone repository" no canto superior direito. Clique nele!

Copie o Link: Vai aparecer um link HTTPS. Copie ele.

Abra o Prompt de Comando (Git CLI): Vá até a pasta onde você quer colocar o projeto e abra o Git CLI.
Se você não tem o Git CLI, baixe aqui.

Cole o Comando: Digite git clone e depois cole o link que você copiou. Vai ficar assim:
git clone https://www.seurepositorio.com/seuprojeto

Aperte Enter: Pronto! Seu projeto vai ser copiado para o seu computador.

Opção 2: Usando Visual Studio Code

Botão "Clone in VS Code": Clique nele, em vez de copiar o link HTTPS.

Siga as Instruções: O Visual Studio Code vai abrir e você só precisa seguir o que ele exibir na tela.

Opção 3: Usando Visual Studio Community

Abra o Visual Studio Community: Inicie o programa e vá para a tela inicial.

Clique em "Clone a Repository": Fica geralmente no canto inferior direito.

Cole o Link HTTPS: No campo "Repository Location", cole o link HTTPS que você copiou do Azure DevOps.

Clique em "Clone": Seu projeto vai ser baixado e aberto no Visual Studio Community.

Caso o Projeto Use Token

Clique em "Generate Git Credentials": No Azure DevOps, essa opção vai aparecer se você precisar de um token.

Repita o Passo: Escolha uma das três opções acima e tente clonar o projeto de novo.

Papéis comuns em times ágeis

Fábio Carvalho — Sat, 02 Sep 2023 19:36:05 +0000

Bem-vindo a este guia sobre os papéis em times ágeis! Compreender os diversos papéis e suas interações é fundamental para o sucesso de qualquer projeto ágil. Cada membro da equipe tem responsabilidades específicas, mas a colaboração e comunicação eficazes são a chave para entregar um produto de sucesso.

Neste guia, vamos explorar em detalhes os papéis comuns encontrados em uma equipe ágil e como eles se inter-relacionam durante o ciclo de vida do projeto. Vamos abordar desde o Agile Coach, que orienta a equipe nas melhores práticas ágeis, até os desenvolvedores que executam as tarefas do dia a dia para criar o produto.

👩‍💼 Agile Coach

Responsabilidades: O Agile Coach treina e orienta a equipe em práticas ágeis. Ele também resolve problemas de processo e ajuda a equipe a se adaptar às mudanças.

Interações: Treina Scrum Master, Product Owner, Team Management e Desenvolvedor Líder em melhores práticas ágeis.

👨‍🚀Scrum Master (SM)
Responsabilidades: O Scrum Master facilita reuniões ágeis, como Daily Stand-ups e Sprint Reviews, e remove obstáculos para a equipe.

Interações: Facilita o trabalho para Back-end Devs, Full-stack Devs e Front-end Devs.

👩‍💻 Product Owner (PO)
Responsabilidades: O Product Owner cria e prioriza o backlog com base nos requisitos e feedback dos usuários.

Interações: Colabora com UX Designers para criar designs e com Arquiteto para definir a estrutura do sistema.

🎨 UX Designers
Responsabilidades: Os UX Designers criam protótipos e designs baseados nas necessidades dos usuários e nos requisitos do PO.

Interações: Fornecem designs para Front-end Devs.

🏗️ Arquiteto
Responsabilidades: O Arquiteto define a estrutura geral do sistema e toma decisões de alto nível sobre design e tecnologias.

Interações: Orienta Back-end Devs e Full-stack Devs na implementação da estrutura.

📊 Team Management
Responsabilidades: Team Management planeja os recursos, aloca tarefas e monitora o progresso do projeto.

Interações: Trabalha com Desenvolvedor Líder para alocar tarefas.

👨‍💻 Desenvolvedor Líder
Responsabilidades: O Desenvolvedor Líder divide as tarefas do backlog em tarefas menores e as distribui entre os desenvolvedores.

Interações: Aloca tarefas para Back-end Devs, Full-stack Devs e Front-end Devs.

👨‍💻 Back-end Devs / Full-stack Devs / Front-end Devs
Responsabilidades: Estes desenvolvedores executam as tarefas para desenvolver o produto, focando em suas respectivas áreas (Back-end, Full-stack, Front-end).

Interações: Recebem tarefas do Desenvolvedor Líder e orientações do Arquiteto e Scrum Master.

Entendendo Requisitos Funcionais e Não Funcionais

Fábio Carvalho — Fri, 01 Sep 2023 23:18:23 +0000

Olá!!!! Neste tutorial!, vamos explorar dois conceitos fundamentais no desenvolvimento de software: Requisitos Funcionais e Requisitos Não Funcionais. Compreender a diferença entre eles é crucial para o sucesso de qualquer projeto, independentemente da metodologia ou ferramentas que você esteja usando.

Requisitos Funcionais

O que são?

Requisitos Funcionais descrevem as funcionalidades específicas que um sistema deve realizar. Em outras palavras, eles detalham o que o sistema deve fazer.

📘 Referência: IEEE Guide to Software Requirements Specifications

Exemplos:

Um sistema de gerenciamento de biblioteca deve ser capaz de emitir cartões de sócio.
Um site de comércio eletrônico deve permitir que os usuários adicionem itens ao carrinho de compras.

Como identificá-los?

Geralmente, os requisitos funcionais são identificados durante a fase de coleta de requisitos e são documentados em um Documento de Requisitos de Software (SRS).

📘 Referência: Software Requirements, por Karl Wiegers

Requisitos Não Funcionais

O que são?

Requisitos Não Funcionais, por outro lado, descrevem como um sistema realiza uma determinada função, em vez de quais funções ele deve realizar. Eles são muitas vezes relacionados à experiência do usuário, desempenho, ou conformidade com regulamentos.

📘 Referência: Non-Functional Requirements in Software Engineering, por Lawrence Chung

Exemplos:

O sistema deve ser capaz de suportar 500 usuários simultaneamente.
Todos os dados devem ser criptografados.

Como identificá-los?

Requisitos não funcionais são frequentemente descobertos por meio de entrevistas com stakeholders ou são derivados de padrões industriais ou regulamentações.

📘 Referência: ISO/IEC 25010:2011 Systems and software engineering

Por Que São Importantes?

Entender a diferença entre Requisitos Funcionais e Não Funcionais é crucial para desenvolver um produto de alta qualidade que atenda tanto às necessidades do usuário quanto aos padrões da indústria. Também é fundamental para a criação de User Stories, Features e Tasks eficazes em um ambiente de gerenciamento de projetos, como o que discutimos no Azure DevOps.

Espero que este tutorial tenha esclarecido as diferenças entre Requisitos Funcionais e Não Funcionais e por que ambos são importantes para o sucesso do seu projeto.

Introdução ao Gerenciamento de Projetos com Azure DevOps

Fábio Carvalho — Fri, 01 Sep 2023 22:42:30 +0000

Bem-vindo a este tutorial, onde exploraremos como usar o Azure DevOps para gerenciar seu projeto de desenvolvimento de software de forma eficiente e eficaz. Se você é um desenvolvedor, gerente de projeto ou stakeholder, entender o fluxo de trabalho do Azure DevOps pode ajudá-lo a tornar seu projeto mais bem-sucedido.

Neste tutorial, vamos desvendar os conceitos de Épicos, Features, User Stories e Tasks, que são a espinha dorsal de qualquer projeto bem gerenciado. Além disso, também cobriremos a importância dos critérios de aceitação e como eles se encaixam no fluxo de trabalho do projeto.

Então, se você está procurando uma maneira de melhorar sua abordagem ao gerenciamento de projetos ou simplesmente quer entender como tudo se encaixa no cenário maior, você veio ao lugar certo. Vamos começar!

O Épico

O Épico representa uma grande funcionalidade ou conjunto de funcionalidades que desejamos implementar. Pode ser visto como o "plano mestre" que direciona o desenvolvimento.

As Features

Dentro de um Épico, temos várias Features. Uma Feature é uma parte menor do Épico e descreve uma funcionalidade específica que queremos implementar.

📘 Referência: Features, por Scrum Alliance

As User Stories
Cada Feature é decomposta em uma ou mais User Stories. Uma User Story é uma descrição de uma funcionalidade do ponto de vista de um usuário final.

📘 Referência: User Stories, por Martin Fowler

As Tasks
Finalmente, cada User Story é dividida em Tasks. Uma Task é uma unidade de trabalho específica necessária para completar uma User Story.

📘 Referência: Tasks, por Scrum Alliance

Critérios de Aceitação
Cada User Story e Feature tem critérios de aceitação associados. Isso ajuda a definir o que "feito" significa para aquela história ou característica.

📘 Referência: Acceptance Criteria, por Yvette Francino

Gerenciamento de Projetos, por que é importante ?

Fábio Carvalho — Fri, 01 Sep 2023 22:20:39 +0000

O gerenciamento de projetos, quando feito corretamente, pode ser um fator crítico para o sucesso de um projeto. Ele oferece um framework estruturado que ajuda a equipe de projeto a navegar pela complexidade e incerteza inerentes ao desenvolvimento de software, garantindo que os objetivos do projeto e da organização sejam alcançados.

E assim, sendo bem sincero, o quê na vida funciona sem planejamento não é mesmo? Em vista desse pensamento que ditos populares como “se você falha em planejar, você planeja em falhar” são comuns no dia a dia do desenvolvimento.

Dito isso, por que usar gerenciamento de projetos?

Eficiência e Produtividade

Gerenciamento de projetos ajuda a organizar e direcionar recursos de forma eficiente, garantindo que o projeto seja concluído no prazo e dentro do orçamento.

📘 Referência: Project Management Institute (PMI) – Benefits of Project Management

Controle e Previsibilidade

Ter um plano de projeto claro e metas bem definidas ajuda na previsibilidade e controle, permitindo que a equipe antecipe problemas e tome medidas preventivas.

📘 Referência: The Five Immutable Principles of Project Success, por Glen B. Alleman

Qualidade e Conformidade
O gerenciamento de projetos assegura que os padrões de qualidade sejam mantidos e que o projeto esteja em conformidade com regulamentações ou requisitos de negócio.

📘 Referência: Quality Management in Project Management, por Project Management Docs

Comunicação e Satisfação do Cliente
Melhora a comunicação entre os membros da equipe e com os stakeholders, aumentando a transparência e a satisfação do cliente.

📘 Referência: Effective Communications in Project Management, por PMI

Governança Organizacional
O PMO fornece um framework de governança que inclui políticas, procedimentos e templates que ajudam a guiar o projeto.

📘 Referência: The Standard for Program Management, por PMI

Gestão de Riscos
O PMO frequentemente implementa uma estrutura de gestão de riscos que ajuda a identificar, avaliar e mitigar riscos.

📘 Referência: Practice Standard for Project Risk Management, por PMI

Alinhamento Estratégico
O PMO garante que os projetos estejam alinhados com os objetivos estratégicos da organização, garantindo que os recursos sejam utilizados de forma eficaz.

📘 Referência: Strategic Role of Project Management, por Harold Kerzner