Skip to content

[Pav -114] criar-documentacao-de-desenvolvimento-local-e-padrao-de-testes - #212

Closed
Benevanio wants to merge 5 commits into
developfrom
PAV-114
Closed

[Pav -114] criar-documentacao-de-desenvolvimento-local-e-padrao-de-testes#212
Benevanio wants to merge 5 commits into
developfrom
PAV-114

Conversation

@Benevanio

Copy link
Copy Markdown
Collaborator

Documentação de desenvolvimento local e padrão de testes automatizados

Objetivo

Criar uma documentação para facilitar o onboarding de novos contribuidores no projeto, centralizando informações sobre execução local da aplicação e o padrão utilizado para criação de testes automatizados.

O que foi alterado

Foi criada uma documentação contendo:

Desenvolvimento local

  • Pré-requisitos necessários para executar o projeto.
  • Configuração inicial do ambiente.
  • Instalação das dependências.
  • Configuração das variáveis de ambiente.
  • Comandos utilizados para executar os serviços localmente.
  • Orientações para execução e validação da aplicação.

Padrão de testes automatizados

Foi documentado o padrão utilizado no projeto para organização de testes utilizando:

  • TP (Test Plan)
  • TC (Test Case)

A documentação explica:

  • Diferença entre TP e TC.
  • Como estruturar cenários de teste.
  • Como criar novos casos de teste.
  • Boas práticas para testes unitários.
  • Quando utilizar it.each.
  • A importância de validar comportamento e regras do sistema, evitando testes acoplados a detalhes de implementação.

Exemplo utilizado

Foi utilizado como referência o fluxo de testes do Go Scraper:

hltav and others added 5 commits July 29, 2026 00:51
Descrição

Esta PR corrige problemas de validação nos formulários e filtros, além
de melhorar a apresentação dos contribuidores na página inicial.

Alterações

Cadastro
- [PAV-82 — Campos do formulário de cadastro não possuem limite de
caracteres](https://linear.app/tatame/issue/PAV-82/bug009-campos-do-formulario-de-cadastro-nao-possuem-limite-de)
    - Nome limitado a 100 caracteres.
    - E-mail limitado a 254 caracteres.
    - Telefone limitado a 15 dígitos.
    - Senha limitada a 128 caracteres.
    - Senha mínima alterada para 8 caracteres.
    - Validações equivalentes adicionadas ao backend.
    - Testes para entradas acima dos limites.
 Filtros
- [PAV-79 — Campo de filtro não possui limite de
caracteres](https://linear.app/tatame/issue/PAV-79/bug007-campo-de-filtro-nao-possui-limite-de-caracteres)
    - Buscas e novas keywords limitadas a 100 caracteres.
    - Filtros longos truncados visualmente.
    - Conteúdo completo disponível pelo atributo title.
    - Prevenção de quebra horizontal do layout.
    - Cobertura para dashboard, vagas e gerenciamento de filtros.
Página inicial
- [PAV-103 — Ícone do GitHub não redireciona para o
repositório](https://linear.app/tatame/issue/PAV-103/bug-011-icone-do-github-nao-redireciona-para-o-repositorio-do-projeto)
    - Link corrigido para o repositório oficial.
    - Adicionado nome acessível ao ícone.
    -Teste de regressão para URL, abertura em nova aba e segurança.
- [PAV-102 — Exibir nome do colaborador em vez do
username](https://linear.app/tatame/issue/PAV-102/melhoria-002-exibir-nome-do-colaborador-em-vez-do-username-do-github)
    - Exibição do nome do colaborador.
    - Username preservado no formato @username.
- Consulta ao perfil do GitHub para obter nomes não cadastrados
localmente.
    - Fallback mantido quando a API estiver indisponível.
- [PAV-101 — Padronizar informações nos cards dos
contribuidores](https://linear.app/tatame/issue/PAV-101/melhoria-001-padronizar-as-informacoes-exibidas-nos-cards-dos)
    - Cards padronizados com nome, username, função e commits.
    - Dados retornados pela API têm prioridade sobre o fallback local.
    - Contagens iguais a zero ficam ocultas.
    - Espaçamento preservado para manter o alinhamento dos cards.
 Validações
- ✅ 316 testes do frontend passando.
- ✅ 523 testes do backend passando.
- ✅ Build de produção concluído.
- ✅ ESLint sem erros.
Commits
- 64fa516 — Limites e validações do cadastro.
- 64ebdca — Limites e truncamento dos filtros.
- 99b7a30 — Redirecionamento do ícone do GitHub.
- 05fe1bb — Nome e username dos contribuidores.
- 98bf63e — Padronização dos cards.
## Alterações

- Ajusta layout da página de login conforme Figma
- Atualiza componentes visuais de autenticação
- Ajusta página de cadastro para manter consistência visual

## Validação

- Testes backend executados com sucesso
- Lint e build do frontend executados com sucesso
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants